Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# AWS Cloud Map exemples utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS Cloud Map.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `create-http-namespace`
L'exemple de code suivant montre comment utiliser`create-http-namespace`.
**AWS CLI**
**Pour créer un espace de noms HTTP**
L’exemple `create-http-namespace` suivant crée un espace de noms HTTP `example.com`.
```
aws servicediscovery create-http-namespace \
--name example.com \
--creator-request-id example-request-id
```
Sortie :
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`. Pour plus d’informations, consultez [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Pour plus d'informations sur la création d'un espace de noms, consultez la section [Création d'un espace de noms AWS Cloud Map pour regrouper les services d'application](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) dans le Guide du *développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [CreateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-http-namespace.html)à la section *Référence des AWS CLI commandes*.
### `create-private-dns-namespace`
L'exemple de code suivant montre comment utiliser`create-private-dns-namespace`.
**AWS CLI**
**Pour créer un espace de noms DNS privé**
L’exemple `create-private-dns-namespace` suivant crée un espace de nom DNS privé.
```
aws servicediscovery create-private-dns-namespace \
--name example.com \
--vpc vpc-1c56417b
```
Sortie :
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`. Pour plus d’informations, consultez [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Pour plus d’informations, consultez [Création d’espaces de noms](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [CreatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-private-dns-namespace.html)à la section *Référence des AWS CLI commandes*.
### `create-public-dns-namespace`
L'exemple de code suivant montre comment utiliser`create-public-dns-namespace`.
**AWS CLI**
**Pour créer un espace de nom DNS public**
L’exemple `create-public-dns-namespace` suivant crée un espace de nom DNS public `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}}
```
Sortie :
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`.
Pour plus d'informations sur la création d'un espace de noms, consultez la section [Création d'un espace de noms AWS Cloud Map pour regrouper les services d'application](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) dans le Guide du *développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [CreatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-public-dns-namespace.html)à la section *Référence des AWS CLI commandes*.
### `create-service`
L'exemple de code suivant montre comment utiliser`create-service`.
**AWS CLI**
**Exemple 1 : pour créer un service à l'aide de l'ID d'espace de noms**
L’exemple `create-service` suivant crée un service.
```
aws servicediscovery create-service \
--name myservice \
--namespace-id ns-ylexjili4cdxy3xm \
--dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"
```
Sortie :
```
{
"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"
}
}
```
Pour plus d'informations, consultez la section [Création d'un service AWS Cloud Map pour un composant d'application](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html) dans le *Guide du développeur de AWS Cloud Map*.
**Exemple 2 : pour créer un service à l'aide de l'espace de noms ARN**
L'`create-service`exemple suivant crée un service à l'aide d'un ARN d'espace de noms au lieu d'un ID d'espace de noms. La spécification d'un ARN d'espace de noms est nécessaire lors de la création d'un service dans un espace de noms partagé.
```
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}]"
```
Sortie :
```
{
"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"
}
}
```
Pour plus d'informations, consultez la section [Espaces de noms partagés de AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-service.html)à la section *Référence des AWS CLI commandes*.
### `delete-namespace`
L'exemple de code suivant montre comment utiliser`delete-namespace`.
**AWS CLI**
**Exemple 1 : pour supprimer un espace de noms**
L’exemple `delete-namespace` suivant supprime un espace de noms.
```
aws servicediscovery delete-namespace \
--id ns-abcd1234xmpl5678
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`. Pour plus d’informations, consultez [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Pour plus d'informations, consultez [la section Suppression d'un espace de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
**Exemple 2 : pour supprimer un espace de noms à l'aide de l'ARN de l'espace de noms**
L'`delete-namespace`exemple suivant supprime un espace de noms à l'aide de son ARN.
```
aws servicediscovery delete-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour plus d'informations, consultez [la section Suppression d'un espace de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-namespace.html)à la section *Référence des AWS CLI commandes*.
### `delete-service-attributes`
L'exemple de code suivant montre comment utiliser`delete-service-attributes`.
**AWS CLI**
**Exemple 1 : pour supprimer un attribut de service**
L’exemple `delete-service-attributes` suivant supprime un attribut de service avec la clé `Port` associée au service spécifié.
```
aws servicediscovery delete-service-attributes \
--service-id srv-abcd1234xmpl5678 \
--attributes Port
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour supprimer un attribut de service à l'aide de l'ARN**
L'`delete-service-attributes`exemple suivant supprime un attribut de service à l'aide de l'ARN du service. La spécification de l'ARN est nécessaire pour supprimer les attributs associés aux services créés dans les espaces de noms partagés avec votre compte.
```
aws servicediscovery delete-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
--attributes Port
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez les [services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) et les [espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service-attributes.html)à la section *Référence des AWS CLI commandes*.
### `delete-service`
L'exemple de code suivant montre comment utiliser`delete-service`.
**AWS CLI**
**Exemple 1 : pour supprimer un service**
L’exemple `delete-service` suivant supprime un service.
```
aws servicediscovery delete-service \
--id srv-abcd1234xmpl5678
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [la section Suppression d'un service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) dans le *Guide du développeur de AWS Cloud Map*.
**Exemple 2 : pour supprimer un service à l'aide de l'ARN**
L'`delete-service`exemple suivant supprime un service à l'aide de son ARN.
```
aws servicediscovery delete-service \
--id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [la section Suppression d'un service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service.html)à la section *Référence des AWS CLI commandes*.
### `deregister-instance`
L'exemple de code suivant montre comment utiliser`deregister-instance`.
**AWS CLI**
**Exemple 1 : pour désenregistrer une instance de service**
L’exemple `deregister-instance` suivant annule l’enregistrement d’une instance de service.
```
aws servicediscovery deregister-instance \
--service-id srv-p5zdwlg5uvvzjita \
--instance-id myservice-53
```
Sortie :
```
{
"OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`. Pour plus d'informations, consultez [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Pour plus d’informations, consultez [Annulation de l’enregistrement d’instances de service](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour désenregistrer une instance de service à l'aide de l'ARN du service pour les espaces de noms partagés**
L'`deregister-instance`exemple suivant annule l'enregistrement d'une instance de service à l'aide d'un ARN de service au lieu d'un ID de service. La spécification d'un ARN est requise lors de l'annulation de l'enregistrement d'instances provenant de services créés dans des espaces de noms partagés avec votre compte.
```
aws servicediscovery deregister-instance \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01
```
Sortie :
```
{
"OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}
```
Pour plus d'informations, consultez les sections [Espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) et [Désenregistrement d'une instance de service AWS Cloud Map dans le](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) Guide du développeur de *AWS Cloud* Map.
+ Pour plus de détails sur l'API, reportez-vous [DeregisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/deregister-instance.html)à la section *Référence des AWS CLI commandes*.
### `discover-instances-revision`
L'exemple de code suivant montre comment utiliser`discover-instances-revision`.
**AWS CLI**
**Exemple 1 : pour découvrir la révision d'une instance**
L’exemple `discover-instances-revision` suivant découvre la révision croissante d’une instance.
```
aws servicediscovery discover-instances-revision \
--namespace-name example.com \
--service-name myservice
```
Sortie :
```
{
"InstancesRevision": 123456
}
```
Pour plus d’informations, consultez [Instances de service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour découvrir la révision des instances à partir d'un compte propriétaire spécifique**
L'`discover-instances-revision`exemple suivant découvre la révision d'instances à partir d'un compte propriétaire spécifique. Le paramètre owner-account est nécessaire pour les instances des espaces de noms partagés avec votre compte.
```
aws servicediscovery discover-instances-revision \
--namespace-name shared-namespace \
--service-name shared-service \
--owner-account 123456789111
```
Sortie :
```
{
"InstancesRevision": 1234567890
}
```
Pour plus d'informations, consultez les [espaces de noms Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) et les [instances du service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [DiscoverInstancesRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances-revision.html)à la section *Référence des AWS CLI commandes*.
### `discover-instances`
L'exemple de code suivant montre comment utiliser`discover-instances`.
**AWS CLI**
**Exemple 1 : pour découvrir les instances enregistrées**
L’exemple `discover-instances` suivant découvre les instances enregistrées.
```
aws servicediscovery discover-instances \
--namespace-name example.com \
--service-name myservice \
--max-results 10 \
--health-status ALL
```
Sortie :
```
{
"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
}
```
Pour plus d’informations, consultez [Instances de service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour découvrir des instances provenant d'un compte propriétaire spécifique**
L'`discover-instances`exemple suivant découvre les instances enregistrées à partir d'un compte propriétaire spécifique. Ce paramètre est nécessaire pour découvrir des instances dans des espaces de noms partagés avec votre compte.
```
aws servicediscovery discover-instances \
--namespace-name shared-namespace \
--service-name shared-service \
--owner-account 123456789111
```
Sortie :
```
{
"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
}
```
Pour plus d'informations, consultez les [espaces de noms Shared AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) et les [instances du service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [DiscoverInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances.html)à la section *Référence des AWS CLI commandes*.
### `get-instance`
L'exemple de code suivant montre comment utiliser`get-instance`.
**AWS CLI**
**Exemple 1 : pour obtenir les détails d'une instance**
L’exemple `get-instance` suivant obtient les attributs d’un service.
```
aws servicediscovery get-instance \
--service-id srv-e4anhexample0004
--instance-id i-abcd1234
```
Sortie :
```
{
"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"
}
}
```
Pour plus d’informations, consultez [Instances de service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour obtenir les détails d'une instance à l'aide de l'ARN du service pour les espaces de noms partagés**
L'`get-instance`exemple suivant obtient les attributs d'une instance à l'aide d'un ARN de service au lieu d'un ID de service. La spécification d'un ARN est requise pour obtenir des informations sur les instances associées aux espaces de noms partagés avec votre compte. L'instance renvoyée dans cet exemple a été enregistrée par compte `123456789111` dans un espace de noms appartenant au compte`123456789012`.
```
aws servicediscovery get-instance \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01
```
Sortie :
```
{
"ResourceOwner": "123456789012",
"Instance": {
"Id": "web-server-01",
"Attributes": {
"AWS_INSTANCE_IPV4": "203.0.113.15",
"AWS_INSTANCE_PORT": "80"
},
"CreatedByAccount": "123456789111"
}
}
```
Pour plus d'informations sur le partage d'espaces de noms entre comptes, consultez la section [Espaces de noms AWS Cloud Map partagés dans le Guide du](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) développeur de *AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [GetInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instance.html)à la section *Référence des AWS CLI commandes*.
### `get-instances-health-status`
L'exemple de code suivant montre comment utiliser`get-instances-health-status`.
**AWS CLI**
**Exemple 1 : pour obtenir l'état de santé des instances associées à un service**
L’exemple `get-instances-health-status` suivant permet d’obtenir le statut de l’état des instances associées au service spécifié.
```
aws servicediscovery get-instances-health-status \
--service-id srv-e4anhexample0004
```
Sortie :
```
{
"Status": {
"i-abcd1234": "HEALTHY",
"i-abcd1235": "UNHEALTHY"
}
}
```
Pour plus d’informations, consultez [Instances de service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour obtenir l'état de santé des instances à l'aide de l'ARN du service pour les espaces de noms partagés**
L'`get-instances-health-status`exemple suivant permet d'obtenir l'état de santé des instances à l'aide d'un ARN de service au lieu d'un ID de service. La spécification d'un ARN est requise lors de l'obtention de l'état de santé des instances associées à des espaces de noms partagés avec le compte du demandeur.
```
aws servicediscovery get-instances-health-status \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
```
Sortie :
```
{
"Status": {
"web-server-01": "HEALTHY",
"web-server-02": "UNHEALTHY"
}
}
```
Pour plus d'informations, consultez les [AWS sections Instances du service Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) et [espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [GetInstancesHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instances-health-status.html)à la section *Référence des AWS CLI commandes*.
### `get-namespace`
L'exemple de code suivant montre comment utiliser`get-namespace`.
**AWS CLI**
**Exemple 1 : pour obtenir les détails d'un espace de noms**
L’exemple `get-namespace` suivant extrait des informations sur l’espace de noms spécifié.
```
aws servicediscovery get-namespace \
--id ns-abcd1234xmpl5678
```
Sortie :
```
{
"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"
}
}
```
Pour plus d’informations, consultez [Espaces de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour obtenir les détails d'un espace de noms à l'aide de l'ARN**
L'`get-namespace`exemple suivant récupère des informations sur l'espace de noms spécifié à l'aide de son ARN. La spécification de l'ARN est nécessaire pour récupérer les détails d'un espace de noms partagé avec votre compte.
```
aws servicediscovery get-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
```
Sortie :
```
{
"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"
}
}
```
Pour plus d'informations, consultez la section [Espaces de noms partagés de AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [GetNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-namespace.html)à la section *Référence des AWS CLI commandes*.
### `get-operation`
L'exemple de code suivant montre comment utiliser`get-operation`.
**AWS CLI**
**Exemple 1 : Pour obtenir le résultat d'une opération**
L’exemple `get-operation` suivant obtient le résultat d’une opération de création d’un espace de noms.
```
aws servicediscovery get-operation \
--operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234
```
Sortie :
```
{
"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"
}
}
}
```
Pour plus d'informations, consultez la section [Création d'un espace de noms AWS Cloud Map pour regrouper les services d'application](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
**Exemple 2 : Pour obtenir une opération à partir d'un compte propriétaire spécifique**
L'`get-operation`exemple suivant obtient le résultat d'une opération associée à un compte propriétaire d'espace de noms spécifique. Ce paramètre est nécessaire pour obtenir le résultat des opérations associées aux espaces de noms partagés avec votre compte.
```
aws servicediscovery get-operation \
--operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \
--owner-account 123456789111
```
Sortie :
```
{
"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"
}
}
}
```
Pour plus d'informations, consultez la section [Espaces de noms partagés de AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [GetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-operation.html)à la section *Référence des AWS CLI commandes*.
### `get-service-attributes`
L'exemple de code suivant montre comment utiliser`get-service-attributes`.
**AWS CLI**
**Exemple 1 : Pour obtenir les attributs d'un service**
L’exemple `get-service-attributes` suivant obtient les attributs d’un service.
```
aws servicediscovery get-service-attributes \
--service-id srv-abcd1234xmpl5678
```
Sortie :
```
{
"ServiceAttributes": {
"ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Attributes": {
"Port": "80"
}
}
}
```
Pour plus d’informations, consultez [Services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour obtenir les attributs d'un service à l'aide de l'ARN**
L'`get-service-attributes`exemple suivant obtient les attributs d'un service à l'aide de son ARN. La spécification d'un ARN est nécessaire pour obtenir les attributs d'un service créé dans un espace de noms partagé avec votre compte.
```
aws servicediscovery get-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
Sortie :
```
{
"ServiceAttributes": {
"ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Attributes": {
"Port": "80"
}
}
}
```
Pour plus d'informations, consultez les [services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) et les [espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [GetServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service-attributes.html)à la section *Référence des AWS CLI commandes*.
### `get-service`
L'exemple de code suivant montre comment utiliser`get-service`.
**AWS CLI**
**Exemple 1 : pour obtenir les paramètres d'un service**
L’exemple `get-service` suivant obtient les paramètres d’un service spécifié.
```
aws servicediscovery get-service \
--id srv-abcd1234xmpl5678
```
Sortie :
```
{
"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"
}
}
```
Pour plus d’informations, consultez [Services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour obtenir les paramètres d'un service à l'aide de l'ARN**
L'`get-service`exemple suivant obtient les paramètres d'un service spécifié à l'aide de son ARN. La spécification de l'ARN est nécessaire pour récupérer des informations sur un service créé dans un espace de noms partagé avec votre compte. Le compte de l'appelant `123456789111` a créé le service dans un espace de noms partagé par compte. `123456789012`
```
aws servicediscovery get-service \
--id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
Sortie :
```
{
"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"
}
}
```
Pour plus d'informations, consultez les [sections Création d'un service AWS Cloud Map pour un composant d'application](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html) et [espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service.html)à la section *Référence des AWS CLI commandes*.
### `list-instances`
L'exemple de code suivant montre comment utiliser`list-instances`.
**AWS CLI**
**Exemple 1 : pour répertorier les instances de service**
L’exemple `list-instances` suivant répertorie les instances de service.
```
aws servicediscovery list-instances \
--service-id srv-qzpwvt2tfqcegapy
```
Sortie :
```
{
"Instances": [
{
"Id": "i-06bdabbae60f65a4e",
"Attributes": {
"AWS_INSTANCE_IPV4": "172.2.1.3",
"AWS_INSTANCE_PORT": "808"
},
"CreatedByAccount": "123456789012"
}
],
"ResourceOwner": "123456789012"
}
```
Pour plus d'informations, consultez la section [Liste des instances du service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) dans le *Guide du développeur de AWS Cloud Map*.
**Exemple 2 : pour répertorier les instances de service à l'aide de l'ARN du service**
L'`list-instances`exemple suivant répertorie les instances de service utilisant un ARN de service au lieu d'un ID de service. La spécification d'un ARN est requise lors de la liste des instances associées à des espaces de noms partagés avec votre compte.
```
aws servicediscovery list-instances \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d'informations sur le partage d'espaces de noms entre comptes, consultez les [sections Espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) et [Listing AWS Cloud Map Service dans le](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) Guide du développeur *AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [ListInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-instances.html)à la section *Référence des AWS CLI commandes*.
### `list-namespaces`
L'exemple de code suivant montre comment utiliser`list-namespaces`.
**AWS CLI**
**Exemple 1 : pour répertorier les espaces de noms**
L’exemple `list-namespaces` suivant répertorie des espaces de noms.
```
aws servicediscovery list-namespaces
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d'informations, consultez la section [Listing AWS Cloud Map namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
**Exemple 2 : pour répertorier les espaces de noms partagés par d'autres comptes**
L'`list-namespaces`exemple suivant répertorie les espaces de noms partagés avec le compte de l'appelant par d'autres AWS comptes utilisant le `RESOURCE_OWNER` filtre.
```
aws servicediscovery list-namespaces \
--filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d'informations, consultez la section [Espaces de noms partagés de AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [ListNamespaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-namespaces.html)à la section *Référence des AWS CLI commandes*.
### `list-operations`
L'exemple de code suivant montre comment utiliser`list-operations`.
**AWS CLI**
**Pour répertorier les opérations qui répondent aux critères spécifiés**
L’exemple `list-operations` suivant répertorie les opérations dont le statut est `PENDING` ou `SUCCESS`.
```
aws servicediscovery list-operations \
--service-id srv-e4anhexample0004 \
--filters Name=STATUS,Condition=IN,Values=PENDING,SUCCESS
```
Sortie :
```
{
"Operations": [
{
"Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample",
"Status": "SUCCESS"
},
{
"Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample",
"Status": "SUCCESS"
},
{
"Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example",
"Status": "PENDING"
}
]
}
```
Pour plus d'informations, consultez [Qu'est-ce que AWS Cloud Map ?](https://docs.aws.amazon.com/cloud-map/latest/dg/what-is-cloud-map.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-operations.html)à la section *Référence des AWS CLI commandes*.
### `list-services`
L'exemple de code suivant montre comment utiliser`list-services`.
**AWS CLI**
**Exemple 1 : pour répertorier les services**
L’exemple `list-services` suivant répertorie des services.
```
aws servicediscovery list-services
```
Sortie :
```
{
"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
}
]
}
```
Pour plus d'informations, consultez la section [Répertorier les services AWS Cloud Map dans un espace de noms](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) dans le *Guide du développeur de AWS Cloud Map*.
**Exemple 2 : pour répertorier les services créés dans des espaces de noms partagés**
L'`list-services`exemple suivant répertorie les services créés dans des espaces de noms partagés avec le compte de l'appelant `123456789012` par d'autres AWS comptes à l'aide du `RESOURCE_OWNER` filtre.
```
aws servicediscovery list-services \
--filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
```
Sortie :
```
{
"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"
}
]
}
```
Pour plus d'informations, consultez les sections [Espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) et [Liste des services AWS Cloud Map dans un espace de noms](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) dans le Guide du *développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-services.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour répertorier les balises associées à la ressource spécifiée**
L’exemple `list-tags-for-resource` suivant répertorie les balises pour la ressource spécifiée.
```
aws servicediscovery list-tags-for-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004
```
Sortie :
```
{
"Tags": [
{
"Key": "Project",
"Value": "Zeta"
},
{
"Key": "Department",
"Value": "Engineering"
}
]
}
```
Pour plus d'informations, consultez la section [Marquage de vos ressources AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `register-instance`
L'exemple de code suivant montre comment utiliser`register-instance`.
**AWS CLI**
**Exemple 1 : pour enregistrer une instance de service à l'aide de l'ID de service**
L’exemple `register-instance` suivant enregistre une instance de service.
```
aws servicediscovery register-instance \
--service-id srv-p5zdwlg5uvvzjita \
--instance-id myservice-53 \
--attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808
```
Sortie :
```
{
"OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`. Pour plus d’informations, consultez [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Pour plus d'informations sur l'enregistrement d'une instance, consultez la section [Enregistrement d'une ressource en tant qu'instance de service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/registering-instances.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour enregistrer une instance de service à l'aide de l'ARN du service**
L'`register-instance`exemple suivant enregistre une instance de service à l'aide d'un ARN de service. La spécification de l'ARN est requise lors de l'enregistrement des instances dans les services partagés avec votre compte.
```
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
```
Sortie :
```
{
"OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}
```
Pour plus d'informations sur le partage d'espaces de noms entre comptes, consultez la section [Espaces de noms AWS Cloud Map partagés dans le Guide du](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) développeur de *AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [RegisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/register-instance.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour associer des balises à la ressource spécifiée**
L’exemple `tag-resource` suivant associe une balise `Department` avec la valeur `Engineering` à l’espace de noms spécifié.
```
aws servicediscovery tag-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
--tags Key=Department, Value=Engineering
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Marquage de vos ressources AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer des balises de la ressource spécifiée**
L’exemple `untag-resource` suivant supprime une balise `Department` de l’espace de noms spécifié.
```
aws servicediscovery untag-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
--tags Key=Department, Value=Engineering
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Marquage de vos ressources AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-http-namespace`
L'exemple de code suivant montre comment utiliser`update-http-namespace`.
**AWS CLI**
**Exemple 1 : pour mettre à jour un espace de noms HTTP**
L’exemple `update-http-namespace` suivant met à jour la description de l’espace de noms HTTP spécifié.
```
aws servicediscovery update-http-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`. Pour plus d’informations, consultez [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Pour plus d’informations, consultez [Espaces de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour mettre à jour un espace de noms HTTP à l'aide de l'ARN**
L'`update-http-namespace`exemple suivant met à jour l'espace de noms HTTP spécifié à l'aide de son 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."
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour plus d’informations, consultez [Espaces de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-http-namespace.html)à la section *Référence des AWS CLI commandes*.
### `update-instance-custom-health-status`
L'exemple de code suivant montre comment utiliser`update-instance-custom-health-status`.
**AWS CLI**
**Exemple 1 : pour mettre à jour un bilan de santé personnalisé**
L’exemple `update-instance-custom-health-status` suivant met à jour le statut de la surveillance de l’état personnalisée pour le service spécifié et l’exemple d’instance de service sur `HEALTHY`.
```
aws servicediscovery update-instance-custom-health-status \
--service-id srv-e4anhexample0004 \
--instance-id example \
--status HEALTHY
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Configuration de la surveillance de l’état du service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour mettre à jour un bilan de santé personnalisé à l'aide de l'ARN du service**
L'`update-instance-custom-health-status`exemple suivant met à jour l'état du bilan de santé personnalisé à l'aide d'un ARN de service. L'ARN est requis lors de la mise à jour de l'état de santé des instances associées à des espaces de noms partagés avec votre compte.
```
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
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez les sections [Configuration du contrôle de santé du service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) et [partage d'espaces de noms AWS Cloud Map entre comptes](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le Guide du *développeur AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateInstanceCustomHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-instance-custom-health-status.html)à la section *Référence des AWS CLI commandes*.
### `update-private-dns-namespace`
L'exemple de code suivant montre comment utiliser`update-private-dns-namespace`.
**AWS CLI**
**Exemple 1 : pour mettre à jour un espace de noms DNS privé à l'aide de l'ID**
L'`update-private-dns-namespace`exemple suivant met à jour la description d'un espace de noms DNS privé à l'aide de l'ID d'espace de noms.
```
aws servicediscovery update-private-dns-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`.
Pour plus d’informations, consultez [Espaces de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour mettre à jour un espace de noms DNS privé à l'aide de l'ARN**
L'`update-private-dns-namespace`exemple suivant met à jour un espace de noms DNS privé à l'aide de son 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."
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour plus d’informations, consultez [Espaces de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [UpdatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-private-dns-namespace.html)à la section *Référence des AWS CLI commandes*.
### `update-public-dns-namespace`
L'exemple de code suivant montre comment utiliser`update-public-dns-namespace`.
**AWS CLI**
**Exemple 1 : pour mettre à jour un espace de noms DNS public à l'aide de l'ID**
L'`update-public-dns-namespace`exemple suivant met à jour la description d'un espace de noms DNS public à l'aide de son ID.
```
aws servicediscovery update-public-dns-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`.
Pour plus d’informations, consultez [Espaces de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour mettre à jour un espace de noms DNS public à l'aide de l'ARN**
L'`update-public-dns-namespace`exemple suivant met à jour un espace de noms DNS public à l'aide de son 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."
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour plus d’informations, consultez [Espaces de noms AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) dans le *Guide du développeur AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [UpdatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-public-dns-namespace.html)à la section *Référence des AWS CLI commandes*.
### `update-service-attributes`
L'exemple de code suivant montre comment utiliser`update-service-attributes`.
**AWS CLI**
**Exemple 1 : Pour mettre à jour un service afin d'ajouter un attribut**
L’exemple `update-service-attributes` suivant met à jour le service spécifié pour ajouter un attribut de service avec une clé `Port` et une valeur `80`.
```
aws servicediscovery update-service-attributes \
--service-id srv-abcd1234xmpl5678 \
--attributes Port=80
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) dans le *Guide du développeur AWS Cloud Map*.
**Exemple 2 : pour mettre à jour les attributs d'un service à l'aide de l'ARN**
L'`update-service-attributes`exemple suivant met à jour un service à l'aide de son ARN pour ajouter un attribut de service. La spécification de l'ARN est nécessaire pour ajouter des attributs aux services créés dans des espaces de noms partagés avec votre compte.
```
aws servicediscovery update-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
--attributes Port=80
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez les [services AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) et les [espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service-attributes.html)à la section *Référence des AWS CLI commandes*.
### `update-service`
L'exemple de code suivant montre comment utiliser`update-service`.
**AWS CLI**
**Exemple 1 : pour mettre à jour un service**
L’exemple `update-service` suivant met à jour un service pour mettre à jour les paramètres `DnsConfig` et `HealthCheckConfig`.
```
aws servicediscovery update-service \
--id srv-abcd1234xmpl5678 \
--service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation`.
Pour plus d'informations sur la mise à jour d'un service, consultez la section [Mise à jour d'un service AWSAWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) *dans le Guide du développeur de Cloud Map*.
**Exemple 2 : pour mettre à jour un service à l'aide de l'ARN**
L'`update-service`exemple suivant met à jour un service à l'aide de son ARN. La spécification d'un ARN est nécessaire pour les services créés dans des espaces de noms partagés avec votre compte.
```
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}"
```
Sortie :
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
Pour plus d'informations sur la mise à jour d'un service, consultez les [sections Mise à jour d'un service AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) et [espaces de noms AWS Cloud Map partagés](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) dans le *Guide du développeur de AWS Cloud Map*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service.html)à la section *Référence des AWS CLI commandes*.