Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS Cloud Map exemplos usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with AWS Cloud Map.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-http-namespace`
O código de exemplo a seguir mostra como usar `create-http-namespace`.
**AWS CLI**
**Como criar um namespace HTTP**
O exemplo de `create-http-namespace` a seguir cria um namespace HTTP chamado `example.com`.
```
aws servicediscovery create-http-namespace \
--name example.com \
--creator-request-id example-request-id
```
Saída:
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`. Para ter mais informações, consulte [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Para obter mais informações sobre a criação de um namespace, consulte [Como criar um namespace do AWS Cloud Map para agrupar serviços de aplicativos](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) no *AWS Cloud* Map Developer Guide.
+ Para obter detalhes da API, consulte [CreateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-http-namespace.html)em *Referência de AWS CLI Comandos*.
### `create-private-dns-namespace`
O código de exemplo a seguir mostra como usar `create-private-dns-namespace`.
**AWS CLI**
**Para criar um namespace de DNS privado**
O exemplo `create-private-dns-namespace` a seguir cria um namespace DNS privado.
```
aws servicediscovery create-private-dns-namespace \
--name example.com \
--vpc vpc-1c56417b
```
Saída:
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`. Para obter mais informações, consulte [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Para obter mais informações, consulte [Criar namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
+ Para obter detalhes da API, consulte [CreatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-private-dns-namespace.html)em *Referência de AWS CLI Comandos*.
### `create-public-dns-namespace`
O código de exemplo a seguir mostra como usar `create-public-dns-namespace`.
**AWS CLI**
**Como criar um namespace de DNS público**
O exemplo de `create-public-dns-namespace` a seguir cria um namespace de DNS público chamado `example.com`.
```
aws servicediscovery create-public-dns-namespace \
--name example-public-dns.com \
--creator-request-id example-public-request-id \
--properties DnsProperties={SOA={TTL=60}}
```
Saída:
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`.
Para obter mais informações sobre a criação de um namespace, consulte [Como criar um namespace do AWS Cloud Map para agrupar serviços de aplicativos](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) no *AWS Cloud* Map Developer Guide.
+ Para obter detalhes da API, consulte [CreatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-public-dns-namespace.html)em *Referência de AWS CLI Comandos*.
### `create-service`
O código de exemplo a seguir mostra como usar `create-service`.
**AWS CLI**
**Exemplo 1: criar um serviço usando o ID do namespace**
O exemplo `create-service` a seguir cria um serviço.
```
aws servicediscovery create-service \
--name myservice \
--namespace-id ns-ylexjili4cdxy3xm \
--dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"
```
Saída:
```
{
"Service": {
"Id": "srv-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Name": "myservice",
"NamespaceId": "ns-abcd1234xmpl5678",
"DnsConfig": {
"NamespaceId": "ns-abcd1234xmpl5678",
"RoutingPolicy": "MULTIVALUE",
"DnsRecords": [
{
"Type": "A",
"TTL": 60
}
]
},
"Type": "DNS_HTTP",
"CreateDate": "2025-08-18T13:45:31.023000-05:00",
"CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
"CreatedByAccount": "123456789012"
}
}
```
Para obter mais informações, consulte [Criação de um serviço do AWS Cloud Map para um componente do aplicativo](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html) no *AWS Cloud Map Developer Guide*.
**Exemplo 2: criar um serviço usando o ARN do namespace**
O exemplo de `create-service` a seguir cria um serviço usando um ARN de namespace em vez de um ID de namespace. É necessário especificar um ARN de namespace ao criar um serviço em um namespace compartilhado.
```
aws servicediscovery create-service \
--name myservice-arn \
--namespace-id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
--dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"
```
Saída:
```
{
"Service": {
"Id": "srv-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Name": "myservice-arn",
"NamespaceId": "ns-abcd1234xmpl5678",
"DnsConfig": {
"NamespaceId": "ns-abcd1234xmpl5678",
"RoutingPolicy": "MULTIVALUE",
"DnsRecords": [
{
"Type": "A",
"TTL": 60
}
]
},
"Type": "DNS_HTTP",
"CreateDate": "2025-08-18T13:45:31.023000-05:00",
"CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
"CreatedByAccount": "123456789012"
}
}
```
Para obter mais informações, consulte os [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-service.html)em *Referência de AWS CLI Comandos*.
### `delete-namespace`
O código de exemplo a seguir mostra como usar `delete-namespace`.
**AWS CLI**
**Exemplo 1: excluir um namespace**
O exemplo `delete-namespace` a seguir exclui um namespace.
```
aws servicediscovery delete-namespace \
--id ns-abcd1234xmpl5678
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`. Para ter mais informações, consulte [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Para obter mais informações, consulte [Excluindo um namespace do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) no Cloud Map Developer *AWS Guide*.
**Exemplo 2: excluir um namespace usando o ARN do namespace**
O exemplo de `delete-namespace` a seguir exclui um namespace usando o respectivo ARN.
```
aws servicediscovery delete-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para obter mais informações, consulte [Excluindo um namespace do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) no Cloud Map Developer *AWS Guide*.
+ Para obter detalhes da API, consulte [DeleteNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-namespace.html)em *Referência de AWS CLI Comandos*.
### `delete-service-attributes`
O código de exemplo a seguir mostra como usar `delete-service-attributes`.
**AWS CLI**
**Exemplo 1: excluir um atributo de serviço**
O exemplo de `delete-service-attributes` a seguir exclui um atributo de serviço com a chave `Port` associada ao serviço especificado.
```
aws servicediscovery delete-service-attributes \
--service-id srv-abcd1234xmpl5678 \
--attributes Port
```
Este comando não produz saída.
Para obter mais informações, consulte [AWS Cloud Map services](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: excluir um atributo de serviço usando o ARN**
O exemplo de `delete-service-attributes` a seguir exclui um atributo de serviço usando o ARN do serviço. A especificação do ARN é necessária para excluir atributos associados aos serviços criados em namespaces compartilhados com sua conta.
```
aws servicediscovery delete-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
--attributes Port
```
Este comando não produz saída.
Para obter mais informações, consulte [Serviços do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) e [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [DeleteServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service-attributes.html)em *Referência de AWS CLI Comandos*.
### `delete-service`
O código de exemplo a seguir mostra como usar `delete-service`.
**AWS CLI**
**Exemplo 1: excluir um serviço**
O exemplo `delete-service` a seguir exclui um serviço.
```
aws servicediscovery delete-service \
--id srv-abcd1234xmpl5678
```
Este comando não produz saída.
Para obter mais informações, consulte [Excluindo um serviço do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) no *AWS Cloud Map Developer Guide*.
**Exemplo 2: excluir um serviço usando o ARN**
O exemplo de `delete-service` a seguir exclui um serviço usando o respectivo ARN.
```
aws servicediscovery delete-service \
--id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
Este comando não produz saída.
Para obter mais informações, consulte [Excluindo um serviço do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service.html)em *Referência de AWS CLI Comandos*.
### `deregister-instance`
O código de exemplo a seguir mostra como usar `deregister-instance`.
**AWS CLI**
**Exemplo 1: cancelar o registro de uma instância de serviço**
O exemplo `deregister-instance` a seguir cancela o registro de uma instância de serviço.
```
aws servicediscovery deregister-instance \
--service-id srv-p5zdwlg5uvvzjita \
--instance-id myservice-53
```
Saída:
```
{
"OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`. Para ter mais informações, consulte [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Para obter mais informações, consulte [Cancelar o registro de instâncias de serviço](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: cancelar o registro de uma instância de serviço usando o ARN do serviço para namespaces compartilhados**
O exemplo de `deregister-instance` a seguir cancela o registro de uma instância de serviço usando um ARN de serviço em vez de um ID de serviço. É necessário especificar um ARN ao cancelar o registro de instâncias de serviço criadas em namespaces compartilhados com sua conta.
```
aws servicediscovery deregister-instance \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01
```
Saída:
```
{
"OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}
```
*Para obter mais informações, consulte [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) e [Cancelamento do registro de uma instância do serviço Cloud AWS Map no Cloud Map Developer](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) Guide AWS .*
+ Para obter detalhes da API, consulte [DeregisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/deregister-instance.html)em *Referência de AWS CLI Comandos*.
### `discover-instances-revision`
O código de exemplo a seguir mostra como usar `discover-instances-revision`.
**AWS CLI**
**Exemplo 1: descobrir a análise de uma instância**
O exemplo de `discover-instances-revision` a seguir descobre a revisão crescente de uma instância.
```
aws servicediscovery discover-instances-revision \
--namespace-name example.com \
--service-name myservice
```
Saída:
```
{
"InstancesRevision": 123456
}
```
Para obter mais informações, consulte [AWS Cloud Map service instances](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: descobrir a análise de instâncias de uma conta de proprietário específica**
O exemplo de `discover-instances-revision` a seguir mostra a análise de instâncias de uma conta de proprietário específica. O parâmetro owner-account é necessário para instâncias em namespaces compartilhados com sua conta.
```
aws servicediscovery discover-instances-revision \
--namespace-name shared-namespace \
--service-name shared-service \
--owner-account 123456789111
```
Saída:
```
{
"InstancesRevision": 1234567890
}
```
Para obter mais informações, consulte os [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) e as [instâncias do serviço AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [DiscoverInstancesRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances-revision.html)em *Referência de AWS CLI Comandos*.
### `discover-instances`
O código de exemplo a seguir mostra como usar `discover-instances`.
**AWS CLI**
**Exemplo 1: descobrir instâncias registradas**
O exemplo `discover-instances` a seguir descobre instâncias registradas.
```
aws servicediscovery discover-instances \
--namespace-name example.com \
--service-name myservice \
--max-results 10 \
--health-status ALL
```
Saída:
```
{
"Instances": [
{
"InstanceId": "myservice-53",
"NamespaceName": "example.com",
"ServiceName": "myservice",
"HealthStatus": "UNKNOWN",
"Attributes": {
"AWS_INSTANCE_IPV4": "172.2.1.3",
"AWS_INSTANCE_PORT": "808"
}
}
],
"InstancesRevision": 85648075627387284
}
```
Para obter mais informações, consulte [AWS Cloud Map service instances](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: descobrir instâncias de uma conta de proprietário específica**
O exemplo de `discover-instances` a seguir descobre instâncias registradas de uma conta de proprietário específica. Esse parâmetro é necessário para descobrir instâncias em namespaces são compartilhados com sua conta.
```
aws servicediscovery discover-instances \
--namespace-name shared-namespace \
--service-name shared-service \
--owner-account 123456789111
```
Saída:
```
{
"Instances": [
{
"InstanceId": "shared-instance-1234",
"NamespaceName": "shared-namespace",
"ServiceName": "shared-service",
"HealthStatus": "HEALTHY",
"Attributes": {
"AWS_INSTANCE_IPV4": "203.0.113.75",
"AWS_INSTANCE_PORT": "80"
}
}
],
"InstancesRevision": 1234567890
}
```
Para obter mais informações, consulte os [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) e as [instâncias do serviço AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [DiscoverInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances.html)em *Referência de AWS CLI Comandos*.
### `get-instance`
O código de exemplo a seguir mostra como usar `get-instance`.
**AWS CLI**
**Exemplo 1: obter detalhes de uma instância**
O exemplo de `get-instance` a seguir obtém os atributos de um serviço.
```
aws servicediscovery get-instance \
--service-id srv-e4anhexample0004
--instance-id i-abcd1234
```
Saída:
```
{
"ResourceOwner": "123456789012",
"Instance": {
"Id": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
"Attributes": {
"AWS_INSTANCE_IPV4": "192.0.2.44",
"AWS_INSTANCE_PORT": "80",
"color": "green",
"region": "us-west-2",
"stage": "beta"
},
"CreatedByAccount": "123456789012"
}
}
```
Para obter mais informações, consulte [AWS Cloud Map service instances](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: obter detalhes de uma instância usando o ARN do serviço para namespaces compartilhados**
O exemplo de `get-instance` a seguir obtém os atributos de uma instância usando um ARN de serviço em vez de um ID de serviço. É necessário especificar um ARN ao obter detalhes de instâncias associadas a namespaces compartilhados com sua conta. A instância exibida neste exemplo foi registrada pela conta `123456789111` em um namespace de propriedade da conta `123456789012`.
```
aws servicediscovery get-instance \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01
```
Saída:
```
{
"ResourceOwner": "123456789012",
"Instance": {
"Id": "web-server-01",
"Attributes": {
"AWS_INSTANCE_IPV4": "203.0.113.15",
"AWS_INSTANCE_PORT": "80"
},
"CreatedByAccount": "123456789111"
}
}
```
*Para obter mais informações sobre o compartilhamento de namespaces entre contas, consulte os [namespaces do Shared AWS Cloud Map no Cloud Map Developer](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) Guide.AWS *
+ Para obter detalhes da API, consulte [GetInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instance.html)em *Referência de AWS CLI Comandos*.
### `get-instances-health-status`
O código de exemplo a seguir mostra como usar `get-instances-health-status`.
**AWS CLI**
**Exemplo 1: obter o status de integridade das instâncias associadas a um serviço**
O exemplo de `get-instances-health-status` a seguir obtém o status de integridade das instâncias associadas ao serviço especificado.
```
aws servicediscovery get-instances-health-status \
--service-id srv-e4anhexample0004
```
Saída:
```
{
"Status": {
"i-abcd1234": "HEALTHY",
"i-abcd1235": "UNHEALTHY"
}
}
```
Para obter mais informações, consulte [AWS Cloud Map service instances](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: obter o status de integridade das instâncias usando o ARN do serviço para namespaces compartilhados**
O exemplo de `get-instances-health-status` a seguir obtém o status de integridade das instâncias usando um ARN de serviço em vez de um ID de serviço. É necessário especificar um ARN ao obter o status de integridade das instâncias associadas a namespaces compartilhados com a conta do solicitante.
```
aws servicediscovery get-instances-health-status \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
```
Saída:
```
{
"Status": {
"web-server-01": "HEALTHY",
"web-server-02": "UNHEALTHY"
}
}
```
Para obter mais informações, consulte [Instâncias do serviço AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) e [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [GetInstancesHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instances-health-status.html)em *Referência de AWS CLI Comandos*.
### `get-namespace`
O código de exemplo a seguir mostra como usar `get-namespace`.
**AWS CLI**
**Exemplo 1: obter os detalhes de um namespace**
O exemplo de `get-namespace` a seguir recupera informações sobre o namespace especificado.
```
aws servicediscovery get-namespace \
--id ns-abcd1234xmpl5678
```
Saída:
```
{
"Namespace": {
"Id": "ns-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Name": "example-http.com",
"Type": "HTTP",
"Description": "Example.com AWS Cloud Map HTTP Namespace",
"Properties": {
"DnsProperties": {},
"HttpProperties": {
"HttpName": "example-http.com"
}
},
"CreateDate": "2024-02-23T13:35:21.874000-06:00",
"CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
}
```
Para obter mais informações, consulte [AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: obter os detalhes de um namespace usando o ARN**
O exemplo de `get-namespace` a seguir recupera informações sobre o namespace especificado usando o respectivo ARN. A especificação do ARN é necessária para recuperar detalhes de um namespace compartilhado com sua conta.
```
aws servicediscovery get-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
```
Saída:
```
{
"Namespace": {
"Id": "ns-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Name": "example-http.com",
"Type": "HTTP",
"Description": "Example.com AWS Cloud Map HTTP Namespace",
"Properties": {
"DnsProperties": {},
"HttpProperties": {
"HttpName": "example-http.com"
}
},
"CreateDate": "2024-02-23T13:35:21.874000-06:00",
"CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
}
```
Para obter mais informações, consulte os [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [GetNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-namespace.html)em *Referência de AWS CLI Comandos*.
### `get-operation`
O código de exemplo a seguir mostra como usar `get-operation`.
**AWS CLI**
**Exemplo 1: obter o resultado de uma operação**
O exemplo de `get-operation` a seguir obtém o resultado da operação de criação de um namespace.
```
aws servicediscovery get-operation \
--operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234
```
Saída:
```
{
"Operation": {
"Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
"Type": "CREATE_NAMESPACE",
"Status": "SUCCESS",
"CreateDate": "2025-01-13T13:35:21.874000-06:00",
"UpdateDate": "2025-01-13T13:36:02.469000-06:00",
"Targets": {
"NAMESPACE": "ns-abcd1234xmpl5678"
}
}
}
```
Para obter mais informações, consulte [Como criar um namespace do AWS Cloud Map para agrupar serviços de aplicativos](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) no *AWS Cloud Map Developer Guide*.
**Exemplo 2: obter uma operação de uma conta de proprietário específica**
O exemplo de `get-operation` a seguir obtém o resultado de uma operação associada a uma conta de proprietário de namespace específica. Esse parâmetro é necessário para obter o resultado das operações associadas aos namespaces compartilhados com sua conta.
```
aws servicediscovery get-operation \
--operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \
--owner-account 123456789111
```
Saída:
```
{
"Operation": {
"Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
"OwnerAccount": "123456789111",
"Type": "CREATE_NAMESPACE",
"Status": "SUCCESS",
"CreateDate": "2025-01-13T13:35:21.874000-06:00",
"UpdateDate": "2025-01-13T13:36:02.469000-06:00",
"Targets": {
"NAMESPACE": "ns-abcd1234xmpl5678"
}
}
}
```
Para obter mais informações, consulte os [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [GetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-operation.html)em *Referência de AWS CLI Comandos*.
### `get-service-attributes`
O código de exemplo a seguir mostra como usar `get-service-attributes`.
**AWS CLI**
**Exemplo 1: obter os atributos de um serviço**
O exemplo de `get-service-attributes` a seguir obtém os atributos de um serviço.
```
aws servicediscovery get-service-attributes \
--service-id srv-abcd1234xmpl5678
```
Saída:
```
{
"ServiceAttributes": {
"ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Attributes": {
"Port": "80"
}
}
}
```
Para obter mais informações, consulte [AWS Cloud Map services](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: obter os atributos de um serviço usando o ARN**
O exemplo de `get-service-attributes` a seguir obtém os atributos de um serviço usando o respectivo ARN. A especificação do ARN é necessária para obter os atributos de um serviço criado em um namespace compartilhado com sua conta.
```
aws servicediscovery get-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
Saída:
```
{
"ServiceAttributes": {
"ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Attributes": {
"Port": "80"
}
}
}
```
Para obter mais informações, consulte [Serviços do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) e [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [GetServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service-attributes.html)em *Referência de AWS CLI Comandos*.
### `get-service`
O código de exemplo a seguir mostra como usar `get-service`.
**AWS CLI**
**Exemplo 1: obter as configurações de um serviço**
O exemplo de `get-service` a seguir obtém as configurações de um serviço especificado.
```
aws servicediscovery get-service \
--id srv-abcd1234xmpl5678
```
Saída:
```
{
"Service": {
"Id": "srv-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Name": "test-service",
"NamespaceId": "ns-abcd1234xmpl5678",
"DnsConfig": {},
"Type": "HTTP",
"CreateDate": "2025-08-18T13:53:02.775000-05:00",
"CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
"CreatedByAccount": "123456789012"
}
}
```
Para obter mais informações, consulte [AWS Cloud Map services](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: obter as configurações de um serviço usando o ARN**
O exemplo de `get-service` a seguir obtém as configurações de um serviço especificado usando o respectivo ARN. É necessário especificar o ARN ao recuperar informações sobre um serviço criado em um namespace compartilhado com sua conta. A conta do chamador `123456789111` criou o serviço em um namespace compartilhado pela conta `123456789012`.
```
aws servicediscovery get-service \
--id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
Saída:
```
{
"Service": {
"Id": "srv-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Name": "test-service",
"NamespaceId": "ns-abcd1234xmpl5678",
"DnsConfig": {},
"Type": "HTTP",
"CreateDate": "2025-08-18T13:53:02.775000-05:00",
"CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
"CreatedByAccount": "123456789111"
}
}
```
Para obter mais informações, consulte [Criação de um serviço AWS Cloud Map para um componente de aplicativo](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html) e [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service.html)em *Referência de AWS CLI Comandos*.
### `list-instances`
O código de exemplo a seguir mostra como usar `list-instances`.
**AWS CLI**
**Exemplo 1: listar instâncias de serviço**
O exemplo `list-instances` a seguir lista as instâncias do serviço.
```
aws servicediscovery list-instances \
--service-id srv-qzpwvt2tfqcegapy
```
Saída:
```
{
"Instances": [
{
"Id": "i-06bdabbae60f65a4e",
"Attributes": {
"AWS_INSTANCE_IPV4": "172.2.1.3",
"AWS_INSTANCE_PORT": "808"
},
"CreatedByAccount": "123456789012"
}
],
"ResourceOwner": "123456789012"
}
```
Para obter mais informações, consulte [Listar instâncias do serviço AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) no *AWS Cloud Map Developer Guide*.
**Exemplo 2: listar instâncias de serviço usando o ARN de serviço**
O exemplo de `list-instances` a seguir lista as instâncias de serviço usando um ARN de serviço em vez de um ID de serviço. É necessário especificar um ARN ao listar instâncias associadas a namespaces compartilhados com sua conta.
```
aws servicediscovery list-instances \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
```
Saída:
```
{
"ResourceOwner": "123456789012",
"Instances": [
{
"Id": "web-server-01",
"Attributes": {
"AWS_INSTANCE_IPV4": "203.0.113.15",
"AWS_INSTANCE_PORT": "80"
},
"CreatedByAccount": "123456789012"
},
{
"Id": "web-server-02",
"Attributes": {
"AWS_INSTANCE_IPV4": "203.0.113.16",
"AWS_INSTANCE_PORT": "80"
},
"CreatedByAccount": "123456789012"
}
]
}
```
*Para obter mais informações sobre o compartilhamento de namespaces entre contas, consulte Namespaces do [Shared AWS Cloud Map e Listar instâncias](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) do [serviço Cloud Map no AWS Cloud Map Developer](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) Guide.AWS *
+ Para obter detalhes da API, consulte [ListInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-instances.html)em *Referência de AWS CLI Comandos*.
### `list-namespaces`
O código de exemplo a seguir mostra como usar `list-namespaces`.
**AWS CLI**
**Exemplo 1: listar namespaces**
O exemplo `list-namespaces` a seguir lista os namespaces.
```
aws servicediscovery list-namespaces
```
Saída:
```
{
"Namespaces": [
{
"Id": "ns-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Name": "local",
"Type": "DNS_PRIVATE",
"Properties": {
"DnsProperties": {
"HostedZoneId": "Z06752353VBUDTC32S84S",
"SOA": {}
},
"HttpProperties": {
"HttpName": "local"
}
},
"CreateDate": "2023-07-17T13:37:27.872000-05:00"
},
{
"Id": "ns-abcd1234xmpl9012",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl9012",
"ResourceOwner": "123456789012",
"Name": "My-second-namespace",
"Type": "HTTP",
"Description": "My second namespace",
"Properties": {
"DnsProperties": {
"SOA": {}
},
"HttpProperties": {
"HttpName": "My-second-namespace"
}
},
"CreateDate": "2023-11-14T10:35:47.840000-06:00"
}
]
}
```
Para obter mais informações, consulte [Listar namespaces do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-namespaces.html) no *AWS Cloud Map Developer Guide*.
**Exemplo 2: listar namespaces compartilhados por outras contas**
O `list-namespaces` exemplo a seguir lista os namespaces que são compartilhados com a conta do chamador por outras AWS contas usando o filtro. `RESOURCE_OWNER`
```
aws servicediscovery list-namespaces \
--filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
```
Saída:
```
{
"Namespaces": [
{
"Id": "ns-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789111:namespace/ns-abcd1234xmpl5678",
"ResourceOwner": "123456789111",
"Name": "shared-namespace",
"Type": "HTTP",
"Description": "Namespace shared from another account",
"Properties": {
"DnsProperties": {
"SOA": {}
},
"HttpProperties": {
"HttpName": "shared-namespace"
}
},
"CreateDate": "2025-01-13T13:35:21.874000-06:00"
}
]
}
```
Para obter mais informações, consulte os [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [ListNamespaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-namespaces.html)em *Referência de AWS CLI Comandos*.
### `list-operations`
O código de exemplo a seguir mostra como usar `list-operations`.
**AWS CLI**
**Como listar operações que atendem aos critérios especificados**
O exemplo de `list-operations` a seguir lista as operações que têm um status `PENDING` ou `SUCCESS`.
```
aws servicediscovery list-operations \
--service-id srv-e4anhexample0004 \
--filters Name=STATUS,Condition=IN,Values=PENDING,SUCCESS
```
Saída:
```
{
"Operations": [
{
"Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample",
"Status": "SUCCESS"
},
{
"Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample",
"Status": "SUCCESS"
},
{
"Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example",
"Status": "PENDING"
}
]
}
```
Para obter mais informações, consulte [O que é o AWS Cloud Map?](https://docs.aws.amazon.com/cloud-map/latest/dg/what-is-cloud-map.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-operations.html)em *Referência de AWS CLI Comandos*.
### `list-services`
O código de exemplo a seguir mostra como usar `list-services`.
**AWS CLI**
**Exemplo 1: listar serviços**
O exemplo `list-services` a seguir lista os serviços.
```
aws servicediscovery list-services
```
Saída:
```
{
"Services": [
{
"Id": "srv-p5zdwlg5uvvzjita",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
"Name": "myservice",
"DnsConfig": {
"RoutingPolicy": "MULTIVALUE",
"DnsRecords": [
{
"Type": "A",
"TTL": 60
}
]
},
"CreateDate": 1587081768.334
}
]
}
```
Para obter mais informações, consulte [Listar os serviços do AWS Cloud Map em um namespace](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) no *AWS Cloud Map Developer Guide*.
**Exemplo 2: listar serviços criados em namespaces compartilhados**
O `list-services` exemplo a seguir lista os serviços criados em namespaces compartilhados com a conta do chamador `123456789012` por outras AWS contas usando o filtro. `RESOURCE_OWNER`
```
aws servicediscovery list-services \
--filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
```
Saída:
```
{
"Services": [
{
"Id": "srv-abcd1234xmpl5678",
"Arn": "arn:aws:servicediscovery:us-west-2:123456789111:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789111",
"Name": "shared-service",
"NamespaceId": "ns-abcd1234xmpl5678",
"Type": "HTTP",
"Description": "Service in shared namespace",
"DnsConfig": {},
"CreateDate": "2025-01-13T13:35:21.874000-06:00",
"CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
"CreatedByAccount": "123456789012"
}
]
}
```
Para obter mais informações, consulte os [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) e [Listar os serviços do AWS Cloud Map em um namespace](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) no *AWS Cloud* Map Developer Guide.
+ Para obter detalhes da API, consulte [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-services.html)em *Referência de AWS CLI Comandos*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Como listar tags associadas a um recurso especificado**
O exemplo de `list-tags-for-resource` a seguir lista tags para o recurso especificado.
```
aws servicediscovery list-tags-for-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004
```
Saída:
```
{
"Tags": [
{
"Key": "Project",
"Value": "Zeta"
},
{
"Key": "Department",
"Value": "Engineering"
}
]
}
```
Para obter mais informações, consulte Como [marcar seus recursos do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*.
### `register-instance`
O código de exemplo a seguir mostra como usar `register-instance`.
**AWS CLI**
**Exemplo 1: registrar uma instância de serviço usando o ID de serviço**
O exemplo `register-instance` a seguir registra uma instância de serviço.
```
aws servicediscovery register-instance \
--service-id srv-p5zdwlg5uvvzjita \
--instance-id myservice-53 \
--attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808
```
Saída:
```
{
"OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`. Para ter mais informações, consulte [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Para obter mais informações sobre como registrar uma instância, consulte [Registrar um recurso como uma instância do serviço AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/registering-instances.html) no Cloud *Map Developer AWS Guide*.
**Exemplo 2: registrar uma instância de serviço usando o ARN de serviço**
O exemplo de `register-instance` a seguir registra uma instância de serviço usando um ARN de serviço. É necessário especificar o ARN ao registrar instâncias em serviços compartilhados com sua conta.
```
aws servicediscovery register-instance \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01 \
--attributes=AWS_INSTANCE_IPV4=203.0.113.15,AWS_INSTANCE_PORT=80
```
Saída:
```
{
"OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}
```
*Para obter mais informações sobre o compartilhamento de namespaces entre contas, consulte os [namespaces do Shared AWS Cloud Map no Cloud Map Developer](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) Guide.AWS *
+ Para obter detalhes da API, consulte [RegisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/register-instance.html)em *Referência de AWS CLI Comandos*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como associar tags ao recurso especificado**
O exemplo de `tag-resource` a seguir associa uma tag `Department` com o valor `Engineering` ao namespace especificado.
```
aws servicediscovery tag-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
--tags Key=Department, Value=Engineering
```
Este comando não produz saída.
Para obter mais informações, consulte Como [marcar seus recursos do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/tag-resource.html)em *Referência de AWS CLI Comandos*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Como remover tags do recurso especificado**
O exemplo de `untag-resource` a seguir remove uma tag `Department` do namespace especificado.
```
aws servicediscovery untag-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
--tags Key=Department, Value=Engineering
```
Este comando não produz saída.
Para obter mais informações, consulte Como [marcar seus recursos do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/untag-resource.html)em *Referência de AWS CLI Comandos*.
### `update-http-namespace`
O código de exemplo a seguir mostra como usar `update-http-namespace`.
**AWS CLI**
**Exemplo 1: atualizar um namespace HTTP**
O exemplo de `update-http-namespace` a seguir atualiza a descrição do namespace HTTP especificado.
```
aws servicediscovery update-http-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`. Para ter mais informações, consulte [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Para obter mais informações, consulte [AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: atualizar um namespace HTTP usando o ARN**
O exemplo de `update-http-namespace` a seguir atualiza o namespace HTTP especificado usando o respectivo ARN.
```
aws servicediscovery update-http-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para obter mais informações, consulte [AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
+ Para obter detalhes da API, consulte [UpdateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-http-namespace.html)em *Referência de AWS CLI Comandos*.
### `update-instance-custom-health-status`
O código de exemplo a seguir mostra como usar `update-instance-custom-health-status`.
**AWS CLI**
**Exemplo 1: atualizar uma verificação de integridade personalizada**
O exemplo de `update-instance-custom-health-status` a seguir atualiza o status da verificação de integridade personalizada do serviço especificado e da instância de serviço de exemplo para `HEALTHY`.
```
aws servicediscovery update-instance-custom-health-status \
--service-id srv-e4anhexample0004 \
--instance-id example \
--status HEALTHY
```
Este comando não produz saída.
Para obter mais informações, consulte [AWS Cloud Map service health check configuration](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: atualizar uma verificação de integridade personalizada usando um ARN de serviço**
O exemplo de `update-instance-custom-health-status` a seguir atualiza o status da verificação de integridade personalizada usando um ARN de serviço. O ARN é necessário ao atualizar o status de integridade de instâncias associadas a namespaces compartilhados com sua conta.
```
aws servicediscovery update-instance-custom-health-status \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01 \
--status HEALTHY
```
Este comando não produz saída.
Para obter mais informações, consulte a [configuração da verificação de integridade do serviço AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) e o [compartilhamento de namespace entre contas do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [UpdateInstanceCustomHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-instance-custom-health-status.html)em *Referência de AWS CLI Comandos*.
### `update-private-dns-namespace`
O código de exemplo a seguir mostra como usar `update-private-dns-namespace`.
**AWS CLI**
**Exemplo 1: atualizar um namespace de DNS privado usando o ID**
O exemplo de `update-private-dns-namespace` a seguir atualiza a descrição de um namespace de DNS privado usando o ID de namespace.
```
aws servicediscovery update-private-dns-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`.
Para obter mais informações, consulte [AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: atualizar um namespace de DNS privado usando o ARN**
O exemplo de `update-private-dns-namespace` a seguir atualiza um namespace de DNS privado usando o respectivo ARN.
```
aws servicediscovery update-private-dns-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para obter mais informações, consulte [AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
+ Para obter detalhes da API, consulte [UpdatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-private-dns-namespace.html)em *Referência de AWS CLI Comandos*.
### `update-public-dns-namespace`
O código de exemplo a seguir mostra como usar `update-public-dns-namespace`.
**AWS CLI**
**Exemplo 1: atualizar um namespace de DNS público usando o ID**
O exemplo de `update-public-dns-namespace` a seguir atualiza a descrição de um namespace de DNS público usando o respectivo ID.
```
aws servicediscovery update-public-dns-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`.
Para obter mais informações, consulte [AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: atualizar um namespace de DNS público usando o ARN**
O exemplo de `update-public-dns-namespace` a seguir atualiza um namespace de DNS público usando o respectivo ARN.
```
aws servicediscovery update-public-dns-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para obter mais informações, consulte [AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) no *Guia do desenvolvedor do AWS Cloud Map*.
+ Para obter detalhes da API, consulte [UpdatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-public-dns-namespace.html)em *Referência de AWS CLI Comandos*.
### `update-service-attributes`
O código de exemplo a seguir mostra como usar `update-service-attributes`.
**AWS CLI**
**Exemplo 1: atualizar um serviço para adicionar um atributo**
O exemplo de `update-service-attributes` a seguir atualiza o serviço especificado para adicionar um atributo de serviço com uma chave `Port` e um valor `80`.
```
aws servicediscovery update-service-attributes \
--service-id srv-abcd1234xmpl5678 \
--attributes Port=80
```
Este comando não produz saída.
Para obter mais informações, consulte [AWS Cloud Map services](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) no *Guia do desenvolvedor do AWS Cloud Map*.
**Exemplo 2: atualizar atributos de um serviço usando o ARN**
O exemplo de `update-service-attributes` a seguir atualiza um serviço usando o respectivo ARN para adicionar um atributo de serviço. É necessário especificar o ARN para adicionar atributos aos serviços criados em namespaces compartilhados com sua conta.
```
aws servicediscovery update-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
--attributes Port=80
```
Este comando não produz saída.
Para obter mais informações, consulte [Serviços do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) e [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [UpdateServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service-attributes.html)em *Referência de AWS CLI Comandos*.
### `update-service`
O código de exemplo a seguir mostra como usar `update-service`.
**AWS CLI**
**Exemplo 1: atualizar um serviço**
O exemplo de `update-service` a seguir atualiza um serviço para atualizar as configurações `HealthCheckConfig` e `DnsConfig`.
```
aws servicediscovery update-service \
--id srv-abcd1234xmpl5678 \
--service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para confirmar que a operação foi bem-sucedida, você pode executar`get-operation`.
Para obter mais informações sobre a atualização de um serviço, consulte [Atualizando um serviço do AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) no *AWS Cloud Map Developer Guide*.
**Exemplo 2: atualizar um serviço usando o ARN**
O exemplo de `update-service` a seguir atualiza um serviço usando o respectivo ARN. É necessário especificar o ARN para serviços criados em namespaces compartilhados com sua conta.
```
aws servicediscovery update-service \
--id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
--service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"
```
Saída:
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Para obter mais informações sobre a atualização de um serviço, consulte Como [atualizar um serviço AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) e [namespaces do Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) no *AWS Cloud Map Developer Guide*.
+ Para obter detalhes da API, consulte [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service.html)em *Referência de AWS CLI Comandos*.