AWS Cloud Map exemples utilisant AWS CLI

Pour créer un espace de noms HTTP

L'create-http-namespaceexemple suivant crée un espace de noms example.com HTTP.

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écuterget-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'create-private-dns-namespaceexemple suivant crée un espace de noms 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écuterget-operation. Pour plus d'informations, consultez get-operation.

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

Pour créer un espace de noms DNS public

L'create-public-dns-namespaceexemple suivant crée un espace de noms example.com DNS public.

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écuterget-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 service

L'create-serviceexemple suivant crée un service.

aws servicediscovery create-service \
    --name myservice \
    --namespace-id  ns-ylexjili4cdxy3xm \
    --dns-config "NamespaceId=ns-ylexjili4cdxy3xm,RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"

Sortie :

{
        "Service": {
        "Id": "srv-p5zdwlg5uvvzjita",
        "Arn": "arn:aws:servicediscovery:us-west-2:803642222207:service/srv-p5zdwlg5uvvzjita",
        "Name": "myservice",
        "NamespaceId": "ns-ylexjili4cdxy3xm",
        "DnsConfig": {
            "NamespaceId": "ns-ylexjili4cdxy3xm",
            "RoutingPolicy": "MULTIVALUE",
            "DnsRecords": [
                {
                    "Type": "A",
                    "TTL": 60
                }
            ]
        },
        "CreateDate": 1587081768.334,
        "CreatorRequestId": "567c1193-6b00-4308-bd57-ad38a8822d25"
    }
}

Pour plus d'informations, consultez la section Création de services dans le Guide du développeur de AWS Cloud Map.

Pour supprimer un espace de noms

L'delete-namespaceexemple suivant supprime un espace de noms.

aws servicediscovery delete-namespace \
    --id ns-ylexjili4cdxy3xm

Sortie :

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
}

Pour confirmer que l'opération a réussi, vous pouvez exécuterget-operation. Pour plus d'informations, consultez get-operation.

Pour plus d'informations, consultez Supprimer des espaces de noms dans le Guide du développeur de AWS Cloud Map.

Pour supprimer un attribut de service

L'delete-service-attributesexemple suivant supprime un attribut de service avec la clé Port associée au service spécifié.

aws servicediscovery delete-service-attributes \
    --service-id srv-e4anhexample0004 \
    --attributes Port

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez Supprimer des espaces de noms dans le Guide du développeur de AWS Cloud Map.

Pour supprimer un service

L'delete-serviceexemple suivant supprime un service.

aws servicediscovery delete-service \
    --id srv-p5zdwlg5uvvzjita

Cette commande ne produit aucun résultat.

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

Pour désenregistrer une instance de service

L'deregister-instanceexemple 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écuterget-operation. Pour plus d'informations, consultez get-operation.

Pour plus d'informations, consultez la section Désenregistrement des instances de service dans le Guide du développeur de AWS Cloud Map.

Pour découvrir la révision d'une instance

L'discover-instances-revisionexemple 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 la section Instances du service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

Pour découvrir les instances enregistrées

L'discover-instancesexemple 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"
            }
        }
    ]
}

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

Pour obtenir les détails d'une instance

L'get-instanceexemple suivant permet d'obtenir les attributs d'un service.

aws servicediscovery get-instance \
    --service-id srv-e4anhexample0004
    --instance-id i-abcd1234

Sortie :

{
    "Instances": {
        "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"
        }
    }
}

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

Pour obtenir l'état de santé des instances associées à un service

L'get-instances-health-statusexemple suivant permet d'obtenir l'état de santé 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 la section Instances du service AWS Cloud Map dans le Guide du développeur de AWS Cloud Map.

Pour obtenir les détails d'un espace de noms

L'get-namespaceexemple suivant récupère les informations relatives à l'espace de noms spécifié.

aws servicediscovery get-namespace \
    --id ns-e4anhexample0004

Sortie :

{
    "Namespaces": {
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004",
        "CreateDate": "20181118T211712Z",
        "CreatorRequestId": "example-creator-request-id-0001",
        "Description": "Example.com AWS Cloud Map HTTP Namespace",
        "Id": "ns-e4anhexample0004",
        "Name": "example-http.com",
        "Properties": {
            "DnsProperties": {},
            "HttpProperties": {
                "HttpName": "example-http.com"
            }
        },
        "Type": "HTTP"
    }
}

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

Pour obtenir le résultat d'une opération

L'get-operationexemple suivant obtient le résultat d'une opération de création d'espace de noms.

aws servicediscovery get-operation \
    --operation-id gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd

Sortie :

{
    "Operation": {
        "Id": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd",
        "Type": "CREATE_NAMESPACE",
        "Status": "SUCCESS",
        "CreateDate": 1587055860.121,
        "UpdateDate": 1587055900.469,
        "Targets": {
            "NAMESPACE": "ns-ylexjili4cdxy3xm"
        }
    }
}

Pour plus d'informations, 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 obtenir les attributs d'un service

L'get-service-attributesexemple suivant permet d'obtenir les attributs d'un service.

aws servicediscovery get-service-attributes \
    --service-id srv-e4anhexample0004

Sortie :

{
    "ServiceAttributes": {
        "ServiceArn": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
        "Attributes": {
            "Port": "80"
        }
    }
}

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

Pour obtenir les paramètres d'un service

L'get-serviceexemple suivant permet d'obtenir les paramètres d'un service spécifié.

aws servicediscovery get-service \
    --id srv-e4anhexample0004

Sortie :

{
    "Service": {
        "Id": "srv-e4anhexample0004",
        "Arn": "arn:aws:servicediscovery:us-west-2:111122223333:service/srv-e4anhexample0004",
        "Name": "test-service",
        "NamespaceId": "ns-e4anhexample0004",
        "DnsConfig": {},
        "Type": "HTTP",
        "CreateDate": "2025-02-24T10:59:02.905000-06:00",
        "CreatorRequestId": "3f50f9d9-b14c-482e-a556-d2a22fe6106d"
    }
}

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

Pour répertorier les instances de service

L'list-instancesexemple 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"
            }
        }
    ]
}

Pour plus d'informations, consultez la section Affichage d'une liste d'instances de service dans le Guide du développeur de AWS Cloud Map.

Pour répertorier les espaces de noms

L'list-namespacesexemple suivant répertorie les espaces de noms.

aws servicediscovery list-namespaces

Sortie :

{
    "Namespaces": [
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-a3ccy2e7e3a7rile",
            "CreateDate": 1585354387.357,
            "Id": "ns-a3ccy2e7e3a7rile",
            "Name": "local",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z06752353VBUDTC32S84S"
                },
                "HttpProperties": {
                    "HttpName": "local"
                 }
            },
            "Type": "DNS_PRIVATE"
        },
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-pocfyjtrsmwtvcxx",
            "CreateDate": 1586468974.698,
            "Description": "My second namespace",
            "Id": "ns-pocfyjtrsmwtvcxx",
            "Name": "My-second-namespace",
            "Properties": {
                "DnsProperties": {},
                "HttpProperties": {
                    "HttpName": "My-second-namespace"
                }
            },
            "Type": "HTTP"
        },
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-ylexjili4cdxy3xm",
            "CreateDate": 1587055896.798,
            "Id": "ns-ylexjili4cdxy3xm",
            "Name": "example.com",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z09983722P0QME1B3KC8I"
                },
                 "HttpProperties": {
                     "HttpName": "example.com"
                }
            },
            "Type": "DNS_PRIVATE"
        }
    ]
}

Pour plus d'informations, consultez la section Affichage d'une liste d'espaces de noms dans le Guide du développeur de AWS Cloud Map.

Pour répertorier les opérations qui répondent aux critères spécifiés

L'list-operationsexemple suivant répertorie les opérations dont le statut est PENDING ouSUCCESS.

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.

Pour répertorier les services

L'list-servicesexemple suivant répertorie les 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 Affichage d'une liste de services dans le Guide du développeur de AWS Cloud Map.

Pour répertorier les balises associées à la ressource spécifiée

L'list-tags-for-resourceexemple 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 dans le Guide du développeur de AWS Cloud Map.

Pour enregistrer une instance de service

L'register-instanceexemple 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écuterget-operation. Pour plus d'informations, consultez get-operation.

Pour plus d'informations, consultez la section Enregistrement des instances dans le Guide du développeur de AWS Cloud Map.

Pour associer des balises à la ressource spécifiée

L'tag-resourceexemple suivant associe une Department balise à la valeur Engineering associée à 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 aucun résultat.

Pour plus d'informations, consultez la section Marquage 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'untag-resourceexemple suivant supprime une Department balise 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 aucun résultat.

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

Pour mettre à jour un espace de noms HTTP

L'update-http-namespaceexemple suivant met à jour la description de l'espace de noms HTTP spécifié.

aws servicediscovery update-http-namespace \
    --id ns-vh4nbmEXAMPLE \
    --updater-request-id example-request-id \
    --namespace Description="The updated namespace description."

Sortie :

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Pour confirmer que l'opération a réussi, vous pouvez exécuterget-operation. Pour plus d'informations, consultez get-operation.

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

Pour mettre à jour un bilan de santé personnalisé

L'update-instance-custom-health-statusexemple suivant met à jour l'état du bilan de santé personnalisé pour le service spécifié et l'exemple d'instance de service surHEALTHY.

aws servicediscovery update-instance-custom-health-status \
    --service-id srv-e4anhexample0004 \
    --instance-id example \
    --status HEALTHY

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez AWS la section Configuration de la vérification de l'état du service AWS Cloud Map dans le Guide du développeur de Cloud Map.

Pour mettre à jour un espace de noms DNS privé

L'update-private-dns-namespaceexemple suivant met à jour la description d'un espace de noms DNS privé.

aws servicediscovery update-private-dns-namespace \
    --id ns-bk3aEXAMPLE \
    --updater-request-id example-private-request-id \
    --namespace Description="The updated namespace description."

Sortie :

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Pour confirmer que l'opération a réussi, vous pouvez exécuterget-operation.

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

Pour mettre à jour un espace de noms DNS public

L'update-public-dns-namespaceexemple suivant met à jour la description d'un espace de noms DNS public.

aws servicediscovery update-public-dns-namespace \
    --id ns-bk3aEXAMPLE \
    --updater-request-id example-public-request-id \
    --namespace Description="The updated namespace description."

Sortie :

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Pour confirmer que l'opération a réussi, vous pouvez exécuterget-operation.

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

Pour mettre à jour un service afin d'ajouter un attribut

L'update-service-attributesexemple suivant met à jour le service spécifié pour ajouter un attribut de service avec une clé Port et une valeur80.

aws servicediscovery update-service-attributes \
    --service-id srv-e4anhexample0004 \
    --attributes Port=80

Cette commande ne produit aucun résultat.

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

Pour mettre à jour un service

L'update-serviceexemple suivant met à jour un service pour mettre à jour les HealthCheckConfig paramètres DnsConfig et.

aws servicediscovery update-service \
    --id srv-e4anhexample0004 \
    --service "DnsConfig={DnsRecords=[{"Type"="A","TTL"=60}]},HealthCheckConfig={"Type"="HTTP","ResourcePath"="/","FailureThreshold"="2"}"

Sortie :

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Pour confirmer que l'opération a réussi, vous pouvez exécuterget-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.