Updating an Amazon Cloud Map service - Amazon Cloud Map
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Updating an Amazon Cloud Map service

Depending on a service's configuration, you can update its tags, Route 53 health check failure threshold, and time to live (TTL) for DNS resolvers. To update a service, perform the following procedure.

Amazon Web Services Management Console

  1. Sign in to the Amazon Web Services Management Console and open the Amazon Cloud Map console at https://console.amazonaws.cn/cloudmap/.

  2. In the navigation pane, choose Namespaces.

  3. On the Namespaces page, choose the namespace in which the service is created.

  4. On the Namespace: namespace-name page, select the service you want to edit and choose View details.

  5. On the Service: service-name page, choose Edit.

    Note

    You can't use the Edit button workflow to edit values for services that allow only API calls for instance discovery. However, you can add or remove tags on the Service: service-name page.

  6. On the Edit service page, under Service description, you can update any previously set description for the service or add a new description. You can also add tags and update TTL for DNS resolvers. I

  7. Under DNS configuration, for TTL, you can specify an updated period of time, in seconds, that determines how long DNS resolvers cache information for this record before the resolvers forward another DNS query to Amazon Route 53 to get updated settings.

  8. If you've set up Route 53 health checks, for Failure threshold, you can specify a new number between 1 and 10 that defines the number of consecutive Route 53 health checks a service instance must pass or fail for its health status to change.

  9. Choose Update service.

Amazon CLI

  • Update a service with the update-service command (replace the red value with your own).

    aws servicediscovery update-service \
    --id  srv-xxxxxxxxxxx \
    --service "Description=new description,DnsConfig={DnsRecords=[{Type=A,TTL=60}]}"

    Output:

    {
    "OperationId": "l3pfx7f4ynndrbj3cfq5fm2qy2z37bms-5m6iaoty"
}
Amazon SDK for Python (Boto3)

  1. If you don't already have Boto3 installed, you can find instructions for installing, configuring, and using Boto3 here.

  2. Import Boto3 and use servicediscovery as your service.

    import boto3
client = boto3.client('servicediscovery')

  3. Update a service with update_service() (replace the red value with your own).

    response = client.update_service(
    Id='srv-xxxxxxxxxxx',
    Service={
        'DnsConfig': {
            'DnsRecords': [
                {
                    'TTL': 300,
                    'Type': 'A',
                },
            ],
        },
        'Description': "new description",
    }
)

    Example response output

    {
    "OperationId": "l3pfx7f4ynndrbj3cfq5fm2qy2z37bms-5m6iaoty"
}