/// <summary>
/// List network domains in the specified datacenter.
/// </summary>
/// <param name="client">
/// The CloudControl API client.
/// </param>
/// <param name="datacenterId">
/// The Id of the datacenter containing the network domain to retrieve.
/// </param>
/// <param name="paging">
/// An optional <see cref="Paging"/> configuration for the results.
/// </param>
/// <param name="cancellationToken">
/// An optional cancellation token that can be used to cancel the request.
/// </param>
/// <returns>
/// The network domains (as <see cref="NetworkDomains"/>).
/// </returns>
public static Task <NetworkDomains> ListNetworkDomains(this CloudControlClient client, string datacenterId, Paging paging, CancellationToken cancellationToken = default(CancellationToken))
{
if (client == null)
{
throw new ArgumentNullException(nameof(client));
}
NetworkDomainQuery query = NetworkDomainQuery.ByDatacenter(datacenterId);
return(client.ListNetworkDomains(query, paging, cancellationToken));
}
/// <summary>
/// Retrieve the first network domain in the specified datacenter with the specified name.
/// </summary>
/// <param name="client">
/// The CloudControl API client.
/// </param>
/// <param name="name">
/// The name of the network domain to retrieve.
/// </param>
/// <param name="datacenterId">
/// The Id of the datacenter containing the network domain to retrieve.
/// </param>
/// <param name="cancellationToken">
/// An optional cancellation token that can be used to cancel the request.
/// </param>
/// <returns>
/// A <see cref="NetworkDomain"/> representing the network domain, or <c>null</c> if no network domain was found with the specified Id.
/// </returns>
public static async Task <NetworkDomain> GetNetworkDomainByName(this CloudControlClient client, string name, string datacenterId, CancellationToken cancellationToken = default(CancellationToken))
{
if (client == null)
{
throw new ArgumentNullException(nameof(client));
}
NetworkDomainQuery query = NetworkDomainQuery.ByNameAndDatacenter(name, datacenterId);
NetworkDomains matchingNetworkDomains = await client.ListNetworkDomains(query, cancellationToken : cancellationToken);
return(matchingNetworkDomains.Items.FirstOrDefault());
}