AWS Cloud Map exemples utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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 montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utilisercreate-private-dns-namespace.

AWS CLI

Pour créer un espace de DNS noms privé

L'create-private-dns-namespaceexemple suivant crée un espace de DNS noms 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.

L'exemple de code suivant montre comment utilisercreate-service.

AWS CLI

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 API plus de détails, voir CreateServicela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-namespace.

AWS CLI

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 la section Supprimer des espaces de noms dans le Guide du développeur de AWS Cloud Map.

  • Pour API plus de détails, voir DeleteNamespacela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-service.

AWS CLI

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 API plus de détails, voir DeleteServicela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserderegister-instance.

AWS CLI

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 API plus de détails, voir DeregisterInstancela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdiscover-instances.

AWS CLI

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 API plus de détails, voir DiscoverInstancesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-operation.

AWS CLI

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

L'get-operationexemple suivant obtient le résultat d'une opération.

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 API plus de détails, voir GetOperationla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-instances.

AWS CLI

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 API plus de détails, voir ListInstancesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-namespaces.

AWS CLI

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 API plus de détails, voir ListNamespacesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-services.

AWS CLI

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 API plus de détails, voir ListServicesla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserregister-instance.

AWS CLI

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 API plus de détails, voir RegisterInstancela section Référence des AWS CLI commandes.