Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) 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 mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine 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.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-http-namespace`
Das folgende Codebeispiel zeigt, wie Sie`create-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](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Weitere Informationen zum Erstellen eines Namespaces finden Sie unter [Creating an AWS Cloud Map Namespace to group application services](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [CreateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-http-namespace.html)in der *AWS CLI Befehlsreferenz*.
### `create-private-dns-namespace`
Das folgende Codebeispiel zeigt die Verwendung`create-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](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Weitere Informationen finden Sie unter [Erstellen von Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) im *AWS -Cloud Map-Entwicklerhandbuch*.
+ Einzelheiten zur API finden Sie [CreatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-private-dns-namespace.html)in der *AWS CLI Befehlsreferenz*.
### `create-public-dns-namespace`
Das folgende Codebeispiel zeigt die Verwendung`create-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 [Creating an AWS Cloud Map Namespace to group application services](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [CreatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-public-dns-namespace.html)in der *AWS CLI Befehlsreferenz*.
### `create-service`
Das folgende Codebeispiel zeigt die Verwendung`create-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 im [AWS Cloud Map *Developer Guide unter Creating a AWS Cloud Map* Service für eine Anwendungskomponente](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html).
**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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-service.html)in AWS CLI der Befehlsreferenz.*
### `delete-namespace`
Das folgende Codebeispiel zeigt die Verwendung`delete-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](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Weitere Informationen finden Sie unter [Löschen eines AWS Cloud Map-Namespace](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) 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](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [DeleteNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-namespace.html)in der *AWS CLI Befehlsreferenz.*
### `delete-service-attributes`
Das folgende Codebeispiel zeigt die Verwendung`delete-service-attributes`.
**AWS CLI**
**Beispiel 1: Um ein Dienstattribut 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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [DeleteServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service-attributes.html)in AWS CLI der Befehlsreferenz.*
### `delete-service`
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 unter [Löschen eines AWS Cloud Map-Dienstes](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) 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](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service.html)in der *AWS CLI Befehlsreferenz*.
### `deregister-instance`
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.](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html)
Weitere Informationen finden Sie unter [Registrierung einer Service Instance aufheben](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [Abmelden einer AWS Cloud Map-Dienstinstanz im Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html) Developer Guide.AWS *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz. [DeregisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/deregister-instance.html)AWS CLI *
### `discover-instances-revision`
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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für AWS Cloud Map*.
**Beispiel 2: Um die Version 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [AWS Cloud Map-Dienstinstanzen im *AWS Cloud Map*](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) Developer Guide.
+ *Einzelheiten zur API finden Sie [DiscoverInstancesRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances-revision.html)in AWS CLI der Befehlsreferenz.*
### `discover-instances`
Das folgende Codebeispiel zeigt die Verwendung`discover-instances`.
**AWS CLI**
**Beispiel 1: Um registrierte Instanzen zu entdecken**
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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [AWS Cloud Map-Dienstinstanzen im *AWS Cloud Map*](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) Developer Guide.
+ *Einzelheiten zur API finden Sie [DiscoverInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances.html)in AWS CLI der Befehlsreferenz.*
### `get-instance`
Das folgende Codebeispiel zeigt die Verwendung`get-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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) Developer Guide.AWS *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz. [GetInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instance.html)AWS CLI *
### `get-instances-health-status`
Das folgende Codebeispiel zeigt die Verwendung`get-instances-health-status`.
**AWS CLI**
**Beispiel 1: Um den Integritätsstatus von Instanzen abzurufen, die einem Dienst 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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [GetInstancesHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instances-health-status.html)in AWS CLI der Befehlsreferenz.*
### `get-namespace`
Das folgende Codebeispiel zeigt die Verwendung`get-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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für 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 eines mit Ihrem Konto geteilten Namespaces abzurufen.
```
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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [GetNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-namespace.html)in AWS CLI der Befehlsreferenz.*
### `get-operation`
Das folgende Codebeispiel zeigt die Verwendung`get-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 Creating a AWS Cloud Map* Namespace to Group Application Services](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html).
**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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [GetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-operation.html)in AWS CLI der Befehlsreferenz.*
### `get-service-attributes`
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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) 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 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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [GetServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service-attributes.html)in AWS CLI der Befehlsreferenz.*
### `get-service`
Das folgende Codebeispiel zeigt die Verwendung`get-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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html) und [Shared AWS Cloud Map Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service.html)in AWS CLI der Befehlsreferenz.*
### `list-instances`
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 [AWS Cloud Map-Dienstinstanzen auflisten](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [Auflisten von Cloud Map-Dienstinstanzen im AWSAWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) Developer Guide.*
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz. [ListInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-instances.html)AWS CLI *
### `list-namespaces`
Das folgende Codebeispiel zeigt die Verwendung`list-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 [AWS Cloud Map-Namespaces auflisten](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-namespaces.html) 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [ListNamespaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-namespaces.html)in AWS CLI der Befehlsreferenz.*
### `list-operations`
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?](https://docs.aws.amazon.com/cloud-map/latest/dg/what-is-cloud-map.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-operations.html)in der *AWS CLI Befehlsreferenz*.
### `list-services`
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 [AWS Cloud Map-Dienste in einem Namespace auflisten](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) und [AWS Cloud Map-Dienste in einem Namespace auflisten im *AWS Cloud* Map](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html) Developer Guide.
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-services.html).AWS CLI *
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-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 unter [Tagging your AWS Cloud Map Resources](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz.*
### `register-instance`
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](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Weitere Informationen zur Registrierung einer Instanz finden Sie unter [Registrierung einer Ressource als AWS Cloud Map-Dienstinstanz](https://docs.aws.amazon.com/cloud-map/latest/dg/registering-instances.html) 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](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) Developer Guide.AWS *
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz. [RegisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/register-instance.html)AWS CLI *
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-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 unter [Tagging your AWS Cloud Map Resources](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/tag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-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 \
--tags Key=Department, Value=Engineering
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Tagging your AWS Cloud Map Resources](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/untag-resource.html)in der *AWS CLI Befehlsreferenz.*
### `update-http-namespace`
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](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html).
Weitere Informationen finden Sie unter [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für 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 [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*.
+ Einzelheiten zur API finden Sie unter [UpdateHttpNamespace AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-http-namespace.html)*Befehlsreferenz.*
### `update-instance-custom-health-status`
Das folgende Codebeispiel zeigt die Verwendung`update-instance-custom-health-status`.
**AWS CLI**
**Beispiel 1: Um eine benutzerdefinierte Integritätsprüfung 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](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html) und [kontoübergreifende Nutzung von AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map Developer Guide*.
+ Einzelheiten zur API finden Sie [UpdateInstanceCustomHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-instance-custom-health-status.html)in der *AWS CLI Befehlsreferenz*.
### `update-private-dns-namespace`
Das folgende Codebeispiel zeigt die Verwendung`update-private-dns-namespace`.
**AWS CLI**
**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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für 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 [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*.
+ Einzelheiten zur API finden Sie unter [UpdatePrivateDnsNamespace AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-private-dns-namespace.html)*Befehlsreferenz.*
### `update-public-dns-namespace`
Das folgende Codebeispiel zeigt die Verwendung`update-public-dns-namespace`.
**AWS CLI**
**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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für 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 [Namespaces von AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html) im *Entwicklerhandbuch für AWS Cloud Map*.
+ Einzelheiten zur API finden Sie unter [UpdatePublicDnsNamespace AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-public-dns-namespace.html)*Befehlsreferenz.*
### `update-service-attributes`
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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *Entwicklerhandbuch für 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](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [UpdateServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service-attributes.html)in AWS CLI der Befehlsreferenz.*
### `update-service`
Das folgende Codebeispiel zeigt die Verwendung`update-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](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) 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](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) und [Shared AWS Cloud Map-Namespaces](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) im *AWS Cloud Map* Developer Guide.
+ *Einzelheiten zur API finden Sie [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service.html)in AWS CLI der Befehlsreferenz.*