• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 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à. # `aws:createStack`— Crea una CloudFormation pila Crea una AWS CloudFormation pila a partire da un modello. **Nota** L'azione `aws:createStack` supporta un nuovo tentativo di limitazione (della larghezza di banda della rete) automatico. Per ulteriori informazioni, consulta [Configurazione della ripetizione dei tentativi automatica per le operazioni di limitazione (della larghezza di banda della rete)](automation-throttling-retry.md). *Per ulteriori informazioni sulla creazione di CloudFormation stack, consulta l'AWS CloudFormation API [CreateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html)Reference.* **Input** ------ #### [ YAML ] ``` name: makeStack action: aws:createStack maxAttempts: 1 onFailure: Abort inputs: Capabilities: - CAPABILITY_IAM StackName: myStack TemplateURL: http://s3.amazonaws.com/amzn-s3-demo-bucket/myStackTemplate TimeoutInMinutes: 5 Parameters: - ParameterKey: LambdaRoleArn ParameterValue: "{{LambdaAssumeRole}}" - ParameterKey: createdResource ParameterValue: createdResource-{{automation:EXECUTION_ID}} ``` ------ #### [ JSON ] ``` { "name": "makeStack", "action": "aws:createStack", "maxAttempts": 1, "onFailure": "Abort", "inputs": { "Capabilities": [ "CAPABILITY_IAM" ], "StackName": "myStack", "TemplateURL": "http://s3.amazonaws.com/amzn-s3-demo-bucket/myStackTemplate", "TimeoutInMinutes": 5, "Parameters": [ { "ParameterKey": "LambdaRoleArn", "ParameterValue": "{{LambdaAssumeRole}}" }, { "ParameterKey": "createdResource", "ParameterValue": "createdResource-{{automation:EXECUTION_ID}}" } } } ``` ------ Funzionalità Un elenco di valori specificato in precedenza CloudFormation può creare determinati stack. Alcuni modelli di stack includono risorse che possono influire sulle autorizzazioni del tuo. Account AWS Per questi stack, è necessario confermare in modo esplicito le relative funzionalità specificando questo parametro. I valori validi includono `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM` e `CAPABILITY_AUTO_EXPAND`. **CAPABILITY\$1IAM e CAPABILITY\$1NAMED\$1IAM** Se sono presenti risorse IAM, è possibile specificare una delle funzionalità. In presenza di risorse IAM con nomi personalizzati, devi specificare `CAPABILITY_NAMED_IAM`. Se non specifichi questo parametro, questa operazione restituisce un errore `InsufficientCapabilities`. Le seguenti risorse richiedono di specificare `CAPABILITY_IAM` o `CAPABILITY_NAMED_IAM`. + [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html) + [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html) + [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html) + [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html) + [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html) + [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-user.html) + [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-addusertogroup.html) Se il modello di stack contiene queste risorse, ti consigliamo di esaminare tutte le autorizzazioni a esse associate e modificarle, se necessario. Per ulteriori informazioni, consulta [Riconoscere le risorse IAM](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#capabilities) nei modelli. CloudFormation **CAPABILITY\$1AUTO\$1EXPAND** Alcuni modelli contengono macro. Le macro eseguono un'elaborazione personalizzata sui modelli; ciò può includere azioni semplici come find-and-replace operazioni, fino a trasformazioni estese di interi modelli. Per questo motivo, gli utenti in genere creano un set di modifiche dal modello elaborato, in modo che possano rivedere le modifiche risultanti dalle macro prima di creare effettivamente lo stack. Se il modello di stack contiene una o più macro e si sceglie di creare uno stack direttamente dal modello elaborato, senza prima esaminare le modifiche risultanti in un set di modifiche, è necessario riconoscere questa funzionalità. *Per ulteriori informazioni, vedere [Utilizzo delle AWS CloudFormation macro per eseguire l'elaborazione personalizzata sui modelli](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-macros.html) nella Guida per l'AWS CloudFormation utente.* Tipo: Array of Strings Valori validi: `CAPABILITY_IAM | CAPABILITY_NAMED_IAM | CAPABILITY_AUTO_EXPAND` Campo obbligatorio: no ClientRequestToken Un identificatore univoco per questa CreateStack richiesta. Specifica questo token se imposti maxAttempts in questa fase su un valore maggiore di 1. Specificando questo token, CloudFormation sa che non stai tentando di creare un nuovo stack con lo stesso nome. ▬Tipo: stringa Obbligatorio: no Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri. Modello: [a-zA-Z0-9][-a-zA-Z0-9]\$1 DisableRollback Imposta su `true` per disattivare il rollback dello stack se la creazione dello stack ha esito negativo. Condizionale: puoi specificare il parametro `DisableRollback` o il parametro `OnFailure`, ma non entrambi. Impostazione predefinita: `false` Tipo: Booleano Obbligatorio: no Notifica ARNs L' ARNs argomento Amazon Simple Notification Service (Amazon SNS) per la pubblicazione di eventi relativi allo stack. [Puoi trovare l'argomento SNS ARNs utilizzando la console https://console.aws.amazon.com/sns/ Amazon SNS, v3/home.](https://console.aws.amazon.com/sns/v3/home) Tipo: Array of Strings Membri della matrice: numero massimo di 5 elementi. Obbligatorio: no OnFailure Determina l'operazione da eseguire se la creazione dello stack ha esito negativo. È necessario specificare `DO_NOTHING`, `ROLLBACK` o `DELETE`. Condizionale: puoi specificare il parametro `OnFailure` o il parametro `DisableRollback`, ma non entrambi. Impostazione predefinita: `ROLLBACK` Tipo: String Valori validi: ` DO_NOTHING | ROLLBACK | DELETE` Obbligatorio: no Parameters Elenco di strutture `Parameter` che specificano i parametri di input per lo stack. Per ulteriori informazioni, consulta il tipo di dati [Parameter](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html). Tipo: matrice di oggetti [Parametro](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html) Obbligatorio: no ResourceTypes Tipi di risorse modello che si è autorizzati a utilizzare per questa operazione di creazione dello stack. Ad esempio: `AWS::EC2::Instance`, `AWS::EC2::*` o `Custom::MyCustomInstance`. Utilizza la seguente sintassi per descrivere i tipi di risorse modello. + Per tutte le risorse: AWS ``` AWS::* ``` + Per tutte le risorse personalizzate: ``` Custom::* ``` + Per una risorsa personalizzata specifica: ``` Custom::logical_ID ``` + Per tutte le risorse di un particolare Servizio AWS: ``` AWS::service_name::* ``` + Per una AWS risorsa specifica: ``` AWS::service_name::resource_logical_ID ``` Se l'elenco dei tipi di risorse non include una risorsa in fase di creazione, la creazione dello stack ha esito negativo. Per impostazione predefinita, CloudFormation concede le autorizzazioni a tutti i tipi di risorse. IAM utilizza questo parametro per chiavi CloudFormation di condizione specifiche nelle politiche IAM. Per ulteriori informazioni, consulta [Controlling Access with AWS Identity and Access Management](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html). Tipo: Array of Strings Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri. Obbligatorio: no RoleARN L'Amazon Resource Name (ARN) di un ruolo IAM che CloudFormation presuppone la creazione dello stack. CloudFormation utilizza le credenziali del ruolo per effettuare chiamate per tuo conto. CloudFormation utilizza sempre questo ruolo per tutte le future operazioni sullo stack. Se gli utenti dispongono dell'autorizzazione per intervenire sullo stack, CloudFormation usa questo ruolo anche se gli utenti non sono autorizzati a passare tale parametro. Assicurati che il ruolo garantisca il livello minimo di privilegi. Se non si specifica un valore, CloudFormation utilizza il ruolo precedentemente associato allo stack. Se non è disponibile alcun ruolo, CloudFormation utilizza una sessione temporanea generata dalle credenziali utente. Tipo: String Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri. Obbligatorio: no StackName Nome associato allo stack. Il nome deve essere univoco nella regione in cui si sta creando lo stack. Il nome di uno stack può contenere solo caratteri alfanumerici (con distinzione tra lettere maiuscole e minuscole) e trattini. Deve iniziare con un carattere alfabetico e non può avere una lunghezza superiore a 128 caratteri. Tipo: stringa Obbligatorio: sì StackPolicyBody Struttura contenente il corpo della policy dello stack. Per ulteriori informazioni, consulta [Impedire gli aggiornamenti delle risorse stack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html). Condizionale: puoi specificare il parametro `StackPolicyBody` o il parametro `StackPolicyURL`, ma non entrambi. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 16384 caratteri. Obbligatorio: no StackPolicyURL Posizione di un file contenente la policy dello stack. L'URL deve puntare a una policy che si trova in un bucket S3 nella stessa regione dello stack. La dimensione massima consentita del file della policy dello stack è 16 KB. Condizionale: puoi specificare il parametro `StackPolicyBody` o il parametro `StackPolicyURL`, ma non entrambi. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1350 caratteri. Obbligatorio: no Tag Coppie chiave-valore da associare a questo stack. CloudFormation propaga inoltre questi tag alle risorse create nello stack. Puoi specificare un massimo di 10 tag. Tipo: matrice di oggetti [Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Tag.html) Obbligatorio: no TemplateBody Struttura contenente il corpo del modello con una lunghezza minima di 1 byte e una lunghezza massima di 51.200 byte. Per ulteriori informazioni, consulta [Anatomia dei modelli](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html). Condizionale: puoi specificare il parametro `TemplateBody` o il parametro `TemplateURL`, ma non entrambi. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Obbligatorio: no TemplateURL Posizione di un file contenente il corpo del modello. L'URL deve puntare a un modello che si trova in un bucket S3. La dimensione massima consentita per il modello è 460.800 byte. Per ulteriori informazioni, consulta [Anatomia dei modelli](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html). Condizionale: puoi specificare il parametro `TemplateBody` o il parametro `TemplateURL`, ma non entrambi. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri. Obbligatorio: no TimeoutInMinutes Intervallo di tempo che può trascorrere prima che lo stato dello stack diventi `CREATE_FAILED`. Se `DisableRollback` non è impostato o è impostato su `false`, verrà eseguito il rollback dello stack. Tipo: numero intero Intervallo valido: valore minimo di 1. Obbligatorio: no ## Output StackId Identificatore univoco dello stack. Tipo: String StackStatus Stato corrente dello stack. Tipo: String Valori validi: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE | REVIEW_IN_PROGRESS` Obbligatorio: sì StackStatusReason Messaggio di operazione riuscita o non riuscita associato allo stato dello stack. ▬Tipo: stringa Obbligatorio: no Per ulteriori informazioni, consulta [CreateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html). ## Considerazioni relative alla sicurezza Prima di utilizzare l'operazione `aws:createStack`, devi assegnare la seguente policy al ruolo presunto del servizio di automazione di IAM. Per ulteriori informazioni sul ruolo presunto, consulta [Processo 1: creazione di un ruolo di servizio per il servizio di automazione](automation-setup-iam.md#create-service-role). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "sqs:*", "cloudformation:CreateStack", "cloudformation:DescribeStacks" ], "Resource":"*" } ] } ``` ------