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à. # CloudFormation StackSets distribuire un riferimento all'azione CodePipeline offre la possibilità di eseguire CloudFormation StackSets operazioni come parte del processo CI/CD. È possibile utilizzare un set di stack per creare pile negli AWS account di tutte AWS le regioni utilizzando un unico modello. CloudFormation Tutte le risorse incluse in ogni stack sono definite dal modello del set di stack. CloudFormation Quando create il set di stack, specificate il modello da utilizzare, nonché tutti i parametri e le funzionalità richiesti dal modello. Per ulteriori informazioni sui concetti di CloudFormation StackSets, consulta [StackSets i concetti](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html) nella *Guida per l'AWS CloudFormation utente*. Puoi integrare la tua pipeline CloudFormation StackSets attraverso due tipi di azioni distinti che usi insieme: + L'`CloudFormationStackSet`azione crea o aggiorna un set di stack o istanze di stack dal modello memorizzato nella posizione di origine della pipeline. Ogni volta che uno stack set viene creato o aggiornato, avvia una distribuzione di tali modifiche su istanze specifiche. Nella console, puoi scegliere il provider di azioni **CloudFormation Stack Set** quando crei o modifichi la tua pipeline. + L'`CloudFormationStackInstances`azione distribuisce le modifiche dall'`CloudFormationStackSet`azione alle istanze specificate, crea nuove istanze dello stack e definisce le sostituzioni dei parametri alle istanze specificate. Nella console, puoi scegliere il provider di azioni **CloudFormation Stack Instances** quando modifichi una pipeline esistente. È possibile utilizzare queste azioni per eseguire la distribuzione su AWS account di destinazione o sull'unità IDs organizzativa AWS Organizations di destinazione. **Nota** Per eseguire la distribuzione sugli account o sull'unità organizzativa di destinazione di AWS Organizations IDs e utilizzare il modello di autorizzazioni gestite dal servizio, è necessario abilitare l'accesso affidabile tra e Organizzazioni. AWS CloudFormation StackSets AWS Per ulteriori informazioni, consulta [Enabling trusted](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-cloudformation.html#integrate-enable-ta-cloudformation) access with Stacksets. AWS CloudFormation **Topics** + [Come funzionano le CloudFormation StackSets azioni](#action-reference-StackSets-concepts) + [Come strutturare le StackSets azioni in una pipeline](#action-reference-StackSets-bestpractices) + [L'operazione `CloudFormationStackSet`](#action-reference-StackSet) + [L'azione CloudFormationStackInstances](#action-reference-StackInstances) + [Autorizzazioni per i ruoli di servizio: azione `CloudFormationStackSet`](#edit-role-cfn-stackset) + [Autorizzazioni per i ruoli di servizio: azione `CloudFormationStackInstances`](#edit-role-cfn-stackinstances) + [Modelli di autorizzazioni per le operazioni relative agli stack set](#action-reference-StackSets-permissions) + [Tipi di dati dei parametri del modello](#action-reference-StackSets-datatypes) + [Consulta anche](#action-reference-CloudFormation-links) ## Come funzionano le CloudFormation StackSets azioni Un'`CloudFormationStackSet`azione crea o aggiorna risorse a seconda che l'azione venga eseguita per la prima volta. L'`CloudFormationStackSet`azione *crea* o *aggiorna* il set di stack e distribuisce tali modifiche in istanze specifiche. **Nota** Se si utilizza questa azione per effettuare un aggiornamento che include l'aggiunta di istanze dello stack, le nuove istanze vengono distribuite per prime e l'aggiornamento viene completato per ultime. Le nuove istanze ricevono prima la versione precedente, quindi l'aggiornamento viene applicato a tutte le istanze. + *Crea*: quando non viene specificata alcuna istanza e lo stack set non esiste, l'**CloudFormationStackSet**azione crea il set di stack senza creare alcuna istanza. + *Aggiornamento*: quando l'**CloudFormationStackSet**azione viene eseguita per un set di stack già creato, l'azione aggiorna il set di stack. Se non viene specificata alcuna istanza e lo stack set esiste già, tutte le istanze vengono aggiornate. Se questa azione viene utilizzata per aggiornare istanze specifiche, tutte le istanze rimanenti passano allo stato OBSOLETO. È possibile utilizzare l'**CloudFormationStackSet**azione per aggiornare lo stack set nei seguenti modi. + Aggiorna il modello su alcune o tutte le istanze. + Aggiorna i parametri su alcune o tutte le istanze. + Aggiorna il ruolo di esecuzione per lo stack set (deve corrispondere al ruolo di esecuzione specificato nel ruolo Amministratore). + Modificate il modello di autorizzazioni (solo se non sono state create istanze). + Abilita/disabilita `AutoDeployment` se il modello di permessi del set di stack è. `Service Managed` + Agisci come amministratore delegato in un account membro se il modello di autorizzazioni dello stack set lo è. `Service Managed` + Aggiorna il ruolo di amministratore. + Aggiorna la descrizione sullo stack set. + Aggiungi obiettivi di distribuzione all'aggiornamento del set di stack per creare nuove istanze dello stack. L'`CloudFormationStackInstances`azione crea nuove istanze dello stack o aggiorna le istanze dello stack obsolete. Un'istanza diventa obsoleta quando un set di stack viene aggiornato, ma non tutte le istanze al suo interno vengono aggiornate. + *Crea*: se lo stack esiste già, l'`CloudFormationStackInstances`azione aggiorna solo le istanze e non crea istanze dello stack. + *Aggiornamento*: dopo l'esecuzione dell'`CloudFormationStackSet`azione, se il modello o i parametri sono stati aggiornati solo in alcuni casi, il resto verrà contrassegnato. `OUTDATED` Nelle fasi successive della pipeline, `CloudFormationStackInstances` aggiorna il resto delle istanze dello stack in ondate in modo che tutte le istanze siano contrassegnate. `CURRENT` Questa azione può essere utilizzata anche per aggiungere istanze aggiuntive o sostituire parametri su istanze nuove o esistenti. Come parte di un aggiornamento, le `CloudFormationStackInstances` azioni `CloudFormationStackSet` and possono specificare nuovi obiettivi di distribuzione, che creano nuove istanze stack. Come parte di un aggiornamento, le `CloudFormationStackInstances` azioni `CloudFormationStackSet` and non eliminano set di stack, istanze o risorse. Quando l'azione aggiorna uno stack ma non specifica tutte le istanze da aggiornare, le istanze che non erano state specificate per l'aggiornamento vengono rimosse dall'aggiornamento e impostate su uno stato di. `OUTDATED` Durante una distribuzione, le istanze dello stack possono anche mostrare lo stato `OUTDATED` se la distribuzione sulle istanze non è riuscita. ## Come strutturare le StackSets azioni in una pipeline Come best practice, è consigliabile costruire la pipeline in modo che lo stack set venga creato e inizialmente distribuito su un sottoinsieme o su una singola istanza. Dopo aver testato la distribuzione e visualizzato lo stack set generato, aggiungete l'`CloudFormationStackInstances`azione in modo che le istanze rimanenti vengano create e aggiornate. Utilizza la console o la CLI per creare la struttura di pipeline consigliata come segue: 1. Crea una pipeline con un'azione di origine (obbligatoria) e l'`CloudFormationStackSet`azione come azione di distribuzione. Esegui la tua pipeline. 1. Quando la pipeline viene eseguita per la prima volta, l'`CloudFormationStackSet`azione *crea* il set di stack e almeno un'istanza iniziale. Verifica la creazione del set di stack ed esamina la distribuzione sull'istanza iniziale. Ad esempio, per la creazione iniziale dello stack set per l'account Account-A dove si `us-east-1` trova la regione specificata, l'istanza dello stack viene creata con lo stack set: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codepipeline/latest/userguide/action-reference-StackSets.html) 1. Modifica la pipeline e create/update aggiungila `CloudFormationStackInstances` come seconda azione di distribuzione per impilare le istanze per gli obiettivi designati. Ad esempio, per la creazione di istanze stack per un account `Account-A` in cui sono specificate le `eu-central-1` regioni `us-east-2` e, le istanze dello stack rimanenti vengono create e l'istanza iniziale rimane aggiornata come segue: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/codepipeline/latest/userguide/action-reference-StackSets.html) 1. Esegui la pipeline secondo necessità per aggiornare il set di stack e aggiornare o creare istanze dello stack. Quando si avvia un aggiornamento dello stack in cui sono stati rimossi gli obiettivi di distribuzione dalla configurazione dell'azione, le istanze dello stack che non erano destinate all'aggiornamento vengono rimosse dalla distribuzione e passano allo stato OBSOLETO. Ad esempio, per l'aggiornamento dell'istanza dello stack per l'account `Account-A` in cui la `us-east-2` regione viene rimossa dalla configurazione dell'azione, vengono create le istanze dello stack rimanenti e l'istanza rimossa viene impostata su OBSOLETA come segue: **** | Istanza Stack | Region | Status | | --- | --- | --- | | StackInstanceID-1 | us-east-1 | CURRENT | | StackInstanceID-2 | us-east-2 | ANTIQUATO | | StackInstanceID-3 | eu-central-1 | CURRENT | *Per ulteriori informazioni sulle migliori pratiche per la distribuzione dei set di stack, consulta la sezione [Best practice StackSets nella Guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-bestpractices.html) per l'AWS CloudFormation utente.* ## L'operazione `CloudFormationStackSet` Questa azione crea o aggiorna uno stack set a partire dal modello memorizzato nella posizione di origine della pipeline. Dopo aver definito un set di stack, è possibile creare, aggiornare o eliminare gli stack negli account e nelle regioni di destinazione specificati nei parametri di configurazione. Durante la creazione, l'aggiornamento e l'eliminazione degli stack, è possibile specificare altre preferenze, come l'ordine delle regioni per le operazioni da eseguire, la percentuale di tolleranza agli errori oltre la quale le operazioni dello stack si interrompono e il numero di account in cui le operazioni vengono eseguite contemporaneamente sugli stack. Un set di stack è una risorsa di livello regionale. Se si crea uno stack impostato in una AWS regione, non è possibile accedervi da altre regioni. Quando questa azione viene utilizzata come azione di aggiornamento dello stack set, gli aggiornamenti allo stack non sono consentiti senza una distribuzione su almeno un'istanza dello stack. **Topics** + [Tipo di operazione](#action-reference-StackSet-type) + [Parametri di configurazione](#action-reference-StackSet-config) + [Input artifact (Artefatti di input)](#action-reference-StackSet-input) + [Artefatti di output](#action-reference-StackSet-output) + [Variabili di output](#action-reference-StackSet-variables) + [Esempio di configurazione **CloudFormationStackSet**dell'azione](#action-reference-StackSet-example) ### Tipo di operazione + Categoria: `Deploy` + Proprietario: `AWS` + Provider: `CloudFormationStackSet` + Versione: `1` ### Parametri di configurazione **StackSetName** Obbligatorio: sì Il nome da associare al set di stack. Questo nome deve essere univoco nella regione in cui è stato creato. Il nome può contenere solo caratteri alfanumerici e trattini. Deve iniziare con un carattere alfabetico e contenere al massimo 128 caratteri. **Description** Obbligatorio: no Una descrizione del set di stack. Puoi usarlo per descrivere lo scopo del set di stack o altre informazioni pertinenti. **TemplatePath** Obbligatorio: sì La posizione del modello che definisce le risorse nello stack set. Deve puntare a un modello con una dimensione massima di 460.800 byte. Immettete il percorso del nome dell'artefatto di origine e del file modello nel formato`"InputArtifactName::TemplateFileName"`, come illustrato nell'esempio seguente. ``` SourceArtifact::template.txt ``` **Parameters** Obbligatorio: no Un elenco di parametri del modello per il set di stack da aggiornare durante una distribuzione. Puoi fornire i parametri come elenco letterale o percorso di file: + È possibile inserire i parametri nel seguente formato di sintassi abbreviata:. `ParameterKey=string,ParameterValue=string,UsePreviousValue=boolean,ResolvedValue=string ParameterKey=string,ParameterValue=string,UsePreviousValue=boolean,ResolvedValue=string` Per ulteriori informazioni su questi tipi di dati, vedere. [Tipi di dati dei parametri del modello](#action-reference-StackSets-datatypes) L'esempio seguente mostra un parametro denominato `BucketName` con il valore`amzn-s3-demo-source-bucket`. ``` ParameterKey=BucketName,ParameterValue=amzn-s3-demo-source-bucket ``` L'esempio seguente mostra una voce con più parametri: ``` ParameterKey=BucketName,ParameterValue=amzn-s3-demo-source-bucket ParameterKey=Asset1,ParameterValue=true ParameterKey=Asset2,ParameterValue=true ``` + È possibile immettere la posizione del file contenente un elenco di sostituzioni dei parametri del modello immesse nel formato`"InputArtifactName::ParametersFileName"`, come illustrato nell'esempio seguente. ``` SourceArtifact::parameters.txt ``` L'esempio seguente mostra il contenuto del file per. `parameters.txt` ``` [ { "ParameterKey": "KeyName", "ParameterValue": "true" }, { "ParameterKey": "KeyName", "ParameterValue": "true" } ] ``` **Funzionalità** Obbligatorio: no Indica che il modello può creare e aggiornare risorse, a seconda dei tipi di risorse presenti nel modello. È necessario utilizzare questa proprietà se nel modello di stack sono presenti risorse IAM o se si crea uno stack direttamente da un modello contenente macro. CloudFormation Affinché l'azione funzioni correttamente in questo modo, è necessario utilizzare una delle seguenti funzionalità: + `CAPABILITY_IAM` + `CAPABILITY_NAMED_IAM` È possibile specificare più di una funzionalità utilizzando una virgola e senza spazi tra le funzionalità. L'esempio in [Esempio di configurazione **CloudFormationStackSet**dell'azione](#action-reference-StackSet-example) mostra una voce con funzionalità multiple. **PermissionModel** Obbligatorio: no Determina come vengono creati e gestiti i ruoli IAM. Se il campo non è specificato, viene utilizzato il valore predefinito. Per informazioni, consulta [Modelli di autorizzazioni per le operazioni relative agli stack set](#action-reference-StackSets-permissions). I valori validi sono: + `SELF_MANAGED`(impostazione predefinita): è necessario creare ruoli di amministratore ed esecuzione da distribuire agli account di destinazione. + `SERVICE_MANAGED`: crea CloudFormation StackSets automaticamente i ruoli IAM necessari per la distribuzione negli account gestiti da AWS Organizations. Ciò richiede che un account sia membro di un'organizzazione. Questo parametro può essere modificato solo quando non esistono istanze di stack nello stack set. ****AdministrationRoleArn**** Poiché CloudFormation StackSets esegue operazioni su più account, è necessario definire le autorizzazioni necessarie in tali account prima di poter creare lo stack set. Obbligatorio: no Questo parametro è facoltativo per il modello di autorizzazioni SELF\$1MANAGED e non viene utilizzato per il modello di autorizzazioni SERVICE\$1MANAGED. L'ARN del ruolo IAM nell'account amministratore utilizzato per eseguire operazioni di stack set. Il nome può contenere caratteri alfanumerici, uno dei seguenti caratteri: \$1\$1=, .@- e senza spazi. Il nome non fa distinzione tra maiuscole e minuscole. Questo nome di ruolo deve avere una lunghezza minima di 20 caratteri e una lunghezza massima di 2048 caratteri. I nomi dei ruoli devono essere univoci all'interno dell'account. Il nome del ruolo specificato qui deve essere un nome di ruolo esistente. Se non si specifica il nome del ruolo, viene impostato su AWSCloudFormationStackSetAdministrationRole. Se si specifica ServiceManaged, non è necessario definire un nome di ruolo. ****ExecutionRoleName**** Poiché CloudFormation StackSets esegue operazioni su più account, è necessario definire le autorizzazioni necessarie in tali account prima di poter creare lo stack set. Obbligatorio: no Questo parametro è facoltativo per il modello di autorizzazioni SELF\$1MANAGED e non viene utilizzato per il modello di autorizzazioni SERVICE\$1MANAGED. Il nome del ruolo IAM negli account di destinazione utilizzati per eseguire le operazioni di stack set. Il nome può contenere caratteri alfanumerici, uno dei seguenti caratteri: \$1\$1=, .@- e senza spazi. Il nome non fa distinzione tra maiuscole e minuscole. Questo nome di ruolo deve avere una lunghezza minima di 1 carattere e una lunghezza massima di 64 caratteri. I nomi dei ruoli devono essere univoci all'interno dell'account. Il nome del ruolo specificato qui deve essere un nome di ruolo esistente. Non specificare questo ruolo se si utilizzano ruoli di esecuzione personalizzati. Se non si specifica il nome del ruolo, viene impostato su`AWSCloudFormationStackSetExecutionRole`. Se si imposta Service\$1Managed su true, non è necessario definire un nome di ruolo. ****OrganizationsAutoDeployment**** Obbligatorio: no Questo parametro è facoltativo per il modello di autorizzazioni SERVICE\$1MANAGED e non viene utilizzato per il modello di autorizzazioni SELF\$1MANAGED. Descrive se CloudFormation StackSets viene distribuito automaticamente agli account AWS Organizations aggiunti a un'organizzazione o a un'unità organizzativa (OU) di destinazione. Se `OrganizationsAutoDeployment` è specificato, non specificare `DeploymentTargets` e`Regions`. Se non viene fornito alcun input`OrganizationsAutoDeployment`, il valore predefinito è`Disabled`. I valori validi sono: + `Enabled`. Obbligatorio: No. StackSets distribuisce automaticamente istanze stack aggiuntive agli account AWS Organizations che vengono aggiunti a un'organizzazione o unità organizzativa (OU) di destinazione nelle regioni specificate. Se un account viene rimosso da un'organizzazione o unità organizzativa di destinazione, CloudFormation StackSets elimina le istanze dello stack dall'account nelle regioni specificate. + `Disabled`. Obbligatorio: No. StackSets non distribuisce automaticamente istanze stack aggiuntive agli account AWS Organizations che vengono aggiunti a un'organizzazione o unità organizzativa (OU) di destinazione nelle regioni specificate. + `EnabledWithStackRetention`. Obbligatorio: No. Le risorse dello stack vengono conservate quando un account viene rimosso da un'organizzazione o unità organizzativa di destinazione. ****DeploymentTargets**** Obbligatorio: no Per il modello di autorizzazioni SERVICE\$1MANAGED, è possibile fornire l'ID radice dell'organizzazione o l'unità organizzativa per gli obiettivi di distribuzione. IDs Per il modello di autorizzazioni SELF\$1MANAGED, puoi fornire solo account. **Quando questo parametro è selezionato, è necessario selezionare anche Regioni.** Un elenco di AWS account o unità organizzative IDs in cui è necessario creare/aggiornare le istanze dello stack set. + **Account:** È possibile fornire gli account come elenco letterale o percorso di file: + *Letterale*: immettete i parametri nel formato sintattico abbreviato`account_ID,account_ID`, come illustrato nell'esempio seguente. ``` 111111222222,333333444444 ``` + *Percorso del file:* la posizione del file contenente un elenco di AWS account in cui le istanze dello stack set devono essere create/aggiornate, inserita nel formato. `InputArtifactName::AccountsFileName` Se si utilizza il percorso del file per specificare **gli account** oppure **OrganizationalUnitIds**, il formato del file deve essere in JSON, come illustrato nell'esempio seguente. ``` SourceArtifact::accounts.txt ``` L'esempio seguente mostra il contenuto del file per`accounts.txt`. ``` [ "111111222222" ] ``` L'esempio seguente mostra il contenuto del file per `accounts.txt` quando si elencano più di un account: ``` [ "111111222222","333333444444" ] ``` + **OrganizationalUnitIds**: **Nota** Questo parametro è facoltativo per il modello di autorizzazioni SERVICE\$1MANAGED e non viene utilizzato per il modello di autorizzazioni SELF\$1MANAGED. Non utilizzarlo se si seleziona. **OrganizationsAutoDeployment** Le unità AWS organizzative in cui aggiornare le istanze dello stack associate. Puoi fornire l'unità organizzativa IDs come elenco letterale o percorso di file: + *Letterale*: inserisci una matrice di stringhe separate da virgole, come illustrato nell'esempio seguente. ``` ou-examplerootid111-exampleouid111,ou-examplerootid222-exampleouid222 ``` + *Percorso del file:* la posizione del file contenente un elenco OrganizationalUnitIds in cui creare o aggiornare le istanze dello stack set. Se si utilizza il percorso del file per specificare **gli account** oppure **OrganizationalUnitIds**, il formato del file deve essere in JSON, come illustrato nell'esempio seguente. Immettete il percorso del file nel formato`InputArtifactName::OrganizationalUnitIdsFileName`. ``` SourceArtifact::OU-IDs.txt ``` L'esempio seguente mostra il contenuto del file per`OU-IDs.txt`: ``` [ "ou-examplerootid111-exampleouid111","ou-examplerootid222-exampleouid222" ] ``` ****Regioni**** Obbligatorio: no Quando questo parametro è selezionato, è necessario selezionare anche **DeploymentTargets**. Un elenco di AWS regioni in cui vengono create o aggiornate le istanze dello stack set. Le regioni vengono aggiornate nell'ordine in cui vengono inserite. Immettete un elenco di AWS regioni valide nel formato`Region1,Region2`, come illustrato nell'esempio seguente. ``` us-west-2,us-east-1 ``` ****FailureTolerancePercentage**** Obbligatorio: no La percentuale di account per regione per i quali questa operazione di stack può fallire prima che l' CloudFormation operazione venga interrotta in quella regione. Se l'operazione viene interrotta in una regione, CloudFormation non tenta l'operazione nelle regioni successive. Quando si calcola il numero di conti in base alla percentuale specificata, viene CloudFormation arrotondato per *difetto* al numero intero successivo. ****MaxConcurrentPercentage**** Obbligatorio: no La percentuale massima di account in cui eseguire questa operazione simultaneamente. *Quando si calcola il numero di conti in base alla percentuale specificata, CloudFormation arrotonda per difetto al numero intero successivo.* Se l'arrotondamento per difetto dà come risultato zero, CloudFormation imposta invece il numero a uno. Sebbene si utilizzi questa impostazione per specificare il *valore massimo*, per le distribuzioni di grandi dimensioni il numero effettivo di account su cui si agisce contemporaneamente potrebbe essere inferiore a causa della limitazione del servizio. **RegionConcurrencyType** Obbligatorio: no È possibile specificare se lo stack set deve essere distribuito in Regioni AWS sequenza o in parallelo configurando il parametro Region concurrency deployment. Quando viene specificata la concorrenza Region per distribuire stack su più stack in Regioni AWS parallelo, ciò può comportare tempi di implementazione complessivi più rapidi. + *Parallelo*: le implementazioni di set di stack verranno eseguite contemporaneamente, a condizione che gli errori di distribuzione in una regione non superino una tolleranza di errore specificata. + *Sequenziale*: le implementazioni di set di stack verranno eseguite una alla volta, a condizione che gli errori di distribuzione in una regione non superino una tolleranza di errore specificata. La distribuzione sequenziale è la selezione predefinita. **ConcurrencyMode** Obbligatorio: no La modalità di concorrenza consente di scegliere il comportamento del livello di concorrenza durante le operazioni di stack set, con una tolleranza agli errori rigorosa o morbida. La **tolleranza rigorosa ai guasti** riduce la velocità di implementazione quando si verificano errori nelle operazioni del set di stack, poiché la simultaneità diminuisce per ogni errore. **Soft Failure Tolerance** dà priorità alla velocità di implementazione sfruttando al contempo le funzionalità di sicurezza. CloudFormation + `STRICT_FAILURE_TOLERANCE`: Questa opzione riduce dinamicamente il livello di concorrenza per garantire che il numero di account falliti non superi mai una particolare tolleranza di errore. Questo è il comportamento che segue di default. + `SOFT_FAILURE_TOLERANCE`: questa opzione disaccoppia la tolleranza agli errori dalla concorrenza effettiva. Ciò consente alle operazioni di stack set di essere eseguite a un livello di concorrenza prestabilito, indipendentemente dal numero di errori. **CallAs** Obbligatorio: no Questo parametro è facoltativo per il modello di `SERVICE_MANAGED` autorizzazioni e non viene utilizzato per il modello di autorizzazioni. `SELF_MANAGED` Speciifica se si agisce nell'account di gestione dell'organizzazione o come amministratore delegato in un account membro. Se questo parametro è impostato su`DELEGATED_ADMIN`, assicurati che il ruolo IAM della pipeline disponga dell'autorizzazione. `organizations:ListDelegatedAdministrators` In caso contrario, l'azione avrà esito negativo durante l'esecuzione con un errore simile al seguente:`Account used is not a delegated administrator`. + `SELF`: La distribuzione di Stack Set utilizzerà le autorizzazioni gestite dal servizio una volta effettuato l'accesso all'account di gestione. + `DELEGATED_ADMIN`: la distribuzione di Stack Set utilizzerà le autorizzazioni gestite dal servizio una volta effettuato l'accesso a un account amministratore delegato. ### Input artifact (Artefatti di input) È necessario includere almeno un elemento di input che contenga il modello per lo stack set in un'azione. `CloudFormationStackSet` È possibile includere più artefatti di input per elenchi di obiettivi, account e parametri di distribuzione. + **Numero di artefatti:** `1 to 3` + **Descrizione:** puoi includere artefatti per fornire: + Il file modello dello stack. Consulta il parametro `TemplatePath`. + Il file dei parametri. Consulta il parametro `Parameters`. + Il file degli account. Consulta il parametro `DeploymentTargets`. ### Artefatti di output + **Numero di artefatti:** `0` + **Descrizione:** gli artefatti di output non si applicano a questo tipo di azione. ### Variabili di output Se si configura questa azione, produce variabili a cui può fare riferimento la configurazione dell'azione di un'azione a valle nella pipeline. È possibile configurare un'azione con uno spazio dei nomi per rendere tali variabili disponibili per la configurazione delle azioni downstream. + **StackSetId**: L'ID dello stack set. + **OperationId**: L'ID dell'operazione di set di stack. Per ulteriori informazioni, consulta [Riferimento alle variabili](reference-variables.md). ### Esempio di configurazione **CloudFormationStackSet**dell'azione Gli esempi seguenti mostrano la configurazione dell'**CloudFormationStackSet**azione. #### Esempio di modello di autorizzazioni autogestite L'esempio seguente mostra un'**CloudFormationStackSet**azione in cui l'obiettivo di distribuzione immesso è un ID AWS account. ------ #### [ YAML ] ``` Name: CreateStackSet ActionTypeId: Category: Deploy Owner: AWS Provider: CloudFormationStackSet Version: '1' RunOrder: 1 Configuration: DeploymentTargets: '111111222222' FailureTolerancePercentage: '20' MaxConcurrentPercentage: '25' PermissionModel: SELF_MANAGED Regions: us-east-1 StackSetName: my-stackset TemplatePath: 'SourceArtifact::template.json' OutputArtifacts: [] InputArtifacts: - Name: SourceArtifact Region: us-west-2 Namespace: DeployVariables ``` ------ #### [ JSON ] ``` { "Name": "CreateStackSet", "ActionTypeId": { "Category": "Deploy", "Owner": "AWS", "Provider": "CloudFormationStackSet", "Version": "1" }, "RunOrder": 1, "Configuration": { "DeploymentTargets": "111111222222", "FailureTolerancePercentage": "20", "MaxConcurrentPercentage": "25", "PermissionModel": "SELF_MANAGED", "Regions": "us-east-1", "StackSetName": "my-stackset", "TemplatePath": "SourceArtifact::template.json" }, "OutputArtifacts": [], "InputArtifacts": [ { "Name": "SourceArtifact" } ], "Region": "us-west-2", "Namespace": "DeployVariables" } ``` ------ #### Esempio del modello di autorizzazioni gestite dal servizio L'esempio seguente mostra un'**CloudFormationStackSet**azione per il modello di autorizzazioni gestite dal servizio in cui l'opzione per la distribuzione automatica in AWS Organizations è abilitata con stack retention. ------ #### [ YAML ] ``` Name: Deploy ActionTypeId: Category: Deploy Owner: AWS Provider: CloudFormationStackSet Version: '1' RunOrder: 1 Configuration: Capabilities: 'CAPABILITY_IAM,CAPABILITY_NAMED_IAM' OrganizationsAutoDeployment: EnabledWithStackRetention PermissionModel: SERVICE_MANAGED StackSetName: stacks-orgs TemplatePath: 'SourceArtifact::template.json' OutputArtifacts: [] InputArtifacts: - Name: SourceArtifact Region: eu-central-1 Namespace: DeployVariables ``` ------ #### [ JSON ] ``` { "Name": "Deploy", "ActionTypeId": { "Category": "Deploy", "Owner": "AWS", "Provider": "CloudFormationStackSet", "Version": "1" }, "RunOrder": 1, "Configuration": { "Capabilities": "CAPABILITY_IAM,CAPABILITY_NAMED_IAM", "OrganizationsAutoDeployment": "EnabledWithStackRetention", "PermissionModel": "SERVICE_MANAGED", "StackSetName": "stacks-orgs", "TemplatePath": "SourceArtifact::template.json" }, "OutputArtifacts": [], "InputArtifacts": [ { "Name": "SourceArtifact" } ], "Region": "eu-central-1", "Namespace": "DeployVariables" } ``` ------ ## L'azione CloudFormationStackInstances Questa azione crea nuove istanze e distribuisce set di stack su istanze specifiche. Un'istanza di stack è un riferimento a uno stack in un account target all'interno di una Regione. Un'istanza dello stack può esistere senza uno stack; ad esempio, se la creazione dello stack non ha esito positivo, l'istanza dello stack mostra il motivo dell'errore di creazione dello stack. Un'istanza di stack è associata a un solo set di stack. Dopo la creazione iniziale di un set di stack, puoi aggiungere nuove istanze di stack utilizzando. `CloudFormationStackInstances` I valori dei parametri del modello possono essere sovrascritti a livello di istanza dello stack durante le operazioni di creazione o aggiornamento dell'istanza dello stack set. Ogni set di stack ha un modello e un set di parametri di modello. Quando aggiorni il modello o i parametri del modello, li aggiorni per l'intero set. Quindi tutti gli stati dell'istanza vengono impostati su `OUTDATED` fino a quando le modifiche non vengono distribuite a quell'istanza. Per sovrascrivere i valori dei parametri su istanze specifiche, ad esempio, se il modello contiene un parametro per `stage` con un valore di`prod`, è possibile sovrascrivere il valore di quel parametro come o. `beta` `gamma` **Topics** + [Tipo di operazione](#action-reference-StackInstances-type) + [Parametri di configurazione](#action-reference-StackInstances-config) + [Input artifact (Artefatti di input)](#action-reference-StackInstances-input) + [Artefatti di output](#action-reference-StackInstances-output) + [Variabili di output](#action-reference-StackInstances-variables) + [Esempio di configurazione dell'operazione](#action-reference-StackInstances-example) ### Tipo di operazione + Categoria: `Deploy` + Proprietario: `AWS` + Provider: `CloudFormationStackInstances` + Versione: `1` ### Parametri di configurazione **StackSetName** Obbligatorio: sì Il nome da associare al set di stack. Questo nome deve essere univoco nella regione in cui è stato creato. Il nome può contenere solo caratteri alfanumerici e trattini. Deve iniziare con un carattere alfabetico e contenere al massimo 128 caratteri. ****DeploymentTargets**** Obbligatorio: no Per il modello di autorizzazioni SERVICE\$1MANAGED, è possibile fornire l'ID radice dell'organizzazione o l'unità organizzativa per gli obiettivi di distribuzione. IDs Per il modello di autorizzazioni SELF\$1MANAGED, puoi fornire solo account. **Quando questo parametro è selezionato, è necessario selezionare anche Regioni.** Un elenco di AWS account o unità organizzative IDs in cui è necessario creare/aggiornare le istanze dello stack set. + **Account:** È possibile fornire gli account come elenco letterale o percorso di file: + *Letterale*: immettete i parametri nel formato sintattico abbreviato`account_ID,account_ID`, come illustrato nell'esempio seguente. ``` 111111222222,333333444444 ``` + *Percorso del file:* la posizione del file contenente un elenco di AWS account in cui le istanze dello stack set devono essere create/aggiornate, inserita nel formato. `InputArtifactName::AccountsFileName` Se si utilizza il percorso del file per specificare **gli account** oppure **OrganizationalUnitIds**, il formato del file deve essere in JSON, come illustrato nell'esempio seguente. ``` SourceArtifact::accounts.txt ``` L'esempio seguente mostra il contenuto del file per`accounts.txt`: ``` [ "111111222222" ] ``` L'esempio seguente mostra il contenuto del file per `accounts.txt` quando si elencano più di un account: ``` [ "111111222222","333333444444" ] ``` + **OrganizationalUnitIds**: **Nota** Questo parametro è facoltativo per il modello di autorizzazioni SERVICE\$1MANAGED e non viene utilizzato per il modello di autorizzazioni SELF\$1MANAGED. Non utilizzarlo se si seleziona. **OrganizationsAutoDeployment** Le unità AWS organizzative in cui aggiornare le istanze dello stack associate. È possibile fornire un'unità organizzativa IDs come elenco letterale o percorso di file. + *Letterale*: immettete una matrice di stringhe separate da virgole, come illustrato nell'esempio seguente. ``` ou-examplerootid111-exampleouid111,ou-examplerootid222-exampleouid222 ``` + *Percorso del file:* la posizione del file contenente un elenco OrganizationalUnitIds in cui creare o aggiornare le istanze dello stack set. Se si utilizza il percorso del file per specificare **gli account** oppure **OrganizationalUnitIds**, il formato del file deve essere in JSON, come illustrato nell'esempio seguente. Immettete il percorso del file nel formato`InputArtifactName::OrganizationalUnitIdsFileName`. ``` SourceArtifact::OU-IDs.txt ``` L'esempio seguente mostra il contenuto del file per`OU-IDs.txt`: ``` [ "ou-examplerootid111-exampleouid111","ou-examplerootid222-exampleouid222" ] ``` ****Regioni**** Obbligatorio: sì Quando questo parametro è selezionato, è necessario selezionare anche **DeploymentTargets**. Un elenco di AWS regioni in cui vengono create o aggiornate le istanze dello stack set. Le regioni vengono aggiornate nell'ordine in cui vengono inserite. Immettete un elenco di AWS regioni valide nel formato:`Region1,Region2`, come illustrato nell'esempio seguente. ``` us-west-2,us-east-1 ``` **ParameterOverrides** Obbligatorio: no Un elenco di parametri dello stack set che desideri sovrascrivere nelle istanze dello stack selezionate. I valori dei parametri sostituiti vengono applicati a tutte le istanze dello stack negli account e nelle regioni specificati. Puoi fornire i parametri come elenco letterale o percorso di file: + È possibile inserire i parametri nel seguente formato di sintassi abbreviata:. `ParameterKey=string,ParameterValue=string,UsePreviousValue=boolean,ResolvedValue=string ParameterKey=string,ParameterValue=string,UsePreviousValue=boolean,ResolvedValue=string` Per ulteriori informazioni su questi tipi di dati, vedere. [Tipi di dati dei parametri del modello](#action-reference-StackSets-datatypes) L'esempio seguente mostra un parametro denominato `BucketName` con il valore`amzn-s3-demo-source-bucket`. ``` ParameterKey=BucketName,ParameterValue=amzn-s3-demo-source-bucket ``` L'esempio seguente mostra una voce con più parametri. ``` ParameterKey=BucketName,ParameterValue=amzn-s3-demo-source-bucket ParameterKey=Asset1,ParameterValue=true ParameterKey=Asset2,ParameterValue=true ``` + È possibile immettere la posizione del file contenente un elenco di sostituzioni dei parametri del modello immesse nel formato`InputArtifactName::ParameterOverridessFileName`, come illustrato nell'esempio seguente. ``` SourceArtifact::parameter-overrides.txt ``` L'esempio seguente mostra il contenuto del file per. `parameter-overrides.txt` ``` [ { "ParameterKey": "KeyName", "ParameterValue": "true" }, { "ParameterKey": "KeyName", "ParameterValue": "true" } ] ``` ****FailureTolerancePercentage**** Obbligatorio: no La percentuale di account per regione per i quali questa operazione di stack può fallire prima dell' CloudFormation interruzione dell'operazione in quella regione. Se l'operazione viene interrotta in una regione, CloudFormation non tenta l'operazione nelle regioni successive. Quando si calcola il numero di conti in base alla percentuale specificata, viene CloudFormation arrotondato per *difetto* al numero intero successivo. ****MaxConcurrentPercentage**** Obbligatorio: no La percentuale massima di account su cui eseguire questa operazione contemporaneamente. Quando si calcola il numero di conti in base alla percentuale specificata, viene CloudFormation arrotondato per *difetto* al numero intero successivo. Se l'arrotondamento per difetto dà come risultato zero, CloudFormation imposta invece il numero a uno. Sebbene si specifichi il *valore massimo*, per le distribuzioni di grandi dimensioni il numero effettivo di account su cui si agisce contemporaneamente potrebbe essere inferiore a causa della limitazione del servizio. **RegionConcurrencyType** Obbligatorio: no È possibile specificare se lo stack set deve essere distribuito in Regioni AWS sequenza o in parallelo configurando il parametro region concurrency deployment. Quando viene specificata la concorrenza Region per distribuire stack su più stack in Regioni AWS parallelo, ciò può comportare tempi di implementazione complessivi più rapidi. + *Parallelo*: le implementazioni di set di stack verranno eseguite contemporaneamente, a condizione che gli errori di distribuzione in una regione non superino una tolleranza di errore specificata. + *Sequenziale*: le implementazioni di set di stack verranno eseguite una alla volta, a condizione che gli errori di distribuzione in una regione non superino una tolleranza di errore specificata. La distribuzione sequenziale è la selezione predefinita. **ConcurrencyMode** Obbligatorio: no La modalità di concorrenza consente di scegliere il comportamento del livello di concorrenza durante le operazioni di stack set, con una tolleranza agli errori rigorosa o morbida. La **tolleranza rigorosa ai guasti** riduce la velocità di implementazione quando si verificano errori nelle operazioni del set di stack, poiché la simultaneità diminuisce per ogni errore. **Soft Failure Tolerance** dà priorità alla velocità di implementazione sfruttando al contempo le funzionalità di sicurezza. CloudFormation + `STRICT_FAILURE_TOLERANCE`: Questa opzione riduce dinamicamente il livello di concorrenza per garantire che il numero di account falliti non superi mai una particolare tolleranza di errore. Questo è il comportamento che segue di default. + `SOFT_FAILURE_TOLERANCE`: questa opzione disaccoppia la tolleranza agli errori dalla concorrenza effettiva. Ciò consente alle operazioni di stack set di essere eseguite a un livello di concorrenza prestabilito, indipendentemente dal numero di errori. **CallAs** Obbligatorio: no Questo parametro è facoltativo per il modello di `SERVICE_MANAGED` autorizzazioni e non viene utilizzato per il modello di autorizzazioni. `SELF_MANAGED` Speciifica se si agisce nell'account di gestione dell'organizzazione o come amministratore delegato in un account membro. Se questo parametro è impostato su`DELEGATED_ADMIN`, assicurati che il ruolo IAM della pipeline disponga dell'autorizzazione. `organizations:ListDelegatedAdministrators` In caso contrario, l'azione avrà esito negativo durante l'esecuzione con un errore simile al seguente:`Account used is not a delegated administrator`. + `SELF`: La distribuzione di Stack Set utilizzerà le autorizzazioni gestite dal servizio una volta effettuato l'accesso all'account di gestione. + `DELEGATED_ADMIN`: la distribuzione di Stack Set utilizzerà le autorizzazioni gestite dal servizio una volta effettuato l'accesso a un account amministratore delegato. ### Input artifact (Artefatti di input) `CloudFormationStackInstances`può contenere artefatti che elencano gli obiettivi e i parametri di distribuzione. + **Numero di artefatti:** `0 to 2` + **Descrizione:** come input, l'azione stack set accetta facoltativamente artefatti per i seguenti scopi: + Per fornire il file dei parametri da utilizzare. Consulta il parametro `ParameterOverrides`. + Per fornire il file degli account di destinazione da utilizzare. Consulta il parametro `DeploymentTargets`. ### Artefatti di output + **Numero di artefatti:** `0` + **Descrizione:** gli artefatti di output non si applicano a questo tipo di azione. ### Variabili di output Quando è configurata, questa azione produce variabili che possono essere referenziate dalla configurazione dell'azione di un'azione downstream nella pipeline. È possibile configurare un'azione con uno spazio dei nomi per rendere tali variabili disponibili per la configurazione delle azioni downstream. + **StackSetId**: L'ID dello stack set. + **OperationId**: L'ID dell'operazione di set di stack. Per ulteriori informazioni, consulta [Riferimento alle variabili](reference-variables.md). ### Esempio di configurazione dell'operazione Gli esempi seguenti mostrano la configurazione dell'**CloudFormationStackInstances**azione. #### Esempio di modello di autorizzazioni autogestite L'esempio seguente mostra un'**CloudFormationStackInstances**azione in cui l'obiettivo di distribuzione immesso è un Account AWS ID. `111111222222` ------ #### [ YAML ] ``` Name: my-instances ActionTypeId: Category: Deploy Owner: AWS Provider: CloudFormationStackInstances Version: '1' RunOrder: 2 Configuration: DeploymentTargets: '111111222222' Regions: 'us-east-1,us-east-2,us-west-1,us-west-2' StackSetName: my-stackset OutputArtifacts: [] InputArtifacts: - Name: SourceArtifact Region: us-west-2 ``` ------ #### [ JSON ] ``` { "Name": "my-instances", "ActionTypeId": { "Category": "Deploy", "Owner": "AWS", "Provider": "CloudFormationStackInstances", "Version": "1" }, "RunOrder": 2, "Configuration": { "DeploymentTargets": "111111222222", "Regions": "us-east-1,us-east-2,us-west-1,us-west-2", "StackSetName": "my-stackset" }, "OutputArtifacts": [], "InputArtifacts": [ { "Name": "SourceArtifact" } ], "Region": "us-west-2" } ``` ------ #### Esempio del modello di autorizzazioni gestite dal servizio L'esempio seguente mostra un'**CloudFormationStackInstances**azione per il modello di autorizzazioni gestite dal servizio in cui l'obiettivo di distribuzione è un ID di unità organizzativa AWS Organizations. `ou-1111-1example` ------ #### [ YAML ] ``` Name: Instances ActionTypeId: Category: Deploy Owner: AWS Provider: CloudFormationStackInstances Version: '1' RunOrder: 2 Configuration: DeploymentTargets: ou-1111-1example Regions: us-east-1 StackSetName: my-stackset OutputArtifacts: [] InputArtifacts: - Name: SourceArtifact Region: eu-central-1 ``` ------ #### [ JSON ] ``` { "Name": "Instances", "ActionTypeId": { "Category": "Deploy", "Owner": "AWS", "Provider": "CloudFormationStackInstances", "Version": "1" }, "RunOrder": 2, "Configuration": { "DeploymentTargets": "ou-1111-1example", "Regions": "us-east-1", "StackSetName": "my-stackset" }, "OutputArtifacts": [], "InputArtifacts": [ { "Name": "SourceArtifact" } ], "Region": "eu-central-1" } ``` ------ ## Autorizzazioni per i ruoli di servizio: azione `CloudFormationStackSet` Per CloudFormation StackSets le azioni, sono richieste le seguenti autorizzazioni minime. Per l'`CloudFormationStackSet`azione, aggiungi quanto segue alla tua dichiarazione politica: ``` { "Effect": "Allow", "Action": [ "cloudformation:CreateStackSet", "cloudformation:UpdateStackSet", "cloudformation:CreateStackInstances", "cloudformation:DescribeStackSetOperation", "cloudformation:DescribeStackSet", "cloudformation:ListStackInstances" ], "Resource": "resource_ARN" }, ``` ## Autorizzazioni per i ruoli di servizio: azione `CloudFormationStackInstances` Per l'`CloudFormationStackInstances`azione, aggiungi quanto segue alla tua dichiarazione politica: ``` { "Effect": "Allow", "Action": [ "cloudformation:CreateStackInstances", "cloudformation:DescribeStackSetOperation" ], "Resource": "resource_ARN" }, ``` ## Modelli di autorizzazioni per le operazioni relative agli stack set Poiché CloudFormation StackSets esegue operazioni su più account, è necessario definire le autorizzazioni necessarie in tali account prima di poter creare lo stack set. È possibile definire le autorizzazioni tramite autorizzazioni autogestite o autorizzazioni gestite dal servizio. Con le autorizzazioni autogestite, puoi creare i due ruoli IAM richiesti da StackSets : un ruolo di amministratore, ad esempio nell'account AWSCloud FormationStackSetAdministrationRole in cui definisci il set di stack, e un ruolo di esecuzione come quello AWSCloud FormationStackSetExecutionRole in ciascuno degli account in cui distribuisci le istanze dello stack set. Utilizzando questo modello di autorizzazioni, StackSets puoi eseguire la distribuzione su qualsiasi AWS account in cui l'utente dispone delle autorizzazioni per creare un ruolo IAM. *Per ulteriori informazioni, consulta [Concedere autorizzazioni autogestite](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs-self-managed.html) nella Guida per l'utente.AWS CloudFormation * **Nota** Poiché CloudFormation StackSets esegue operazioni su più account, è necessario definire le autorizzazioni necessarie in tali account prima di poter creare lo stack set. Con le autorizzazioni gestite dal servizio, puoi distribuire istanze stack su account gestiti da Organizations. AWS Utilizzando questo modello di autorizzazioni, non è necessario creare i ruoli IAM necessari, in quanto StackSets crea i ruoli IAM per conto dell'utente. Con questo modello, puoi anche abilitare le distribuzioni automatiche agli account che verranno aggiunti all'organizzazione in futuro. Vedi [Enable trusted access with AWS Organizations](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-enable-trusted-access.html) nella *Guida AWS CloudFormation per l'utente*. ## Tipi di dati dei parametri del modello I parametri del modello utilizzati nelle operazioni di stack set includono i seguenti tipi di dati. Per ulteriori informazioni, consulta [DescribeStackSet](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html). ParameterKey + Descrizione: la chiave associata al parametro. Se non specificate una chiave e un valore per un particolare parametro, AWS CloudFormation utilizza il valore predefinito specificato nel modello. + Esempio: ``` "ParameterKey=BucketName,ParameterValue=amzn-s3-demo-source-bucket" ``` ParameterValue + Descrizione: il valore di input associato al parametro. + Esempio: ``` "ParameterKey=BucketName,ParameterValue=amzn-s3-demo-source-bucket" ``` UsePreviousValue + Durante un aggiornamento dello stack, utilizzate il valore del parametro esistente utilizzato dallo stack per una determinata chiave di parametro. Se lo specificate`true`, non specificate il valore di un parametro. + Esempio: ``` "ParameterKey=Asset1,UsePreviousValue=true" ``` Ogni set di stack ha un modello e un set di parametri di modello. Quando aggiorni il modello o i parametri del modello, li aggiorni per l'intero set. Quindi tutti gli stati delle istanze vengono impostati su OBSOLETO fino a quando le modifiche non vengono distribuite a quell'istanza. Per sovrascrivere i valori dei parametri su istanze specifiche, ad esempio, se il modello contiene un parametro per `stage` con un valore di`prod`, è possibile sovrascrivere il valore di quel parametro impostando or. `beta` `gamma` ## Consulta anche Le risorse correlate seguenti possono essere utili durante l'utilizzo di questa operazione. + [Tipi di parametri](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html#parameters-section-structure-properties-type): questo capitolo di riferimento della *Guida per l'AWS CloudFormation utente* fornisce ulteriori descrizioni ed esempi per CloudFormation i parametri del modello. + Procedure ottimali: per ulteriori informazioni sulle migliori pratiche per la distribuzione di set di stack, [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-bestpractices.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-bestpractices.html) consulta la Guida per l'*AWS CloudFormation utente*. + [AWS CloudFormation Riferimento alle API](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/): puoi fare riferimento CloudFormation alle seguenti azioni nell'*AWS CloudFormation API Reference* per ulteriori informazioni sui parametri utilizzati nelle operazioni relative agli stack set: + L'[CreateStackSet](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStackSet.html)azione crea un set di stack. + L'[UpdateStackSet](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackSet.html)azione aggiorna il set di stack e le istanze di stack associate negli account e nelle regioni specificati. Anche se l'operazione di stack set creata aggiornando lo stack set fallisce (completamente o parzialmente, al di sotto o al di sopra di una tolleranza di errore specificata), il set di stack viene aggiornato con queste modifiche. Le CreateStackInstances chiamate successive sul set di stack specificato utilizzano il set di stack aggiornato. + L'[CreateStackInstances](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStackInstances.html)azione crea un'istanza stack per tutte le regioni specificate all'interno di tutti gli account specificati su un modello di autorizzazione autogestito o all'interno di tutti gli obiettivi di distribuzione specificati su un modello di autorizzazione gestito dal servizio. È possibile sovrascrivere i parametri per le istanze create da questa azione. Se le istanze esistono già, CreateStackInstances chiamate UpdateStackInstances con gli stessi parametri di input. Quando utilizzate questa azione per creare istanze, non modifica lo stato delle altre istanze dello stack. + L'[UpdateStackInstances](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_UpdateStackInstances.html)azione aggiorna le istanze dello stack con lo stack impostato per tutte le regioni specificate all'interno di tutti gli account specificati su un modello di autorizzazione autogestito o entro tutti gli obiettivi di distribuzione specificati su un modello di autorizzazione gestito dal servizio. È possibile sovrascrivere i parametri per le istanze aggiornate da questa azione. Quando si utilizza questa azione per aggiornare un sottoinsieme di istanze, non modifica lo stato delle altre istanze dello stack. + L'[DescribeStackSetOperation](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackSetOperation.html)azione restituisce la descrizione dell'operazione di stack set specificata. + L'[DescribeStackSet](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackSet.html)azione restituisce la descrizione del set di stack specificato.