AWS Cloud Map
amazonaws · Cloud
Cloud Map With Cloud Map, you can configure public DNS, private DNS, or HTTP namespaces that your microservice applications run in. When an instance becomes available, you can call the Cloud Map API to register the instance with Cloud Map. For public or private DNS namespaces, Cloud Map automatically creates DNS records and an optional health check. Clients that submit public or private DNS queries, or HTTP requests, for the service receive an answer that contains up to e
Authentication
Sample Requests
Gets the current health status ( Healthy , Unhealthy , or Unknown ) of one or more instances that are associated with a specified service. There's a brief delay between when you register an instance and when the health status for the instance is av
Hover any highlighted part to learn what it does
| X-Amz-Target | Route53AutoNaming_v20170314.GetInstancesHealthStatus |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.GetInstancesHealthStatus?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: Route53AutoNaming_v20170314.GetInstancesHealthStatus"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "Route53AutoNaming_v20170314.GetInstancesHealthStatus"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.GetInstancesHealthStatus",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.GetInstancesHealthStatus');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'Route53AutoNaming_v20170314.GetInstancesHealthStatus'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.GetInstancesHealthStatus")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "Route53AutoNaming_v20170314.GetInstancesHealthStatus")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.GetInstancesHealthStatus")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "Route53AutoNaming_v20170314.GetInstancesHealthStatus"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.GetInstancesHealthStatus?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: Route53AutoNaming_v20170314.GetInstancesHealthStatus"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Lists summary information about the instances that you registered by using a specified service.
Hover any highlighted part to learn what it does
| X-Amz-Target | Route53AutoNaming_v20170314.ListInstances |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListInstances?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: Route53AutoNaming_v20170314.ListInstances"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "Route53AutoNaming_v20170314.ListInstances"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListInstances",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListInstances');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'Route53AutoNaming_v20170314.ListInstances'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListInstances")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "Route53AutoNaming_v20170314.ListInstances")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListInstances")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "Route53AutoNaming_v20170314.ListInstances"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListInstances?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: Route53AutoNaming_v20170314.ListInstances"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Lists summary information about the namespaces that were created by the current Amazon Web Services account.
Hover any highlighted part to learn what it does
| X-Amz-Target | Route53AutoNaming_v20170314.ListNamespaces |
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListNamespaces?NextToken=example&MaxResults=example" \ -H "X-Amz-Target: Route53AutoNaming_v20170314.ListNamespaces"
import requests
params = {
"NextToken": "example",
"MaxResults": "example"
}
headers = {
"X-Amz-Target": "Route53AutoNaming_v20170314.ListNamespaces"
}
response = requests.post(
"https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListNamespaces",
params=params,
headers=headers,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListNamespaces');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');
const response = await fetch(url, {
method: 'POST',
headers: {
'X-Amz-Target': 'Route53AutoNaming_v20170314.ListNamespaces'
},
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListNamespaces")
q := baseURL.Query()
q.Set("NextToken", "example")
q.Set("MaxResults", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("POST", targetURL, nil)
req.Header.Set("X-Amz-Target", "Route53AutoNaming_v20170314.ListNamespaces")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListNamespaces")
uri.query = URI.encode_www_form({
"NextToken" => "example",
"MaxResults" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "Route53AutoNaming_v20170314.ListNamespaces"
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/servicediscovery/2017-03-14/#X-Amz-Target=Route53AutoNaming_v20170314.ListNamespaces?" . http_build_query([
"NextToken" => "example",
"MaxResults" => "example"
]);
$opts = ["http" => [
"method" => "POST",
"header" => implode("\r\n", [
"X-Amz-Target: Route53AutoNaming_v20170314.ListNamespaces"
]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with AWS Cloud Map?
AWS Cloud Map is a Cloud API. Developers commonly use cloud APIs for:
- provisioning and managing cloud infrastructure
- automating deployments and container orchestration
- monitoring uptime and performance metrics
- managing storage buckets and databases
- setting up auto-scaling and load balancing
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. AWS Cloud Map is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?