AWS Cloud Map exemples utilisant 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.

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 dans le Guide du développeur de AWS Cloud Map.

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.

Pour plus d’informations, consultez Création d’espaces de noms dans le Guide du développeur AWS  Cloud Map.

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 dans le Guide du développeur de AWS Cloud Map.

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 dans le Guide du développeur de AWS Cloud Map.

Exemple 2 : pour créer un service à l'aide de l'ARN de l'espace de noms

L'create-serviceexemple 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 Shared AWS Cloud Map dans le Guide du développeur AWS Cloud Map.

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.

Pour plus d'informations, consultez la section Supprimer un espace de noms AWS Cloud Map 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-namespaceexemple 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 Supprimer un espace de noms AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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 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-attributesexemple 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 et les espaces de noms AWS Cloud Map partagés dans le Guide du développeur de AWS Cloud Map.

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 Supprimer un service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

Exemple 2 : Pour supprimer un service à l'aide de l'ARN

L'delete-serviceexemple 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 Supprimer un service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

Exemple 1 : pour annuler l'enregistrement d'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.

Pour plus d’informations, consultez Annulation de l’enregistrement d’instances de service dans le Guide du développeur AWS  Cloud Map.

Exemple 2 : Pour annuler l'enregistrement d'une instance de service à l'aide de l'ARN du service pour les espaces de noms partagés

L'deregister-instanceexemple 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 à partir 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 rubriques Espaces de noms AWS Cloud Map partagés et Annulation de l'enregistrement d'une instance de service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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 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-revisionexemple suivant découvre la révision des 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 la section Espaces de noms AWS Cloud Map partagés et instances de service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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 dans le Guide du développeur AWS  Cloud Map.

Exemple 2 : pour découvrir des instances à partir d'un compte propriétaire spécifique

L'discover-instancesexemple 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 les espaces de noms qui sont 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 la section Espaces de noms AWS Cloud Map partagés et instances de service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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 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-instanceexemple 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 à account123456789012.

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 développeur de AWS Cloud Map.

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 dans le Guide du développeur AWS  Cloud Map.

Exemple 2 : Pour obtenir l'état de santé des instances à l'aide de l'ARN de service pour les espaces de noms partagés

L'get-instances-health-statusexemple 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 pour obtenir 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 la section Instances de service AWS Cloud Map et espaces de noms AWS Cloud Map partagés dans le Guide du développeur de AWS Cloud Map.

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 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-namespaceexemple suivant récupère les informations relatives à 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 Shared AWS Cloud Map dans le Guide du développeur AWS Cloud Map.

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 applicatifs 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-operationexemple suivant obtient le résultat d'une opération associée au compte propriétaire d'un 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 Shared AWS Cloud Map dans le Guide du développeur AWS Cloud Map.

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 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-attributesexemple 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 et les espaces de noms AWS Cloud Map partagés dans le Guide du développeur de AWS Cloud Map.

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 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-serviceexemple suivant obtient les paramètres d'un service spécifié à l'aide de son ARN. Il est nécessaire de spécifier l'ARN 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 le 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 la section Création d'un service AWS Cloud Map pour un composant d'application et des espaces de noms AWS Cloud Map partagés dans le Guide du développeur de AWS Cloud Map.

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 AWS Répertorier les instances du service AWS Cloud Map dans le Guide du développeur de Cloud Map.

Exemple 2 : Pour répertorier les instances de service à l'aide de l'ARN du service

L'list-instancesexemple suivant répertorie les instances 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 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 et Listing des instances du service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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 AWS Répertorier les espaces de noms Cloud Map 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-namespacesexemple suivant répertorie les espaces de noms qui sont partagés avec le compte de l'appelant par d'autres AWS comptes à l'aide du 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 Shared AWS Cloud Map dans le Guide du développeur AWS Cloud Map.

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 ? dans le Guide du développeur de AWS Cloud Map.

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 AWS Répertorier les services Cloud Map dans un espace de noms 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-servicesexemple 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 et Répertorier les services AWS Cloud Map dans un espace de noms dans le AWS Cloud Map Developer Guide.

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 Balisage de vos ressources AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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.

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 dans le Guide du développeur de AWS Cloud Map.

Exemple 2 : Pour enregistrer une instance de service à l'aide de l'ARN du service

L'register-instanceexemple 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 d'instances dans des 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 développeur de AWS Cloud Map.

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 Balisage de vos ressources AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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 \
    --tag-keys Department

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Balisage de vos ressources AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

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.

Pour plus d’informations, consultez Espaces de noms AWS  Cloud Map 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-namespaceexemple 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 dans le Guide du développeur AWS  Cloud Map.

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 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-statusexemple 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 AWS la section Configuration du bilan de santé du service Cross-account AWS Cloud Map et partage de l'espace de noms Cloud Map dans le Guide du développeur AWS Cloud Map.

Exemple 1 : pour mettre à jour un espace de noms DNS privé à l'aide d'un ID

L'update-private-dns-namespaceexemple 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 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-namespaceexemple 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 dans le Guide du développeur AWS  Cloud Map.

Exemple 1 : pour mettre à jour un espace de noms DNS public à l'aide d'un ID

L'update-public-dns-namespaceexemple 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 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-namespaceexemple 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 dans le Guide du développeur AWS  Cloud Map.

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 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-attributesexemple 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 les 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 et les espaces de noms AWS Cloud Map partagés dans le Guide du développeur de AWS Cloud Map.

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 dans le Guide du développeur de Cloud Map.

Exemple 2 : pour mettre à jour un service à l'aide de l'ARN

L'update-serviceexemple 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 la section Mise à jour d'un service AWS Cloud Map et d'espaces de noms AWS Cloud Map partagés dans le Guide du développeur de AWS Cloud Map.