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 dei documenti di Systems Manager Automation
AWS Systems Manager ti offre visibilità e controllo della tua infrastruttura su AWS. Systems Manager fornisce un'interfaccia utente unificata che consente di visualizzare i dati operativi da più AWS servizi e automatizzare le attività operative tra le AWS risorse.
Un [documento di Systems Manager](https://docs.aws.amazon.com//systems-manager/latest/userguide/sysman-systems-manager-docs.html) definisce le operazioni eseguite da Systems Manager sulle istanze gestite. Un documento di automazione è un tipo di documento Systems Manager utilizzato per eseguire attività di manutenzione e distribuzione comuni come la creazione o l'aggiornamento di un'Amazon Machine Image (AMI). Questo argomento descrive come creare, modificare, pubblicare ed eliminare documenti di Automation con AWS Toolkit for Visual Studio Code.
**Topics**
+ [Presupposti e prerequisiti](#systems-manager-assumptions)
+ [Autorizzazioni IAM per i documenti di automazione di Systems Manager](#systems-manager-permissions)
+ [Creazione di un nuovo documento Systems Manager Automation](#systems-manager-create)
+ [Apertura di un documento Systems Manager Automation esistente](#systems-manager-open)
+ [Modifica di un documento Systems Manager Automation](#systems-manager-edit)
+ [Pubblicazione di un documento Systems Manager Automation](#systems-manager-publish)
+ [Eliminazione di un documento Systems Manager Automation](#systems-manager-delete)
+ [Esecuzione di un documento Systems Manager Automation](#systems-manager-run)
+ [Risoluzione dei problemi relativi ai documenti di Systems Manager Automation in Toolkit for VS Code](systems-manager-troubleshoot.md)
## Presupposti e prerequisiti
Prima di iniziare, assicurati di:
+ Sono stati installati Visual Studio Code e la versione più recente di AWS Toolkit for Visual Studio Code. Per ulteriori informazioni, consulta [Installazione del AWS Toolkit for Visual Studio Code](setup-toolkit.md).
+ Sapere come funziona Systems Manager. Per ulteriori informazioni, consulta la [https://docs.aws.amazon.com//systems-manager/latest/userguide/what-is-systems-manager.html](https://docs.aws.amazon.com//systems-manager/latest/userguide/what-is-systems-manager.html).
+ Conosci i casi d'uso di Systems Manager Automation. Per ulteriori informazioni, consulta la sezione [Automazione di AWS Systems Manager](https://docs.aws.amazon.com//systems-manager/latest/userguide/systems-manager-automation.html) nella *Guida per l'utente di AWS Systems Manager *.
## Autorizzazioni IAM per i documenti di automazione di Systems Manager
Nel Toolkit for VS Code è necessario disporre di un profilo di credenziali che contenga AWS Identity and Access Management le autorizzazioni (IAM) necessarie per creare, modificare, pubblicare ed eliminare i documenti di Systems Manager Automation. Il seguente documento di policy definisce le autorizzazioni IAM necessarie che possono essere utilizzate in una policy principale:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ssm:ListDocuments",
"ssm:ListDocumentVersions",
"ssm:DescribeDocument",
"ssm:GetDocument",
"ssm:CreateDocument",
"ssm:UpdateDocument",
"ssm:UpdateDocumentDefaultVersion",
"ssm:DeleteDocument"
],
"Resource": "*"
}
]
}
```
------
Per informazioni sull'aggiornamento di una policy IAM, consulta la sezione [Creazione di policy IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_create.html) nella *Guida per l'utente di IAM*. Per informazioni su come configurare il profilo delle credenziali, consulta. [AWS Credenziali IAM](setup-credentials.md)
## Creazione di un nuovo documento Systems Manager Automation
È possibile creare un nuovo documento di automazione in `JSON` o `YAML` utilizzando Visual Studio Code. Quando crei un nuovo documento di automazione, questo verrà presentato in un file senza titolo. Puoi assegnare un nome al tuo file e salvarlo in VS Code, tuttavia il nome del file non è visibile. AWS
**Per creare un nuovo documento di automazione**
1. Apri VS Code.
1. Nel menu **Visualizza**, scegli **Command Palette** per aprire la Command Palette.
1. Nella palette dei comandi, immettere **AWS Toolkit Create a new Systems Manager Document Localmente**.
1. Scegli uno dei modelli di avvio per un esempio di Hello World.
1. Scegliere `JSON` o `YAML`.
Viene creato un nuovo documento di automazione.
**Nota**
Il tuo nuovo documento di automazione in VS Code non appare automaticamente in AWS. Devi pubblicarlo su AWS prima di poterlo eseguire.
## Apertura di un documento Systems Manager Automation esistente
È possibile utilizzare AWS Explorer per trovare i documenti esistenti di Systems Manager Automation. Quando si apre un documento di automazione esistente, viene visualizzato come un file senza titolo in VS Code.
**Per aprire il documento di automazione**
1. Apri VS Code.
1. Dalla barra di navigazione a sinistra, scegli di **AWS**aprire Explorer. AWS
1. In AWS Explorer, per **Systems Manager**, scegli l'icona di download sul documento che desideri aprire, quindi scegli la versione del documento. Il file verrà aperto nel formato per quella versione. Altrimenti scegli **Scarica come JSON** o **Scarica come YAML**.
**Nota**
Il salvataggio locale di un documento di automazione come file in VS Code non lo fa apparire in. AWS Deve essere pubblicato su AWS prima dell'esecuzione.
## Modifica di un documento Systems Manager Automation
Se possiedi documenti di automazione, questi vengono visualizzati nella categoria **Owned by Me** dei documenti Systems Manager in AWS Explorer. Puoi possedere documenti di automazione già esistenti in AWS e documenti nuovi o aggiornati su cui hai precedentemente pubblicato AWS da VS Code.
Quando apri un documento di automazione per modificarlo in VS Code, puoi utilizzarlo più di quanto non sia possibile in Console di gestione AWS. Esempio:
+ È disponibile la convalida dello schema su entrambi `JSON` i `YAML` formati.
+ Nell'editor di documenti sono disponibili frammenti che consentono di creare qualsiasi tipo di fase di automazione.
+ È disponibile il supporto per il completamento automatico su varie opzioni in `JSON` and`YAML`.
### Utilizzo delle versioni
I documenti di Systems Manager Automation utilizzano versioni per la gestione delle modifiche. È possibile scegliere la versione predefinita per un documento di automazione in VS Code.
**Per impostare una versione di default**
+ In AWS Explorer, vai al documento su cui desideri impostare la versione predefinita, apri il menu contestuale (fai clic con il pulsante destro del mouse) per il documento e scegli **Imposta versione predefinita**.
**Nota**
Se il documento scelto ha una sola versione, non sarà possibile modificare l'impostazione predefinita.
## Pubblicazione di un documento Systems Manager Automation
Dopo aver modificato il documento di automazione in VS Code, puoi pubblicarlo su AWS.
**Per pubblicare il tuo documento di automazione**
1. Apri il documento di automazione che desideri pubblicare utilizzando la procedura descritta in[Apertura di un documento Systems Manager Automation esistente](#systems-manager-open).
1. Apporta le modifiche che desideri pubblicare. Per ulteriori informazioni, consulta [Modifica di un documento Systems Manager Automation](#systems-manager-edit).
1. In alto a destra del file aperto, scegli l'icona di caricamento.
1. Nella finestra di dialogo del flusso di lavoro di pubblicazione, scegli la AWS regione in cui desideri pubblicare il documento di automazione.
1. Se stai pubblicando un nuovo documento, scegli **Creazione rapida**. Altrimenti, scegli **Aggiornamento rapido** per aggiornare un documento di automazione esistente in quella AWS regione.
1. Inserisci il nome per questo documento di automazione.
Quando si pubblica un aggiornamento di un documento di automazione esistente su AWS, viene aggiunta una nuova versione al documento.
## Eliminazione di un documento Systems Manager Automation
È possibile eliminare i documenti di automazione in VS Code. Se si elimina un documento di automazione, oltre a quest'ultimo vengono eliminate anche tutte le rispettive versioni.
**Importante**
L'eliminazione è un'azione distruttiva che non può essere annullata.
L'eliminazione di un documento di automazione che è già stato eseguito non elimina le AWS risorse che sono state create o modificate al momento dell'avvio.
**Per eliminare il documento di automazione**
1. Apri VS Code.
1. Dalla barra di navigazione a sinistra, scegli di **AWS**aprire Explorer. AWS
1. In AWS Explorer, per **Systems Manager**, apri il menu contestuale (con il pulsante destro del mouse) per il documento che desideri eliminare e scegli **Elimina documento**.
## Esecuzione di un documento Systems Manager Automation
Una volta pubblicato il documento di automazione su AWS, puoi eseguirlo per eseguire attività per tuo conto nel tuo AWS account. Per eseguire il documento di automazione, si utilizza il Console di gestione AWS, Systems Manager APIs AWS CLI, o il AWS Strumenti per PowerShell. Per istruzioni su come eseguire un documento di automazione, consulta [Running a simple automation](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) nella *Guida per l'AWS Systems Manager utente*.
In alternativa, se desideri utilizzare uno di questi AWS SDKs con Systems Manager APIs per eseguire il documento di automazione, consulta i [riferimenti AWS SDK](https://aws.amazon.com/getting-started/tools-sdks/).
**Nota**
L'esecuzione di un documento di automazione può creare nuove risorse AWS e comportare costi di fatturazione. Ti consigliamo vivamente di comprendere cosa creerà il documento di automazione nel tuo account prima di avviarlo.
# Risoluzione dei problemi relativi ai documenti di Systems Manager Automation in Toolkit for VS Code
**Ho salvato il mio documento di automazione in VS Code, ma non lo vedo in. Console di gestione AWS**
Il salvataggio di un documento di automazione in VS Code non comporta la pubblicazione del documento di automazione su AWS. Per ulteriori informazioni sulla pubblicazione di un documento di automazione, consulta la sezione [Pubblicazione di un documento Systems Manager Automation](systems-manager-automation-docs.md#systems-manager-publish).
**La pubblicazione del mio documento di automazione non è riuscita a causa di un errore di autorizzazione.**
Assicurati che il tuo profilo di AWS credenziali disponga delle autorizzazioni necessarie per pubblicare i documenti di automazione. Per un esempio di policy delle autorizzazioni, consulta [Autorizzazioni IAM per i documenti di automazione di Systems Manager](systems-manager-automation-docs.md#systems-manager-permissions).
**Ho pubblicato il mio documento di automazione su AWS, ma non lo vedo in. Console di gestione AWS**
Assicurati di aver pubblicato il documento nella stessa AWS regione in cui stai navigando Console di gestione AWS.
**Ho eliminato il mio documento di automazione, ma mi vengono ancora addebitate le risorse che ha creato.**
L'eliminazione di un documento di automazione non elimina le risorse da esso create o modificate. Puoi identificare le AWS risorse che hai creato dalla [AWS Billing Management Console](https://console.aws.amazon.com/billing/home), esaminare gli addebiti e scegliere quali risorse eliminare da lì.