

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AMS Accelerate의 태그 지정
<a name="acc-tagging"></a>

대부분의 Accelerate 기능(패치, 백업, 모니터링)은 *태그*와 *구성 프로파일을* 사용하여 관리할 리소스, 적용할 작업, 적용할 시기를 결정합니다. 태그는 리소스에 적용하는 레이블입니다. 구성 프로필에는 해당 태그를 기반으로 하는 규칙이 포함됩니다.

각 Accelerate 기능에는 고유한 태그 지정 요구 사항이 있습니다. 일부 기능을 사용하려면 특정 태그를 사용해야 하지만 다른 기능을 사용하면 원하는 태그를 사용할 수 있습니다.

필수 태그에 대한 자세한 내용은 섹션을 참조하세요[Accelerate의 고객 관리형 태그](acc-tag-req.md).

고객을 정의할 수 있는 태그에 대한 자세한 내용은 섹션을 참조하세요. [Accelerate의 고객 제공 태그](acc-tag-cust-provided.md) 

**Contents**
+ [태그](acc-tag-intro.md)
  + [태그란 무엇입니까?](acc-tag-intro.md#acc-tag-what-is)
  + [태그 지정 작동 방식](acc-tag-intro.md#acc-tag-how-works)
  + [고객 관리형 태그](acc-tag-req.md)
    + [모니터링](acc-tag-req-mon.md)
    + [EC2 인스턴스 구성](acc-tag-req-ins-config.md)
    + [백업](acc-tag-req-backup.md)
  + [Accelerate 관리형 태그](acc-tag-infra.md)
  + [고객 제공 태그](acc-tag-cust-provided.md)
+ [태그 관리 도구](acc-tag-tools.md)
  + [리소스 태거](acc-resource-tagger.md)
    + [Resource Tagger란 무엇입니까?](acc-resource-tagger.md#acc-rt-what-is)
    + [Resource Tagger 작동 방식](acc-resource-tagger.md#acc-rt-how-works)
    + [구성 프로파일](acc-tag-tools-profiles.md)
      + [구문 및 구조](acc-tag-tools-profiles.md#acc-rt-config-doc-format)
    + [사용 사례](acc-rt-using.md)
      + [Resource Tagger에서 적용한 태그 보기](acc-rt-using.md#acc-rt-using-view-tags)
      + [Resource Tagger를 사용하여 태그 생성](acc-rt-using.md#acc-tag-how-works-rt)
      + [Resource Tagger의 리소스 수정 방지](acc-rt-using.md#acc-rt-preventing-rt-changes)
      + [예제 구성 프로필](acc-rt-using.md#acc-rt-using-ex-config-doc)
      + [기본 구성 병합](acc-rt-using.md#acc-rt-using-merge-default-config)
      + [기본 구성 비활성화](acc-rt-using.md#acc-rt-using-disable-default-config)
      + [Resource Tagger에서 적용한 태그 제거](acc-rt-using.md#acc-rt-remove-tags)
      + [Resource Tagger 구성 보기 또는 변경](acc-rt-using.md#acc-rt-make-changes)
      + [구성 변경 사항 배포](acc-rt-using.md#acc-rt-deploy-changes)
      + [Resource Tagger 태그를 무시하도록 Terraform 구성](acc-rt-using.md#acc-rt-ignore-tags)
      + [Resource Tagger에서 관리하는 리소스 수 보기](acc-rt-using.md#acc-rt-number-of-resources)
  + [CloudFormation](acc-tag-how-works-cfn.md)
    + [사용 사례](acc-tag-tools-cf-ex.md)
      + [EC2 태그 지정](acc-tag-cf-ex-tag-ec2.md)
      + [ASG 태그 지정](acc-tag-cf-ex-tag-asg.md)
      + [구성 프로필 배포](acc-tag-cf-ex-deploy-config.md)
  + [Terraform](acc-tag-tools-terraform.md)

# AMS Accelerate의 태그
<a name="acc-tag-intro"></a>

**Contents**
+ [태그란 무엇입니까?](#acc-tag-what-is)
+ [태그 지정 작동 방식](#acc-tag-how-works)
+ [Accelerate의 고객 관리형 태그](acc-tag-req.md)
  + [Accelerate의 모니터링](acc-tag-req-mon.md)
  + [Accelerate에서 EC2 인스턴스에 대한 태그 구성](acc-tag-req-ins-config.md)
  + [Accelerate에서 백업 태그 관리](acc-tag-req-backup.md)
+ [Accelerate 관리형 태그](acc-tag-infra.md)
+ [Accelerate의 고객 제공 태그](acc-tag-cust-provided.md)

## 태그란 무엇입니까?
<a name="acc-tag-what-is"></a>

태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

태그를 사용하여 용도, 소유자 또는 환경 등 다양한 방식으로 AWS 리소스를 분류합니다. 예를 들어 계정의 Amazon EC2 인스턴스에 대한 태그 세트를 정의하여 각 인스턴스의 소유자 및 스택 수준을 추적할 수 있습니다.

태그는 Amazon EC2에는 의미가 없으며 엄격하게 문자열로 해석됩니다.

자세한 내용은 [AWS 리소스 태그 지정을 참조하세요](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).

## 태그 지정 작동 방식
<a name="acc-tag-how-works"></a>

리소스에 태그를 적용하는 방법에는 여러 가지가 있습니다. 리소스를 생성할 때 각 AWS 서비스의 콘솔에서 직접 리소스에 태그를 지정하거나, AWS [태그 편집기](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)를 사용하여 여러 리소스에 대한 태그를 추가, 제거 또는 편집하거나, 리소스 태그와 같은 CloudFormation 프로비저닝 도구를 사용할 수 있습니다. [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html) 또한 AMS Accelerate는 자동화된 태그 수명 주기 관리자에 대한 규칙을 정의하는 데 사용하는 AMS Accelerate 리소스 태거도 제공합니다. AMS Accelerate에서 Resource Tagger를 사용하는 방법에 대한 자세한 내용은 섹션을 참조하세요[리소스 태거 가속화](acc-resource-tagger.md). 또한 AMS Accelerate는 AMS 리소스에 사용자 지정 태그를 추가 및 제거할 수 있는 고객 제공 태그를 제공합니다. 고객 제공 태그에 대한 자세한 내용은 섹션을 참조하세요[Accelerate의 고객 제공 태그](acc-tag-cust-provided.md).

# Accelerate의 고객 관리형 태그
<a name="acc-tag-req"></a>

다양한 AMS Accelerate 작업을 트리거하려면 특정 태그가 필요합니다.

**Contents**
+ [Accelerate의 모니터링](acc-tag-req-mon.md)
+ [Accelerate에서 EC2 인스턴스에 대한 태그 구성](acc-tag-req-ins-config.md)
+ [Accelerate에서 백업 태그 관리](acc-tag-req-backup.md)

# Accelerate의 모니터링
<a name="acc-tag-req-mon"></a>

AMS Accelerate는 지원되는 리소스의 상태, 가용성 및 신뢰성을 모니터링합니다. 이 서비스 상품에 대한 자세한 내용은 섹션을 참조하세요[AMS Accelerate의 모니터링 및 이벤트 관리](acc-mon-event-mgmt.md).

AMS Accelerate는 기준 모니터링 AWS 서비스 에 추가로 주기적으로 온보딩합니다. Resource Tagger 기본 구성을 사용하는 경우 이러한 업데이트가 계정에 자동으로 배포되고 변경 사항이 지원되는 리소스에 반영됩니다.

AMS Accelerate에서 Amazon EC2 인스턴스를 관리하도록 옵트인하려면 AppConfig의 사용자 지정 프로파일을 통해 다음 태그를 적용해야 합니다. 자세한 내용은 [ 3단계: 구성 및 구성 프로파일 생성을](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-creating-configuration-and-profile.html) 참조하세요.

리소스에 다음 태그를 적용합니다.


| 키 | 값 | 
| --- | --- | 
| ams:rt:ams-managed | true | 

예를 들어 다음과 같은 사용자 지정 구성 문서를 생성하여 모든 AMS 지원 EC2 리소스에 태그를 적용할 수 있습니다.

```
{
    "AWS::EC2::Instance": {
        "AllEC2": {
            "Enabled": true,
            "Filter": {
                "Platform": "*"
            },
            "Tags": [
                {
                    "Key": "ams:rt:ams-managed",
                    "Value": "true"
                }
            ]
        }
    }
}
```

**중요**  
구성 변경 사항을 적용한 후에는 배포해야 합니다. SSM AppConfig에서는 구성을 생성한 후 새 버전의 구성을 배포해야 합니다.

Amazon EC2 이외의 서비스에는 기본 기준 모니터링이 있습니다. AMS Accelerate에서 모니터링할 리소스를 *옵트아웃*하려면 사용자 지정 구성 프로파일을 사용하여 특정 리소스 또는를 제외할 수 있습니다 AWS 서비스. 이를 통해 기준 경보 정의를 배포하기 위해 모니터링 태그가 있어야 하는 리소스를 제어할 수 있습니다. [AMS Accelerate의 Resource Tagger 사용 사례](acc-rt-using.md)을(를) 참조하세요.

**Resource Tagger 사용**

계정의 AMS Accelerate Resource Tagger 구성은이 하나의 태그(**ams:rt:ams-managed**)를 적용하는 경우 다음 태그가 자동으로 배포되도록 하는 데 도움이 됩니다.

**기준 모니터링을 위해 지원되는 리소스에 다음 태그가 적용되는 것을 확인할 수 있습니다.**


| 키 | 값 | 규칙 | 
| --- | --- | --- | 
| ams:rt:ams-monitoring-policy | ams-monitored | AMS에서 지원하는 모든 EC2 리소스에 적용됩니다. | 
| ams:rt:ams-monitoring-policy-platform | ams-monitored-linux | Linux OS를 실행하는 모든 Amazon EC2 인스턴스에 적용됩니다. | 
| ams:rt:ams-monitoring-policy-platform | ams-monitored-windows | Windows OS를 실행하는 모든 Amazon EC2 인스턴스에 적용됩니다. | 

**기타 지원되는 서비스의 경우**

지정된 규칙에 따라 리소스에 다음 태그를 적용합니다.


| 키 | 값 | 규칙 | 
| --- | --- | --- | 
| ams:rt:ams-monitoring-policy | ams-monitored | AMS Accelerate 모니터링에서 지원하는 모든 리소스에 적용됩니다. | 
| ams:rt:ams-monitoring-with-kms | ams-monitored-with-kms | KMS를 사용하는 OpenSearch 도메인  | 
| ams:rt:ams-monitoring-with-master  | ams-monitored-with-master | 전용 마스터 노드가 있는 OpenSearch 도메인 | 

**Resource Tagger를 사용하지 않는 경우**

AMS Resource Tagger 사용 이외의 방법을 사용하여 올바른 모니터링 태그를 적용하는 방법에 [Resource Tagger 없이 태그 가속화](acc-mem-tags-no-rt.md) 대한 도움말은 섹션을 참조하세요.

# Accelerate에서 EC2 인스턴스에 대한 태그 구성
<a name="acc-tag-req-ins-config"></a>

AMS Accelerate는 SSM 에이전트 및 CloudWatch 에이전트와 같은 Amazon EC2 인스턴스에서 에이전트를 관리합니다. 이 서비스 상품에 대한 자세한 내용은 섹션을 참조하세요. [AMS Accelerate의 자동 인스턴스 구성](acc-inst-auto-config.md) 

Amazon EC2 인스턴스를 AMS Accelerate에서 관리하도록 옵트인하려면 Amazon EC2 인스턴스에 다음 태그를 적용해야 합니다.


| 키 | 값 | 
| --- | --- | 
| ams:rt:ams-managed | true | 

# Accelerate에서 백업 태그 관리
<a name="acc-tag-req-backup"></a>

AMS Accelerate는 지원되는 리소스의 백업을 관리합니다. 이 서비스 상품에 대한 자세한 내용은 섹션을 참조하세요[AMS Accelerate의 연속성 관리](acc-backup.md).

AMS Accelerate 백업 관리는 태그를 사용하여 자동으로 백업해야 하는 리소스를 식별합니다(수동 백업 기능도 제공). 태그 키:값 조합을 사용하여 리소스를 백업 계획과 연결할 수 있습니다. **ams-default-backup-plan** AWS Backup 계획을 사용하여 자동 백업을 옵트인하려면 지원되는 리소스에 다음 태그를 적용해야 합니다.


| 키 | 값 | 
| --- | --- | 
| ams:rt:backup-orchestrator | true | 

**참고**  
온보딩 중에 AMS Accelerate는 짧은 간격, 짧은 보존 스냅샷에 대해 값이 **true**인 **ams:rt:backup-orchestrator-onboarding**으로 모든 리소스에 태그를 지정합니다. 이는 **ams-onboarding-backup-plan** 백업 계획에 의해 관리됩니다. AMS Accelerate 관리형 AWS Backup 플랜에 대한 자세한 내용은 섹션을 참조하세요[AMS 백업 계획 선택](acc-backup-select-plan.md).

# Accelerate 관리형 태그
<a name="acc-tag-infra"></a>

AMS Accelerate에 온보딩하는 동안 계정에 여러 AWS 리소스가 배포됩니다. 이를 식별할 수 있도록 이러한 리소스에는 다음과 같은 태그가 지정됩니다.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/managedservices/latest/accelerate-guide/acc-tag-infra.html)

**참고**  
이러한 태그는 CloudFormation 스택 수준 태그를 사용하여 적용되며 생성된 리소스에 태그를 CloudFormation 전파하는 데 의존합니다. 자세한 내용은 [ 리소스 태그를](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html) 참조하세요.

# Accelerate의 고객 제공 태그
<a name="acc-tag-cust-provided"></a>

**고객 제공 태그란 무엇입니까?**

고객 제공 태그는 계정에서 AMS 리소스에 태그를 지정하는 방법을 제어하는 규칙을 지정하는 데 사용되는 AMS Accelerate 서비스 기능입니다. 고객 제공 태그를 사용하면 계정에 배포된 AMS 리소스에 사용자 정의 사용자 지정 태그를 추가할 수 있습니다. 자동화된 서비스를 사용하여 Cloud Service Delivery Manager(CSDM)에 요청할 때 고객 제공 태그 기능이 요청된 계정에 자동으로 추가됩니다. [AMS 태그](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-tag-infra.html)는 재정의할 수 없습니다. AMS 태그는 'ams:'로 시작합니다.

자체 [태그](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-tag-intro.html)(레이블)를 정의하고 모든 [AMS Accelerate 리소스](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-resource-inventory.html)에 대해 이러한 태그의 기능을 지정할 수 있습니다. AMS에 온보딩하기 전에 이러한 태그를 제공하여 AMS 태그와 사용자 지정 태그가 온보딩 프로세스 중에 적용되도록 할 수 있습니다. 또는 온보딩 후 태그를 제공할 수 있습니다.

**고객 제공 태그를 추가하려면 어떻게 해야 하나요?**

리소스에 이러한 태그를 추가하도록 요청하려면 [CSDM에 문의하십시오](https://docs.aws.amazon.com/managedservices/latest/accelerate-guide/acc-contact-escalate.html). 이러한 태그는 계정의 AMS 리소스에 적용됩니다.

**태그의 범위는 어떻게 됩니까?**

이 기능은 현재 Accelerate 고객 및 AWS 상용 리전에서만 사용할 수 있습니다. 소유한 모든 계정 또는 특정 계정 목록에 태그를 추가할 수 있습니다.

**참고**  
이러한 태그는 AMS 리소스에만 적용되며 자체 리소스에는 영향을 주지 않습니다.

# Accelerate용 태그 관리 도구
<a name="acc-tag-tools"></a>

**목차**
+ [리소스 태거 가속화](acc-resource-tagger.md)
+ [CloudFormation을 사용하여 AMS Accelerate에 대한 태그 생성](acc-tag-how-works-cfn.md)
+ [Terraform을 사용하여 AMS Accelerate용 태그 생성](acc-tag-tools-terraform.md)

# 리소스 태거 가속화
<a name="acc-resource-tagger"></a>

 Resource Tagger를 사용하면 계정에서 AWS 리소스에 태그를 지정하는 방법을 제어하는 규칙을 지정할 수 있습니다. 계정을 온보딩하는 동안 AMS Accelerate는 태그 지정 정책을 배포하여 관리형 계정 내의 리소스에 태그가 지정되도록 합니다.

**Contents**
+ [Resource Tagger란 무엇입니까?](#acc-rt-what-is)
+ [Resource Tagger 작동 방식](#acc-rt-how-works)
+ [AMS Accelerate의 리소스 태거 구성 프로파일](acc-tag-tools-profiles.md)
  + [구문 및 구조](acc-tag-tools-profiles.md#acc-rt-config-doc-format)
+ [AMS Accelerate의 Resource Tagger 사용 사례](acc-rt-using.md)
  + [Resource Tagger에서 적용한 태그 보기](acc-rt-using.md#acc-rt-using-view-tags)
  + [Resource Tagger를 사용하여 태그 생성](acc-rt-using.md#acc-tag-how-works-rt)
  + [Resource Tagger의 리소스 수정 방지](acc-rt-using.md#acc-rt-preventing-rt-changes)
  + [예제 구성 프로필](acc-rt-using.md#acc-rt-using-ex-config-doc)
  + [기본 구성 병합](acc-rt-using.md#acc-rt-using-merge-default-config)
  + [기본 구성 비활성화](acc-rt-using.md#acc-rt-using-disable-default-config)
  + [Resource Tagger에서 적용한 태그 제거](acc-rt-using.md#acc-rt-remove-tags)
  + [Resource Tagger 구성 보기 또는 변경](acc-rt-using.md#acc-rt-make-changes)
  + [구성 변경 사항 배포](acc-rt-using.md#acc-rt-deploy-changes)
  + [Resource Tagger 태그를 무시하도록 Terraform 구성](acc-rt-using.md#acc-rt-ignore-tags)
  + [Resource Tagger에서 관리하는 리소스 수 보기](acc-rt-using.md#acc-rt-number-of-resources)

## Resource Tagger란 무엇입니까?
<a name="acc-rt-what-is"></a>

Resource Tagger는 계정에서 AWS 리소스에 태그를 지정하는 방법을 제어하는 규칙을 지정하는 데 사용하는 AMS Accelerate 서비스입니다. 이는 태그가 리소스에 적용되는 방식에 대한 완전한 가시성을 제공하는 것을 목표로 합니다 AWS .

Resource Tagger는 구성 프로필에서 지정한 태그 지정 규칙에 따라 지원되는 AWS 리소스에 태그를 자동으로 생성, 업데이트 및 삭제합니다. 예를 들어 Amazon EC2 인스턴스 컬렉션에 태그를 적용하는 규칙을 지정하여 AMS Accelerate에서 관리해야 함을 나타내면 인스턴스가 모니터링되거나 백업됩니다. 이와 같은 태그를 사용하여 AWS AppConfig 구성 프로필에 정의된 정책을 기반으로 리소스의 규정 준수 상태를 AWS 식별할 수 있습니다. 자세한 내용은 [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html) 단원을 참조하십시오.

AMS Accelerate는 기본 관리형 태그 지정 구성을 제공하므로 AMS Accelerate에서 리소스를 모니터링할 수 있습니다. AMS Accelerate에서 관리해야 하는 리소스를 정의하면 관리형 태그 지정 규칙을 통해 AMS Accelerate에서 적절한 태그를 가진 리소스를 모니터링할 수 있습니다.

Resource Tagger를 사용하면 기본 AMS Accelerate 관리형 태그를 재정의하거나 비활성화하고, 정책에 맞는 자체 태그 지정 규칙을 제공하고, 드리프트를 방지하기 위해 Terraform과 같은 다른 메커니즘을 사용할 수 있습니다. 작업에 따라 확장할 예외를 정의할 수 있습니다. 예를 들어 지원되는 플랫폼(예: Windows 및 Linux)이 있는 모든 Amazon EC2 인스턴스에 태그를 적용하고 특정 인스턴스 IDs.

**중요**  
Resource Tagger는 **ams:rt:** 접두사가 있는 계정의 모든 태그를 제어합니다. 이 접두사로 시작하는 모든 태그는 Resource Tagger의 구성 규칙에 없는 한 삭제됩니다. 요약하자면 **ams:rt:**로 시작하는 지원되는 리소스의 모든 태그는 Resource Tagger가 소유한 것으로 간주됩니다. **ams:rt:**와 같이 수동으로 태그를 지정하면 Resource Tagger 구성 프로필 중 하나에 지정되지 않은 태그가 자동으로 제거됩니다.

## Resource Tagger 작동 방식
<a name="acc-rt-how-works"></a>

계정이 AMS Accelerate에 온보딩되면의 계정에 두 개의 JSON 구성 문서가 배포됩니다 AWS AppConfig. *구성 프로필*이라고 하는 두 문서는 기본 구성 프로필이라고 하는 **AMSManagedTags**와 **사용자 지정** 구성 프로필이라고 하는 **CustomerManagedTags**입니다. **** 사용자 지정 구성 프로파일을 사용하여 계정에 대한 자체 정책 및 규칙을 정의하면 AMS Accelerate에서 이를 덮어쓰지 않습니다.

두 프로파일 모두 **AMSResourceTagger** 애플리케이션과 **AMSInfrastructure** 환경에 있습니다. 리소스 태거가 적용하는 모든 태그에는 키 접두사 **ams:rt:**가 있습니다.

**사용자 지정 구성 프로필**:

사용자 지정 구성 프로필은 처음에 계정 온보딩 시 비어 있지만, 프로필 문서에 배치된 모든 규칙은 기본 구성 프로필의 규칙 외에도 적용됩니다. 사용자 지정 구성 프로필의 모든 구성은 전적으로 사용자가 관리하며 요청을 제외하고 AMS Accelerate에서 덮어쓰지 않습니다.

지원되는 AWS 리소스의 사용자 지정 구성 프로필에서 원하는 사용자 지정 태그 지정 규칙을 지정할 수 있으며, 여기에서 AMS Accelerate 관리형 기본 구성에 대한 수정을 지정할 수도 있습니다. 섹션을 참조하세요[AMS Accelerate의 Resource Tagger 사용 사례](acc-rt-using.md).

**중요**  
이 프로필을 업데이트하면 Resource Tagger는의 모든 관련 리소스에 변경 사항을 자동으로 적용합니다 AWS 계정. 변경 사항은 자동으로 적용되지만 적용되는 데 최대 60분이 걸릴 수 있습니다.

를 사용하거나 AWS CLI/SDK 도구를 AWS Management Console통해이 프로파일을 업데이트할 수 있습니다. 사용자 지정 구성 프로필 업데이트에 대한 자세한 내용은 AWS AppConfig 사용 설명서:[란 무엇입니까 AWS AppConfig?](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html)를 참조하세요.

**기본 구성 프로필**:

기본 구성 프로필 문서는 AMS Accelerate의 내부 문서이며 영구적으로 수정하거나 삭제할 수 없는 AMS Accelerate 제공 기본 규칙을 포함합니다. 이 프로필은 AMS Accelerate에서 언제든지 업데이트할 수 있으며 검토할 수 있습니다. 프로필을 변경하면 자동으로 삭제됩니다. 사용자 지정 구성 프로파일을 사용하는 기본 구성 규칙을 수정하거나 비활성화하려면 섹션을 참조하세요[AMS Accelerate의 Resource Tagger 사용 사례](acc-rt-using.md).

# AMS Accelerate의 리소스 태거 구성 프로파일
<a name="acc-tag-tools-profiles"></a>

구성 프로필을 사용하면 리소스 수명 주기 동안 리소스에 태그를 균일하게 적용할 수 있습니다.

## 구문 및 구조
<a name="acc-rt-config-doc-format"></a>

구성 프로필은 다음 구조의 JSON 객체입니다.

```
{
   "Options": {
      "ReadOnly": false
   },
   "ResourceType": {
      "ConfigurationID": {
			   "Enabled": true,
			   "Filter": { ... },
			   "Tags": [  ...  ]
      },
      "ConfigurationID": {
			   ...
      }
   },
   "ResourceType": {
		   ...
   }
}
```

**옵션**: (선택 사항) ResourceTagger의 작동 방식에 대한 옵션을 지정합니다. 블록을 생략하는 것은 모든 옵션을 기본값으로 설정하는 것과 같습니다. 사용 가능한 **옵션** 설정은 아래를 참조하세요.
+ **ReadOnly**: (선택 사항, 기본값은 false): Resource Tagger에 대한 ReadOnly 모드를 지정합니다. AWS 리소스에서 태그를 생성하거나 제거하는 Resource Tagger를 비활성화하려면 ReadOnly를 true로 설정합니다. 자세한 내용은 [Resource Tagger의 리소스 수정 방지](acc-rt-using.md#acc-rt-preventing-rt-changes) 단원을 참조하십시오.

**ResourceType**:이 키는 다음 지원되는 문자열 중 하나여야 하며 표시된 리소스 유형과 관련된 모든 구성을 나타냅니다.
+ AWS::AutoScaling::AutoScalingGroup
+ AWS::DynamoDB::Table
+ AWS::EC2::Instance
+ AWS::EC2::NatGateway
+ AWS::EC2::VPNConnection
+ AWS::EFS::FileSystem
+ AWS::EKS::Cluster
+ AWS::ElasticLoadBalancing::LoadBalancer
+ AWS::ElasticLoadBalancingV2::LoadBalancer
+ AWS::Elasticsearch::Domain
+ AWS::FSx::FileSystem
+ AWS::OpenSearch::Domain
+ AWS::RDS::DBCluster
+ AWS::RDS::DBInstance
+ AWS::Redshift::Cluster
+ AWS::S3::Bucket
+ AWS::Synthetics::Canary

**ConfigurationID**:이 키는 프로파일 문서에서 고유해야 하며 다음 구성 블록의 이름을 고유하게 지정해야 합니다. 동일한 **ResourceType** 블록에 있는 두 구성 블록의 **ConfigurationID**가 동일한 경우 프로파일에 마지막으로 나타나는 구성 블록이 적용됩니다. 사용자 지정 프로파일에서 기본 문서에 지정된 것과 동일한 **ConfigurationID**를 지정하면 사용자 지정 프로파일에 정의된 구성 블록이 적용됩니다.

**중요**  
**ConfigurationID**는 AMS Accelerate 프로파일과 겹치지 ***않아야*** 합니다. 예를 들어 **AMSMonitoringLinux** 또는 **AMSMonitoringWindows**가 아니어야 합니다. 그렇지 않으면 **AMSManagedTags** 구성 프로파일의 각 구성을 비활성화합니다.

**활성화됨**(선택 사항, 기본값은 **true**): 구성 블록이 적용되는지 여부를 지정합니다. 구성 블록을 비활성화****하려면 false로 설정합니다. 비활성화된 구성 블록은 효과가 없습니다.

**필터**: 구성이 적용되는 리소스를 지정합니다. 각 필터 객체에는 다음 필드 중 하나(하나만)가 있을 수 있습니다.
+ **AWS::AutoScaling::AutoScalingGroup**:
  + **AutoScalingGroupName**: Autoscaling 그룹 이름입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::DynamoDB::Table**:
  + **TableName**: DynamoDB 테이블의 이름입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::EC2::Instance**:
  + **AvailabilityZone**: 필터가 지정된 가용 영역의 EC2 인스턴스와 일치합니다. 이 필드는 와일드카드 일치를 지원하므로 **\$1a**는 us-east-1a, ap-northeast-1a 등과 일치합니다.
  + **InstanceId**: 필터가 지정된 인스턴스 ID를 가진 EC2 인스턴스와 일치합니다. 이 필드는 와일드카드 일치를 지원하므로 **i-00000\$1**은 인스턴스 ID가 **i-00000**으로 시작하는 모든 인스턴스와 일치합니다.
  + **플랫폼**: 필터가 지정된 플랫폼과 EC2 인스턴스를 일치시킵니다. 유효한 값은 **창**, Linux **** 또는 와일드카드 **\$1**(모든 플랫폼과 일치)입니다.
+ **AWS::EC2::NatGateway**:
  + **NatGatewayId**: NAT 게이트웨이의 ID입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **상태**: NAT 게이트웨이의 상태(보류 중 \$1 실패 \$1 사용 가능 \$1 삭제 \$1 삭제됨 또는 와일드카드 "\$1")
  + **VpcId**: NAT 게이트웨이가 있는 VPC의 ID입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **SubnetId**: NAT 게이트웨이가 있는 서브넷의 ID입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::EC2::VPNConnection**:
  + **VpnConnectionId**: 연결의 ID입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::EFS::FileSystem**:
  + **FileSystemId**: EFS 파일 시스템의 ID입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::EKS::Cluster**:
  + **ClusterName**: 클러스터의 이름입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::ElasticLoadBalancing::LoadBalancer(Classic Load Balancer)**:
  + **LoadBalancerName**: LoadBalancer 이름입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **스키마**: "인터넷 경계", "내부" 또는 와일드카드 "\$1"일 수 있습니다.
  + **VPCId**: 로드밸런서가 배포되는 VPCId로, 와일드카드 "\$1"일 수 있습니다.
+ **AWS::ElasticLoadBalancingV2::LoadBalancer(Application Load Balancer(ALB))**:
  + **LoadBalancerArn**: LoadBalancer Amazon 리소스 이름(ARN).
  + **DNSName**: LoadBalancer의 DNSName입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **LoadBalancerName**: LoadBalancer 이름입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::Elasticsearch::Domain**:
  + **DomainId**: ElasticSearch 리소스의 DomainId입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **DomainName**: ElasticSearch 리소스의 DomainName입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **HasMasterNode**: true 또는 false의 부울 값입니다. 도메인에 전용 마스터 노드가 있는 경우 일치합니다.
  + **HasKmsKey** 부울 값이 true 또는 false입니다. 도메인에 저장 시 암호화를 위한 KMS 키가 있는 경우 일치합니다.
+ **AWS::FSx::FileSystem**:
  + **FileSystemId**: FSx 파일 시스템의 ID입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::OpenSearch::Domain**:
  + **DomainId**: OpenSearch 리소스의 DomainId입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **DomainName**: OpenSearch 리소스의 DomainName입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **HasMasterNode**: 부울, 도메인에 전용 마스터 노드가 있는 경우 true로 설정할 수 있습니다.
  + **HasKmsKey**: 도메인에 저장 시 암호화를 위한 KMS 키가 있는 경우 true로 설정할 수 있습니다.
+ **AWS::RDS::DBCluster**:
  + **DBClusterIdentifier**: 필터가 RDS 클러스터 식별자와 지정된 식별자를 일치시킵니다. 이 필드는 와일드카드 일치를 지원하지 않으므로 클러스터 식별자를 지정해야 합니다.
  + **엔진**: RDS 인스턴스에서 사용 중인 엔진입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **EngineVersion**: 엔진 버전입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::RDS::DBInstance**:
  + **DBInstanceIdentifier**: 필터가 지정된 인스턴스 ID를 가진 RDS 인스턴스와 일치합니다. 이 필드는 와일드카드 일치를 지원하지 않으므로 인스턴스 식별자를 지정해야 합니다.
  + **엔진**: RDS 인스턴스에서 사용 중인 엔진입니다. 이 필드는 와일드카드 일치를 지원합니다.
  + **EngineVersion**: 엔진 버전입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::Redshift::Cluster**:
  + **ClusterIdentifier**: 클러스터 식별자입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::S3::Bucket**:
  + **BucketName**: S3 버킷의 이름입니다. 이 필드는 와일드카드 일치를 지원합니다.
+ **AWS::Synthetics::Canary**:
  + **CanaryName**: Synthetics canary의 이름입니다.

**기타 필터 속성:**
+ **태그**: 필터는 지정된 태그가 이미 적용된 모든 리소스에 적용됩니다. 이 속성의 값은 다음 필드가 있는 JSON 객체여야 합니다.
  + **키**: 정확한 문자열이어야 하며 리소스에 정확한 키가 있는 태그가 있도록 지정합니다.
  + **값**: 태그의 일치하는 값을 지정합니다. 와일드카드를 지원하므로 **샘플** 값은 문자열 **샘플**로 끝나는 모든 값과 일치합니다.
+ **Fn::AND**: JSON 객체의 JSON 배열입니다. 각 객체는 **필터** 구성 블록과 동일한 규칙을 따릅니다. 이는 필터가 모든 하위 필터와 일치하는 모든 리소스와 일치하도록 지정합니다.
+ **Fn::OR**: JSON 객체의 JSON 배열입니다. 각 객체는 **필터** 구성 블록과 동일한 규칙을 따릅니다. 이는 필터가 하위 필터와 일치하는 모든 리소스와 일치하도록 지정합니다.
+ **Fn::NOT**: **필터** 구성 블록과 동일한 규칙을 따르는 JSON 객체입니다. 이는 필터가 하위 필터와 일치하는 리소스와 명시적으로 일치하지 않도록 지정합니다. 이를 사용하여 태그 지정 규칙에 대한 제외 항목을 지정합니다.

**태그**: 일치하는 리소스에 적용할 태그입니다. ([태그 이름 지정 및 사용 규칙](https://docs.aws.amazon.com/mediaconnect/latest/ug/tagging-restrictions.html) 참조) 이 필드는 키-값 페어의 배열입니다.
+ **키**: 적용할 태그의 키입니다.
+ **값**: 적용할 태그의 값입니다.

**참고**  
Resource Tagger에서 적용하는 태그에는 항상 **ams:rt:**로 시작하는 키가 있습니다. 프로필에이 접두사를 지정하지 않으면 Resource Tagger가 이를 삽입합니다. 이렇게 하면 Resource Tagger가 소유 및 관리하는 태그를 다른 도구에서 다른 목적으로 사용하는 태그와 구별할 수 있습니다.

# AMS Accelerate의 Resource Tagger 사용 사례
<a name="acc-rt-using"></a>

이 섹션에서는 Resource Tagger에서 일반적으로 수행되는 작업을 나열합니다.

## Resource Tagger에서 적용한 태그 보기
<a name="acc-rt-using-view-tags"></a>

Resource Tagger에서 적용하는 모든 태그에는 **ams:rt:라는 키 접두사가 있습니다.** 예를 들어 다음 태그 정의는 키 **ams:rt:sampleKey** 및 값 **sampleValue**가 있는 태그를 생성합니다. 이 접두사가 있는 모든 태그는 Resource Tagger의 일부로 취급됩니다.

```
{
	"Key": "sampleKey",
	"Value": "sampleValue"
}
```

**중요**  
**ams:rt:** 접두사를 사용하여 자체 태그를 수동으로 생성하는 경우 Resource Tagger에서 관리하는 것으로 간주됩니다. 즉, Resource Tagger에서 리소스를 관리하지만 구성 프로필에 태그를 적용해야 한다고 표시되지 않는 경우 Resource Tagger는 수동으로 추가된 태그를 제거합니다. Resource Tagger에서 관리하는 리소스에 수동으로 태그를 지정하는 경우 태그 키에 **ams:rt:** 접두사를 사용하지 마십시오.

## Resource Tagger를 사용하여 태그 생성
<a name="acc-tag-how-works-rt"></a>

AMS Accelerate 리소스 태거는 AMS Accelerate 온보딩 중에 계정에 배포되는 구성 요소입니다. Resource Tagger에는 리소스에 태그를 지정하는 방법을 정의하는 구성 가능한 규칙 세트가 있습니다. 그런 다음 해당 규칙을 적용하여 리소스에 태그를 자동으로 추가 및 제거하여 규칙을 준수하는지 확인합니다.

Resource Tagger를 사용하여 리소스에 태그를 지정하려면 섹션을 참조하세요[리소스 태거 가속화](acc-resource-tagger.md).

다음은 모든 Amazon EC2 인스턴스에 값이 **true**인 **ams:rt:ams-managed** 태그를 추가하는 Resource Tagger 구성 코드 조각의 예입니다. **ams:rt:ams-managed** 태그는 AMS Accelerate에서 리소스를 모니터링하도록 옵트인합니다.

```
{
    "AWS::EC2::Instance": {
        "SampleConfigurationBlock": {
            "Enabled": true,
            "Filter": {
                "Platform": "*"
            },
            "Tags": [
                {
                    "Key": "ams:rt:ams-managed",
                    "Value": "true"
                }
            ]
        }
    }
}
```

**주의**  
새 구성의 이름(`SampleConfigurationBlock`제공된 예의 )을 지정할 때는 AMS 관리형 구성을 동일한 이름으로 실수로 재정의할 수 있으므로 주의해야 합니다.

## Resource Tagger의 리소스 수정 방지
<a name="acc-rt-preventing-rt-changes"></a>

Resource Tagger는 리소스에 태그를 추가하거나 제거하지 못하도록 읽기 전용 모드로 설정할 수 있습니다. 이는 자체 태그 지정 메커니즘을 제공하려는 경우에 유용합니다.

읽기 전용 모드인 경우에도 Resource Tagger는 관리형 및 고객 구성 프로필에 지정된 태그 지정 규칙을 검사하고 이러한 태그 지정 규칙을 충족하지 않는 리소스를 검사합니다. 규정을 준수하지 않는 리소스는 모두 표시됩니다 AWS Config. 찾을 수 AWS Config 규칙 있는 에는 `AMSResourceTagger-` 접두사가 있습니다. 예를 들어 `AMSResourceTagger-EC2Instance` AWS Config 규칙은 구성 프로파일을 기반으로 `AWS::EC2::Instance` 리소스에 대한 적절한 태그가 생성되었는지 평가합니다.

Resource Tagger는이 시점에서 중지되며 리소스를 변경하지 않습니다(태그를 추가하거나 제거하지 않음).

**옵션** 블록에 **ReadOnly** 키를 포함하도록 고객 구성 프로필을 수정하여 읽기 전용 모드를 활성화할 수 있습니다. 예를 들어 다음 구성 프로파일 코드 조각은이 모양이 어떻게 보일 수 있는지 보여줍니다.

```
{
    "Options": {
        "ReadOnly": true
    },
    "AWS::EC2::Instance": {
        [... the rest of your configuration ...]
    }
}
```

Resource Tagger는 배포가 완료되는 즉시이 새 구성에 반응하고 리소스에 대한 태그 추가 및 제거를 중지합니다.

**참고**  
태그 수정을 다시 활성화하려면 기본값이 **false**이므로 **ReadOnly** 값을 **false**로 변경하거나 키를 모두 제거합니다.

**옵션** 설정에 대한 자세한 내용은 [구문 및 구조](acc-tag-tools-profiles.md#acc-rt-config-doc-format)다음 단원을 참조하십시오.

## 예제 구성 프로필
<a name="acc-rt-using-ex-config-doc"></a>

다음 예제 프로파일 문서는 스택-\$1 CloudFormation 스택의 일부인 모든 Windows EC2 인스턴스를 AMS Accelerate에서 관리하도록 지정하지만 ID가 i-00000000000000001인 특정 EC2 인스턴스는 명시적으로 제외합니다.

```
{
    "AWS::EC2::Instance": {
        "AMSMonitoringWindows": {
            "Enabled": true,
            "Filter": {  
                "Fn::AND": [
                    {
                        "Platform": "Windows"
                    },
                    {
                        "Tag": {
                            "Key": "aws:cloudformation:stack-name",
                            "Value": "stack-*"
                        }
                    },
                    {
                        "Fn::NOT": {
                            "InstanceId": "i-00000000000000001"
                        }
                    }
                ]
            },
            "Tags": [
                {
                    "Key": "ams:rt:ams-managed",
                    "Value": "true"
                }
            ]
        }
    }
}
```

**주의**  
새 구성의 이름(`SampleConfigurationBlock`제공된 예의 )을 지정할 때는 AMS 관리형 구성을 동일한 이름으로 실수로 재정의할 수 있으므로 주의해야 합니다.

## 기본 구성 병합
<a name="acc-rt-using-merge-default-config"></a>

기본 구성 프로필은 계정 온보딩 시 AMS Accelerate에서 제공합니다. 이 프로필은 계정에 배포된 기본 규칙을 제공합니다.

기본 구성 프로필은 수정할 수 없지만 기본 구성 블록과 동일한 **ConfigurationID**를 사용하여 사용자 지정 구성 프로필에 구성 블록을 지정하여 기본값에 대한 재정의를 제공할 수 있습니다. 이렇게 하면 구성 블록이 기본 구성 블록을 덮어씁니다.

예를 들어 다음과 같은 기본 구성 문서를 고려합니다.

```
{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": true,
			"Filter": {
				"Platform": "Windows"
			},
			"Tags": [{
				"Key": "my-tag",
				"Value": "SampleValueA"
			}]
		}
	}
}
```

여기에 적용된 태그 값을에서 `SampleValueA`로 변경`SampleValueB`하고 Windows 인스턴스뿐만 아니라 모든 인스턴스에 태그를 적용하려면 다음과 같은 사용자 지정 구성 프로파일을 제공합니다.

```
{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": true,
			"Filter": {
				"Platform": "*"
			},
			"Tags": [{
				"Key": "my-tag",
				"Value": "SampleValueB"
			}]
		}
	}
}
```

**중요**  
구성 변경 사항을 적용한 후에는 배포해야 합니다. 자세한 내용은 [구성 변경 사항 배포](#acc-rt-deploy-changes) 단원을 참조하십시오. SSM AppConfig에서는 구성을 생성한 후 새 버전의 구성을 배포해야 합니다.

## 기본 구성 비활성화
<a name="acc-rt-using-disable-default-config"></a>

사용자 지정 구성 프로필에 동일한 **ConfigurationID**가 있는 구성 블록을 추가하고 값에 대해 **활성화됨** 필드를 **false**로 지정하여 기본 구성 규칙을 비활성화할 수 있습니다.

예를 들어 기본 구성 프로필에 다음 구성이 있는 경우:

```
{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": true,
			"Filter": {
				"Platform": "Windows"
			},
			"Tags": [{
				"Key": "my-tag",
				"Value": "SampleValueA"
			}]
		}
	}
}
```

사용자 지정 구성 프로필에 다음을 포함하여이 태그 지정 규칙을 비활성화할 수 있습니다.

```
{
	"AWS::EC2::Instance": {
		"AMSManagedBlock1": {
			"Enabled": false
		}
	}
}
```

**중요**  
구성 변경 사항을 적용한 후에는 배포해야 합니다. 자세한 내용은 섹션을 참조하세요[구성 변경 사항 배포](#acc-rt-deploy-changes). SSM AppConfig에서는 구성을 생성한 후 새 버전의 구성을 배포해야 합니다.

## Resource Tagger에서 적용한 태그 제거
<a name="acc-rt-remove-tags"></a>

**ams:rt** 접두사가 붙은 태그가 구성 프로필에 없거나 태그가 있는 경우 필터가 일치하지 않는 경우 Resource Tagger에서 제거합니다. 즉, 다음 중 하나를 수행하여 Resource Tagger에서 적용한 태그를 제거할 수 있습니다.
+ 태그를 정의하는 사용자 지정 구성 섹션 수정.
+ 특정 리소스가 더 이상 필터와 일치하지 않도록 해당 리소스에 대한 예외를 추가합니다.

예: **Linux** 인스턴스에 다음 태그가 있는 경우:

```
"Tags": [{
    "Key": "ams:rt:MyOwnTag",
    "Value": true
},{
    "Key": "myTag",
    "Value": true
}]
```

그리고 다음 Resource Tagger 구성 프로파일을 배포합니다.

```
{
    "AWS::EC2::Instance": {
        "AMSMonitoringWindows": {
            "Enabled": true,
            "Filter": {
                "Platform": "Windows"
            },
            "Tags": [{
                "Key": "ams:rt:ams-managed",
                "Value": "true"
            }]
        }
    }
}
```

Resource Tagger는 새 구성 변경에 반응하며 인스턴스의 유일한 태그는 다음과 같습니다.

```
 "Tags": [{
     "Key": "myTag",
     "Value": true
 }]
```

**주의**  
새 구성의 이름(`SampleConfigurationBlock`제공된 예의 )을 지정할 때는 AMS 관리형 구성을 동일한 이름으로 실수로 재정의할 수 있으므로 주의해야 합니다.

**중요**  
구성 변경 사항을 적용한 후에는 배포해야 합니다. 자세한 내용은 섹션을 참조하세요[구성 변경 사항 배포](#acc-rt-deploy-changes). SSM AppConfig에서는 구성을 생성한 후 새 버전의 구성을 배포해야 합니다.

## Resource Tagger 구성 보기 또는 변경
<a name="acc-rt-make-changes"></a>

**AMSManagedTags** 및 **AMSInfrastructure** 환경에서 온보딩 및 상주 시 [AWS AppConfig](https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html)의 계정에 배포된 두 가지 JSON 구성 프로파일인 AMSManagedTags 및 **CustomerManagedTags**는 AppConfig의 [GetConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_GetConfiguration.html) API를 통해 검토할 수 있습니다. AMSResourceTagger 

다음은이 GetConfiguration 호출의 예입니다.

```
aws appconfig get-configuration 
 --application AMSResourceTagger 
 --environment AMSInfrastructure 
 --configuration AMSManagedTags 
 --client-id ANY_STRING
 outfile.json
```

**애플리케이션**: 기능을 제공하는 AppConfig 논리 단위입니다. Resource Tagger의 경우 AMSResourceTagger입니다.
+ **환경**: AMSInfrastructure.
+ **구성**: AMS Accelerate 기본 태그 정의를 보려면 값은 AMSManagedTags이고, 고객 태그 정의를 보려면 CustomerManagedTags입니다.
+ **클라이언트 ID**: 고유한 애플리케이션 인스턴스 식별자로, 모든 문자열일 수 있습니다.
+ 그런 다음 지정된 출력 파일,이 경우 outfile.json에서 태그 정의를 볼 수 있습니다.

그런 다음 지정된 출력 파일,이 경우 outfile.json에서 경보 정의를 볼 수 있습니다.

**AMSInfrastructure** 환경에서 과거 배포를 확인하여 계정에 배포된 구성 버전을 확인할 수 있습니다.

****태그 규칙을 재정의하려면:

 CloudFormation [CloudFormation for Accelerate를 사용하여 구성 프로파일 배포](acc-tag-cf-ex-deploy-config.md) 또는를 사용하여 사용자 지정 프로필을 업데이트하거나 AppConfig의 [https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateHostedConfigurationVersion.html) API를 사용하여 직접 기존 태그 규칙을 재정의할 수 있습니다. 동일한 **ConfigurationID**를 기본 구성 태그 규칙으로 사용하면 기본 규칙이 재정의되고 사용자 지정 규칙이 대신 적용됩니다.

**CustomerManagedTags** 문서에 대한 변경 사항을 배포하려면

사용자 지정 구성 프로필을 변경한 후에는 변경 사항을 배포해야 합니다. 새 변경 사항을 배포하려면 AWS AppConfig 콘솔 또는 CLI를 사용하여 AppConfig의 [StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html) API를 실행해야 합니다.

## 구성 변경 사항 배포
<a name="acc-rt-deploy-changes"></a>

사용자 지정이 완료되면 이러한 변경 사항을 [ StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html) API를 AWS AppConfig 통해 배포해야 합니다. 다음 지침은를 사용하여를 배포하는 방법을 보여줍니다 AWS CLI. 또한 AWS Management Console 를 사용하여 이러한 변경을 수행할 수 있습니다. 자세한 내용은 [ 5단계: 구성 배포를 참조하세요](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-deploying.html).

```
aws appconfig start-deployment
--application-id <application_id>
--environment-id <environment_id>
--deployment-strategy-id <deployment_strategy_id>
--configuration-profile-id <configuration_profile_id>
--configuration-version 1
```
+ **애플리케이션 ID**: 애플리케이션 AMSResourceTagger의 애플리케이션 ID입니다. [ ListApplications](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListApplications.html) API 호출을 통해 이를 가져옵니다.
+ **환경 ID**: 환경 ID입니다. [ ListEnvironments](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListEnvironments.html) API 호출을 통해 이를 가져옵니다.
+ **배포 전략 ID**: 배포 전략 ID입니다. [ ListDeploymentStrategies](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListDeploymentStrategies.html) API 호출을 통해 이를 가져옵니다.
+ **구성 프로필 ID**: CustomerManagedTags의 구성 프로필 ID입니다. [ ListConfigurationProfiles](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_ListConfigurationProfiles.html) API 호출을 통해 이를 가져옵니다.
+ **구성 버전**: 배포하려는 구성 프로필의 버전입니다.

**중요**  
Resource Tagger는 구성 프로필에 지정된 대로 태그를 적용합니다. 리소스 태그에 대한 모든 수동 수정 사항( AWS Management Console또는 CloudWatch CLI/SDK 사용)은 자동으로 되돌려지므로 Resource Tagger를 통해 변경 사항을 정의해야 합니다. Resource Tagger에서 생성되는 태그를 확인하려면 접두사가 붙은 태그 키를 찾습니다`ams:rt:`.

[StartDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StartDeployment.html) 및 [StopDeployment](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_StopDeployment.html) API 작업을 사용하여 배포에 대한 액세스를 대상에 새 구성을 배포할 때의 책임과 결과를 이해하는 신뢰할 수 있는 사용자로 제한합니다.

 AWS AppConfig 기능을 사용하여 구성을 생성하고 배포하는 방법에 대한 자세한 내용은 [AWS AppConfig 작업](https://docs.aws.amazon.com/appconfig/latest/userguide/appconfig-working.html)의 설명서를 참조하세요.

## Resource Tagger 태그를 무시하도록 Terraform 구성
<a name="acc-rt-ignore-tags"></a>

Terraform을 사용하여 리소스를 프로비저닝하고 Resource Tagger를 사용하여 리소스에 태그를 지정하려는 경우 Resource Tagger 태그는 Terraform에 의해 드리프트로 식별될 수 있습니다.

**수명 주기** 구성 블록 또는 **ignore\$1tags** 글로벌 구성 블록을 사용하여 모든 Resource Tagger 태그를 무시하도록 Terraform을 구성할 수 있습니다. 자세한 내용은 리소스 태그 지정의 [ 리소스 태그 지정에 대한 Terraform 설명서를 참조하세요](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/guides/resource-tagging).

다음 예제에서는 Resource Tagger 태그 접두사 로 시작하는 모든 태그를 무시하도록 전역 구성을 생성하는 방법을 보여줍니다`ams:rt:`.

```
provider "aws" {
  # ... potentially other configuration ...

  ignore_tags {
    key_prefixes = ["ams:rt:"]
  }
}
```

## Resource Tagger에서 관리하는 리소스 수 보기
<a name="acc-rt-number-of-resources"></a>

 Resource Tagger는 매시간 `AMS/ResourceTagger` 네임스페이스의 Amazon CloudWatch로 지표를 전송합니다. 지표는 Resource Tagger에서 지원하는 리소스 유형에 대해서만 내보내집니다.


| 지표 이름 | 측정기준 | 설명 | 
| --- | --- | --- | 
| ResourceCount |  구성 요소, ResourceType  | 이 리전에 배포된 리소스 수(지정된 리소스 유형)입니다. 단위: 개 | 
| ResourcesMissingManagedTags |  구성 요소, ResourceType  | 구성 프로필에 따라 관리형 태그가 필요하지만 아직 Resource Tagger에서 태그를 지정하지 않은 리소스 수(지정된 리소스 유형)입니다. 단위: 개 | 
| UnmanagedResources |  구성 요소, ResourceType  | Resource Tagger에서 관리형 태그를 적용하지 않은 리소스 수(지정된 리소스 유형)입니다. 일반적으로 이러한 리소스는 Resource Tagger 구성 블록과 일치하지 않거나 구성 블록에서 명시적으로 제외됩니다. 단위: 개 | 
| MatchingResourceCount |  구성 요소, ResourceType, ConfigClauseName  | Resource Tagger 구성 블록과 일치하는 리소스 수(지정된 리소스 유형)입니다. 리소스가 구성 블록과 일치하려면 블록을 활성화하고 리소스가 블록의 필터와 일치해야 합니다. 단위: 개 | 

이러한 지표는 **AMS-Resource-Tagger-Reporting-Dashboard**에서 그래프로도 볼 수 있습니다. 대시보드를 보려면 Amazon CloudWatch 관리 콘솔에서 **AMS-Resource-Tagger-Reporting-Dashboard**를 선택합니다. 기본적으로이 대시보드의 그래프에는 이전 12시간 동안의 데이터가 표시됩니다.

AMS Accelerate는 계정에 CloudWatch 경보를 배포하여 AMS Resource Tagger의 관리에서 제외된 리소스와 같은 비관리형 리소스 수의 상당한 증가를 감지합니다. AMS Operations는 동일한 유형의 리소스 3개를 초과하거나 동일한 유형의 모든 리소스에 대해 50% 증가를 초과하는 비관리형 리소스의 증가를 조사합니다. 변경 사항이 의도적으로 표시되지 않는 경우 AMS Operations에서 변경 사항을 검토하기 위해 사용자에게 연락할 수 있습니다.

# CloudFormation을 사용하여 AMS Accelerate에 대한 태그 생성
<a name="acc-tag-how-works-cfn"></a>

 CloudFormation 를 사용하여 스택 수준( CloudFormation 설명서, [ 리소스 태그](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html) 참조) 또는 개별 리소스 수준(예: [ Amazon EC2 리소스 태그 지정 참조)에서 태그를 적용할 수 있습니다](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html).

**중요**  
일부 AMS Accelerate 서비스 구성 요소에는 **ams:rt:** 접두사가 있는 태그가 필요합니다. Resource Tagger는 이러한 태그를 소유하고 있다고 생각하며 Resource Tagger 구성 규칙에서 허용하는 태그가 없는 경우 태그를 삭제합니다. CloudFormation 또는 Terraform을 사용하는 경우에도 항상 이러한 태그에 대한 Resource Tagger 구성 프로파일을 배포해야 합니다.

# CloudFormation AMS Accelerate 사용 사례
<a name="acc-tag-tools-cf-ex"></a>

이 섹션에서는를 사용하여 일반적으로 수행되는 작업을 나열합니다 CloudFormation.

**Topics**
+ [CloudFormation Accelerate용를 사용하여 EC2 인스턴스에 태그 지정](acc-tag-cf-ex-tag-ec2.md)
+ [가속화를 CloudFormation 위해를 사용하여 AutoScaling 그룹(ASG)에 태그 지정](acc-tag-cf-ex-tag-asg.md)
+ [CloudFormation for Accelerate를 사용하여 구성 프로파일 배포](acc-tag-cf-ex-deploy-config.md)

# CloudFormation Accelerate용를 사용하여 EC2 인스턴스에 태그 지정
<a name="acc-tag-cf-ex-tag-ec2"></a>

다음은 **ams:rt:ams-managed** 태그와 **true** 값을에서 관리하는 Amazon EC2 인스턴스에 적용하는 방법의 예입니다 CloudFormation. **ams:rt:ams-managed** 태그는 AMS Accelerate에서 리소스를 모니터링하도록 옵트인합니다.

```
 Type: AWS::EC2::Instance

Properties: 
  InstanceType: "t3.micro"
  
  # ...other properties...
  
  Tags: 
    - Key: "ams:rt:ams-managed"
      Value: "true"
```

# 가속화를 CloudFormation 위해를 사용하여 AutoScaling 그룹(ASG)에 태그 지정
<a name="acc-tag-cf-ex-tag-asg"></a>

다음은 **ams:rt:ams-managed** 태그와 **true** 값을에서 관리하는 Auto Scaling 그룹에 적용하는 방법의 예입니다 CloudFormation. Auto Scaling 그룹은 자신이 생성한 Amazon EC2 인스턴스에 태그를 전파합니다. **ams:rt:ams-managed** 태그는 AMS Accelerate에서 리소스를 모니터링하도록 옵트인합니다.

```
  Type: AWS::AutoScaling::AutoScalingGroup
Properties: 
  AutoScalingGroupName: "SampleASG"
  
  # ...other properties...
  
  Tags: 
    - Key: "ams:rt:ams-managed"
      Value: "true"
```

# CloudFormation for Accelerate를 사용하여 구성 프로파일 배포
<a name="acc-tag-cf-ex-deploy-config"></a>

를 사용하여 `CustomerManagedTags` 구성 프로필을 배포하려는 경우 다음 CloudFormation 템플릿을 사용할 CloudFormation수 있습니다. `AMSResourceTaggerConfigurationVersion.Content` 필드에 원하는 JSON 구성을 입력합니다.

 CloudFormation 스택 또는 스택 세트에 템플릿을 배포하면 구성에 필요한 JSON 형식을 따르지 않으면 `AMSResourceTaggerDeployment ` 리소스 배포가 실패합니다. 예상 형식에 대한 [구문 및 구조](acc-tag-tools-profiles.md#acc-rt-config-doc-format) 자세한 내용은 섹션을 참조하세요.

 이러한 템플릿을 CloudFormation 스택 또는 스택 세트로 배포하는 방법에 대한 도움말은 아래 관련 AWS CloudFormation 설명서를 참조하세요.
+  [AWS CloudFormation 콘솔에서 스택 생성 ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) 
+  [를 사용하여 스택 생성 AWS CLI](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-creating-stack.html) 
+  [ 스택 세트 생성 ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-getting-started-create.html) 

**참고**  
이러한 템플릿 중 하나를 사용하여 구성 버전을 배포한 다음 CloudFormation 스택/스택 세트를 삭제하면 템플릿 구성 버전이 현재 배포된 버전으로 유지되며 추가 배포가 이루어지지 않습니다. 기본 구성으로 되돌리려면 스택을 삭제하는 대신 수동으로 빈 구성(즉, 만`{}`)을 배포하거나 스택을 빈 구성으로 업데이트해야 합니다.

**JSON**

```
{
  "Description": "Custom configuration for the AMS Resource Tagger.",
  "Resources": {
    "AMSResourceTaggerConfigurationVersion": {
      "Type": "AWS::AppConfig::HostedConfigurationVersion",
      "Properties": {
        "ApplicationId": {
          "Fn::ImportValue": "AMS-ResourceTagger-Configuration-ApplicationId"
        },
        "ConfigurationProfileId": {
          "Fn::ImportValue": "AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID"
        },
        "Content": "{\"Options\": {\"ReadOnly\": false}}",
        "ContentType": "application/json"
      }
    },
    "AMSResourceTaggerDeployment": {
      "Type": "AWS::AppConfig::Deployment",
      "Properties": {
        "ApplicationId": {
          "Fn::ImportValue": "AMS-ResourceTagger-Configuration-ApplicationId"
        },
        "ConfigurationProfileId": {
          "Fn::ImportValue": "AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID"
        },
        "ConfigurationVersion": {
          "Ref": "AMSResourceTaggerConfigurationVersion"
        },
        "DeploymentStrategyId": {
          "Fn::ImportValue": "AMS-ResourceTagger-Configuration-Deployment-StrategyID"
        }, 
        "EnvironmentId": {
          "Fn::ImportValue": "AMS-ResourceTagger-Configuration-EnvironmentId"
        }
      }
    }
  }
}
```

**YAML**

```
Description: Custom configuration for the AMS Resource Tagger.
Resources:
  AMSResourceTaggerConfigurationVersion:
    Type: AWS::AppConfig::HostedConfigurationVersion
    Properties:
      ApplicationId:
        !ImportValue AMS-ResourceTagger-Configuration-ApplicationId
      ConfigurationProfileId:
        !ImportValue AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID
      Content: |
        {
          "Options": {
            "ReadOnly": false
          }
        }
      ContentType: application/json
  AMSResourceTaggerDeployment:
    Type: AWS::AppConfig::Deployment
    Properties:
      ApplicationId:
        !ImportValue AMS-ResourceTagger-Configuration-ApplicationId
      ConfigurationProfileId:
        !ImportValue AMS-ResourceTagger-Configuration-CustomerManagedTags-ProfileID
      ConfigurationVersion:
        !Ref AMSResourceTaggerConfigurationVersion
      DeploymentStrategyId:
        !ImportValue AMS-ResourceTagger-Configuration-Deployment-StrategyID
      EnvironmentId:
        !ImportValue AMS-ResourceTagger-Configuration-EnvironmentId
```

# Terraform을 사용하여 AMS Accelerate용 태그 생성
<a name="acc-tag-tools-terraform"></a>

AMS Accelerate Resource Tagger를 사용하지 않으려면 Terraform을 사용하여 자체 태그를 적용할 수 있습니다. 그러나 Terraform 정의의 드리프트로 인해 Resource Tagger를 사용하지 않으려는 경우 Resource Tagger를 사용하고 Resource Tagger가 유발하는 드리프트를 무시할 수 있는 방법이 있습니다. 섹션을 참조하세요[Resource Tagger 태그를 무시하도록 Terraform 구성](acc-rt-using.md#acc-rt-ignore-tags).

**중요**  
일부 AMS Accelerate 서비스 구성 요소에는 **ams:rt:** 접두사가 있는 태그가 필요합니다. Resource Tagger는 이러한 태그를 소유하고 있다고 생각하며 Resource Tagger 구성 규칙에서 허용하는 태그가 없는 경우 태그를 삭제합니다. CloudFormation 또는 Terraform을 사용하는 경우에도 이러한 태그에 대한 Resource Tagger 구성 프로파일을 배포해야 합니다.

다음은 Terraform에서 관리하는 Amazon EC2 인스턴스에 **값으로** **ams:rt:ams-managed** 태그를 적용하는 방법의 예입니다. **ams:rt:ams-managed** 태그는 AMS Accelerate에서 리소스를 모니터링하도록 옵트인합니다.

```
  resource "aws_instance" "sample_linux_instance" {
    # ...ami and other properties...
  
    instance_type = "t3.micro"

    tags = {
        "ams:rt:ams-managed" = "true"
    }
}
```

다음은 Terraform에서 관리하는 Auto Scaling 그룹에 값이 **true**인 **ams:rt:ams-managed** 태그를 적용하는 방법의 예입니다. Auto Scaling 그룹은 태그를 자신이 생성한 Amazon EC2 인스턴스로 전파합니다. **ams:rt:ams-managed** 태그는 AMS Accelerate에서 리소스를 모니터링하도록 옵트인합니다.

```
  resource "aws_autoscaling_group" "sample_asg" {
    # ...other properties...
  
    name = "terraform-sample"

    tags = {
        "ams:rt:ams-managed" = "true"
    }
}
```

Terraform에서 생성한 리소스 태그를 관리하는 방법에 대한 설명은 섹션을 참조하세요[Resource Tagger 태그를 무시하도록 Terraform 구성](acc-rt-using.md#acc-rt-ignore-tags).