本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 用于 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 加速服务组件需要带有 **ams: rt:** 前缀的标签。Resource Tagger 认为自己拥有这些标签，如果资源标记器配置规则不允许，则会将其删除。即使您使用的是 CloudFormation 或 Terraform，您也始终需要为这些标签部署资源标记器配置文件。

# CloudFormation AMS 加速的用例
<a name="acc-tag-tools-cf-ex"></a>

本节列出了常用执行的操作 CloudFormation。

**Topics**
+ [使用 for Accel EC2 erate CloudFormation 标记实例](acc-tag-cf-ex-tag-ec2.md)
+ [使用标记 AutoScaling 群组 (ASG) 以获得加速 CloudFormation](acc-tag-cf-ex-tag-asg.md)
+ [使用 for Accelerat CloudFormation e 部署配置文件](acc-tag-cf-ex-deploy-config.md)

# 使用 for Accel EC2 erate CloudFormation 标记实例
<a name="acc-tag-cf-ex-tag-ec2"></a>

**以下示例说明如何将值为 true 的 **ams: rt: ams-managed 标签应用于由管理**的亚马逊实例。** EC2 CloudFormation**ams: rt: ams-managed 标签允许你选择让 AM** S Accelerate 监控你的资源。

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

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

# 使用标记 AutoScaling 群组 (ASG) 以获得加速 CloudFormation
<a name="acc-tag-cf-ex-tag-asg"></a>

以下示例说明了如何将值为 true 的 **ams: rt: ams-managed 标签应用于由管理**的 Auto **S** caling 组。 CloudFormation请注意，Auto Scaling 组会将其标签传播到由其创建的亚马逊 EC2 实例。**ams: rt: ams-managed 标签允许你选择让 AM** S Accelerate 监控你的资源。

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

# 使用 for Accelerat CloudFormation e 部署配置文件
<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
```