IAmazonServiceDiscovery.UpdateService Method (UpdateServiceRequest)

Submits a request to perform the following operations:

Update the TTL setting for existing DnsRecords configurations
Add, update, or delete HealthCheckConfig for a specified service
You can't add, update, or delete a HealthCheckCustomConfig configuration.

For public and private DNS namespaces, note the following:

If you omit any existing DnsRecords or HealthCheckConfig configurations from an UpdateService request, the configurations are deleted from the service.
If you omit an existing HealthCheckCustomConfig configuration from an UpdateService request, the configuration isn't deleted from the service.

When you update settings for a service, Cloud Map also updates the corresponding settings in all the records and health checks that were created by using the specified service.

Note:

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

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

Syntax

public abstract UpdateServiceResponse UpdateService(
         UpdateServiceRequest request
)

Parameters

request: Type: Amazon.ServiceDiscovery.Model.UpdateServiceRequest

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

Return Value

Type: UpdateServiceResponse

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

Exceptions

Exception	Condition
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.
ServiceNotFoundException	No service exists with the specified ID.

Examples

This example submits a request to replace the DnsConfig and HealthCheckConfig settings of a specified service.

UpdateService Example


var client = new AmazonServiceDiscoveryClient();
var response = client.UpdateService(new UpdateServiceRequest 
{
    Id = "srv-e4anhexample0004",
    Service = new ServiceChange {
        DnsConfig = new DnsConfigChange { DnsRecords = new List<DnsRecord> {
            new DnsRecord {
                TTL = 60,
                Type = "A"
            }
        } },
        HealthCheckConfig = new HealthCheckConfig {
            FailureThreshold = 2,
            ResourcePath = "/",
            Type = "HTTP"
        }
    }
});

string operationId = response.OperationId;

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

IAmazonServiceDiscovery.UpdateService (UpdateServiceRequest)

Method