View a markdown version of this page

AWS Cloud Map Beispiele unter Verwendung AWS CLI - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im AWS Doc SDK Examples GitHub Repo verfügbar.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS Cloud Map Beispiele unter Verwendung AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und gängige Szenarien implementieren AWS Cloud Map.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungcreate-http-namespace.

AWS CLI

So erstellen Sie einen HTTP-Namespace

Im folgenden create-http-namespace-Beispiel wird ein HTTP-Namespace example.com erstellt.

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

Ausgabe:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation.

Weitere Informationen zum Erstellen eines Namespaces finden Sie unter Einen AWS Cloud Map-Namespace zum Gruppieren von Anwendungsdiensten erstellen im AWS Cloud Map Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-private-dns-namespace.

AWS CLI

So erstellen Sie einen privaten DNS-Namespace

Im folgenden create-private-dns-namespace-Beispiel wird ein privater DNS-Namespace erstellt.

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

Ausgabe:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation.

Weitere Informationen finden Sie unter Erstellen von Namespaces im AWS -Cloud Map-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcreate-public-dns-namespace.

AWS CLI

So erstellen Sie einen öffentlichen DNS-Namespace

Im folgenden create-public-dns-namespace-Beispiel wird ein öffentlicher DNS-Namespace example.com erstellt.

aws servicediscovery create-public-dns-namespace \
    --name example-public-dns.com \
    --creator-request-id example-public-request-id \
    --properties DnsProperties={SOA={TTL=60}}

Ausgabe:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war.

Weitere Informationen zum Erstellen eines Namespaces finden Sie unter Einen AWS Cloud Map-Namespace zum Gruppieren von Anwendungsdiensten erstellen im AWS Cloud Map Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-service.

AWS CLI

Beispiel 1: Um einen Dienst mithilfe der Namespace-ID zu erstellen

Im folgenden create-service-Beispiel wird ein Service erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Einen AWS Cloud Map-Dienst für eine Anwendungskomponente erstellen im AWS Cloud Map Developer Guide.

Beispiel 2: So erstellen Sie einen Dienst mithilfe des Namespace-ARN

Im folgenden create-service Beispiel wird ein Dienst erstellt, der einen Namespace-ARN anstelle einer Namespace-ID verwendet. Die Angabe eines Namespace-ARN ist erforderlich, wenn Sie einen Dienst in einem gemeinsam genutzten Namespace erstellen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Shared AWS Cloud Map-Namespaces im Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendungdelete-namespace.

AWS CLI

Beispiel 1: Um einen Namespace zu löschen

Im folgenden delete-namespace-Beispiel wird ein Namespace gelöscht.

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

Ausgabe:

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

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation.

Weitere Informationen finden Sie im Cloud Map-Entwicklerhandbuch unter Löschen eines AWS Cloud Map-Namespaces. AWS

Beispiel 2: So löschen Sie einen Namespace mithilfe des Namespace-ARN

Im folgenden delete-namespace Beispiel wird ein Namespace mithilfe seines ARN gelöscht.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Löschen eines AWS Cloud Map-Namespaces im Cloud AWS Map-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt die Verwendung. delete-service-attributes

AWS CLI

Beispiel 1: Um ein Serviceattribut zu löschen

Im folgenden delete-service-attributes-Beispiel wird ein Serviceattribut mit dem Schlüssel Port gelöscht, das dem angegebenen Service zugeordnet ist.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Services von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um ein Serviceattribut mithilfe von ARN zu löschen

Im folgenden delete-service-attributes Beispiel wird ein Dienstattribut mithilfe des Dienst-ARN gelöscht. Die Angabe des ARN ist erforderlich, um Attribute zu löschen, die Diensten zugeordnet sind, die in Namespaces erstellt wurden, die mit Ihrem Konto gemeinsam genutzt werden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter AWS Cloud Map-Dienste und Shared Cloud Map-Namespaces im AWS Cloud Map-Entwicklerhandbuch. AWS

Das folgende Codebeispiel zeigt die Verwendung. delete-service

AWS CLI

Beispiel 1: Um einen Dienst zu löschen

Im folgenden Beispiel für delete-service wird ein Service gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS Cloud Map-Entwicklerhandbuch unter Löschen eines AWS Cloud Map-Dienstes.

Beispiel 2: Um einen Dienst mithilfe von ARN zu löschen

Im folgenden delete-service Beispiel wird ein Dienst mithilfe seines ARN gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS Cloud Map-Entwicklerhandbuch unter Löschen eines AWS Cloud Map-Dienstes.

Das folgende Codebeispiel zeigt die Verwendung. deregister-instance

AWS CLI

Beispiel 1: Um die Registrierung einer Dienstinstanz aufzuheben

Im folgenden deregister-instance-Beispiel wird die Registrierung einer Service-Instance aufgehoben.

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

Ausgabe:

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

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation.

Weitere Informationen finden Sie unter Registrierung einer Service Instance aufheben im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um die Registrierung einer Dienstinstanz mithilfe des Dienst-ARN für gemeinsam genutzte Namespaces aufzuheben

Im folgenden deregister-instance Beispiel wird die Registrierung einer Dienstinstanz mithilfe eines Dienst-ARN anstelle einer Dienst-ID aufgehoben. Die Angabe eines ARN ist erforderlich, wenn Instanzen von Diensten, die in Namespaces erstellt wurden, die mit Ihrem Konto gemeinsam genutzt werden, deregistriert werden.

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

Ausgabe:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Weitere Informationen finden Sie unter Gemeinsam genutzte AWS Cloud Map-Namespaces und Abmelden einer Cloud Map-Service-Instanz im AWS Cloud Map-Entwicklerhandbuch. AWS

Das folgende Codebeispiel zeigt die Verwendung. discover-instances-revision

AWS CLI

Beispiel 1: Um die Revision einer Instanz zu ermitteln

Im folgenden discover-instances-revision-Beispiel wird die zunehmende Revision einer Instance gefunden.

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

Ausgabe:

{
    "InstancesRevision": 123456
}

Weitere Informationen finden Sie unter Service-Instances von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um die Revision von Instanzen von einem bestimmten Eigentümerkonto aus zu ermitteln

Im folgenden discover-instances-revision Beispiel wird die Revision von Instances aus einem bestimmten Eigentümerkonto ermittelt. Der Parameter owner-account ist für Instanzen in Namespaces erforderlich, die mit Ihrem Konto gemeinsam genutzt werden.

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

Ausgabe:

{
    "InstancesRevision": 1234567890
}

Weitere Informationen finden Sie unter Gemeinsam genutzte AWS Cloud Map-Namespaces und AWS Cloud Map-Service-Instanzen im AWS Cloud Map Developer Guide.

Das folgende Codebeispiel zeigt die Verwendung. discover-instances

AWS CLI

Beispiel 1: Um registrierte Instanzen zu ermitteln

Im folgenden discover-instances-Beispiel werden registrierte Instances gefunden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Service-Instances von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um Instanzen von einem bestimmten Eigentümerkonto aus zu ermitteln

Im folgenden discover-instances Beispiel werden registrierte Instances aus einem bestimmten Eigentümerkonto erkannt. Dieser Parameter ist erforderlich, um Instanzen in Namespaces zu erkennen, die mit Ihrem Konto gemeinsam genutzt werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Gemeinsam genutzte AWS Cloud Map-Namespaces und AWS Cloud Map-Service-Instanzen im Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendungget-instance.

AWS CLI

Beispiel 1: Um die Details einer Instanz abzurufen

Im folgenden get-instance-Beispiel werden die Attribute eines Services abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Service-Instances von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um die Details einer Instanz mithilfe des Service-ARN für gemeinsam genutzte Namespaces abzurufen

Im folgenden get-instance Beispiel werden die Attribute einer Instanz abgerufen, die einen Service-ARN anstelle einer Service-ID verwendet. Die Angabe eines ARN ist erforderlich, um Details zu Instanzen abzurufen, die Namespaces zugeordnet sind, die mit Ihrem Konto gemeinsam genutzt werden. Die in diesem Beispiel zurückgegebene Instanz wurde von einem Konto 123456789111 in einem Namespace registriert, der dem Konto gehört. 123456789012

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

Ausgabe:

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

Weitere Informationen zur kontoübergreifenden gemeinsamen Nutzung von Namespaces finden Sie unter Shared AWS Cloud Map-Namespaces im Cloud Map Developer Guide. AWS

  • API-Details finden Sie in der Befehlsreferenz. GetInstance AWS CLI

Das folgende Codebeispiel zeigt die Verwendung. get-instances-health-status

AWS CLI

Beispiel 1: Um den Integritätsstatus von Instances abzurufen, die einem Service zugeordnet sind

Im folgenden get-instances-health-status-Beispiel wird der Integritätsstatus von Instances abgerufen, die dem angegebenen Service zugeordnet sind.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Service-Instances von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um den Integritätsstatus von Instanzen mithilfe des Service-ARN für gemeinsam genutzte Namespaces abzurufen

Im folgenden get-instances-health-status Beispiel wird der Integritätsstatus von Instanzen abgerufen, die einen Service-ARN anstelle einer Service-ID verwenden. Die Angabe eines ARN ist erforderlich, um den Integritätsstatus für Instanzen abzurufen, die Namespaces zugeordnet sind, die mit dem Konto des Anforderers gemeinsam genutzt werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter AWS Cloud Map-Serviceinstanzen und Shared Cloud Map-Namespaces im AWS Cloud Map-Entwicklerhandbuch. AWS

Das folgende Codebeispiel zeigt die Verwendungget-namespace.

AWS CLI

Beispiel 1: Um die Details eines Namespaces abzurufen

Im folgenden get-namespace-Beispiel werden Informationen zu den angegebenen Namespace abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Namespaces von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um die Details eines Namespaces mithilfe von ARN abzurufen

Das folgende get-namespace Beispiel ruft Informationen über den angegebenen Namespace mithilfe seines ARN ab. Die Angabe des ARN ist erforderlich, um Details eines Namespaces abzurufen, der mit Ihrem Konto gemeinsam genutzt wird.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Shared AWS Cloud Map-Namespaces im Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendungget-operation.

AWS CLI

Beispiel 1: Um das Ergebnis einer Operation zu erhalten

Im folgenden get-operation-Beispiel wird das Ergebnis einer Operation zur Erstellung eines Namespaces abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie im AWS Cloud Map Developer Guide unter Einen Cloud Map-Namespace zum Gruppieren von Anwendungsdiensten erstellen. AWS

Beispiel 2: Um einen Vorgang von einem bestimmten Eigentümerkonto aus abzurufen

Im folgenden get-operation Beispiel wird das Ergebnis eines Vorgangs abgerufen, der einem bestimmten Namespace-Eigentümerkonto zugeordnet ist. Dieser Parameter ist erforderlich, um das Ergebnis von Vorgängen abzurufen, die mit Namespaces verknüpft sind, die mit Ihrem Konto gemeinsam genutzt werden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Shared AWS Cloud Map-Namespaces im Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendung. get-service-attributes

AWS CLI

Beispiel 1: Um die Attribute eines Dienstes abzurufen

Im folgenden get-service-attributes-Beispiel werden die Attribute eines Services abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Services von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um die Attribute eines Dienstes mithilfe von ARN abzurufen

Im folgenden get-service-attributes Beispiel werden die Attribute eines Dienstes anhand seines ARN abgerufen. Die Angabe eines ARN ist erforderlich, um die Attribute eines Dienstes abzurufen, der in einem Namespace erstellt wurde, der mit Ihrem Konto gemeinsam genutzt wird.

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

Ausgabe:

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

Weitere Informationen finden Sie unter AWS Cloud Map-Dienste und Shared AWS Cloud Map-Namespaces im AWS Cloud Map-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungget-service.

AWS CLI

Beispiel 1: Um die Einstellungen eines Dienstes abzurufen

Im folgenden get-service-Beispiel werden die Einstellungen des angegebenen Services abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Services von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um die Einstellungen eines Dienstes mithilfe von ARN abzurufen

Im folgenden get-service Beispiel werden die Einstellungen eines angegebenen Dienstes anhand seines ARN abgerufen. Die Angabe des ARN ist erforderlich, wenn Informationen zu einem Dienst abgerufen werden, der in einem Namespace erstellt wurde, der mit Ihrem Konto gemeinsam genutzt wird. Das Anruferkonto 123456789111 hat den Dienst in einem Namespace erstellt, der von einem Konto gemeinsam genutzt wird. 123456789012

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erstellen eines AWS Cloud Map-Dienstes für eine Anwendungskomponente und Shared AWS Cloud Map-Namespaces im Cloud Map-Entwicklerhandbuch. AWS

  • API-Details finden Sie GetService in AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendung. list-instances

AWS CLI

Beispiel 1: Um Dienstinstanzen aufzulisten

Im folgenden list-instances-Beispiel werden die Service-Instances aufgelistet.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Auflisten von AWS Cloud Map-Serviceinstanzen im AWS Cloud Map Developer Guide.

Beispiel 2: So listen Sie Dienstinstanzen mithilfe des Service-ARN auf

Im folgenden list-instances Beispiel werden Dienstinstanzen aufgeführt, die einen Dienst-ARN anstelle einer Dienst-ID verwenden. Die Angabe eines ARN ist erforderlich, wenn Instanzen aufgelistet werden, die Namespaces zugeordnet sind, die mit Ihrem Konto gemeinsam genutzt werden.

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

Ausgabe:

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

Weitere Informationen zur kontoübergreifenden Nutzung von Namespaces finden Sie unter Gemeinsam genutzte AWS Cloud Map-Namespaces und Auflisten von Cloud Map-Service-Instanzen im AWS Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendunglist-namespaces.

AWS CLI

Beispiel 1: Um Namespaces aufzulisten

Im folgenden list-namespaces-Beispiel werden Namespaces aufgelistet.

aws servicediscovery list-namespaces

Ausgabe:

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

Weitere Informationen finden Sie unter Auflisten von AWS Cloud Map-Namespaces im Cloud Map Developer Guide. AWS

Beispiel 2: Um Namespaces aufzulisten, die von anderen Konten gemeinsam genutzt werden

Das folgende list-namespaces Beispiel listet Namespaces auf, die von anderen Konten, die den Filter verwenden, mit dem Anruferkonto gemeinsam genutzt werden. AWS RESOURCE_OWNER

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

Ausgabe:

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

Weitere Informationen finden Sie unter Shared AWS Cloud Map-Namespaces im Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendung. list-operations

AWS CLI

So listen Sie Vorgänge auf, die den angegebenen Kriterien entsprechen

Im folgenden list-operations-Beispiel werden Vorgänge aufgelistet, die den Status PENDING oder SUCCESS haben.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Was ist AWS Cloud Map? im AWS Cloud Map-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt die Verwendung. list-services

AWS CLI

Beispiel 1: Um Dienste aufzulisten

Im folgenden list-services-Beispiel werden Services aufgelistet.

aws servicediscovery list-services

Ausgabe:

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

Weitere Informationen finden Sie unter Auflisten von AWS Cloud Map-Diensten in einem Namespace im AWS Cloud Map Developer Guide.

Beispiel 2: Um Dienste aufzulisten, die in gemeinsam genutzten Namespaces erstellt wurden

Das folgende list-services Beispiel listet Dienste auf, die in Namespaces erstellt wurden, die von anderen Konten, die den Filter verwenden, mit dem Anruferkonto 123456789012 geteilt wurden. AWS RESOURCE_OWNER

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

Ausgabe:

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

Weitere Informationen finden Sie unter Shared AWS Cloud Map-Namespaces und Auflisten von Cloud Map-Diensten in einem Namespace im AWS Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

So listen Sie die Tags auf, die der angegebenen Ressourcengruppe zugeordnet sind

Im folgenden list-tags-for-resource-Beispiel werden die Tags für die angegebene Ressource aufgelistet.

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

Ausgabe:

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

Weitere Informationen finden Sie im AWS Cloud Map-Entwicklerhandbuch unter Taggen Ihrer AWS Cloud Map-Ressourcen.

Das folgende Codebeispiel zeigt die Verwendung. register-instance

AWS CLI

Beispiel 1: Um eine Dienstinstanz mithilfe der Service-ID zu registrieren

Im folgenden register-instance-Beispiel wird eine Service-Instance registriert.

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

Ausgabe:

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

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation.

Weitere Informationen zum Registrieren einer Instanz finden Sie unter Registrieren einer Ressource als AWS Cloud Map-Dienstinstanz im AWS Cloud Map Developer Guide.

Beispiel 2: Um eine Dienstinstanz mithilfe des Dienst-ARN zu registrieren

Das folgende register-instance Beispiel registriert eine Dienstinstanz mithilfe eines Dienst-ARN. Die Angabe des ARN ist erforderlich, wenn Sie Instanzen in Diensten registrieren, die mit Ihrem Konto gemeinsam genutzt werden.

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

Ausgabe:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Weitere Informationen zur kontoübergreifenden Nutzung von Namespaces finden Sie unter Shared AWS Cloud Map-Namespaces im Cloud Map Developer Guide. AWS

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

So ordnen Sie Tags der angegebenen Ressource zu

Im folgenden tag-resource-Beispiel wird ein Department-Tag mit dem Wert Engineering dem angegebenen Namespace zugeordnet.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS Cloud Map-Entwicklerhandbuch unter Taggen Ihrer AWS Cloud Map-Ressourcen.

  • API-Details finden Sie TagResource in der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

So entfernen Sie Tags aus der angegebenen Ressource

Im folgenden untag-resource-Beispiel wird ein Department-Tag aus dem angegebenen Namespace entfernt.

aws servicediscovery untag-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
    --tag-keys Department

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS Cloud Map-Entwicklerhandbuch unter Taggen Ihrer AWS Cloud Map-Ressourcen.

Das folgende Codebeispiel zeigt die Verwendung. update-http-namespace

AWS CLI

Beispiel 1: Um einen HTTP-Namespace zu aktualisieren

Im folgenden update-http-namespace-Beispiel wird die Beschreibung des angegebenen HTTP-Namespace aktualisiert.

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

Ausgabe:

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

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war. Weitere Informationen finden Sie unter get-operation.

Weitere Informationen finden Sie unter Namespaces von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um einen HTTP-Namespace mithilfe von ARN zu aktualisieren

Das folgende update-http-namespace Beispiel aktualisiert den angegebenen HTTP-Namespace mithilfe seines 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."

Ausgabe:

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

Weitere Informationen finden Sie unter Namespaces von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Das folgende Codebeispiel zeigt die Verwendung. update-instance-custom-health-status

AWS CLI

Beispiel 1: Um eine benutzerdefinierte Systemdiagnose zu aktualisieren

Im folgenden update-instance-custom-health-status-Beispiel wird der Status der benutzerdefinierten Zustandsprüfung für den angegebenen Service und die angegebene Beispiel-Service-Instance auf HEALTHY aktualisiert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Zustandsprüfung des Services AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um eine benutzerdefinierte Systemdiagnose mithilfe des Dienst-ARN zu aktualisieren

Im folgenden update-instance-custom-health-status Beispiel wird der Status der benutzerdefinierten Integritätsprüfung mithilfe eines Dienst-ARN aktualisiert. Der ARN ist erforderlich, wenn der Integritätsstatus von Instances aktualisiert wird, die Namespaces zugeordnet sind, die mit Ihrem Konto gemeinsam genutzt werden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Konfiguration der AWS Cloud Map-Dienst-Integritätsprüfung und Teilen von Cross-account AWS Cloud Map-Namespaces im AWS Cloud Map-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt die Verwendung. update-private-dns-namespace

AWS CLI

Beispiel 1: Um einen privaten DNS-Namespace mithilfe der ID zu aktualisieren

Im folgenden update-private-dns-namespace Beispiel wird die Beschreibung eines privaten DNS-Namespace mithilfe der Namespace-ID aktualisiert.

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

Ausgabe:

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

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war.

Weitere Informationen finden Sie unter Namespaces von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um einen privaten DNS-Namespace mithilfe von ARN zu aktualisieren

Im folgenden update-private-dns-namespace Beispiel wird ein privater DNS-Namespace mithilfe seines ARN aktualisiert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Namespaces von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Das folgende Codebeispiel zeigt die Verwendung. update-public-dns-namespace

AWS CLI

Beispiel 1: Um einen öffentlichen DNS-Namespace mithilfe der ID zu aktualisieren

Im folgenden update-public-dns-namespace Beispiel wird die Beschreibung eines öffentlichen DNS-Namespaces anhand seiner ID aktualisiert.

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

Ausgabe:

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

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war.

Weitere Informationen finden Sie unter Namespaces von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um einen öffentlichen DNS-Namespace mithilfe von ARN zu aktualisieren

Im folgenden update-public-dns-namespace Beispiel wird ein öffentlicher DNS-Namespace mithilfe seines ARN aktualisiert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Namespaces von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Das folgende Codebeispiel zeigt die Verwendung. update-service-attributes

AWS CLI

Beispiel 1: Um einen Dienst zu aktualisieren, um ein Attribut hinzuzufügen

Im folgenden update-service-attributes-Beispiel wird der angegebene Service aktualisiert, um ein Serviceattribut mit einem Schlüssel Port und einem Wert von 80 hinzuzufügen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Services von AWS Cloud Map im Entwicklerhandbuch für AWS Cloud Map.

Beispiel 2: Um die Attribute eines Dienstes mithilfe von ARN zu aktualisieren

Im folgenden update-service-attributes Beispiel wird ein Dienst mithilfe seines ARN aktualisiert, um ein Dienstattribut hinzuzufügen. Die Angabe des ARN ist erforderlich, um Attributen zu Diensten hinzuzufügen, die in Namespaces erstellt wurden, die mit Ihrem Konto gemeinsam genutzt werden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter AWS Cloud Map-Dienste und Shared Cloud Map-Namespaces im AWS Cloud Map-Entwicklerhandbuch. AWS

Das folgende Codebeispiel zeigt die Verwendungupdate-service.

AWS CLI

Beispiel 1: Um einen Dienst zu aktualisieren

Im folgenden update-service-Beispiel wird ein Service aktualisiert, um die Einstellungen DnsConfig und HealthCheckConfig zu aktualisieren.

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

Ausgabe:

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

Sie können get-operation ausführen, um zu bestätigen, dass der Vorgang erfolgreich war.

Weitere Informationen zum Aktualisieren eines Dienstes finden Sie unter Aktualisieren eines AWS Cloud Map-Dienstes im AWS Cloud Map-Entwicklerhandbuch.

Beispiel 2: Um einen Service mithilfe von ARN zu aktualisieren

Im folgenden update-service Beispiel wird ein Dienst mithilfe seines ARN aktualisiert. Die Angabe eines ARN ist für Dienste erforderlich, die in Namespaces erstellt werden, die mit Ihrem Konto gemeinsam genutzt werden.

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

Ausgabe:

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

Weitere Informationen zum Aktualisieren eines Dienstes finden Sie unter Aktualisieren eines AWS Cloud Map-Dienstes und geteilter Cloud Map-Namespaces im AWS Cloud Map-Entwicklerhandbuch. AWS