Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1426158150.9 KB

Lists summary information about the instances that you registered by using a specified service.

post/#X-Amz-Target=Route53AutoNaming_v20170314.ListInstances

Query parameters

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'Route53AutoNaming_v20170314.ListInstances' required

Request body

ServiceIdstring required

The ID of the service that you want to list instances for.

NextTokenstring
<p>For the first <code>ListInstances</code> request, omit this value.</p> <p>If more than <code>MaxResults</code> instances match the specified criteria, you can submit another <code>ListInstances</code> request to get the next group of results. Specify the value of <code>NextToken</code> from the previous response in the next request.</p>
MaxResultsinteger

The maximum number of instances that you want Cloud Map to return in the response to a <code>ListInstances</code> request. If you don't specify a value for <code>MaxResults</code>, Cloud Map returns up to 100 instances.

Response

Success

NextTokenstring

If more than <code>MaxResults</code> instances match the specified criteria, you can submit another <code>ListInstances</code> request to get the next group of results. Specify the value of <code>NextToken</code> from the previous response in the next request.

Example response

{
  "Instances": [
    {
      "Attributes": {
        "AWS_INSTANCE_IPV4": "172.2.1.3",
        "AWS_INSTANCE_PORT": "808"
      },
      "Id": "i-06bdabbae60f65a4e"
    }
  ]
}