Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Cloud Map 를 사용한 예제 AWS CLI
다음 코드 예제에서는를와 AWS Command Line Interface 함께 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS Cloud Map.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**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 명령 참조*의 [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` 예제에서는 네임스페이스 ID 대신 네임스페이스 ARN을 사용하여 서비스를 생성합니다. 공유 네임스페이스에서 서비스를 생성할 때는 네임스페이스 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 개발자 안내서의 공유 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` 예제에서는 서비스 ID 대신 서비스 ARN을 사용하여 서비스 인스턴스의 등록을 취소합니다. 계정과 공유되는 네임스페이스에서 생성된 서비스에서 인스턴스를 등록 취소할 때 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) 및 [Cloud Map 서비스 인스턴스 등록 취소 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html)를 참조하세요. *AWS *
+ 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` 예제에서는 서비스 ID 대신 서비스 ARN을 사용하여 인스턴스의 속성을 가져옵니다. 계정과 공유되는 네임스페이스와 연결된 인스턴스의 세부 정보를 가져올 때 ARN을 지정해야 합니다. 이 예제에서 반환된 인스턴스는 계정 `123456789012`가 소유한 네임스페이스에 계정 `123456789111`이 등록했습니다.
```
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` 예제에서는 서비스 ID 대신 서비스 ARN을 사용하여 인스턴스의 상태를 가져옵니다. 요청자의 계정과 공유되는 네임스페이스와 연결된 인스턴스의 상태를 가져올 때 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 개발자 안내서의 공유 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 개발자 안내서의 공유 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` 예제에서는 서비스 ID 대신 서비스 ARN을 사용하여 서비스 인스턴스를 나열합니다. 계정과 공유되는 네임스페이스와 연결된 인스턴스를 나열할 때 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 서비스 인스턴스 나열](https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html)을 참조하세요. *AWS *
+ 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 Cloud Map 개발자 안내서의 공유 Cloud Map 네임스페이스를 참조하세요](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` 예제에서는 `RESOURCE_OWNER` 필터를 AWS 사용하여 다른 계정에서 호출자 계정과 공유`123456789012`된 네임스페이스에서 생성된 서비스를 나열합니다.
```
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` 예시에서는 지정된 네임스페이스가 있고 값이 `Engineering`인 `Department` 태그를 연결합니다.
```
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` 예제에서는 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` 예제에서는 ID를 사용하여 퍼블릭 DNS 네임스페이스의 설명을 업데이트합니다.
```
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 서비스 및 공유 Cloud Map 네임스페이스 업데이트를](https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html) [참조하세요 AWS](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html). *AWS *
+ API 세부 정보는 *AWS CLI 명령 참조*의 [UpdateService](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicediscovery/update-service.html)를 참조하세요.