AmazonServiceDiscoveryClient.CreateService Method (CreateServiceRequest)

Creates a service. This action defines the configuration for the following entities:

For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:
- A
- AAAA
- A and AAAA
- SRV
- CNAME
Optionally, a health check

After you create the service, you can submit a RegisterInstance request, and Cloud Map uses the values in the configuration to create the specified entities.

For the current quota on the number of instances that you can register using the same namespace and using the same service, see Cloud Map quotas in the Cloud Map Developer Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateServiceAsync.

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

Syntax

public virtual CreateServiceResponse CreateService(
         CreateServiceRequest request
)

Parameters

request: Type: Amazon.ServiceDiscovery.Model.CreateServiceRequest

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

Return Value

Type: CreateServiceResponse

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

Exceptions

Exception	Condition
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.
NamespaceNotFoundException	No namespace exists with the specified ID.
ResourceLimitExceededException	The resource can't be created because you've reached the quota on the number of resources.
ServiceAlreadyExistsException	The service can't be created because a service with the same name already exists.
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.

Examples

Example: Create service


var client = new AmazonServiceDiscoveryClient();
var response = client.CreateService(new CreateServiceRequest 
{
    CreatorRequestId = "567c1193-6b00-4308-bd57-ad38a8822d25",
    DnsConfig = new DnsConfig {
        DnsRecords = new List<DnsRecord> {
            new DnsRecord {
                TTL = 60,
                Type = "A"
            }
        },
        NamespaceId = "ns-ylexjili4cdxy3xm",
        RoutingPolicy = "MULTIVALUE"
    },
    Name = "myservice",
    NamespaceId = "ns-ylexjili4cdxy3xm"
});

Service service = response.Service;

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

AmazonServiceDiscoveryClient.CreateService (CreateServiceRequest)

Method