AWS Cloud Map Beispiele mit AWS CLI

So erstellen Sie einen HTTP-Namespace

Im folgenden Beispiel für create-http-namespace 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 Creating an AWS Cloud Map Namespace to group application services im AWS Cloud Map Developer Guide.

So erstellen Sie einen privaten DNS-Namespace

Im folgenden Beispiel für create-private-dns-namespace 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 Entwicklerhandbuch zu AWS Cloud Map.

So erstellen Sie einen öffentlichen DNS-Namespace

Im folgenden Beispiel für create-public-dns-namespace 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 Creating an AWS Cloud Map Namespace to group application services im AWS Cloud Map Developer Guide.

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

Im folgenden Beispiel für create-service 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 im AWS Cloud Map Developer Guide unter Creating a AWS Cloud Map Service für eine Anwendungskomponente.

Beispiel 2: So erstellen Sie einen Dienst mit dem 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 AWS Cloud Map Developer Guide.

Beispiel 1: Um einen Namespace zu löschen

Im folgenden Beispiel für delete-namespace 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 unter Löschen eines AWS Cloud Map-Namespace im AWS Cloud Map Developer Guide.

Beispiel 2: Um einen Namespace mithilfe des Namespace-ARN zu löschen

Im folgenden delete-namespace Beispiel wird ein Namespace mit seinem 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-Namespace im AWS Cloud Map Developer Guide.

Beispiel 1: Um ein Dienstattribut zu löschen

Im folgenden Beispiel für delete-service-attributes 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 zu AWS Cloud Map.

Beispiel 2: Um ein Dienstattribut mit 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 mit Diensten verknüpft 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 AWS Cloud Map-Namespaces im AWS Cloud Map Developer Guide.

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 unter Löschen eines AWS Cloud Map-Dienstes im AWS Cloud Map Developer Guide.

Beispiel 2: Um einen Dienst mit 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 unter Löschen eines AWS Cloud Map-Dienstes im AWS Cloud Map Developer Guide.

Beispiel 1: Um eine Dienstinstanz abzumelden

Im folgenden Beispiel für deregister-instance 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 Aufheben der Registrierung einer Service-Instance im Entwicklerhandbuch zu AWS Cloud Map.

Beispiel 2: So deregistrieren Sie eine Dienstinstanz mithilfe des Dienst-ARN für gemeinsam genutzte Namespaces

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 Sie Instances von Diensten abmelden, die in Namespaces erstellt wurden, die mit Ihrem Konto gemeinsam genutzt 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 Shared AWS Cloud Map-Namespaces und Abmelden einer AWS Cloud Map-Dienstinstanz im Cloud Map Developer Guide.AWS

Beispiel 1: Um die Revision einer Instanz zu ermitteln

Im folgenden Beispiel für discover-instances-revision 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 zu AWS Cloud Map.

Beispiel 2: Um die Revision von Instanzen aus einem bestimmten Besitzerkonto zu ermitteln

Im folgenden discover-instances-revision Beispiel wird die Version von Instanzen eines bestimmten Besitzerkontos 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 Shared AWS Cloud Map-Namespaces und AWS Cloud Map-Dienstinstanzen im AWS Cloud Map Developer Guide.

Beispiel 1: Um registrierte Instanzen zu entdecken

Im folgenden Beispiel für discover-instances 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 zu AWS Cloud Map.

Beispiel 2: Um Instances von einem bestimmten Besitzerkonto aus zu entdecken

Im folgenden discover-instances Beispiel werden registrierte Instances von einem bestimmten Besitzerkonto erkannt. Dieser Parameter ist erforderlich, um Instanzen in Namespaces zu ermitteln, 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 Shared AWS Cloud Map-Namespaces und AWS Cloud Map-Dienstinstanzen im AWS Cloud Map Developer Guide.

Beispiel 1: Um die Details einer Instanz abzurufen

Im folgenden Beispiel für get-instance 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 zu AWS Cloud Map.

Beispiel 2: Um die Details einer Instanz abzurufen, die den Dienst-ARN für gemeinsam genutzte Namespaces verwendet

Im folgenden get-instance Beispiel werden die Attribute einer Instanz abgerufen, die einen Dienst-ARN anstelle einer Dienst-ID verwendet. Die Angabe eines ARN ist erforderlich, um Details zu Instanzen abzurufen, die mit Namespaces verknüpft sind, die mit Ihrem Konto geteilt 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 Nutzung von Namespaces finden Sie unter Shared AWS Cloud Map-Namespaces im Cloud Map Developer Guide.AWS

Beispiel 1: Um den Integritätsstatus von Instanzen abzurufen, die einem Dienst zugeordnet sind

Im folgenden Beispiel für get-instances-health-status 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 zu AWS Cloud Map.

Beispiel 2: So rufen Sie den Integritätsstatus von Instanzen ab, die den Dienst-ARN für gemeinsam genutzte Namespaces verwenden

Im folgenden get-instances-health-status Beispiel wird der Integritätsstatus von Instanzen abgerufen, die einen Dienst-ARN anstelle einer Dienst-ID verwenden. Die Angabe eines ARN ist erforderlich, um den Integritätsstatus für Instances abzurufen, die mit Namespaces verknüpft 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-Dienstinstanzen und Shared AWS Cloud Map-Namespaces im AWS Cloud Map Developer Guide.

Beispiel 1: Um die Details eines Namespaces abzurufen

Im folgenden Beispiel für get-namespace 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 AWS -Cloud Map-Namespaces im Entwicklerhandbuch zu AWS Cloud Map.

Beispiel 2: Um die Details eines Namespaces mit ARN abzurufen

Im folgenden get-namespace Beispiel werden Informationen über den angegebenen Namespace mithilfe seines ARN abgerufen. Die Angabe des ARN ist erforderlich, um Details zu einem Namespace abzurufen, der mit Ihrem Konto geteilt 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 AWS Cloud Map Developer Guide.

Beispiel 1: Um das Ergebnis einer Operation zu erhalten

Im folgenden Beispiel für get-operation 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 Creating a AWS Cloud Map Namespace to Group Application Services.

Beispiel 2: Um einen Vorgang von einem bestimmten Besitzerkonto aus abzurufen

Im folgenden get-operation Beispiel wird das Ergebnis einer Operation abgerufen, die 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 AWS Cloud Map Developer Guide.

Beispiel 1: Um die Attribute eines Dienstes abzurufen

Im folgenden Beispiel für get-service-attributes 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 zu 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 mithilfe seines ARN abgerufen. Die Angabe eines ARN ist erforderlich, um Attribute eines Dienstes abzurufen, der in einem mit Ihrem Konto gemeinsam genutzten Namespace erstellt wurde.

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 Developer Guide.

Beispiel 1: Um die Einstellungen eines Dienstes abzurufen

Im folgenden Beispiel für get-service 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 zu AWS Cloud Map.

Beispiel 2: Um die Einstellungen eines Dienstes mit ARN abzurufen

Im folgenden get-service Beispiel werden die Einstellungen eines angegebenen Dienstes mithilfe seines ARN abgerufen. Die Angabe des ARN ist erforderlich, wenn Sie Informationen über einen Dienst abrufen, der in einem Namespace erstellt wurde, der mit Ihrem Konto gemeinsam genutzt wird. Das Anruferkonto 123456789111 hat den Dienst in einem Namespace erstellt, der vom 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 Creating a AWS Cloud Map Service für eine Anwendungskomponente und Shared AWS Cloud Map Namespaces im AWS Cloud Map Developer Guide.

Beispiel 1: Um Dienstinstanzen aufzulisten

Im folgenden Beispiel für list-instances 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 AWS Cloud Map-Dienstinstanzen auflisten im AWS Cloud Map Developer Guide.

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

Das folgende list-instances Beispiel listet Dienstinstanzen auf, die einen Dienst-ARN anstelle einer Dienst-ID verwenden. Die Angabe eines ARN ist erforderlich, wenn Sie Instances auflisten, die mit Namespaces verknüpft sind, die mit Ihrem Konto geteilt 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 Shared AWS Cloud Map-Namespaces und Auflisten von Cloud Map-Dienstinstanzen im AWSAWS Cloud Map Developer Guide.

Beispiel 1: Um Namespaces aufzulisten

Im folgenden Beispiel für list-namespaces 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 AWS Cloud Map-Namespaces auflisten im AWS Cloud Map Developer Guide.

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

Im folgenden list-namespaces Beispiel werden Namespaces aufgeführt, 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 AWS Cloud Map Developer Guide.

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

Im folgenden Beispiel für list-operations 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 Developer Guide.

Beispiel 1: Um Dienste aufzulisten

Im folgenden Beispiel für list-services 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 AWS Cloud Map-Dienste in einem Namespace auflisten im AWS Cloud Map Developer Guide.

Beispiel 2: Um Dienste aufzulisten, die in gemeinsamen 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 gemeinsam genutzt werden. 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 AWS Cloud Map-Dienste in einem Namespace auflisten im AWS Cloud Map Developer Guide.

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

Im folgenden Beispiel für list-tags-for-resource 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 unter Tagging your AWS Cloud Map Resources im AWS Cloud Map Developer Guide.

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

Im folgenden Beispiel für register-instance 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 zur Registrierung einer Instanz finden Sie unter Registrierung einer Ressource als AWS Cloud Map-Dienstinstanz im AWS Cloud Map Developer Guide.

Beispiel 2: So registrieren Sie eine Dienstinstanz mithilfe des Dienst-ARN

Im folgenden register-instance Beispiel wird eine Dienstinstanz mithilfe eines Dienst-ARN registriert. 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

So ordnen Sie Tags der angegebenen Ressource zu

Im folgenden Beispiel für tag-resource 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 unter Tagging your AWS Cloud Map Resources im AWS Cloud Map Developer Guide.

So entfernen Sie Tags aus der angegebenen Ressource

Im folgenden Beispiel für untag-resource 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 \
    --tags Key=Department, Value=Engineering

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tagging your AWS Cloud Map Resources im AWS Cloud Map Developer Guide.

Beispiel 1: Um einen HTTP-Namespace zu aktualisieren

Im folgenden Beispiel für update-http-namespace 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 zu AWS Cloud Map.

Beispiel 2: Um einen HTTP-Namespace mit ARN zu aktualisieren

Im folgenden update-http-namespace Beispiel wird der angegebene HTTP-Namespace mithilfe seines ARN aktualisiert.

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 AWS -Cloud Map-Namespaces im Entwicklerhandbuch zu AWS Cloud Map.

Beispiel 1: Um eine benutzerdefinierte Integritätsprüfung zu aktualisieren

Im folgenden Beispiel für update-instance-custom-health-status 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 für einen Service von AWS Cloud Map im Entwicklerhandbuch zu AWS Cloud Map.

Beispiel 2: So aktualisieren Sie eine benutzerdefinierte Zustandsprüfung mithilfe des Dienst-ARN

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 für Instances aktualisiert wird, die mit Namespaces verknüpft sind, die mit Ihrem Konto geteilt 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 Integritätsprüfung des AWS Cloud Map-Dienstes und kontoübergreifende Nutzung von AWS Cloud Map-Namespaces im AWS Cloud Map Developer Guide.

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

Im folgenden update-private-dns-namespace Beispiel wird die Beschreibung eines privaten DNS-Namespaces 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 zu AWS Cloud Map.

Beispiel 2: Um einen privaten DNS-Namespace mit 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 AWS -Cloud Map-Namespaces im Entwicklerhandbuch zu AWS Cloud Map.

Beispiel 1: Um einen öffentlichen DNS-Namespace mithilfe von 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 zu AWS Cloud Map.

Beispiel 2: Um einen öffentlichen DNS-Namespace mit 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 AWS -Cloud Map-Namespaces im Entwicklerhandbuch zu AWS Cloud Map.

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

Im folgenden Beispiel für update-service-attributes 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 zu AWS Cloud Map.

Beispiel 2: So aktualisieren Sie Dienstattribute mithilfe von ARN

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

Beispiel 1: Um einen Dienst zu aktualisieren

Im folgenden Beispiel für update-service 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 Developer Guide.

Beispiel 2: Um einen Dienst mit 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 geteilt 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 Shared AWS Cloud Map-Namespaces im AWS Cloud Map Developer Guide.