Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1426158150.9 KB

Lists summary information for all the services that are associated with one or more specified namespaces.

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

Query parameters

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'Route53AutoNaming_v20170314.ListServices' required

Request body

NextTokenstring
<p>For the first <code>ListServices</code> request, omit this value.</p> <p>If the response contains <code>NextToken</code>, submit another <code>ListServices</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> <note> <p>Cloud Map gets <code>MaxResults</code> services and then filters them based on the specified criteria. It's possible that no services in the first <code>MaxResults</code> services matched the specified criteria but that subsequent groups of <code>MaxResults</code> services do contain services that match the criteria.</p> </note>
MaxResultsinteger

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

Response

Success

NextTokenstring
<p>If the response contains <code>NextToken</code>, submit another <code>ListServices</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> <note> <p>Cloud Map gets <code>MaxResults</code> services and then filters them based on the specified criteria. It's possible that no services in the first <code>MaxResults</code> services matched the specified criteria but that subsequent groups of <code>MaxResults</code> services do contain services that match the criteria.</p> </note>

Example response

{
  "Services": [
    {
      "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
      "CreateDate": 1587081768.334,
      "DnsConfig": {
        "DnsRecords": [
          {
            "TTL": 60,
            "Type": "A"
          }
        ],
        "RoutingPolicy": "MULTIVALUE"
      },
      "Id": "srv-p5zdwlg5uvvzjita",
      "Name": "myservice"
    }
  ]
}