本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS Cloud Map 使用 的範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 來執行動作和實作常見案例 AWS Cloud Map。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [動作](#actions)
## 動作
### `create-http-namespace`
以下程式碼範例顯示如何使用 `create-http-namespace`。
**AWS CLI**
**建立 HTTP 命名空間**
以下 `create-http-namespace` 範例建立 HTTP 命名空間 `example.com`。
```
aws servicediscovery create-http-namespace \
--name example.com \
--creator-request-id example-request-id
```
輸出：
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
若要確認操作成功，您可以執行 `get-operation`。如需詳細資訊，請參閱 [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html)。
如需建立命名空間的詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的建立 Cloud Map 命名空間以將應用程式服務分組](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-http-namespace.html)。
### `create-private-dns-namespace`
以下程式碼範例顯示如何使用 `create-private-dns-namespace`。
**AWS CLI**
**建立私有 DNS 命名空間**
以下 `create-private-dns-namespace` 範例建立私有 DNS 命名空間。
```
aws servicediscovery create-private-dns-namespace \
--name example.com \
--vpc vpc-1c56417b
```
輸出：
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
若要確認操作成功，您可以執行 `get-operation`。如需詳細資訊，請參閱 [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html)。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的[建立命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-private-dns-namespace.html)。
### `create-public-dns-namespace`
以下程式碼範例顯示如何使用 `create-public-dns-namespace`。
**AWS CLI**
**建立公有 DNS 命名空間**
以下 `create-public-dns-namespace` 範例建立公有 DNS 命名空間 `example.com`。
```
aws servicediscovery create-public-dns-namespace \
--name example-public-dns.com \
--creator-request-id example-public-request-id \
--properties DnsProperties={SOA={TTL=60}}
```
輸出：
```
{
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}
```
若要確認操作成功，您可以執行 `get-operation`。
如需建立命名空間的詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的建立 Cloud Map 命名空間以將應用程式服務分組](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱 *AWS CLI Command Reference* 中的 [CreatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-public-dns-namespace.html)。
### `create-service`
以下程式碼範例顯示如何使用 `create-service`。
**AWS CLI**
**範例 1：使用命名空間 ID 建立服務**
以下 `create-service` 範例會建立服務。
```
aws servicediscovery create-service \
--name myservice \
--namespace-id ns-ylexjili4cdxy3xm \
--dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"
```
輸出：
```
{
"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"
}
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的為應用程式元件建立 Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html)。 *AWS *
**範例 2：使用命名空間 ARN 建立服務**
下列`create-service`範例會使用命名空間 ARN 而非命名空間 ID 來建立服務。在共用命名空間中建立服務時，需要指定命名空間 ARN。
```
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}]"
```
輸出：
```
{
"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"
}
}
```
如需詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的共用雲端地圖命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/create-service.html)。
### `delete-namespace`
以下程式碼範例顯示如何使用 `delete-namespace`。
**AWS CLI**
**範例 1：刪除命名空間**
以下 `delete-namespace` 範例會刪除命名空間。
```
aws servicediscovery delete-namespace \
--id ns-abcd1234xmpl5678
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
若要確認操作成功，您可以執行 `get-operation`。如需詳細資訊，請參閱 [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html)。
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的刪除 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html)。 *AWS *
**範例 2：使用命名空間 ARN 刪除命名空間**
下列`delete-namespace`範例會使用其 ARN 刪除命名空間。
```
aws servicediscovery delete-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的刪除 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-namespace.html)。
### `delete-service-attributes`
以下程式碼範例顯示如何使用 `delete-service-attributes`。
**AWS CLI**
**範例 1：刪除服務屬性**
下列 `delete-service-attributes` 範例刪除具有與指定服務相關聯之索引鍵 `Port` 的服務屬性。
```
aws servicediscovery delete-service-attributes \
--service-id srv-abcd1234xmpl5678 \
--attributes Port
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html)。
**範例 2：使用 ARN 刪除服務屬性**
下列`delete-service-attributes`範例會使用服務 ARN 刪除服務屬性。刪除與在與您的帳戶共用的命名空間中建立的服務相關聯的屬性時，需要指定 ARN。
```
aws servicediscovery delete-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
--attributes Port
```
此命令不會產生輸出。
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的 Cloud Map 服務和](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html)*AWS *[共用 Cloud Map 命名空間 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service-attributes.html)。
### `delete-service`
以下程式碼範例顯示如何使用 `delete-service`。
**AWS CLI**
**範例 1：刪除服務**
下列 `delete-service` 範例會刪除服務。
```
aws servicediscovery delete-service \
--id srv-abcd1234xmpl5678
```
此命令不會產生輸出。
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的刪除 Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html)。 *AWS *
**範例 2：使用 ARN 刪除服務**
下列`delete-service`範例會使用服務 ARN 刪除服務。
```
aws servicediscovery delete-service \
--id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
此命令不會產生輸出。
如需詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的刪除 Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/delete-service.html)。
### `deregister-instance`
以下程式碼範例顯示如何使用 `deregister-instance`。
**AWS CLI**
**範例 1：取消註冊服務執行個體**
下列 `deregister-instance` 範例取消註冊服務執行個體。
```
aws servicediscovery deregister-instance \
--service-id srv-p5zdwlg5uvvzjita \
--instance-id myservice-53
```
輸出：
```
{
"OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
}
```
若要確認操作成功，您可以執行 `get-operation`。如需詳細資訊，請參閱 [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html)。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的[取消註冊服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html)。
**範例 2：使用共用命名空間的服務 ARN 取消註冊服務執行個體**
下列`deregister-instance`範例會使用服務 ARN 取消註冊服務執行個體，而不是服務 ID。從與您的帳戶共用的命名空間中建立的服務取消註冊執行個體時，需要指定 ARN。
```
aws servicediscovery deregister-instance \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01
```
輸出：
```
{
"OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的共用 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)*AWS 和*[取消註冊 Cloud Map 服務執行個體 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeregisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/deregister-instance.html)。
### `discover-instances-revision`
以下程式碼範例顯示如何使用 `discover-instances-revision`。
**AWS CLI**
**範例 1：探索執行個體的修訂**
下列 `discover-instances-revision` 範例會探索執行個體不斷增加的修訂。
```
aws servicediscovery discover-instances-revision \
--namespace-name example.com \
--service-name myservice
```
輸出：
```
{
"InstancesRevision": 123456
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html)。
**範例 2：從特定擁有者帳戶探索執行個體的修訂**
下列`discover-instances-revision`範例會探索來自特定擁有者帳戶的執行個體修訂。與您的帳戶共用的命名空間中的執行個體需要擁有者帳戶參數。
```
aws servicediscovery discover-instances-revision \
--namespace-name shared-namespace \
--service-name shared-service \
--owner-account 123456789111
```
輸出：
```
{
"InstancesRevision": 1234567890
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的共用 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)*AWS 和* [AWS Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DiscoverInstancesRevision](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances-revision.html)。
### `discover-instances`
以下程式碼範例顯示如何使用 `discover-instances`。
**AWS CLI**
**範例 1：探索已註冊的執行個體**
下列 `discover-instances` 範例會探索已註冊的執行個體。
```
aws servicediscovery discover-instances \
--namespace-name example.com \
--service-name myservice \
--max-results 10 \
--health-status ALL
```
輸出：
```
{
"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
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html)。
**範例 2：從特定擁有者帳戶探索執行個體**
下列`discover-instances`範例會從特定擁有者帳戶探索已註冊的執行個體。在與您的帳戶共用的命名空間中探索執行個體時，需要此參數。
```
aws servicediscovery discover-instances \
--namespace-name shared-namespace \
--service-name shared-service \
--owner-account 123456789111
```
輸出：
```
{
"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
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的共用 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)*AWS 和* [AWS Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html)。
+ 如需 API 詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [DiscoverInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/discover-instances.html)。
### `get-instance`
以下程式碼範例顯示如何使用 `get-instance`。
**AWS CLI**
**範例 1：取得執行個體的詳細資訊**
下列 `get-instance` 範例會取得服務的屬性。
```
aws servicediscovery get-instance \
--service-id srv-e4anhexample0004
--instance-id i-abcd1234
```
輸出：
```
{
"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"
}
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html)。
**範例 2：使用共用命名空間的服務 ARN 取得執行個體的詳細資訊**
下列`get-instance`範例使用服務 ARN 而非服務 ID 取得執行個體的屬性。取得與您帳戶共用之命名空間相關聯的執行個體詳細資訊時，需要指定 ARN。此範例中傳回的執行個體是由帳戶 在帳戶 擁有的命名空間`123456789111`中註冊`123456789012`。
```
aws servicediscovery get-instance \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
--instance-id web-server-01
```
輸出：
```
{
"ResourceOwner": "123456789012",
"Instance": {
"Id": "web-server-01",
"Attributes": {
"AWS_INSTANCE_IPV4": "203.0.113.15",
"AWS_INSTANCE_PORT": "80"
},
"CreatedByAccount": "123456789111"
}
}
```
如需跨帳戶命名空間共用的詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的共用 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instance.html)。
### `get-instances-health-status`
以下程式碼範例顯示如何使用 `get-instances-health-status`。
**AWS CLI**
**範例 1：取得與服務相關聯之執行個體的運作狀態**
下列 `get-instances-health-status` 範例會取得與指定服務相關聯之執行個體的運作狀態。
```
aws servicediscovery get-instances-health-status \
--service-id srv-e4anhexample0004
```
輸出：
```
{
"Status": {
"i-abcd1234": "HEALTHY",
"i-abcd1235": "UNHEALTHY"
}
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html)。
**範例 2：使用共用命名空間的服務 ARN 取得執行個體的運作狀態**
下列`get-instances-health-status`範例會使用服務 ARN 而非服務 ID 取得執行個體的運作狀態。取得與請求者帳戶共用之命名空間相關聯的執行個體運作狀態時，需要指定 ARN。
```
aws servicediscovery get-instances-health-status \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
```
輸出：
```
{
"Status": {
"web-server-01": "HEALTHY",
"web-server-02": "UNHEALTHY"
}
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的 Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html)*AWS 和*[共用 Cloud Map 命名空間 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetInstancesHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-instances-health-status.html)。
### `get-namespace`
以下程式碼範例顯示如何使用 `get-namespace`。
**AWS CLI**
**範例 1：取得命名空間的詳細資訊**
以下 `get-namespace` 範例會擷取指定命名空間的相關資訊。
```
aws servicediscovery get-namespace \
--id ns-abcd1234xmpl5678
```
輸出：
```
{
"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"
}
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html)。
**範例 2：使用 ARN 取得命名空間的詳細資訊**
下列`get-namespace`範例會使用其 ARN 擷取指定命名空間的相關資訊。若要擷取與您的帳戶共用的命名空間詳細資訊，必須指定 ARN。
```
aws servicediscovery get-namespace \
--id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
```
輸出：
```
{
"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"
}
}
```
如需詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的共用雲端地圖命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-namespace.html)。
### `get-operation`
以下程式碼範例顯示如何使用 `get-operation`。
**AWS CLI**
**範例 1：取得 操作的結果**
下列 `get-operation` 範例取得命名空間建立操作的結果。
```
aws servicediscovery get-operation \
--operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234
```
輸出：
```
{
"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"
}
}
}
```
如需詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的建立 Cloud Map 命名空間以將應用程式服務分組](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html)。 *AWS *
**範例 2：從特定擁有者帳戶取得 操作**
下列`get-operation`範例取得與特定命名空間擁有者帳戶相關聯的 操作的結果。若要取得與與您帳戶共用的命名空間相關聯的操作結果，需要此參數。
```
aws servicediscovery get-operation \
--operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \
--owner-account 123456789111
```
輸出：
```
{
"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"
}
}
}
```
如需詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的共用雲端地圖命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetOperation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-operation.html)。
### `get-service-attributes`
以下程式碼範例顯示如何使用 `get-service-attributes`。
**AWS CLI**
**範例 1：取得服務的屬性**
下列 `get-service-attributes` 範例會取得服務的屬性。
```
aws servicediscovery get-service-attributes \
--service-id srv-abcd1234xmpl5678
```
輸出：
```
{
"ServiceAttributes": {
"ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Attributes": {
"Port": "80"
}
}
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html)。
**範例 2：使用 ARN 取得服務的屬性**
下列`get-service-attributes`範例使用服務 ARN 取得服務的屬性。若要取得在與您帳戶共用的命名空間中建立之服務的屬性，必須指定 ARN。
```
aws servicediscovery get-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
輸出：
```
{
"ServiceAttributes": {
"ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
"ResourceOwner": "123456789012",
"Attributes": {
"Port": "80"
}
}
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的 Cloud Map 服務和](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html)*AWS *[共用 Cloud Map 命名空間 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service-attributes.html)。
### `get-service`
以下程式碼範例顯示如何使用 `get-service`。
**AWS CLI**
**範例 1：取得服務的設定**
下列 `get-service` 範例會取得指定服務的設定。
```
aws servicediscovery get-service \
--id srv-abcd1234xmpl5678
```
輸出：
```
{
"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"
}
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html)。
**範例 2：使用 ARN 取得服務的設定**
下列`get-service`範例會使用其 ARN 取得指定服務的設定。擷取在與您的帳戶共用的命名空間中建立之服務的相關資訊時，需要指定 ARN。發起人帳戶在帳戶 共用的命名空間中`123456789111`建立服務`123456789012`。
```
aws servicediscovery get-service \
--id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
```
輸出：
```
{
"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"
}
}
```
如需詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的為應用程式元件建立 Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html)*AWS *[以及共用 Cloud Map 命名空間 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/get-service.html)。
### `list-instances`
以下程式碼範例顯示如何使用 `list-instances`。
**AWS CLI**
**範例 1：列出服務執行個體**
下列 `list-instances` 範例列出服務執行個體。
```
aws servicediscovery list-instances \
--service-id srv-qzpwvt2tfqcegapy
```
輸出：
```
{
"Instances": [
{
"Id": "i-06bdabbae60f65a4e",
"Attributes": {
"AWS_INSTANCE_IPV4": "172.2.1.3",
"AWS_INSTANCE_PORT": "808"
},
"CreatedByAccount": "123456789012"
}
],
"ResourceOwner": "123456789012"
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的列出 Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html)。 *AWS *
**範例 2：使用服務 ARN 列出服務執行個體**
下列`list-instances`範例列出使用服務 ARN 而非服務 ID 的服務執行個體。列出與與您帳戶共用的命名空間相關聯的執行個體時，需要指定 ARN。
```
aws servicediscovery list-instances \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
```
輸出：
```
{
"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"
}
]
}
```
如需跨帳戶命名空間共用的詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的共用 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)*AWS 和*[列出 Cloud Map 服務執行個體 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListInstances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-instances.html)。
### `list-namespaces`
以下程式碼範例顯示如何使用 `list-namespaces`。
**AWS CLI**
**範例 1：列出命名空間**
下列 `list-namespaces` 範例列出命名空間。
```
aws servicediscovery list-namespaces
```
輸出：
```
{
"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"
}
]
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的列出 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-namespaces.html)。 *AWS *
**範例 2：列出其他帳戶共用的命名空間**
下列`list-namespaces`範例列出使用 `RESOURCE_OWNER`篩選條件的其他 AWS 帳戶與發起人帳戶共用的命名空間。
```
aws servicediscovery list-namespaces \
--filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
```
輸出：
```
{
"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"
}
]
}
```
如需詳細資訊，請參閱《 [AWS 雲端地圖開發人員指南》中的共用雲端地圖命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListNamespaces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-namespaces.html)。
### `list-operations`
以下程式碼範例顯示如何使用 `list-operations`。
**AWS CLI**
**列出符合指定條件的操作**
下列 `list-operations` 範例列出狀態為 `PENDING` 或 `SUCCESS` 的操作。
```
aws servicediscovery list-operations \
--service-id srv-e4anhexample0004 \
--filters Name=STATUS,Condition=IN,Values=PENDING,SUCCESS
```
輸出：
```
{
"Operations": [
{
"Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample",
"Status": "SUCCESS"
},
{
"Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample",
"Status": "SUCCESS"
},
{
"Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example",
"Status": "PENDING"
}
]
}
```
如需詳細資訊，請參閱[什麼是 AWS Cloud Map？](https://docs.aws.amazon.com/cloud-map/latest/dg/what-is-cloud-map.html) 《*AWS Cloud Map 開發人員指南*》中的 。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-operations.html)。
### `list-services`
以下程式碼範例顯示如何使用 `list-services`。
**AWS CLI**
**範例 1：列出服務**
下列 `list-services` 範例會列出服務。
```
aws servicediscovery list-services
```
輸出：
```
{
"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
}
]
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的列出命名空間中的 Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html)。 *AWS *
**範例 2：列出在共用命名空間中建立的服務**
下列`list-services`範例列出`123456789012`使用 `RESOURCE_OWNER`篩選條件的其他 AWS 帳戶在與發起人帳戶共用的命名空間中建立的服務。
```
aws servicediscovery list-services \
--filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
```
輸出：
```
{
"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"
}
]
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的共用 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)*AWS 和*[在命名空間中列出 Cloud Map 服務 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListServices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-services.html)。
### `list-tags-for-resource`
以下程式碼範例顯示如何使用 `list-tags-for-resource`。
**AWS CLI**
**列出與指定資源相關聯的標籤**
以下 `list-tags-for-resource` 範例列出指定資源的標籤：
```
aws servicediscovery list-tags-for-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004
```
輸出：
```
{
"Tags": [
{
"Key": "Project",
"Value": "Zeta"
},
{
"Key": "Department",
"Value": "Engineering"
}
]
}
```
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的標記 Cloud Map 資源](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/list-tags-for-resource.html)。
### `register-instance`
以下程式碼範例顯示如何使用 `register-instance`。
**AWS CLI**
**範例 1：使用服務 ID 註冊服務執行個體**
下列 `register-instance` 範例註冊服務執行個體。
```
aws servicediscovery register-instance \
--service-id srv-p5zdwlg5uvvzjita \
--instance-id myservice-53 \
--attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808
```
輸出：
```
{
"OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7"
}
```
若要確認操作成功，您可以執行 `get-operation`。如需詳細資訊，請參閱 [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html)。
如需註冊執行個體的詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的將資源註冊為 Cloud Map 服務執行個體](https://docs.aws.amazon.com/cloud-map/latest/dg/registering-instances.html)。 *AWS *
**範例 2：使用服務 ARN 註冊服務執行個體**
下列`register-instance`範例會使用服務 ARN 註冊服務執行個體。在與您帳戶共用的 服務中註冊執行個體時，需要指定 ARN。
```
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
```
輸出：
```
{
"OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}
```
如需跨帳戶命名空間共用的詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的共用 Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱*《AWS CLI 命令參考》*中的 [RegisterInstance](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/register-instance.html)。
### `tag-resource`
以下程式碼範例顯示如何使用 `tag-resource`。
**AWS CLI**
**建立標籤與指定資源的關聯**
下列 `tag-resource` 範例為 `Department` 標籤與值 `Engineering` 和指定的命名空間建立關聯。
```
aws servicediscovery tag-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
--tags Key=Department, Value=Engineering
```
此命令不會產生輸出。
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的標記 Cloud Map 資源](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/tag-resource.html)。
### `untag-resource`
以下程式碼範例顯示如何使用 `untag-resource`。
**AWS CLI**
**從指定的資源移除標籤**
下列 `untag-resource` 範例會從指定的命名空間移除 `Department` 標籤。
```
aws servicediscovery untag-resource \
--resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
--tags Key=Department, Value=Engineering
```
此命令不會產生輸出。
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的標記 Cloud Map 資源](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html)。 *AWS *
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/untag-resource.html)。
### `update-http-namespace`
以下程式碼範例顯示如何使用 `update-http-namespace`。
**AWS CLI**
**範例 1：更新 HTTP 命名空間**
下列 `update-http-namespace` 範例更新指定之 HTTP 命名空間的描述。
```
aws servicediscovery update-http-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
若要確認操作成功，您可以執行 `get-operation`。如需詳細資訊，請參閱 [get-operation](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html)。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html)。
**範例 2：使用 ARN 更新 HTTP 命名空間**
下列`update-http-namespace`範例會使用其 ARN 更新指定的 HTTP 命名空間。
```
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."
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateHttpNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-http-namespace.html)。
### `update-instance-custom-health-status`
以下程式碼範例顯示如何使用 `update-instance-custom-health-status`。
**AWS CLI**
**範例 1：更新自訂運作狀態檢查**
下列 `update-instance-custom-health-status` 範例將指定服務和範例服務執行個體的自訂運作狀態檢查狀態，更新為 `HEALTHY`。
```
aws servicediscovery update-instance-custom-health-status \
--service-id srv-e4anhexample0004 \
--instance-id example \
--status HEALTHY
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務運作狀態檢查組態](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html)。
**範例 2：使用服務 ARN 更新自訂運作狀態檢查**
下列`update-instance-custom-health-status`範例會使用服務 ARN 更新自訂運作狀態檢查的狀態。更新與與您帳戶共用之命名空間相關聯的執行個體的運作狀態時，需要 ARN。
```
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
```
此命令不會產生輸出。
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的 Cloud Map 服務運作狀態檢查組態](https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html)*AWS 和*[跨帳戶 Cloud Map 命名空間共用 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateInstanceCustomHealthStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-instance-custom-health-status.html)。
### `update-private-dns-namespace`
以下程式碼範例顯示如何使用 `update-private-dns-namespace`。
**AWS CLI**
**範例 1：使用 ID 更新私有 DNS 命名空間**
下列`update-private-dns-namespace`範例會使用命名空間 ID 更新私有 DNS 命名空間的描述。
```
aws servicediscovery update-private-dns-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
若要確認操作成功，您可以執行 `get-operation`。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html)。
**範例 2：使用 ARN 更新私有 DNS 命名空間**
下列`update-private-dns-namespace`範例會使用私有 DNS 命名空間的 ARN 來更新私有 DNS 命名空間。
```
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."
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdatePrivateDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-private-dns-namespace.html)。
### `update-public-dns-namespace`
以下程式碼範例顯示如何使用 `update-public-dns-namespace`。
**AWS CLI**
**範例 1：使用 ID 更新公有 DNS 命名空間**
下列`update-public-dns-namespace`範例會使用公有 DNS 命名空間的 ID 更新其描述。
```
aws servicediscovery update-public-dns-namespace \
--id ns-abcd1234xmpl5678 \
--updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
--namespace Description="The updated namespace description."
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
若要確認操作成功，您可以執行 `get-operation`。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html)。
**範例 2：使用 ARN 更新公有 DNS 命名空間**
下列`update-public-dns-namespace`範例會使用其 ARN 更新公有 DNS 命名空間。
```
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."
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 命名空間](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdatePublicDnsNamespace](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-public-dns-namespace.html)。
### `update-service-attributes`
以下程式碼範例顯示如何使用 `update-service-attributes`。
**AWS CLI**
**範例 1：更新服務以新增屬性**
下列 `update-service-attributes` 範例會更新指定的服務，以新增具有索引鍵 `Port` 和值 `80` 的服務屬性。
```
aws servicediscovery update-service-attributes \
--service-id srv-abcd1234xmpl5678 \
--attributes Port=80
```
此命令不會產生輸出。
如需詳細資訊，請參閱《*AWS Cloud Map 開發人員指南*》中的 [AWS Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html)。
**範例 2：使用 ARN 更新服務屬性**
下列`update-service-attributes`範例會使用服務 ARN 來更新服務，以新增服務屬性。在與您的帳戶共用的命名空間中建立的 服務中新增屬性時，需要指定 ARN。
```
aws servicediscovery update-service-attributes \
--service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
--attributes Port=80
```
此命令不會產生輸出。
如需詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的 Cloud Map 服務和](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html)*AWS *[共用 Cloud Map 命名空間 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateServiceAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service-attributes.html)。
### `update-service`
以下程式碼範例顯示如何使用 `update-service`。
**AWS CLI**
**範例 1：更新服務**
下列 `update-service` 範例會更新服務以更新 `DnsConfig` 和 `HealthCheckConfig` 設定。
```
aws servicediscovery update-service \
--id srv-abcd1234xmpl5678 \
--service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
若要確認操作成功，您可以執行 `get-operation`。
如需更新服務的詳細資訊，請參閱《[AWS Cloud Map 開發人員指南》中的更新 Cloud Map 服務](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html)。 *AWS *
**範例 2：使用 ARN 更新服務**
下列`update-service`範例會使用服務 ARN 更新服務。在與您帳戶共用的命名空間中建立的服務需要指定 ARN。
```
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}"
```
輸出：
```
{
"OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}
```
如需更新服務的詳細資訊，請參閱[AWS 《Cloud Map 開發人員指南》中的更新 Cloud Map 服務和](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html)*AWS *[共用 Cloud Map 命名空間 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service.html)。