AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a public namespace based on DNS, which is visible on the internet. The namespace defines your service naming scheme. For example, if you name your namespace example.com and name your service backend, the resulting DNS name for the service is backend.example.com. You can discover instances that were registered with a public DNS namespace by using either a DiscoverInstances request or using DNS. For the current quota on the number of namespaces that you can create using the same Amazon Web Services account, see Cloud Map quotas in the Cloud Map Developer Guide.

The CreatePublicDnsNamespace API operation is not supported in the Amazon Web Services GovCloud (US) Regions.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreatePublicDnsNamespace and EndCreatePublicDnsNamespace.

Namespace: Amazon.ServiceDiscovery
Assembly: AWSSDK.ServiceDiscovery.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<CreatePublicDnsNamespaceResponse> CreatePublicDnsNamespaceAsync(
         CreatePublicDnsNamespaceRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ServiceDiscovery.Model.CreatePublicDnsNamespaceRequest

Container for the necessary parameters to execute the CreatePublicDnsNamespace service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the CreatePublicDnsNamespace service method, as returned by ServiceDiscovery.

Exceptions

ExceptionCondition
DuplicateRequestException The operation is already in progress.
InvalidInputException One or more specified values aren't valid. For example, a required value might be missing, a numeric value might be outside the allowed range, or a string value might exceed length constraints.
NamespaceAlreadyExistsException The namespace that you're trying to create already exists.
ResourceLimitExceededException The resource can't be created because you've reached the quota on the number of resources.
TooManyTagsException The list of tags on the resource is over the quota. The maximum number of tags that can be applied to a resource is 50.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also