AWS Cloud Map esempi utilizzando AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS Cloud Map esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with AWS Cloud Map.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-private-dns-namespace.

AWS CLI

Per creare uno spazio dei DNS nomi privato

L'create-private-dns-namespaceesempio seguente crea uno spazio dei nomi privatoDNS.

aws servicediscovery create-private-dns-namespace \
    --name example.com \
    --vpc vpc-1c56417b

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Per confermare che l'operazione è riuscita, puoi eseguire. get-operation Per ulteriori informazioni, vedere get-operation.

Per ulteriori informazioni, consulta Creazione di namespace nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzarecreate-service.

AWS CLI

Per creare un servizio

L'create-serviceesempio seguente crea un servizio.

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

Output:

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

Per ulteriori informazioni, consulta Creating services in AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzaredelete-namespace.

AWS CLI

Per eliminare un namespace

L'delete-namespaceesempio seguente elimina uno spazio dei nomi.

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

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
}

Per confermare che l'operazione è riuscita, puoi eseguire. get-operation Per ulteriori informazioni, vedere get-operation.

Per ulteriori informazioni, consulta Eliminazione dei namespace nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzaredelete-service.

AWS CLI

Per eliminare un servizio

L'delete-serviceesempio seguente elimina un servizio.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione dei servizi nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzarederegister-instance.

AWS CLI

Per annullare la registrazione di un'istanza del servizio

L'deregister-instanceesempio seguente annulla la registrazione di un'istanza di servizio.

aws servicediscovery deregister-instance \
    --service-id srv-p5zdwlg5uvvzjita \
    --instance-id myservice-53

Output:

{
    "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
}

Per confermare che l'operazione è riuscita, puoi eseguire. get-operation Per ulteriori informazioni, vedere get-operation.

Per ulteriori informazioni, consulta Annullamento della registrazione delle istanze di servizio nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzarediscover-instances.

AWS CLI

Per scoprire le istanze registrate

L'discover-instancesesempio seguente scopre le istanze registrate.

aws servicediscovery discover-instances \
    --namespace-name example.com \
    --service-name myservice \
    --max-results 10 \
    --health-status ALL

Output:

{
    "Instances": [
        {
            "InstanceId": "myservice-53",
            "NamespaceName": "example.com",
            "ServiceName": "myservice",
            "HealthStatus": "UNKNOWN",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "172.2.1.3",
                "AWS_INSTANCE_PORT": "808"
            }
        }
    ]
}

Il seguente esempio di codice mostra come utilizzareget-operation.

AWS CLI

Per ottenere il risultato di un'operazione

L'get-operationesempio seguente ottiene il risultato di un'operazione.

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

Output:

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

  • Per API i dettagli, vedere GetOperationin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-instances.

AWS CLI

Per elencare le istanze del servizio

L'list-instancesesempio seguente elenca le istanze del servizio.

aws servicediscovery list-instances \
    --service-id srv-qzpwvt2tfqcegapy

Output:

{
    "Instances": [
        {
            "Id": "i-06bdabbae60f65a4e",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "172.2.1.3",
                "AWS_INSTANCE_PORT": "808"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione di un elenco di istanze di servizio nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-namespaces.

AWS CLI

Per elencare i namespace

L'list-namespacesesempio seguente elenca i namespace.

aws servicediscovery list-namespaces

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione di un elenco di namespace nella AWS Cloud Map Developer Guide.

  • Per API i dettagli, consulta Command ListNamespacesReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarelist-services.

AWS CLI

Per elencare i servizi

L'list-servicesesempio seguente elenca i servizi.

aws servicediscovery list-services

Output:

{
    "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
        }
    ]
}

Per ulteriori informazioni, consulta Visualizzazione di un elenco di servizi nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareregister-instance.

AWS CLI

Per registrare un'istanza di servizio

L'register-instanceesempio seguente registra un'istanza di servizio.

aws servicediscovery register-instance \
    --service-id srv-p5zdwlg5uvvzjita \
    --instance-id myservice-53 \
    --attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808

Output:

{
    "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7"
}

Per confermare che l'operazione è riuscita, puoi eseguire. get-operation Per ulteriori informazioni, vedere get-operation.

Per ulteriori informazioni, consulta Registrazione delle istanze nella AWS Cloud Map Developer Guide.