Esempi di AWS Cloud Map con la AWS CLI

Come creare un namespace HTTP

Nell’esempio seguente, create-http-namespace 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 Creating an AWS Cloud Map namespace to group application services nella Guida per gli sviluppatori di AWS Cloud Map.

Come creare un namespace DNS privato

Nell’esempio seguente, create-private-dns-namespace 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

Nell’esempio seguente, create-public-dns-namespace 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 Creating an AWS Cloud Map namespace to group application services nella Guida per gli sviluppatori di AWS Cloud Map.

Come creare un servizio

Nell’esempio seguente, create-service 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 Creazione dei servizi nella Guida per gli sviluppatori di AWS Cloud Map.

Come eliminare un namespace

L’esempio delete-namespace seguente elimina un namespace.

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

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
}

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

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

Come 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-e4anhexample0004 \
    --attributes Port

Questo comando non produce alcun output.

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

Come eliminare un servizio

Nell’esempio seguente, delete-service elimina un servizio.

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

Questo comando non produce alcun output.

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

Come 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, consulta get-operation.

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

Come rilevare la revisione di un’istanza

Nell’esempio seguente, discover-instances-revision 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 AWS Cloud Map service instances nella Guida per gli sviluppatori di AWS Cloud Map.

Come rilevare le istanze registrate

Nell’esempio seguente, discover-instances 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"
            }
        }
    ]
}

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

Come 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:

{
    "Instances": {
        "Id": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
        "Attributes": {
            "AWS_INSTANCE_IPV4": "192.0.2.44",
            "AWS_INSTANCE_PORT": "80",
            "color": "green",
            "region": "us-west-2",
            "stage": "beta"
        }
    }
}

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

Come ottenere lo stato di integrità delle istanze associate a un servizio

Nell’esempio seguente, get-instances-health-status 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 AWS Cloud Map service instances nella Guida per gli sviluppatori di AWS Cloud Map.

Come ottenere i dettagli di un namespace

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

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

Output:

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

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

Come ottenere il risultato di un’operazione

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

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 ulteriori informazioni, consulta Creating an AWS Cloud Map namespace to group application services nella Guida per gli sviluppatori di AWS Cloud Map.

Come 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-e4anhexample0004

Output:

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

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

Come ottenere le impostazioni di un servizio

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

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

Output:

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

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

Come elencare le istanze del servizio

Nell’esempio seguente, list-instances 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 Viewing a list of service instances nella Guida per gli sviluppatori di AWS Cloud Map.

Come elencare namespace

Nell’esempio seguente, list-namespaces 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 Viewing a list of namespaces nella Guida per gli sviluppatori di AWS Cloud Map.

Come elencare le operazioni che soddisfano i criteri specificati

Nell’esempio seguente, list-operations 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.

Come elencare i servizi

Nell’esempio seguente, list-services 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 Viewing a list of services nella Guida per gli sviluppatori di AWS Cloud Map.

Come elencare i tag associati alle risorse specificate

Nell’esempio seguente, list-tags-for-resource 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 resources nella Guida per gli sviluppatori di AWS Cloud Map.

Come registrare un’istanza del servizio

Nell’esempio seguente, register-instance 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, consulta Registrazione delle istanze nella Guida per gli sviluppatori di AWS Cloud Map.

Come associare i tag alle risorse specificate

Nell’esempio seguente, tag-resource 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 resources nella Guida per gli sviluppatori di AWS Cloud Map.

Come rimuovere i tag dalla risorsa specificata

Nell’esempio seguente, untag-resource 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 Tagging your AWS Cloud Map resources nella Guida per gli sviluppatori di AWS Cloud Map.

Come aggiornare un namespace HTTP

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

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

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 AWS Cloud Map namespaces nella Guida per gli sviluppatori di AWS Cloud Map.

Come aggiornare un controllo dell’integrità personalizzato

Nell’esempio seguente, update-instance-custom-health-status 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 AWS Cloud Map service health check configuration nella Guida per gli sviluppatori di AWS Cloud Map.

Come aggiornare un namespace DNS privato

Nell’esempio seguente, update-private-dns-namespace aggiorna la descrizione di un namespace DNS privato.

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

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

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

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

Come aggiornare un namespace DNS pubblico

Nell’esempio seguente, update-public-dns-namespace aggiorna la descrizione di un namespace DNS pubblico.

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

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

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

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

Come aggiornare un servizio per l’aggiunta di un attributo

Nell’esempio seguente update-service-attributes 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-e4anhexample0004 \
    --attributes Port=80

Questo comando non produce alcun output.

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

Come aggiornare un servizio

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

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

Output:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

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

Per ulteriori informazioni sull’aggiornamento di un servizio, consulta Updating an AWS Cloud Map service nella Guida per gli sviluppatori di AWS Cloud Map.