AWS Cloud Map esempi di utilizzo 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 un namespace, consulta Creazione di uno spazio dei nomi AWS Cloud Map per raggruppare i servizi applicativi nella AWS Cloud Map Developer Guide.

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.

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 un namespace, consulta Creazione di uno spazio dei nomi AWS Cloud Map per raggruppare i servizi applicativi nella AWS Cloud Map Developer Guide.

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 il namespace ARN

L'create-serviceesempio seguente crea un servizio utilizzando un namespace 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 i namespace di Shared AWS Cloud Map nella Cloud Map Developer Guide. AWS

Esempio 1: 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 Cloud Map Developer Guide. AWS

Esempio 2: eliminare un namespace utilizzando namespace 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 Cloud Map nella AWS Cloud Map Developer Guide. AWS

Esempio 1: 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: eliminare un attributo di servizio utilizzando ARN

L'delete-service-attributesesempio seguente elimina un attributo di servizio utilizzando l'ARN del servizio. 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 i servizi AWS Cloud Map e gli spazi dei nomi Shared Cloud Map nella AWS Cloud Map Developer Guide. AWS

Esempio 1: 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: 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 Cloud Map Developer AWS Guide.

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 del servizio utilizzando l'ARN del servizio per i namespace condivisi

L'deregister-instanceesempio seguente annulla la registrazione di un'istanza del servizio utilizzando un ARN di servizio anziché un ID di servizio. È necessario specificare un ARN quando si annulla la registrazione delle istanze dai servizi creati nei 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 i namespace di Shared AWS Cloud Map e Annullamento della registrazione di un'istanza del servizio Cloud Map nella Cloud Map Developer Guide. AWS AWS

Esempio 1: per 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 un account proprietario specifico

L'discover-instances-revisionesempio seguente rileva la revisione delle istanze da un account proprietario specifico. Il parametro owner-account è necessario per le istanze nei namespace condivisi con il tuo account.

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

Output:

{
    "InstancesRevision": 1234567890
}

Per ulteriori informazioni, consulta i namespace di Shared AWS Cloud Map e le istanze del servizio Cloud Map nella AWS Cloud Map Developer Guide. AWS

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 di un account proprietario specifico

L'discover-instancesesempio seguente rileva le istanze registrate da un account proprietario specifico. Questo parametro è necessario per individuare le istanze nei namespace condivise con il tuo 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 i namespace di Shared AWS Cloud Map e le istanze del servizio Cloud Map nella AWS Cloud Map Developer Guide. AWS

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 namespace condivisi

L'get-instanceesempio seguente ottiene gli attributi di un'istanza utilizzando un ARN di servizio anziché un ID di servizio. È necessario specificare un ARN per ottenere i dettagli delle istanze associate ai namespace condivisi con il proprio account. L'istanza restituita in questo esempio è stata registrata da account 123456789111 in un namespace 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 i namespace di Shared Cloud Map nella AWS Cloud Map Developer Guide. AWS

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 namespace condivisi

L'get-instances-health-statusesempio seguente ottiene lo stato di integrità delle istanze utilizzando un ARN di servizio anziché un ID di 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 Cloud Map nella AWS Cloud Map Developer Guide. AWS

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 un namespace condiviso con il tuo 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 i namespace di Shared AWS Cloud Map nella Cloud Map Developer Guide. AWS

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: Per ottenere un'operazione da un account proprietario specifico

L'get-operationesempio seguente ottiene il risultato di un'operazione associata a un account proprietario specifico dello spazio dei nomi. 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 i namespace di Shared AWS Cloud Map nella Cloud Map Developer Guide. AWS

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 specifica di un ARN è necessaria per ottenere gli attributi di un servizio creato in un namespace condiviso con il tuo 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 i servizi AWS Cloud Map e gli spazi dei nomi Shared AWS Cloud Map nella Cloud Map Developer Guide. AWS

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 un namespace condiviso con il proprio account. L'account chiamante 123456789111 ha creato il servizio in un namespace 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 gli spazi dei nomi Shared AWS Cloud Map nella Cloud Map Developer Guide. AWS

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 Elenco delle 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 del servizio che utilizzano un ARN di servizio anziché un ID di 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 i namespace di Shared Cloud Map e le istanze del servizio Listing AWS Cloud Map nella Cloud Map Developer Guide. AWS AWS

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 Elenco dei namespace di AWS Cloud Map nella Cloud Map Developer Guide. AWS

Esempio 2: elencare i namespace condivisi da altri account

L'list-namespacesesempio seguente elenca i namespace 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 i namespace di Shared AWS Cloud Map nella Cloud Map Developer Guide. AWS

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 AWS Cloud Map Developer Guide.

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 Elenco dei 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 utilizzando 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 namespace e Listing Cloud Map services in a namespace nella AWS Cloud Map Developer Guide. AWS

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 Tagging your AWS Cloud Map nelle AWS Cloud Map Developer Guide.

Esempio 1: registrare un'istanza del 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, vedi 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 ARN di servizio. La specificazione dell'ARN è obbligatoria per la registrazione delle 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 i namespace di Shared Cloud Map nella AWS Cloud Map Developer Guide. AWS

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 Tagging your AWS Cloud Map nelle AWS Cloud Map Developer Guide.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging your AWS Cloud Map nelle AWS Cloud Map Developer Guide.

Esempio 1: per 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.

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 di integrità personalizzato utilizzando un servizio ARN. L'ARN è necessario per l'aggiornamento dello stato di integrità delle istanze associate ai namespace condivisi con l'account dell'utente.

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 dello stato del servizio AWS Cloud Map e la condivisione dello spazio dei nomi Cross-account AWS Cloud Map nella Cloud Map Developer Guide. AWS

Esempio 1: per 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.

Esempio 1: per 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: per 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.

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 il tuo 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 i servizi AWS Cloud Map e gli spazi dei nomi Shared Cloud Map nella AWS Cloud Map Developer Guide. AWS

Esempio 1: per 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: per 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 il tuo 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 Aggiornamento di un servizio AWS Cloud Map e dei namespace di Shared Cloud Map nella AWS Cloud Map Developer Guide. AWS