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

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 azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-http-namespace.

AWS CLI

Come creare un namespace HTTP

L’esempio create-http-namespace seguente crea un namespace HTTP denominato example.com.

aws servicediscovery create-http-namespace \
    --name example.com \
    --creator-request-id example-request-id

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation. Per ulteriori informazioni, consulta get-operation.

Per ulteriori informazioni sulla creazione di uno spazio dei nomi, vedere Creating an AWS Cloud Map namespace per raggruppare i servizi applicativi nella AWS Cloud Map Developer Guide.

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

AWS CLI

Come creare un namespace DNS privato

L’esempio create-private-dns-namespace seguente crea un namespace DNS privato.

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

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation. Per ulteriori informazioni, consulta get-operation.

Per ulteriori informazioni, consulta Creazione degli spazi dei nomi nella Guida per gli sviluppatori di AWS Cloud Map.

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

AWS CLI

Come creare un namespace DNS pubblico

L’esempio create-public-dns-namespace seguente crea un namespace DNS pubblico denominato 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}}

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation.

Per ulteriori informazioni sulla creazione di uno spazio dei nomi, vedere Creating an AWS Cloud Map namespace per raggruppare i servizi applicativi nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzarecreate-service.

AWS CLI

Esempio 1: creare un servizio utilizzando l'ID dello spazio dei nomi

L’esempio create-service seguente crea un servizio.

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

Output:

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

Per ulteriori informazioni, consulta Creazione di un servizio AWS Cloud Map per un componente applicativo nella AWS Cloud Map Developer Guide.

Esempio 2: creare un servizio utilizzando lo spazio dei nomi ARN

L'create-serviceesempio seguente crea un servizio utilizzando uno spazio dei nomi ARN anziché un ID dello spazio dei nomi. La specificazione di un namespace ARN è necessaria quando si crea un servizio in uno spazio dei nomi condiviso.

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

Output:

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

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

  • Per i dettagli sull'API, consulta Command CreateServiceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-namespace.

AWS CLI

Esempio 1: Per eliminare un namespace

L’esempio delete-namespace seguente elimina un namespace.

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

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation. Per ulteriori informazioni, consulta get-operation.

Per ulteriori informazioni, consulta Eliminazione di uno spazio dei nomi AWS Cloud Map nella AWS Cloud Map Developer Guide.

Esempio 2: Per eliminare uno spazio dei nomi utilizzando lo spazio dei nomi ARN

L'delete-namespaceesempio seguente elimina uno spazio dei nomi utilizzando il relativo ARN.

aws servicediscovery delete-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per ulteriori informazioni, consulta Eliminazione di uno spazio dei nomi AWS Cloud Map nella AWS Cloud Map Developer Guide.

  • Per i dettagli sull'API, consulta Command DeleteNamespaceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-service-attributes.

AWS CLI

Esempio 1: Per eliminare un attributo di servizio

L’esempio delete-service-attributes seguente elimina un attributo di servizio con la chiave Port associata al servizio specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Servizi AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: Per eliminare un attributo di servizio utilizzando ARN

L'delete-service-attributesesempio seguente elimina un attributo di servizio utilizzando il servizio ARN. La specificazione dell'ARN è necessaria per eliminare gli attributi associati ai servizi creati nei namespace condivisi con l'account.

aws servicediscovery delete-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --attributes Port

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta AWS Cloud Map services e Shared AWS Cloud Map namespace nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzaredelete-service.

AWS CLI

Esempio 1: Per eliminare un servizio

L’esempio delete-service seguente elimina un segreto.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione di un servizio AWS Cloud Map nella AWS Cloud Map Developer Guide.

Esempio 2: Per eliminare un servizio utilizzando ARN

L'delete-serviceesempio seguente elimina un servizio utilizzando il relativo ARN.

aws servicediscovery delete-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminazione di un servizio AWS Cloud Map nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzarederegister-instance.

AWS CLI

Esempio 1: annullare la registrazione di un'istanza del servizio

L’esempio deregister-instance seguente annulla la registrazione di un’istanza del 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 il comando get-operation. Per ulteriori informazioni, vedere get-operation.

Per ulteriori informazioni, consulta Annullare la registrazione delle istanze del servizio nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: annullare la registrazione di un'istanza di servizio utilizzando il servizio ARN per gli spazi dei nomi condivisi

L'deregister-instanceesempio seguente annulla la registrazione di un'istanza di servizio utilizzando un ARN del servizio anziché l'ID del servizio. È necessario specificare un ARN quando si annullano le istanze dai servizi creati in namespace condivisi con l'account.

aws servicediscovery deregister-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01

Output:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Per ulteriori informazioni, consulta Shared AWS Cloud Map namespace e Annullamento della registrazione di un'istanza del servizio Cloud AWS Map nella Cloud Map Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarediscover-instances-revision.

AWS CLI

Esempio 1: scoprire la revisione di un'istanza

L’esempio discover-instances-revision seguente rileva la revisione crescente di un’istanza.

aws servicediscovery discover-instances-revision \
    --namespace-name example.com \
    --service-name myservice

Output:

{
    "InstancesRevision": 123456
}

Per ulteriori informazioni, consulta Istanze del servizio AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: per scoprire la revisione delle istanze da uno specifico account proprietario

L'discover-instances-revisionesempio seguente rileva la revisione delle istanze di uno specifico account proprietario. Il parametro owner-account è necessario per le istanze nei namespace condivisi con l'account.

aws servicediscovery discover-instances-revision \
    --namespace-name shared-namespace \
    --service-name shared-service \
    --owner-account 123456789111

Output:

{
    "InstancesRevision": 1234567890
}

Per ulteriori informazioni, consulta gli spazi dei nomi Shared AWS Cloud Map e le istanze del servizio AWS Cloud Map nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzarediscover-instances.

AWS CLI

Esempio 1: per scoprire le istanze registrate

L’esempio discover-instances seguente rileva 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"
            }
        }
    ],
    "InstancesRevision": 85648075627387284
}

Per ulteriori informazioni, consulta Istanze del servizio AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: per scoprire le istanze da uno specifico account proprietario

L'discover-instancesesempio seguente scopre le istanze registrate da uno specifico account proprietario. Questo parametro è necessario per individuare le istanze nei namespace condivisi con l'account.

aws servicediscovery discover-instances \
    --namespace-name shared-namespace \
    --service-name shared-service \
    --owner-account 123456789111

Output:

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

Per ulteriori informazioni, consulta gli spazi dei nomi Shared AWS Cloud Map e le istanze del servizio AWS Cloud Map nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-instance.

AWS CLI

Esempio 1: per ottenere i dettagli di un'istanza

L’esempio get-instance seguente ottiene gli attributi di un servizio.

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

Output:

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

Per ulteriori informazioni, consulta Istanze del servizio AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: per ottenere i dettagli di un'istanza utilizzando il servizio ARN per gli spazi dei nomi condivisi

L'get-instanceesempio seguente ottiene gli attributi di un'istanza utilizzando un servizio ARN anziché un ID di servizio. È necessario specificare un ARN per ottenere i dettagli delle istanze associate ai namespace condivisi con l'account. L'istanza restituita in questo esempio è stata registrata per account 123456789111 in uno spazio dei nomi di proprietà dell'account. 123456789012

aws servicediscovery get-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01

Output:

{
    "ResourceOwner": "123456789012",
    "Instance": {
        "Id": "web-server-01",
        "Attributes": {
            "AWS_INSTANCE_IPV4": "203.0.113.15",
            "AWS_INSTANCE_PORT": "80"
        },
        "CreatedByAccount": "123456789111"
    }
}

Per ulteriori informazioni sulla condivisione dello spazio dei nomi tra account, consulta Shared AWS Cloud Map namespaces nella Cloud Map Developer Guide.AWS

  • Per i dettagli sull'API, consulta Command Reference. GetInstanceAWS CLI

Il seguente esempio di codice mostra come utilizzareget-instances-health-status.

AWS CLI

Esempio 1: per ottenere lo stato di integrità delle istanze associate a un servizio

L’esempio get-instances-health-status seguente ottiene lo stato dell’integrità delle istanze associate al servizio specificato.

aws servicediscovery get-instances-health-status \
    --service-id srv-e4anhexample0004

Output:

{
    "Status": {
        "i-abcd1234": "HEALTHY",
        "i-abcd1235": "UNHEALTHY"
    }
}

Per ulteriori informazioni, consulta Istanze del servizio AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: per ottenere lo stato di integrità delle istanze utilizzando il servizio ARN per gli spazi dei nomi condivisi

L'get-instances-health-statusesempio seguente ottiene lo stato di integrità delle istanze che utilizzano un ARN del servizio anziché l'ID del servizio. È necessario specificare un ARN per ottenere lo stato di integrità delle istanze associate ai namespace condivisi con l'account del richiedente.

aws servicediscovery get-instances-health-status \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita

Output:

{
    "Status": {
        "web-server-01": "HEALTHY",
        "web-server-02": "UNHEALTHY"
    }
}

Per ulteriori informazioni, consulta le istanze del servizio AWS Cloud Map e gli spazi dei nomi Shared AWS Cloud Map nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-namespace.

AWS CLI

Esempio 1: Per ottenere i dettagli di un namespace

L’esempio get-namespace seguente recupera le informazioni relative al namespace specificato.

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

Output:

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

Per ulteriori informazioni, consulta Namespace AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: Per ottenere i dettagli di un namespace utilizzando ARN

L'get-namespaceesempio seguente recupera le informazioni sullo spazio dei nomi specificato utilizzando il relativo ARN. La specificazione dell'ARN è necessaria per recuperare i dettagli di uno spazio dei nomi condiviso con l'account.

aws servicediscovery get-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678

Output:

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

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

  • Per i dettagli sull'API, consulta Command GetNamespaceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareget-operation.

AWS CLI

Esempio 1: Per ottenere il risultato di un'operazione

L’esempio get-operation seguente ottiene il risultato di un’operazione di creazione del namespace.

aws servicediscovery get-operation \
    --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234

Output:

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

Per ulteriori informazioni, consulta Creazione di uno spazio dei nomi AWS Cloud Map per raggruppare i servizi applicativi nella AWS Cloud Map Developer Guide.

Esempio 2: ottenere un'operazione da un account proprietario specifico

L'get-operationesempio seguente ottiene il risultato di un'operazione associata a un account proprietario del namespace specifico. Questo parametro è necessario per ottenere il risultato delle operazioni associate ai namespace condivisi con l'account.

aws servicediscovery get-operation \
    --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \
    --owner-account 123456789111

Output:

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

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

  • Per i dettagli sull'API, consulta Command GetOperationReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareget-service-attributes.

AWS CLI

Esempio 1: Per ottenere gli attributi di un servizio

L’esempio get-service-attributes seguente ottiene gli attributi di un servizio.

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

Output:

{
    "ServiceAttributes": {
        "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Attributes": {
            "Port": "80"
        }
    }
}

Per ulteriori informazioni, consulta Servizi AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: Per ottenere gli attributi di un servizio utilizzando ARN

L'get-service-attributesesempio seguente ottiene gli attributi di un servizio utilizzando il relativo ARN. La specificazione di un ARN è necessaria per ottenere gli attributi di un servizio creato in uno spazio dei nomi condiviso con l'account.

aws servicediscovery get-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Output:

{
    "ServiceAttributes": {
        "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Attributes": {
            "Port": "80"
        }
    }
}

Per ulteriori informazioni, consulta AWS Cloud Map services e Shared AWS Cloud Map namespace nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-service.

AWS CLI

Esempio 1: Per ottenere le impostazioni di un servizio

L’esempio get-service seguente ottiene le impostazioni di un servizio specificato.

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

Output:

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

Per ulteriori informazioni, consulta Servizi AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: Per ottenere le impostazioni di un servizio utilizzando ARN

L'get-serviceesempio seguente ottiene le impostazioni di un servizio specificato utilizzando il relativo ARN. La specificazione dell'ARN è necessaria per recuperare informazioni su un servizio creato in uno spazio dei nomi condiviso con l'account. L'account chiamante 123456789111 ha creato il servizio in uno spazio dei nomi condiviso dall'account. 123456789012

aws servicediscovery get-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Output:

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

Per ulteriori informazioni, consulta Creazione di un servizio AWS Cloud Map per un componente applicativo e Shared AWS Cloud Map namespace nella AWS Cloud Map Developer Guide.

  • Per i dettagli sull'API, consulta Command GetServiceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarelist-instances.

AWS CLI

Esempio 1: per elencare le istanze del servizio

L’esempio list-instances 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"
            },
            "CreatedByAccount": "123456789012"
        }
    ],
    "ResourceOwner": "123456789012"
}

Per ulteriori informazioni, consulta Elencare le istanze del servizio AWS Cloud Map nella AWS Cloud Map Developer Guide.

Esempio 2: elencare le istanze del servizio utilizzando il servizio ARN

L'list-instancesesempio seguente elenca le istanze di servizio che utilizzano un ARN del servizio anziché l'ID del servizio. È necessario specificare un ARN quando si elencano le istanze associate ai namespace condivisi con l'account.

aws servicediscovery list-instances \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita

Output:

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

Per ulteriori informazioni sulla condivisione dello spazio dei nomi tra account, consulta Shared AWS Cloud Map namespaces e Elenco delle istanze del servizio Cloud AWS Map nella Cloud Map Developer Guide.AWS

  • Per i dettagli sull'API, consulta Command Reference. ListInstancesAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-namespaces.

AWS CLI

Esempio 1: Per elencare i namespace

L’esempio list-namespaces seguente elenca i namespace.

aws servicediscovery list-namespaces

Output:

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

Per ulteriori informazioni, consulta Elencare gli spazi dei nomi di AWS Cloud Map nella AWS Cloud Map Developer Guide.

Esempio 2: per elencare i namespace condivisi da altri account

L'list-namespacesesempio seguente elenca gli spazi dei nomi condivisi con l'account chiamante da altri account utilizzando il filtro. AWS RESOURCE_OWNER

aws servicediscovery list-namespaces \
    --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ

Output:

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

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

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

Il seguente esempio di codice mostra come utilizzarelist-operations.

AWS CLI

Come elencare le operazioni che soddisfano i criteri specificati

L’esempio list-operations seguente elenca le operazioni il cui stato è PENDING o SUCCESS.

aws servicediscovery list-operations \
    --service-id srv-e4anhexample0004 \
    --filters Name=STATUS,Condition=IN,Values=PENDING,SUCCESS

Output:

{
    "Operations": [
        {
            "Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample",
            "Status": "SUCCESS"
        },
        {
            "Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample",
            "Status": "SUCCESS"
        },
        {
            "Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example",
            "Status": "PENDING"
        }
    ]
}

Per ulteriori informazioni, consulta Cos'è AWS Cloud Map? nella Guida per gli sviluppatori di AWS Cloud Map.

Il seguente esempio di codice mostra come utilizzarelist-services.

AWS CLI

Esempio 1: Per elencare i servizi

L’esempio list-services 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 Elencare i servizi AWS Cloud Map in un namespace nella AWS Cloud Map Developer Guide.

Esempio 2: per elencare i servizi creati in namespace condivisi

L'list-servicesesempio seguente elenca i servizi creati in namespace condivisi con l'account chiamante da altri account 123456789012 che utilizzano il filtro. AWS RESOURCE_OWNER

aws servicediscovery list-services \
    --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ

Output:

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

Per ulteriori informazioni, consulta Shared AWS Cloud Map namespaces e Listing AWS Cloud Map services in un namespace nella Cloud Map AWS Developer Guide.

  • Per i dettagli sull'API, consulta Command Reference. ListServicesAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag associati alle risorse specificate

L’esempio list-tags-for-resource seguente elenca i tag della risorsa specificata.

aws servicediscovery list-tags-for-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004

Output:

{
    "Tags": [
        {
            "Key": "Project",
            "Value": "Zeta"
        },
        {
            "Key": "Department",
            "Value": "Engineering"
        }
    ]
}

Per ulteriori informazioni, consulta Taggare le risorse di AWS Cloud Map nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareregister-instance.

AWS CLI

Esempio 1: registrare un'istanza di servizio utilizzando l'ID del servizio

L’esempio register-instance seguente registra un’istanza del 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 il comando get-operation. Per ulteriori informazioni, consulta get-operation.

Per ulteriori informazioni sulla registrazione di un'istanza, consulta Registrazione di una risorsa come istanza del servizio AWS Cloud Map nella AWS Cloud Map Developer Guide.

Esempio 2: registrare un'istanza di servizio utilizzando il servizio ARN

L'register-instanceesempio seguente registra un'istanza di servizio utilizzando un servizio ARN. È necessario specificare l'ARN quando si registrano istanze nei servizi condivisi con l'account.

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

Output:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Per ulteriori informazioni sulla condivisione dello spazio dei nomi tra account, consulta Shared AWS Cloud Map namespaces nella Cloud Map Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come associare i tag alle risorse specificate

L’esempio tag-resource seguente associa un tag Department al valore Engineering del namespace specificato.

aws servicediscovery tag-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
    --tags Key=Department, Value=Engineering

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le risorse di AWS Cloud Map nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere i tag dalla risorsa specificata

L’esempio untag-resource seguente rimuove un tag Department dal namespace specificato.

aws servicediscovery untag-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
    --tags Key=Department, Value=Engineering

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le risorse di AWS Cloud Map nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareupdate-http-namespace.

AWS CLI

Esempio 1: aggiornare uno spazio dei nomi HTTP

L’esempio update-http-namespace seguente aggiorna la descrizione del namespace HTTP specificato.

aws servicediscovery update-http-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation. Per ulteriori informazioni, consulta get-operation.

Per ulteriori informazioni, consulta Namespace AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: aggiornare uno spazio dei nomi HTTP utilizzando ARN

L'update-http-namespaceesempio seguente aggiorna lo spazio dei nomi HTTP specificato utilizzando il relativo 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."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per ulteriori informazioni, consulta Namespace AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Il seguente esempio di codice mostra come utilizzareupdate-instance-custom-health-status.

AWS CLI

Esempio 1: Per aggiornare un controllo sanitario personalizzato

L’esempio update-instance-custom-health-status seguente aggiorna lo stato del controllo dell’integrità personalizzato per il servizio specificato e l’istanza del servizio di esempio impostandolo su HEALTHY.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Configurazione del controllo dell’integrità del servizio AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: Aggiornare un controllo sanitario personalizzato utilizzando il servizio ARN

L'update-instance-custom-health-statusesempio seguente aggiorna lo stato del controllo sanitario personalizzato utilizzando un servizio ARN. L'ARN è necessario per aggiornare lo stato di integrità delle istanze associate ai namespace condivisi con l'account.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta la configurazione del controllo dello stato del servizio AWS Cloud Map e la condivisione dello spazio dei nomi AWS Cloud Map tra account nella AWS Cloud Map Developer Guide.

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

AWS CLI

Esempio 1: aggiornare uno spazio dei nomi DNS privato utilizzando ID

L'update-private-dns-namespaceesempio seguente aggiorna la descrizione di uno spazio dei nomi DNS privato utilizzando l'ID dello spazio dei nomi.

aws servicediscovery update-private-dns-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation.

Per ulteriori informazioni, consulta Namespace AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: per aggiornare uno spazio dei nomi DNS privato utilizzando ARN

L'update-private-dns-namespaceesempio seguente aggiorna uno spazio dei nomi DNS privato utilizzando il relativo 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."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per ulteriori informazioni, consulta Namespace AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Il seguente esempio di codice mostra come utilizzareupdate-public-dns-namespace.

AWS CLI

Esempio 1: aggiornare uno spazio dei nomi DNS pubblico utilizzando ID

L'update-public-dns-namespaceesempio seguente aggiorna la descrizione di uno spazio dei nomi DNS pubblico utilizzando il relativo ID.

aws servicediscovery update-public-dns-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation.

Per ulteriori informazioni, consulta Namespace AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: aggiornare uno spazio dei nomi DNS pubblico utilizzando ARN

L'update-public-dns-namespaceesempio seguente aggiorna uno spazio dei nomi DNS pubblico utilizzando il relativo 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."

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per ulteriori informazioni, consulta Namespace AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Il seguente esempio di codice mostra come utilizzareupdate-service-attributes.

AWS CLI

Esempio 1: aggiornare un servizio per aggiungere un attributo

L’esempio update-service-attributes seguente aggiorna il servizio specificato in modo che venga aggiunto un attributo di servizio con una chiave Port e un valore 80.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Servizi AWS Cloud Map nella Guida per gli sviluppatori di AWS Cloud Map.

Esempio 2: aggiornare gli attributi di un servizio utilizzando ARN

L'update-service-attributesesempio seguente aggiorna un servizio utilizzando il relativo ARN per aggiungere un attributo di servizio. La specificazione dell'ARN è necessaria per aggiungere attributi ai servizi creati nei namespace condivisi con l'account.

aws servicediscovery update-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --attributes Port=80

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta AWS Cloud Map services e Shared AWS Cloud Map namespace nella AWS Cloud Map Developer Guide.

Il seguente esempio di codice mostra come utilizzareupdate-service.

AWS CLI

Esempio 1: aggiornare un servizio

L’esempio update-service seguente aggiorna un servizio in modo che vengano aggiornate le impostazioni DnsConfig e HealthCheckConfig.

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

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per confermare che l’operazione è riuscita, puoi eseguire il comando get-operation.

Per ulteriori informazioni sull'aggiornamento di un servizio, consulta Aggiornamento di un servizio AWS Cloud Map nella AWS Cloud Map Developer Guide.

Esempio 2: Aggiornare un servizio utilizzando ARN

L'update-serviceesempio seguente aggiorna un servizio utilizzando il relativo ARN. La specificazione di un ARN è necessaria per i servizi creati in namespace condivisi con l'account.

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

Output:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Per ulteriori informazioni sull'aggiornamento di un servizio, consulta Updating an AWS Cloud Map service e Shared AWS Cloud Map namespace nella AWS Cloud Map Developer Guide.

  • Per i dettagli sull'API, consulta Command UpdateServiceReference AWS CLI .