기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Cloud Map 리소스에 태그 지정
태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 *키*와 선택적 *값*으로 구성됩니다.
태그를 사용하면 용도, 소유자 또는 환경을 기준으로 AWS 리소스를 분류할 수 있습니다. 동일한 유형의 리소스가 많은 경우 할당한 태그에 따라 특정 리소스를 빠르게 식별할 수 있습니다. 예를 들어 각 AWS Cloud Map 서비스의 소유자 및 스택 수준을 추적하는 데 도움이 되도록 서비스에 대한 태그 세트를 정의할 수 있습니다. 각 리소스 유형에 대해 일관된 태그 키 집합을 고안하는 것이 좋습니다.
태그가 리소스에 자동으로 할당되는 것은 아닙니다. 태그를 추가한 후에는 언제든지 태그 키와 값을 편집하거나 리소스에서 태그를 제거할 수 있습니다. 리소스를 삭제하면 리소스 태그도 삭제됩니다.
태그는에 의미가 없으며 엄격하게 문자열로 해석 AWS Cloud Map 됩니다. 태그의 값을 빈 문자열로 설정할 수 있지만 태그의 값을 Null로 설정할 수는 없습니다. 해당 리소스에 대해 키가 기존 태그와 동일한 태그를 추가하는 경우 새 값이 이전 값을 덮어씁니다.
AWS Management Console, AWS CLI및 AWS Cloud Map API를 사용하여 태그로 작업할 수 있습니다.
AWS Identity and Access Management (IAM)를 사용하는 경우 태그 생성, 편집 또는 삭제 권한이 있는 AWS 계정의 사용자를 제어할 수 있습니다.
## 리소스 태그 지정 방법
신규 또는 기존 AWS Cloud Map 네임스페이스 및 서비스에 태그를 지정할 수 있습니다.
AWS Cloud Map 콘솔을 사용하는 경우 새 리소스가 생성될 때 태그를 적용하거나 관련 리소스 페이지의 태그 탭을 사용하여 언제든지 기존 리소스에 **태그를** 적용할 수 있습니다.
AWS Cloud Map API AWS CLI, 또는 AWS SDK를 사용하는 경우 관련 API 작업의 `tags` 파라미터를 사용하여 새 리소스에 태그를 적용하거나 [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html) API 작업을 사용하여 기존 리소스에 태그를 적용할 수 있습니다. 자세한 내용은 [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)를 참조하세요.
일부 리소스 생성 작업에서는 리소스 생성 시 리소스에 태그를 지정할 수 있습니다. 리소스 생성 중에 태그를 적용할 수 없는 경우 리소스 생성 프로세스는 실패합니다. 이로써 생성 중에 태그를 지정하려는 리소스는 지정된 태그와 함께 생성되거나 전혀 생성되지 않습니다. 생성 시 리소스에 태그를 지정하면 리소스 생성 후 사용자 지정 태그 지정 스크립트를 실행할 필요가 없습니다.
다음 표에서는 태그를 지정할 수 있는 AWS Cloud Map 리소스와 생성 시 태그를 지정할 수 있는 리소스를 설명합니다.
**AWS Cloud Map 리소스에 대한 태그 지정 지원**
| 리소스 | 태그 지원 | 태그 전달 지원 | 생성 시 태그 지정 지원(AWS Cloud Map API, AWS CLI, AWS SDK) |
| --- | --- | --- | --- |
| AWS Cloud Map 네임스페이스 | 예 | 아니요. 네임스페이스 태그는 네임스페이스에 연결된 다른 리소스로 전파되지 않습니다. | 예 |
| AWS Cloud Map 서비스 | 예 | 아니요. 서비스 태그는 서비스에 연결된 다른 리소스로 전파되지 않습니다. | 예 |
## 제한 사항
태그에 적용되는 기본 제한은 다음과 같습니다.
+ 각 리소스의 최대 태그 수는 50입니다.
+ 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - UTF-8 형식의 유니코드 문자 128자
+ 최대 값 길이 - UTF-8 형식의 유니코드 문자 256자
+ 여러 AWS 서비스 및 리소스에서 태깅 스키마를 사용하는 경우 다른 서비스에 허용되는 문자에 대한 제한이 있을 수 있습니다. 일반적으로 허용되는 문자는 UTF-8로 표시할 수 있는 문자, 숫자 및 공백과 특수 문자 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ `aws:`, `AWS:`또는 키 또는 값에 대한 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. AWS 사용을 위해 예약되어 있습니다. 이 접두사가 지정된 태그 키나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.
# AWS Cloud Map 리소스에 대한 태그 업데이트
다음 AWS CLI 명령 또는 AWS Cloud Map API 작업을 사용하여 리소스에 대한 태그를 추가, 업데이트, 나열 및 삭제합니다.
**AWS Cloud Map 리소스에 대한 태그 지정 지원**
| Task | API 작업 | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| 하나 이상의 태그를 추가하거나 덮어씁니다. | [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/tag-resource.html) | [Add-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Add-SDResourceTag.html) |
| 하나 이상의 태그를 삭제합니다. | [UntagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/untag-resource.html) | [Remove-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-SDResourceTag.html) |
| 리소스에 대한 태그 나열 | [ListTagsForResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListTagsForResource.html) | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-tags-for-resource.html) | [Get-SDResourceTag](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SDResourceTag.html) |
다음 예제는 AWS CLI를 사용하여 리소스에 태그를 지정하거나 태그를 제거하는 방법을 보여줍니다.
**예제 1: 기존 리소스에 태그 지정**
다음 명령은 기존 리소스에 태그를 지정합니다.
```
aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs
```
**예제 2: 기존 리소스에서 태그 제거**
다음 명령은 기존 리소스에서 태그를 삭제합니다.
```
aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**예제 3: 리소스의 태그 나열**
다음 명령은 기존 리소스와 연결된 태그를 나열합니다.
```
aws servicediscovery list-tags-for-resource --resource-arn resource_ARN
```
일부 리소스 생성 작업에서는 리소스를 생성할 때 태그를 지정할 수 있습니다. 다음 태스크는 생성 시 태그 지정을 지원합니다.
| 작업 | API 작업 | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| HTTP 네임스페이스 생성 | [CreateHttpNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateHttpNamespace.html) | [create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html) | [New-SDHttpNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDHttpNamespace.html) |
| DNS를 기반으로 프라이빗 네임스페이스 생성 | [CreatePrivateDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePrivateDnsNamespace.html) | [create-private-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-private-dns-namespace.html) | [New-SDPrivateDnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPrivateDnsNamespace.html) |
| DNS를 기반으로 공용 네임스페이스 생성 | [CreatePublicDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePublicDnsNamespace.html) | [create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html) | [New-SDPublicDnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPublicDnsNamespace.html) |
| 서비스 생성 | [CreateService](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-service.html) | [New-SDService](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDService.html) |