• 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.
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à.
Schema documento di sessione
Le seguenti informazioni descrivono gli elementi dello schema di un documento di sessione. AWS Systems Manager Session Managerutilizza i documenti di sessione per determinare il tipo di sessione da avviare, ad esempio una sessione standard, una sessione di port forwarding o una sessione per eseguire un comando interattivo.
- schemaVersion
-
Versione dello schema del documento di sessione. I documenti delle sessioni supportano solo la versione 1.0.
Tipo: stringa
Obbligatorio: sì
- description
-
Descrizione specificata per il documento di sessione. Ad esempio, «Documento per avviare la sessione di inoltro della porta con Session Manager>>.
▬Tipo: stringa
Obbligatorio: no
- sessionType
-
Il tipo di sessione che il documento di sessione viene utilizzato per stabilire.
Tipo: stringa
Obbligatorio: sì
Valori validi:
InteractiveCommands|NonInteractiveCommands|Port|Standard_Stream - inputs
-
Preferenze di sessione da utilizzare per le sessioni stabilite utilizzando questo documento di sessione. Questo elemento è necessario per i documenti di sessione utilizzati per creare sessioni
Standard_Stream.Tipo: StringMap
Obbligatorio: no
- s3BucketName
-
Il bucket Amazon Simple Storage Service (Amazon S3) a cui desideri inviare i log delle sessioni al termine delle sessioni.
Tipo: string
Obbligatorio: no
- s3KeyPrefix
-
Il prefisso da utilizzare quando si inviano i log al bucket Amazon S3 specificato nell'input
s3BucketName. Per ulteriori informazioni sull'utilizzo di un prefisso condiviso con gli oggetti archiviati in Amazon S3, consulta Come si utilizzano le cartelle in un bucket S3? nella Guida per l'utente di Amazon Simple Storage Service.▬Tipo: stringa
Obbligatorio: no
- s3EncryptionEnabled
-
Se impostato su
true, il bucket Amazon S3 specificato nell'inputs3BucketNamedeve essere crittografato.Tipo: Booleano
Obbligatorio: sì
- cloudWatchLogGroupName
-
Il nome del gruppo Amazon CloudWatch Logs (CloudWatch Logs) a cui desideri inviare i log delle sessioni al termine delle sessioni.
▬Tipo: stringa
Obbligatorio: no
- cloudWatchEncryptionEnabled
-
Se impostato su
true, il gruppo di log specificato nell'inputcloudWatchLogGroupNamedeve essere crittografato.Tipo: Booleano
Obbligatorio: sì
- cloudWatchStreamingEnabled
-
Se impostato su
true, un flusso continuo di log di dati delle sessioni viene inviato al gruppo di log specificato nell'inputcloudWatchLogGroupName. Se impostati sufalse, i log delle sessioni vengono inviati al gruppo di log specificato nell'input dicloudWatchLogGroupNamealla fine delle sessioni.Tipo: Booleano
Obbligatorio: sì
- kmsKeyId
-
L'ID che AWS KMS key desideri utilizzare per crittografare ulteriormente i dati tra i tuoi computer client locali e i nodi gestiti di Amazon Elastic Compute Cloud (Amazon EC2) a cui ti connetti.
▬Tipo: stringa
Obbligatorio: no
- runAsEnabled
-
Se impostato su
true, è necessario specificare un account utente esistente nei nodi gestiti a cui ci si connetterà nell'inputrunAsDefaultUser. In caso contrario, le sessioni non verranno avviate. Per impostazione predefinita, le sessioni vengono avviate utilizzandossm-usercreato dall'account AWS Systems Manager SSM Agent. La funzionalità Esegui come è supportata solo per la connessione con Linux ai nodi gestiti da macOS.Tipo: Booleano
Obbligatorio: sì
- runAsDefaultUser
-
Il nome dell'account utente per avviare le sessioni con i nodi gestiti da Linux e macOS, quando l'input
runAsEnabledè impostato sutrue. L'account utente specificato per questo input deve esistere nei nodi gestiti a cui ci si connetterà; in caso contrario, le sessioni non verranno avviate. Nel determinare l'account utente del sistema operativo da utilizzare, Session Manager verifica nel seguente ordine: ilSSMSessionRunAstag sui tag di sessione dell'utente IAM, quindi ilSSMSessionRunAstag sul ruolo IAM assunto e infine questorunAsDefaultUservalore delle preferenze di sessione. Per ulteriori informazioni, consulta Attiva Esegui come supporto per i nodi gestiti da Linux and macOS.▬Tipo: stringa
Obbligatorio: no
- idleSessionTimeout
-
La quantità di tempo di inattività che si desidera consentire prima del termine di una sessione. Questo input viene misurato in minuti.
Tipo: String
Valori validi: 1-60
Obbligatorio: no
- maxSessionDuration
-
La quantità di tempo che si desidera permettere prima del termine di una sessione. Questo input viene misurato in minuti.
Tipo: String
Valori validi: 1-1440
Obbligatorio: no
- shellProfile
-
Le preferenze specificate per il sistema operativo da applicare alle sessioni quali le preferenze della shell, le variabili di ambiente, le directory di lavoro e l'esecuzione di più comandi all'avvio di una sessione.
Tipo: StringMap
Obbligatorio: no
- windows
-
Le preferenze della shell, le variabili di ambiente, le directory di lavoro e i comandi specificati per le sessioni sui nodi gestiti Windows Server.
▬Tipo: stringa
Obbligatorio: no
- linux
-
Le preferenze della shell, le variabili di ambiente, le directory di esecuzione e i comandi specificati per le sessioni sui nodi gestiti da Linux e macOS.
Tipo: stringa
Obbligatorio: no
- parameters
-
Una struttura che definisce i parametri accettati dal documento. ì Per ulteriori informazioni su come specificare i parametri del documento, consulta Parametri di definizione del processo nella Elementi di dati di primo livello. Per i parametri a cui fai spesso riferimento, è consigliabile archiviare questi parametri in Systems Manager Parameter Store e farvi riferimento. Puoi fare riferimento ai parametri
String,StringListe Parameter Store in questa sezione di un documento. Puoi fare riferimento ai parametri Parameter StoreSecureStringin questa sezione di un documento. È possibile fare riferimento a un parametro Parameter Store utilizzando il seguente formato.{{ssm:parameter-name}}Per ulteriori informazioni su Parameter Store, consultare AWS Systems Manager Parameter Store.
Tipo: StringMap
Obbligatorio: no
- properties
-
Un oggetto i cui valori specificati vengono utilizzati nell' operazione API
StartSession.Per i documenti di sessione utilizzati per sessioni
InteractiveCommands, l'oggetto proprietà include i comandi da eseguire nei sistemi operativi specificati. Puoi inoltre determinare se i comandi vengono eseguiti comerootutilizzando la proprietà booleanarunAsElevated. Per ulteriori informazioni consulta Limitare l'accesso ai comandi in una sessione.Per i documenti di sessione utilizzati per sessioni
Port, l'oggetto proprietà contiene il numero di porta verso cui deve essere reindirizzato il traffico. Per un esempio, consulta il documento di Sessione tipoPortpiù avanti in questo argomento.Tipo: StringMap
Obbligatorio: no
Esempio di documento di sessione tipo Standard_Stream
Esempio di documento di sessione tipo InteractiveCommands
Esempio di documento di sessione tipo Port
Esempio di documento di sessione con caratteri speciali