

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo CloudFormation per creare tag per AMS Accelerate
<a name="acc-tag-how-works-cfn"></a>

Puoi utilizzarli CloudFormation per applicare i tag a livello di stack (vedi CloudFormation documentazione, [tag Resource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html)) o a livello di singola risorsa (ad esempio, vedi [Tagging your Amazon EC2 resources](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html)).

**Importante**  
Alcuni componenti del servizio AMS Accelerate richiedono tag con il prefisso **ams:rt:**. Resource Tagger ritiene di possedere questi tag e li eliminerà se nessuna regola di configurazione di Resource Tagger li consente. È sempre necessario implementare un profilo di configurazione Resource Tagger per questi tag, anche se si utilizza Terraform. CloudFormation 

# CloudFormation Casi d'uso per AMS Accelerate
<a name="acc-tag-tools-cf-ex"></a>

Questa sezione elenca le azioni più comuni eseguite con CloudFormation.

**Topics**
+ [Taggare un' EC2 istanza con CloudFormation for Accelerate](acc-tag-cf-ex-tag-ec2.md)
+ [Taggare un AutoScaling gruppo (ASG) con CloudFormation For Accelerate](acc-tag-cf-ex-tag-asg.md)
+ [Implementazione di un profilo di configurazione con CloudFormation for Accelerate](acc-tag-cf-ex-deploy-config.md)

# Taggare un' EC2 istanza con CloudFormation for Accelerate
<a name="acc-tag-cf-ex-tag-ec2"></a>

Di seguito è riportato un esempio di come è possibile applicare il tag **ams:rt:ams-managed** con il valore true a un'istanza Amazon gestita **da**. EC2 CloudFormation Il tag **ams:rt:ams-managed ti consente di far monitorare le tue risorse da AMS Accelerate**.

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

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

# Taggare un AutoScaling gruppo (ASG) con CloudFormation For Accelerate
<a name="acc-tag-cf-ex-tag-asg"></a>

Di seguito è riportato un esempio di come è possibile applicare il tag **ams:rt:ams-managed** con il valore true a **un** gruppo Auto Scaling gestito da. CloudFormation Tieni presente che il gruppo Auto Scaling propagherà i propri tag alle EC2 istanze Amazon da esso create. Il tag **ams:rt:ams-managed** ti consente di far monitorare le tue risorse da AMS Accelerate.

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

# Implementazione di un profilo di configurazione con CloudFormation for Accelerate
<a name="acc-tag-cf-ex-deploy-config"></a>

Se desideri distribuire il tuo profilo di `CustomerManagedTags` configurazione utilizzando CloudFormation, puoi utilizzare i seguenti CloudFormation modelli. Inserisci la configurazione JSON desiderata nel `AMSResourceTaggerConfigurationVersion.Content` campo.

 Quando distribuisci i modelli in uno CloudFormation stack o in uno stack set, la distribuzione della `AMSResourceTaggerDeployment ` risorsa avrà esito negativo se non hai seguito il formato JSON richiesto per la configurazione. Vedi [Sintassi e struttura](acc-tag-tools-profiles.md#acc-rt-config-doc-format) per i dettagli sul formato previsto. 

 Per assistenza sulla distribuzione di questi modelli come CloudFormation stack o set di stack, consulta la documentazione pertinente AWS CloudFormation di seguito: 
+  [Creazione di uno stack sulla console AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) 
+  [Creazione di uno stack con AWS CLI](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-creating-stack.html) 
+  [Creazione di un set di stack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-getting-started-create.html) 

**Nota**  
Se si distribuisce una versione di configurazione utilizzando uno di questi modelli e successivamente si elimina lo CloudFormation stack/stack set, la versione di configurazione del modello rimarrà la versione attualmente distribuita e non verrà effettuata alcuna distribuzione aggiuntiva. Se desideri ripristinare una configurazione predefinita, dovrai distribuire manualmente una configurazione vuota (ovvero solo`{}`) o aggiornare lo stack a una configurazione vuota, anziché eliminare lo stack. 

**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
```