Documentazione di riferimento del plugin per i documenti di comando - AWS Systems Manager
Input condivisiaws:applicationsaws:cloudWatchaws:configureDockeraws:configurePackageaws:domainJoinaws:downloadContentaws:psModuleaws:refreshAssociationaws:runDockerActionaws:runDocumentaws:runPowerShellScriptaws:runShellScriptaws:softwareInventoryaws:updateAgentaws:updateSsmAgent

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à.

Documentazione di riferimento del plugin per i documenti di comando

Questo riferimento descrive i plugin che è possibile specificare in un documento di tipo Command AWS Systems Manager (SSM). Questi plugin non possono essere utilizzati nei runbook di SSM automazione, che utilizzano azioni di automazione. Per informazioni sulle azioni di AWS Systems Manager automazione, consulta. Riferimento alle operazioni del servizio di automazione di Systems Manager

Systems Manager determina le azioni da eseguire su un'istanza gestita leggendo il contenuto di un SSM documento. Ogni documento include una sezione di esecuzione di codice. A seconda della versione dello schema del documento, questa sezione di esecuzione di codice può includere uno o più plugin o fasi. Ai fini di questo argomento della Guida, i plugin e le fasi sono chiamati plugin. Questa sezione include informazioni su ciascun plugin di Systems Manager. Per ulteriori informazioni sui documenti, incluse informazioni sulla creazione di documenti e sulle differenze tra le versioni dello schema, consulta Documenti di AWS Systems Manager.

Nota

Alcuni dei plugin illustrati in questa sezione possono essere eseguiti soltanto su istanze Windows Server o Linux. Sono riportate le dipendenze della piattaforma per ogni plugin.

I seguenti plug-in per documenti sono supportati sulle istanze Amazon Elastic Compute Cloud EC2 (Amazon) per: macOS

  • aws:refreshAssociation

  • aws:runShellScript

  • aws:runPowerShellScript

  • aws:softwareInventory

  • aws:updateSsmAgent

Input condivisi

Solo con la versione 3.0.502 e successive di SSM Agent tutti i plugin possono utilizzare i seguenti input:

finallyStep

L'ultimo passaggio è l'esecuzione del documento. Se questo input è definito per un passaggio, ha la precedenza su un valore exit specificato negli input onFailure o onSuccess. Affinché un passaggio con questo input sia eseguito come previsto, il passaggio deve essere l'ultimo definito nel mainSteps del documento.

Tipo: Booleano

Valori validi: true | false

Campo obbligatorio: no

onFailure

Se si specifica questo input per un plugin con il valore exit e il passaggio non riesce, lo stato del passaggio riflette l'errore e il documento non esegue i passaggi rimanenti a meno che non sia stato definito un finallyStep. Se si specifica questo input per un plugin con il valore successAndExit e il passaggio non riesce, lo stato del passaggio riflette l'errore e il documento non esegue i passaggi rimanenti a meno che non sia stato definito un finallyStep.

Tipo: stringa

Valori validi: exit | successAndExit

Campo obbligatorio: no

onSuccess

Se si specifica questo input per un plugin e il passaggio viene eseguito correttamente, il documento non esegue i passaggi rimanenti a meno che non sia stato definito un finallyStep.

Tipo: stringa

Valori validi: exit

Campo obbligatorio: no

YAML
---
schemaVersion: '2.2'
description: Shared inputs example
parameters:
  customDocumentParameter:
    type: String
    description: Example parameter for a custom Command-type document.
mainSteps:
- action: aws:runDocument
  name: runCustomConfiguration
  inputs:
    documentType: SSMDocument
    documentPath: "yourCustomDocument"
    documentParameters: '"documentParameter":{{customDocumentParameter}}'
    onSuccess: exit
- action: aws:runDocument
  name: ifConfigurationFailure
  inputs:
    documentType: SSMDocument
    documentPath: "yourCustomRepairDocument"
    onFailure: exit
- action: aws:runDocument
  name: finalConfiguration
  inputs:
    documentType: SSMDocument
    documentPath: "yourCustomFinalDocument"
    finallyStep: true
JSON
{
   "schemaVersion": "2.2",
   "description": "Shared inputs example",
   "parameters": {
      "customDocumentParameter": {
         "type": "String",
         "description": "Example parameter for a custom Command-type document."
      }
   },
   "mainSteps":[
      {
         "action": "aws:runDocument",
         "name": "runCustomConfiguration",
         "inputs": {
            "documentType": "SSMDocument",
            "documentPath": "yourCustomDocument",
            "documentParameters": "\"documentParameter\":{{customDocumentParameter}}",
            "onSuccess": "exit"
         }
      },
      {
         "action": "aws:runDocument",
         "name": "ifConfigurationFailure",
         "inputs": {
            "documentType": "SSMDocument",
            "documentPath": "yourCustomRepairDocument",
            "onFailure": "exit"
         }
      },
      {
         "action": "aws:runDocument",
         "name":"finalConfiguration",
         "inputs": {
            "documentType": "SSMDocument",
            "documentPath": "yourCustomFinalDocument",
            "finallyStep": true
         }
      }
   ]
}

aws:applications

Installa, ripara o disinstalla applicazioni su un'istanza. EC2 Questo plugin può essere eseguito solo su sistemi operativi Windows Server.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:applications plugin
parameters:
  source:
    description: "(Required) Source of msi."
    type: String
mainSteps:
- action: aws:applications
  name: example
  inputs:
    action: Install
    source: "{{ source }}"
JSON
{
  "schemaVersion":"2.2",
  "description":"aws:applications",
  "parameters":{
    "source":{
    "description":"(Required) Source of msi.",
    "type":"String"
    }
  },
  "mainSteps":[
    {
      "action":"aws:applications",
      "name":"example",
      "inputs":{
        "action":"Install",
        "source":"{{ source }}"
      }
    }
  ]
}

Schema 1.2

YAML
---
runtimeConfig:
  aws:applications:
    properties:
    - id: 0.aws:applications
      action: "{{ action }}"
      parameters: "{{ parameters }}"
      source: "{{ source }}"
      sourceHash: "{{ sourceHash }}"
JSON
{
   "runtimeConfig":{
      "aws:applications":{
         "properties":[
            {
               "id":"0.aws:applications",
               "action":"{{ action }}",
               "parameters":"{{ parameters }}",
               "source":"{{ source }}",
               "sourceHash":"{{ sourceHash }}"
            }
         ]
      }
   }
}

Proprietà

action

L'operazione da eseguire.

Tipo: Enum

Valori validi: Install | Repair | Uninstall

Campo obbligatorio: sì

parametri

I parametri per il programma di installazione.

Tipo: string

Campo obbligatorio: no

source

Il URL .msi file per l'applicazione.

Tipo: stringa

Campo obbligatorio: sì

sourceHash

L'SHA256hash del .msi file.

Tipo: string

Campo obbligatorio: no

aws:cloudWatch

Esporta i dati Windows Server da Amazon CloudWatch o Amazon CloudWatch Logs e monitora i dati utilizzando le CloudWatch metriche. Questo plugin può essere eseguito solo su sistemi operativi Windows Server. Per ulteriori informazioni sulla configurazione CloudWatch dell'integrazione con Amazon Elastic Compute Cloud EC2 (Amazon), consulta la sezione Raccolta di metriche, log e tracce con l'agente CloudWatch nella Amazon User Guide. CloudWatch

Importante

L' CloudWatch agente unificato è stato sostituito SSM Agent come strumento per l'invio dei dati di log ad Amazon CloudWatch Logs. Il cloudWatch plugin SSM Agent aws: non è supportato. Ti consigliamo di utilizzare solo l' CloudWatch agente unificato per i processi di raccolta dei log. Per ulteriori informazioni, consulta i seguenti argomenti:

Puoi esportare e monitorare i seguenti tipi di dati:

ApplicationEventLog

Invia i dati del registro degli eventi dell'applicazione a CloudWatch Logs.

CustomLogs

Invia qualsiasi file di registro basato su testo ad Amazon CloudWatch Logs. Il CloudWatch plug-in crea un'impronta digitale per i file di registro. Quindi, il sistema associa un offset dei dati con ciascun ID digitale. Il plugin carica i file quando sono presenti modifiche, registra l'offset e lo associa a un ID digitale. Questo metodo viene utilizzato per evitare una situazione in cui un utente attiva il plugin, associa il servizio a una directory che contiene un numero elevato di file e il sistema carica tutti i file.

avvertimento

Se l'applicazione tronca o tenta di eliminare i log durante il polling, qualsiasi log specificato per LogDirectoryPath può perdere voci. Se, ad esempio, desideri limitare le dimensioni del file di log, devi creare un nuovo file di log quando viene raggiunto il limite, quindi devi continuare a scrivere i dati sul nuovo file.

ETW

Invia i dati di Event Tracing for Windows (ETW) ai CloudWatch registri.

IIS

Invia i dati di IIS registro a CloudWatch Logs.

PerformanceCounter

Invia i contatori delle prestazioni di Windows a. CloudWatch Puoi selezionare diverse categorie in cui caricare i dati CloudWatch come metriche. Per ogni contatore delle prestazioni che desideri caricare, crea una PerformanceCountersezione con un ID univoco (ad esempio, "PerformanceCounter2"," PerformanceCounter 3" e così via) e configurane le proprietà.

Nota

Se il plug-in AWS Systems Manager SSM Agent o il CloudWatch plug-in sono interrotti, i dati del contatore delle prestazioni non vengono registrati. CloudWatch Questo comportamento è diverso rispetto ai log personalizzati o ai log di eventi di Windows. I registri personalizzati e i registri degli eventi di Windows conservano i dati del contatore delle prestazioni e li caricano su after, CloudWatch SSM Agent altrimenti il CloudWatch plug-in sarà disponibile.

SecurityEventLog

Invia i dati del registro degli eventi di sicurezza ai CloudWatch registri.

SystemEventLog

Invia i dati del registro degli eventi di sistema ai CloudWatch registri.

Puoi definire le seguenti destinazioni per i dati:

CloudWatch

La destinazione in cui vengono inviati i dati dei parametri del contatore delle prestazioni. È possibile aggiungere altre sezioni con caratteri univoci IDs (ad esempio, "CloudWatch2", CloudWatch 3" e così via) e specificare una regione diversa per ogni nuovo ID per inviare gli stessi dati a posizioni diverse.

CloudWatchLogs

La destinazione in cui vengono inviati i dati di log. Puoi aggiungere altre sezioni con un valore univoco IDs (ad esempio, "CloudWatchLogs2", CloudWatchLogs 3" e così via) e specificare una regione diversa per ogni nuovo ID per inviare gli stessi dati a posizioni diverse.

Sintassi

"runtimeConfig":{
        "aws:cloudWatch":{
            "settings":{
                "startType":"{{ status }}"
            },
            "properties":"{{ properties }}"
        }
    }

Impostazioni e proprietà

AccessKey

L'ID chiave di accesso . Questa proprietà è obbligatoria a meno che l'istanza non sia stata avviata utilizzando un IAM ruolo. Questa proprietà non può essere utilizzata conSSM.

Tipo: string

Campo obbligatorio: no

CategoryName

La categoria del contatore delle prestazioni da Performance Monitor.

Tipo: stringa

Campo obbligatorio: sì

CounterName

Il nome del contatore delle prestazioni da Performance Monitor.

Tipo: stringa

Campo obbligatorio: sì

CultureName

L'impostazione locale in cui viene registrato il timestamp. Se CultureNameè vuota, il valore predefinito è lo stesso locale usato dall'istanza. Windows Server

Tipo: stringa

Valori validi: per un elenco dei valori supportati, vedere National Language Support (NLS) sul sito Web di Microsoft. I valori div, div-MV, hu e hu-HU non sono supportati.

Campo obbligatorio: no

DimensionName

Una dimensione per la tua CloudWatch metrica Amazon. Se specifichi DimensionName, devi specificare DimensionValue. Questi parametri forniscono un'altra vista al momento della creazione di elenchi di parametri. Puoi utilizzare la stessa dimensione per più parametri per poter visualizzare tutti i parametri appartenenti a una dimensione specifica.

Tipo: string

Campo obbligatorio: no

DimensionValue

Un valore dimensionale per la tua CloudWatch metrica Amazon.

Tipo: string

Campo obbligatorio: no

Encoding

La codifica del file da utilizzare (ad esempio, UTF -8). Utilizza il nome di codifica, non il nome di visualizzazione.

Tipo: stringa

Valori validi: per un elenco dei valori supportati, consulta l'argomento relativo alla classe di codifica nella libreria di Microsoft Learn.

Campo obbligatorio: sì

Filtro

Il prefisso dei nomi di log. Lascia questo parametro bianco per monitorare tutti i file.

Tipo: stringa

Valori validi: per un elenco dei valori supportati, consultate la FileSystemWatcherFilter proprietà nella MSDN libreria.

Campo obbligatorio: no

Flows

Ogni tipo di dati da caricare, insieme alla destinazione dei dati (CloudWatch o dei CloudWatch registri). Ad esempio, per inviare un contatore delle prestazioni definito in "Id": "PerformanceCounter" alla CloudWatch destinazione definita in"Id": "CloudWatch", inserisci CloudWatch"PerformanceCounter,». Analogamente, per inviare il registro personalizzato, il ETW registro e il registro di sistema alla destinazione dei CloudWatch registri definita in"Id": "ETW", immettete «(ETW),CloudWatchLogs". Inoltre, puoi inviare lo stesso contatore delle prestazioni o file di log a più destinazioni. Ad esempio, per inviare il registro dell'applicazione a due diverse destinazioni definite in "Id": "CloudWatchLogs" E"Id": "CloudWatchLogs2", immettete "ApplicationEventLog, (CloudWatchLogs, CloudWatchLogs 2)».

Tipo: stringa

Valori validi (origine): ApplicationEventLog | CustomLogs | ETW | PerformanceCounter | SystemEventLog | SecurityEventLog

Valori validi (destinazione): CloudWatch | CloudWatchLogs | CloudWatchn | CloudWatchLogsn

Campo obbligatorio: sì

FullName

Il nome completo del componente.

Tipo: stringa

Campo obbligatorio: sì

Id

Identifica l'origine o la destinazione dei dati. Questo identificatore deve essere univoco all'interno del file di configurazione.

Tipo: stringa

Campo obbligatorio: sì

InstanceName

Il nome dell'istanza del contatore delle prestazioni. Non utilizzare un asterisco (*) per indicare tutte le istanze perché ciascun componente del contatore delle prestazioni supporta solo un parametro. Tuttavia, puoi utilizzare _Total.

Tipo: stringa

Campo obbligatorio: sì

Levels

I tipi di messaggi da inviare ad Amazon CloudWatch.

Tipo: stringa

Valori validi:

  • 1 - Solo i messaggi di errore caricati.

  • 2 - Solo i messaggi di avviso caricati.

  • 4 - Solo i messaggi informativi caricati.

È possibile aggiungere valori per includere più di un tipo di messaggio. Ad esempio, 3 indica che i messaggi di errore (1) e i messaggi di avviso (2) sono inclusi. Un valore pari a 7 indica che i messaggi di errore (1), i messaggi di avviso (2) e i messaggi informativi (4) sono inclusi.

Campo obbligatorio: sì

Nota

I log di sicurezza di Windows dovrebbero impostare livelli fino a 7.

LineCount

Il numero di righe dell'intestazione per identificare il file di log. Ad esempio, i file di IIS registro hanno intestazioni praticamente identiche. Puoi inserire 3, che può leggere le prime tre righe dell'intestazione del file di log per identificarlo. Nei file di IIS registro, la terza riga è l'indicatore di data e ora, che è diverso da un file di registro all'altro.

Tipo: integer

Campo obbligatorio: no

LogDirectoryPath

Ad esempio CustomLogs, il percorso in cui vengono archiviati i log sull'istanza. EC2 Per IIS i log, la cartella in cui sono archiviati IIS i log di un singolo sito (ad esempio, C:\\ inetpub\\ logs\\\\ W3 LogFiles SVCn). Per IIS i log, è supportato solo il formato di registro W3C. IISNCSA, e i formati personalizzati non sono supportati.

Tipo: stringa

Campo obbligatorio: sì

LogGroup

Nome del gruppo di log. Questo nome viene visualizzato nella schermata Log Groups della CloudWatch console.

Tipo: stringa

Campo obbligatorio: sì

LogName

Nome del file di log.

  1. Per individuare il nome del log , in Event Viewer (Visualizzatore eventi), nel riquadro di navigazione, scegli Applications and Services Logs (Log di applicazioni e servizi).

  2. Nell'elenco dei registri, fai clic con il pulsante destro del mouse sul log che desideri caricare (ad esempio, Microsoft>Windows>Backup>Operativo), quindi seleziona Create Custom View (Crea visualizzazione personalizzata).

  3. Nella finestra di dialogo Crea visualizzazione personalizzata, seleziona la XMLscheda. LogNameSi trova nel tag <Select Path=> (ad esempio,). Microsoft-Windows-Backup Copia questo testo nel parametro. LogName

Tipo: stringa

Valori validi: Application| Security| System| Microsoft-Windows-WinINet/Analytic

Campo obbligatorio: sì

LogStream

Il flusso di log di destinazione. Se utilizzi {instance_id}, il valore predefinito, l'ID di questa istanza viene utilizzato come nome del flusso di log.

Tipo: stringa

Valori validi: {instance_id} | {hostname} | {ip_address} <log_stream_name>

Se inserisci un nome di log stream che non esiste già, CloudWatch Logs lo crea automaticamente per te. Puoi utilizzare una stringa letterale o variabili predefinite ({instance_id}, {hostname}, {ip_address}) o una combinazione di tutte e tre per definire un nome di flusso di log.

Il nome del flusso di log specificato in questo parametro viene visualizzato in Log Groups > Streams per <YourLogStream>schermata nella CloudWatch console.

Campo obbligatorio: sì

MetricName

La CloudWatch metrica in cui desideri includere i dati sulle prestazioni.

Nota

Non utilizzare caratteri speciali nel nome. In caso contrario, il parametro e gli allarmi associati potrebbero non funzionare.

Tipo: stringa

Campo obbligatorio: sì

NameSpace

Il namespace parametro in cui desideri che vengano scritti i dati dei contatori delle prestazioni.

Tipo: stringa

Campo obbligatorio: sì

PollInterval

Il numero di secondi che devono trascorrere prima che un nuovo contatore delle prestazioni e i dati di log vengano caricati.

Tipo: integer

Valori validi: imposta questo valore su 5 o più secondi. Quindici secondi (00:00:15) è il valore consigliato.

Campo obbligatorio: sì

Regione

La destinazione Regione AWS in cui desideri inviare i dati di registro. Sebbene possa inviare contatori delle prestazioni a una regione diversa rispetto a quella a cui invii i dati di log, è consigliabile impostare questo parametro sulla stessa regione in cui l'istanza è in esecuzione.

Tipo: stringa

Valori validi: aree IDs Regioni AWS supportate sia da Systems Manager che da CloudWatch Logs, ad esempio us-east-2eu-west-1, eap-southeast-1. Per gli elenchi degli endpoint del servizio Regioni AWS supportati da ciascun servizio, consulta Amazon CloudWatch Logs Service Endpoints and Systems Manager nel. Riferimenti generali di Amazon Web Services

Campo obbligatorio: sì

SecretKey

La chiave di accesso segreta . Questa proprietà è obbligatoria a meno che tu non abbia avviato l'istanza utilizzando un ruolo. IAM

Tipo: string

Campo obbligatorio: no

startType

Attiva o disattiva CloudWatch l'istanza.

Tipo: stringa

Valori validi: Enabled | Disabled

Campo obbligatorio: sì

TimestampFormat

Il formato del timestamp che desideri utilizzare. Per un elenco dei valori supportati, consulta Stringhe di formato di data e ora personalizzate nella MSDN libreria.

Tipo: stringa

Campo obbligatorio: sì

TimeZoneKind

Fornisce le informazioni sul fuso orario se non sono incluse nel timestamp del log. Se questo parametro viene lasciato vuoto e se il timestamp non include informazioni sul fuso orario, per impostazione predefinita CloudWatch Logs utilizza il fuso orario locale. Questo parametro viene ignorato se il timestamp contiene già informazioni sul fuso orario.

Tipo: stringa

Valori validi: Local | UTC

Campo obbligatorio: no

Unità

L'unità di misura appropriata per il parametro.

Tipo: stringa

Valori validi: Secondi | Microsecondi | Millisecondi | Byte | Kilobyte | Megabyte | Gigabyte | Terabyte | Bit | Kilobit | Megabit | Gigabit | Terabit | Percentuale | Conteggio | Byte/secondo | Kilobyte/secondo | Megabyte/secondo | Gigabyte/secondo | Terabyte/secondo | Bit/secondo | Kilobit/secondo | Megabit/secondo | Gigabit/secondo | Terabit/secondo | Conteggio/secondo | Nessuno.

Campo obbligatorio: sì

aws:configureDocker

(Versione dello schema 2.0 o successiva) Configura un'istanza da utilizzare con contenitori e Docker. Questo plugin è supportato su Linux e dai sistemi operativi Windows Server.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:configureDocker
parameters:
  action:
    description: "(Required) The type of action to perform."
    type: String
    default: Install
    allowedValues:
    - Install
    - Uninstall
mainSteps:
- action: aws:configureDocker
  name: configureDocker
  inputs:
    action: "{{ action }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:configureDocker plugin",
  "parameters": {
    "action": {
      "description": "(Required) The type of action to perform.",
      "type": "String",
      "default": "Install",
      "allowedValues": [
        "Install",
        "Uninstall"
      ]
    }
  },
  "mainSteps": [
    {
      "action": "aws:configureDocker",
      "name": "configureDocker",
      "inputs": {
        "action": "{{ action }}"
      }
    }
  ]
}

Input

action

Il tipo di operazione da eseguire.

Tipo: Enum

Valori validi: Install | Uninstall

Campo obbligatorio: sì

aws:configurePackage

(Schema versione 2.0 o successiva) Installa o disinstalla un pacchetto. AWS Systems Manager Distributor Puoi installare la versione più recente, la versione predefinita o una versione del pacchetto specificata. Sono supportati anche AWS i pacchetti forniti da. Questo plugin viene eseguito sui sistemi operativi Windows Server e Linux, ma non tutti i pacchetti disponibili sono supportati sui sistemi operativi Linux.

AWS I pacchetti disponibili Windows Server includono quanto segue: AWSPVDriverAWSNVMe,AwsEnaNetworkDriver,AwsVssComponents,AmazonCloudWatchAgent,CodeDeployAgent, e AWSSupport-EC2Rescue.

AWS I pacchetti disponibili per i sistemi operativi Linux includono quanto segue:AmazonCloudWatchAgent,CodeDeployAgent, eAWSSupport-EC2Rescue.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:configurePackage
parameters:
  name:
    description: "(Required) The name of the AWS package to install or uninstall."
    type: String
  action:
    description: "(Required) The type of action to perform."
    type: String
    default: Install
    allowedValues:
    - Install
    - Uninstall
  ssmParameter:
    description: "(Required) Argument stored in Parameter Store."
    type: String
    default: "{{ ssm:parameter_store_arg }}"
mainSteps:
- action: aws:configurePackage
  name: configurePackage
  inputs:
    name: "{{ name }}"
    action: "{{ action }}"
    additionalArguments: 
      "{\"SSM_parameter_store_arg\": \"{{ ssmParameter }}\", \"SSM_custom_arg\": \"myValue\"}"
JSON
{
   "schemaVersion": "2.2",
   "description": "aws:configurePackage",
   "parameters": {
      "name": {
         "description": "(Required) The name of the AWS package to install or uninstall.",
         "type": "String"
      },
      "action": {
         "description": "(Required) The type of action to perform.",
         "type": "String",
         "default": "Install",
         "allowedValues": [
            "Install",
            "Uninstall"
         ]
      },
      "ssmParameter": {
         "description": "(Required) Argument stored in Parameter Store.",
         "type": "String",
         "default": "{{ ssm:parameter_store_arg }}"
      }
   },
   "mainSteps": [
      {
         "action": "aws:configurePackage",
         "name": "configurePackage",
         "inputs": {
            "name": "{{ name }}",
            "action": "{{ action }}",
            "additionalArguments": "{\"SSM_parameter_store_arg\": \"{{ ssmParameter }}\", \"SSM_custom_arg\": \"myValue\"}"
         }
      }
   ]
}

Input

nome

Il nome del AWS pacchetto da installare o disinstallare. I pacchetti disponibili includono: AWSPVDriver, AwsEnaNetworkDriver, AwsVssComponents e AmazonCloudWatchAgent.

Tipo: stringa

Campo obbligatorio: sì

action

Installa o disinstalla un pacchetto.

Tipo: Enum

Valori validi: Install | Uninstall

Campo obbligatorio: sì

installationType

Il tipo di installazione da eseguire. Se si specifica Uninstall and reinstall, il pacchetto viene completamente disinstallato e quindi reinstallato. L'applicazione non è disponibile fino al completamento della reinstallazione. Se si specifica In-place update, solo i file nuovi o modificati vengono aggiunti all'installazione esistente in base alle istruzioni fornite in uno script di aggiornamento. L'applicazione rimane disponibile durante tutto il processo di aggiornamento. L'In-place updateopzione non è supportata per i pacchetti AWS-published. Uninstall and reinstallè il valore predefinito.

Tipo: Enum

Valori validi: Uninstall and reinstall | In-place update

Campo obbligatorio: no

additionalArguments

Una JSON stringa di parametri aggiuntivi da fornire agli script di installazione, disinstallazione o aggiornamento. Ogni parametro deve essere preceduto da SSM_. È possibile fare riferimento a un parametro Parameter Store negli argomenti aggiuntivi utilizzando la convenzione {{ssm:parameter-name}}. Per utilizzare il parametro aggiuntivo nello script di installazione, disinstallazione o aggiornamento, è necessario fare riferimento al parametro come variabile di ambiente utilizzando la sintassi appropriata per il sistema operativo. Ad esempio, in PowerShell, si fa riferimento all'SSM_argargomento come$Env:SSM_arg. Non vi è alcun limite al numero di argomenti definiti, ma l'input dell'argomento aggiuntivo ha un limite di 4096 caratteri. Questo limite include tutte le chiavi e i valori definiti.

Tipo: StringMap

Campo obbligatorio: no

version

Una versione specifica del pacchetto da installare o disinstallare. In caso di installazione, il sistema installa per impostazione predefinita l'ultima versione pubblicata. In caso di disinstallazione, il sistema disinstalla per impostazione predefinita la versione attualmente installata. Se non viene trovata nessuna versione installata, viene scaricata l'ultima versione pubblicata e viene eseguita l'operazione di disinstallazione.

Tipo: string

Campo obbligatorio: no

aws:domainJoin

Unisci un'EC2istanza a un dominio. Questo plugin funziona su Linux e sistemi operativi Windows Server. Questo plugin cambia il nome host per le istanze Linux nel formato - EC2AMAZXXXXXXX. Per ulteriori informazioni sull'aggiunta di EC2 istanze, consulta Aggiungere un'EC2istanza alla directory AWS gestita di Microsoft AD nella Guida all'AWS Directory Service amministrazione.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:domainJoin
parameters:
  directoryId:
    description: "(Required) The ID of the directory."
    type: String
  directoryName:
    description: "(Required) The name of the domain."
    type: String
  directoryOU:
    description: "(Optional) The organizational unit to assign the computer object to."
    type: String
  dnsIpAddresses:
    description: "(Required) The IP addresses of the DNS servers for your directory."
    type: StringList
mainSteps:
- action: aws:domainJoin
  name: domainJoin
  inputs:
    directoryId: "{{ directoryId }}"
    directoryName: "{{ directoryName }}"
    directoryOU: "{{ directoryOU }}"
    dnsIpAddresses: "{{ dnsIpAddresses }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:domainJoin",
  "parameters": {
    "directoryId": {
      "description": "(Required) The ID of the directory.",
      "type": "String"
    },
    "directoryName": {
      "description": "(Required) The name of the domain.",
      "type": "String"
    },
    "directoryOU": {
        "description": "(Optional) The organizational unit to assign the computer object to.",
        "type": "String"
      },
    "dnsIpAddresses": {
      "description": "(Required) The IP addresses of the DNS servers for your directory.",
      "type": "StringList"
    },
  },
  "mainSteps": [
    {
      "action": "aws:domainJoin",
      "name": "domainJoin",
      "inputs": {
        "directoryId": "{{ directoryId }}",
        "directoryName": "{{ directoryName }}",
        "directoryOU":"{{ directoryOU }}",
        "dnsIpAddresses":"{{ dnsIpAddresses }}"
      }
    }
  ]
}

Schema 1.2

YAML
---
runtimeConfig:
  aws:domainJoin:
    properties:
      directoryId: "{{ directoryId }}"
      directoryName: "{{ directoryName }}"
      directoryOU: "{{ directoryOU }}"
      dnsIpAddresses: "{{ dnsIpAddresses }}"
JSON
{
   "runtimeConfig":{
      "aws:domainJoin":{
         "properties":{
            "directoryId":"{{ directoryId }}",
            "directoryName":"{{ directoryName }}",
            "directoryOU":"{{ directoryOU }}",
            "dnsIpAddresses":"{{ dnsIpAddresses }}"
         }
      }
   }
}

Proprietà

directoryId

L'ID della directory.

Tipo: stringa

Campo obbligatorio: sì

Esempio: "directoryId«: «d-1234567890"

directoryName

Il nome del dominio.

Tipo: stringa

Campo obbligatorio: sì

Esempio: "«: «example.com» directoryName

directoryOU

L'unità organizzativa (OU).

Tipo: string

Campo obbligatorio: no

Esempio: "directoryOU": "OU=test,DC=example,DC=com"

dnsIpAddresses

Gli indirizzi IP dei server. DNS

Tipo: StringList

Campo obbligatorio: sì

Esempio: "dnsIpAddresses«: [" 198.51.100.1", "198.51.100.2"]

keepHostName

Determina se il nome host viene modificato per le istanze Linux quando vengono aggiunte al dominio.

Tipo: Booleano

Campo obbligatorio: no

Esempi

Ad esempio, consulta Aggiungere un'EC2istanza Amazon alla tua AWS Managed Microsoft AD nella Guida all'AWS Directory Service amministrazione.

aws:downloadContent

(Schema versione 2.0 o successiva) Scarica SSM documenti e script da postazioni remote. GitHub Enterprisei repository non sono supportati. Questo plugin è supportato su Linux e dai sistemi operativi Windows Server.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:downloadContent
parameters:
  sourceType:
    description: "(Required) The download source."
    type: String
  sourceInfo:
    description: "(Required) The information required to retrieve the content from
      the required source."
    type: StringMap
mainSteps:
- action: aws:downloadContent
  name: downloadContent
  inputs:
    sourceType: "{{ sourceType }}"
    sourceInfo: "{{ sourceInfo }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:downloadContent",
  "parameters": {
    "sourceType": {
    "description": "(Required) The download source.",
    "type": "String"
  },
  "sourceInfo": {
    "description": "(Required) The information required to retrieve the content from the required source.",
    "type": "StringMap"
    }
  },
  "mainSteps": [
    {
      "action": "aws:downloadContent",
      "name": "downloadContent",
      "inputs": {
        "sourceType":"{{ sourceType }}",
        "sourceInfo":"{{ sourceInfo }}"
      }
    }
  ]
}

Input

sourceType

Origine del download Systems Manager supporta i seguenti tipi di sorgenti per il download di script e SSM documenti: GitHubGit,HTTP,S3, eSSMDocument.

Tipo: stringa

Campo obbligatorio: sì

sourceInfo

Le informazioni necessarie per recuperare il contenuto dall'origine richiesta.

Tipo: StringMap

Campo obbligatorio: sì

Per sourceType GitHub, specificare quanto segue:

  • owner: il proprietario del repository.

  • repository: il nome del repository.

  • path: il percorso del file o della directory che desideri scaricare.

  • getOptions: opzioni aggiuntive per recuperare il contenuto da un ramo diverso dal master o da un commit specifico nel repository. getOptions può essere omesso se si utilizza l'ultimo commit nel ramo principale. Se il repository è stato creato dopo il 1° ottobre 2020, il ramo predefinito potrebbe essere denominato main anziché master. In questo caso, dovrai specificare i valori per il getOptions parametro.

    Questo parametro utilizza il seguente formato:

    • ramo: refs/heads/branch_name

      Il valore predefinito è master.

      Per specificare un ramo non predefinito, utilizza il formato seguente:

      ramo:refs/heads/branch_name

    • CommitID:commitID

      Il valore predefinito è head.

      Per utilizzare la versione del SSM documento in un commit diverso dalla più recente, specifica l'ID di commit completo. Per esempio:

      "getOptions": "commitID:bbc1ddb94...b76d3bEXAMPLE",

  • tokenInfo: Il parametro Systems Manager (un SecureString parametro) in cui vengono memorizzate le informazioni sul token di GitHub accesso, nel formato{{ssm-secure:secure-string-token-name}}.

    Nota

    Questo tokenInfo campo è l'unico campo SSM del plug-in del documento che supporta un SecureString parametro. SecureString i parametri non sono supportati per nessun altro campo, né per nessun altro plugin di SSM documento.

{
    "owner":"TestUser",
    "repository":"GitHubTest",
    "path":"scripts/python/test-script",
    "getOptions":"branch:master",
    "tokenInfo":"{{ssm-secure:secure-string-token}}"
}

Perché sourceType Git, è necessario specificare quanto segue:

  • repository

    L'archivio URL Git nel file o nella directory che desideri scaricare.

    Tipo: stringa

Inoltre, è possibile specificare i seguenti parametri facoltativi:

  • getOptions

    Opzioni aggiuntive per recuperare il contenuto da un ramo diverso dal master o da un commit specifico nel repository. getOptions può essere omesso se si utilizza l'ultimo commit nel ramo principale.

    Tipo: stringa

    Questo parametro utilizza il seguente formato:

    • ramo: refs/heads/branch_name

      Il valore predefinito è master.

      "branch"è obbligatorio solo se il SSM documento è archiviato in una filiale diversa da. master Per esempio:

      "getOptions": "branch:refs/head/main"

    • CommitID:commitID

      Il valore predefinito è head.

      Per utilizzare la versione del SSM documento in un commit diverso dalla più recente, specifica l'ID di commit completo. Per esempio:

      "getOptions": "commitID:bbc1ddb94...b76d3bEXAMPLE",

  • privateSSHKey

    La SSH chiave da usare quando ci si repository connette al file specificato. È possibile utilizzare il seguente formato per fare riferimento a un SecureString parametro per il valore della SSH chiave:{{ssm-secure:your-secure-string-parameter}}.

    Tipo: stringa

  • skipHostKeyControllo

    Determina il valore dell' StrictHostKeyCheckingopzione quando ci si repository connette all'indirizzo specificato. Il valore predefinito è false.

    Tipo: Booleano

  • username

    Il nome utente da utilizzare quando ci si repository connette al file specificato utilizzandoHTTP. È possibile utilizzare il formato seguente per riferirsi a un parametro SecureString per il valore del nome utente: {{ssm-secure:your-secure-string-parameter}}.

    Tipo: stringa

  • password

    La password da utilizzare quando ci si repository connette al dispositivo specificato utilizzandoHTTP. È possibile utilizzare il formato seguente per riferirsi a un parametro SecureString per il valore della password: {{ssm-secure:your-secure-string-parameter}}.

    Tipo: stringa

Per sourceType HTTP, è necessario specificare quanto segue:

  • url

    Vai URL al file o alla directory che desideri scaricare.

    Tipo: stringa

Inoltre, è possibile specificare i seguenti parametri facoltativi:

  • allowInsecureDownload

    Determina se un download può essere eseguito su una connessione non crittografata con Secure Socket Layer (SSL) o Transport Layer Security (TLS). Il valore predefinito è false. Si sconsiglia l'esecuzione di download senza crittografia. Se si sceglie di farlo, si assumono tutti i relativi rischi. La sicurezza è una responsabilità condivisa tra te AWS e te. Questo è descritto come il modello di responsabilità condivisa. Per ulteriori informazioni, consultare il modello di responsabilità condivisa.

    Tipo: Booleano

  • authMethod

    Determina se un nome utente e una password vengono utilizzati per l'autenticazione durante la connessione all'url specificato. Se si specifica Basic o Digest, è necessario fornire valori per i parametri username e password. Per utilizzare il metodo Digest, deve essere installata nell'istanza la versione di SSM Agent 3.0.1181.0 o successiva. Il Digest metodo supporta MD5 la SHA256 crittografia.

    Tipo: stringa

    Valori validi: None | Basic | Digest

  • username

    Il nome utente da usare durante la connessione all'url specificato utilizzando l'autenticazione Basic. È possibile utilizzare il formato seguente per riferirsi a un parametro SecureString per il valore del nome utente: {{ssm-secure:your-secure-string-parameter}}.

    Tipo: stringa

  • password

    La password da usare durante la connessione all'url specificato utilizzando l'autenticazione Basic. È possibile utilizzare il formato seguente per riferirsi a un parametro SecureString per il valore della password: {{ssm-secure:your-secure-string-parameter}}.

    Tipo: stringa

Per sourceType S3, specificare quanto segue:

  • percorso: Il URL verso il file o la directory che desideri scaricare da Amazon S3.

{
    "path": "https://s3.amazonaws.com/amzn-s3-demo-bucket/powershell/helloPowershell.ps1" 
}

Per sourceType SSMDocument, specifica una delle seguenti opzioni:

  • name: il nome e la versione del documento nel formato seguente: name:version. La versione è facoltativa. 

    {
    "name": "Example-RunPowerShellScript:3" 
}

  • nome: Il ARN per il documento nel seguente formato: arn:aws:ssm:region:account_id:document/document_name

    {
   "name":"arn:aws:ssm:us-east-2:3344556677:document/MySharedDoc"
}
destinationPath

Un percorso locale facoltativo nell'istanza in cui desideri scaricare il file. Se non specifichi un percorso, i contenuti vengono scaricati in un percorso relativo al tuo ID comando.

Tipo: string

Campo obbligatorio: no

aws:psModule

Installa PowerShell i moduli su un'EC2istanza Amazon. Questo plugin può essere eseguito solo su sistemi operativi Windows Server.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:psModule
parameters:
  source:
    description: "(Required) The URL or local path on the instance to the application
      .zip file."
    type: String
mainSteps:
- action: aws:psModule
  name: psModule
  inputs:
    source: "{{ source }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:psModule",
  "parameters": {
    "source": {
      "description": "(Required) The URL or local path on the instance to the application .zip file.",
      "type": "String"
    }
  },
  "mainSteps": [
    {
      "action": "aws:psModule",
      "name": "psModule",
      "inputs": {
        "source": "{{ source }}"
      }
    }
  ]
}

Schema 1.2

YAML
---
runtimeConfig:
  aws:psModule:
    properties:
    - runCommand: "{{ commands }}"
      source: "{{ source }}"
      sourceHash: "{{ sourceHash }}"
      workingDirectory: "{{ workingDirectory }}"
      timeoutSeconds: "{{ executionTimeout }}"
JSON
{
   "runtimeConfig":{
      "aws:psModule":{
         "properties":[
            {
               "runCommand":"{{ commands }}",
               "source":"{{ source }}",
               "sourceHash":"{{ sourceHash }}",
               "workingDirectory":"{{ workingDirectory }}",
               "timeoutSeconds":"{{ executionTimeout }}"
            }
         ]
      }
   }
}

Proprietà

runCommand

Il PowerShell comando da eseguire dopo l'installazione del modulo.

Tipo: StringList

Campo obbligatorio: no

source

Il percorso URL o il percorso locale dell'istanza verso il .zip file dell'applicazione.

Tipo: stringa

Campo obbligatorio: sì

sourceHash

L'SHA256hash del .zip file.

Tipo: string

Campo obbligatorio: no

timeoutSeconds

Il tempo in secondi entro cui un comando deve essere portato a termine prima di essere considerato non riuscito.

Tipo: string

Campo obbligatorio: no

workingDirectory

Il percorso alla directory di lavoro nell'istanza.

Tipo: string

Campo obbligatorio: no

aws:refreshAssociation

(Versione dello schema 2.0 o successiva) Aggiorna (applicazione di forza) un'associazione on demand. Questa operazione modificherà lo stato del sistema in base a quanto definito nell'associazione selezionata o in tutte le associazioni dei target. Questo plugin funziona su sistemi operativi Linux e Microsoft Windows Server.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:refreshAssociation
parameters:
  associationIds:
    description: "(Optional) List of association IDs. If empty, all associations bound
      to the specified target are applied."
    type: StringList
mainSteps:
- action: aws:refreshAssociation
  name: refreshAssociation
  inputs:
    associationIds:
    - "{{ associationIds }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:refreshAssociation",
  "parameters": {
    "associationIds": {
      "description": "(Optional) List of association IDs. If empty, all associations bound to the specified target are applied.",
      "type": "StringList"
    }
  },
  "mainSteps": [
    {
      "action": "aws:refreshAssociation",
      "name": "refreshAssociation",
      "inputs": {
        "associationIds": [
          "{{ associationIds }}"
        ]
      }
    }
  ]
}

Input

associationIds

Elenco delle associazioniIDs. Se vuoto, vengono applicate tutte le associazioni ai target specificati.

Tipo: StringList

Campo obbligatorio: no

aws:runDockerAction

(Versione dello schema 2.0 o successiva) Esegui operazioni Docker sui contenitori. Questo plugin funziona su sistemi operativi Linux e Microsoft Windows Server.

Sintassi

Schema 2.2

YAML
---
mainSteps:
- action: aws:runDockerAction
  name: RunDockerAction
  inputs:
    action: "{{ action }}"
    container: "{{ container }}"
    image: "{{ image }}"
    memory: "{{ memory }}"
    cpuShares: "{{ cpuShares }}"
    volume: "{{ volume }}"
    cmd: "{{ cmd }}"
    env: "{{ env }}"
    user: "{{ user }}"
    publish: "{{ publish }}"
JSON
{
   "mainSteps":[
      {
         "action":"aws:runDockerAction",
         "name":"RunDockerAction",
         "inputs":{
            "action":"{{ action }}",
            "container":"{{ container }}",
            "image":"{{ image }}",
            "memory":"{{ memory }}",
            "cpuShares":"{{ cpuShares }}",
            "volume":"{{ volume }}",
            "cmd":"{{ cmd }}",
            "env":"{{ env }}",
            "user":"{{ user }}",
            "publish":"{{ publish }}"
         }
      }
   ]
}

Input

action

Il tipo di operazione da eseguire.

Tipo: stringa

Campo obbligatorio: sì

container

L'ID del container Docker.

Tipo: string

Campo obbligatorio: no

image

Il nome dell'immagine Docker.

Tipo: string

Campo obbligatorio: no

cmd

Il comando del container.

Tipo: string

Campo obbligatorio: no

memory

Il limite di memoria del container.

Tipo: string

Campo obbligatorio: no

cpuShares

Le CPU quote del contenitore (peso relativo).

Tipo: string

Campo obbligatorio: no

volume

I montaggi dei volumi del container.

Tipo: StringList

Campo obbligatorio: no

env

Le variabili di ambiente del container.

Tipo: string

Campo obbligatorio: no

Utente

Il nome dell'utente del container.

Tipo: string

Campo obbligatorio: no

pubblicazione

Le porte pubblicate del container.

Tipo: string

Campo obbligatorio: no

aws:runDocument

(Schema versione 2.0 o successiva) Esegue SSM documenti archiviati in Systems Manager o in una condivisione locale. È possibile utilizzare questo plug-in con il aws:downloadContent plug-in per scaricare un SSM documento da una postazione remota a una condivisione locale e quindi eseguirlo. Questo plugin è supportato su Linux e dai sistemi operativi Windows Server. Questo plug-in non supporta l'esecuzione del documento AWS-UpdateSSMAgent o qualsiasi documento che utilizza il plugin aws:updateSsmAgent.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:runDocument
parameters:
  documentType:
    description: "(Required) The document type to run."
    type: String
    allowedValues:
    - LocalPath
    - SSMDocument
mainSteps:
- action: aws:runDocument
  name: runDocument
  inputs:
    documentType: "{{ documentType }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:runDocument",
  "parameters": {
    "documentType": {
      "description": "(Required) The document type to run.",
      "type": "String",
      "allowedValues": [
        "LocalPath",
        "SSMDocument"
      ]
    }
  },
  "mainSteps": [
    {
      "action": "aws:runDocument",
      "name": "runDocument",
      "inputs": {
        "documentType": "{{ documentType }}"
      }
    }
  ]
}

Input

documentType

Il tipo di documento da eseguire. È possibile eseguire documenti locali (LocalPath) o documenti archiviati in Systems Manager (SSMDocument).

Tipo: stringa

Campo obbligatorio: sì

documentPath

Il percorso del documento. Se documentType è LocalPath, specifica il percorso al documento nella condivisione locale. Se documentType è SSMDocument, specifica il nome del documento.

Tipo: string

Campo obbligatorio: no

documentParameters

I parametri per il documento.

Tipo: StringMap

Campo obbligatorio: no

aws:runPowerShellScript

Esegui PowerShell gli script o specifica il percorso di uno script da eseguire. Questo plugin può essere eseguito su sistemi operativi Microsoft Windows Server e Linux.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:runPowerShellScript
parameters:
  commands:
    type: String
    description: "(Required) The commands to run or the path to an existing script
      on the instance."
    default: Write-Host "Hello World"
mainSteps:
- action: aws:runPowerShellScript
  name: runPowerShellScript
  inputs:
    timeoutSeconds: '60'
    runCommand:
    - "{{ commands }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:runPowerShellScript",
  "parameters": {
    "commands": {
      "type": "String",
      "description": "(Required) The commands to run or the path to an existing script on the instance.",
      "default": "Write-Host \"Hello World\""
    }
  },
  "mainSteps": [
    {
      "action": "aws:runPowerShellScript",
      "name": "runPowerShellScript",
      "inputs": {
        "timeoutSeconds": "60",
        "runCommand": [
          "{{ commands }}"
        ]
      }
    }
  ]
}

Schema 1.2

YAML
---
runtimeConfig:
  aws:runPowerShellScript:
    properties:
    - id: 0.aws:runPowerShellScript
      runCommand: "{{ commands }}"
      workingDirectory: "{{ workingDirectory }}"
      timeoutSeconds: "{{ executionTimeout }}"
JSON
{
   "runtimeConfig":{
      "aws:runPowerShellScript":{
         "properties":[
            {
               "id":"0.aws:runPowerShellScript",
               "runCommand":"{{ commands }}",
               "workingDirectory":"{{ workingDirectory }}",
               "timeoutSeconds":"{{ executionTimeout }}"
            }
         ]
      }
   }
}

Proprietà

runCommand

Specifica i comandi da eseguire o il percorso a uno script esistente nell'istanza.

Digitare: StringList

Campo obbligatorio: sì

timeoutSeconds

Il tempo in secondi entro cui un comando deve essere portato a termine prima di essere considerato non riuscito. Quando viene raggiunto il timeout, Systems Manager interrompe l'esecuzione del comando.

Tipo: string

Campo obbligatorio: no

workingDirectory

Il percorso alla directory di lavoro nell'istanza.

Tipo: string

Campo obbligatorio: no

aws:runShellScript

Esegui script di shell Linux o specifica il percorso a uno script da eseguire. Questo plugin può essere eseguito solo su sistemi operativi Linux.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:runShellScript
parameters:
  commands:
    type: String
    description: "(Required) The commands to run or the path to an existing script
      on the instance."
    default: echo Hello World
mainSteps:
- action: aws:runShellScript
  name: runShellScript
  inputs:
    timeoutSeconds: '60'
    runCommand:
    - "{{ commands }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:runShellScript",
  "parameters": {
    "commands": {
      "type": "String",
      "description": "(Required) The commands to run or the path to an existing script on the instance.",
      "default": "echo Hello World"
    }
  },
  "mainSteps": [
    {
      "action": "aws:runShellScript",
      "name": "runShellScript",
      "inputs": {
        "timeoutSeconds": "60",
        "runCommand": [
          "{{ commands }}"
        ]
      }
    }
  ]
}

Schema 1.2

YAML
---
runtimeConfig:
  aws:runShellScript:
    properties:
    - runCommand: "{{ commands }}"
      workingDirectory: "{{ workingDirectory }}"
      timeoutSeconds: "{{ executionTimeout }}"
JSON
{
   "runtimeConfig":{
      "aws:runShellScript":{
         "properties":[
            {
               "runCommand":"{{ commands }}",
               "workingDirectory":"{{ workingDirectory }}",
               "timeoutSeconds":"{{ executionTimeout }}"
            }
         ]
      }
   }
}

Proprietà

runCommand

Specifica i comandi da eseguire o il percorso a uno script esistente nell'istanza.

Tipo: StringList

Campo obbligatorio: sì

timeoutSeconds

Il tempo in secondi entro cui un comando deve essere portato a termine prima di essere considerato non riuscito. Quando viene raggiunto il timeout, Systems Manager interrompe l'esecuzione del comando.

Tipo: string

Campo obbligatorio: no

workingDirectory

Il percorso alla directory di lavoro nell'istanza.

Tipo: string

Campo obbligatorio: no

aws:softwareInventory

(Versione dello schema 2.0 o successiva) è possibile ottenere i metadati su applicazioni, file e configurazioni sulle istanze gestite. Questo plugin funziona su sistemi operativi Linux e Microsoft Windows Server. Quando configuri la raccolta dell'inventario, inizi con la creazione di un' AWS Systems Manager State Managerassociazione. Systems Manager raccoglie i dati dell'inventario quando viene eseguita l'associazione. Se non si crea prima l'associazione e si tenta di richiamare il plugin aws:softwareInventory, il sistema restituisce il seguente errore:

The aws:softwareInventory plugin can only be invoked via ssm-associate.

Un'istanza può avere una sola associazione di Inventory configurata alla volta. Se configuri un'istanza con due o più associazioni, l'associazione di Inventory non viene eseguita e non viene raccolto alcun dato dell'inventario. Per ulteriori informazioni sulla raccolta dell'inventario, consulta AWS Systems Manager Inventory.

Sintassi

Schema 2.2

YAML
---
mainSteps:
- action: aws:softwareInventory
  name: collectSoftwareInventoryItems
  inputs:
    applications: "{{ applications }}"
    awsComponents: "{{ awsComponents }}"
    networkConfig: "{{ networkConfig }}"
    files: "{{ files }}"
    services: "{{ services }}"
    windowsRoles: "{{ windowsRoles }}"
    windowsRegistry: "{{ windowsRegistry}}"
    windowsUpdates: "{{ windowsUpdates }}"
    instanceDetailedInformation: "{{ instanceDetailedInformation }}"
    customInventory: "{{ customInventory }}"
JSON
{
   "mainSteps":[
      {
         "action":"aws:softwareInventory",
         "name":"collectSoftwareInventoryItems",
         "inputs":{
            "applications":"{{ applications }}",
            "awsComponents":"{{ awsComponents }}",
            "networkConfig":"{{ networkConfig }}",
            "files":"{{ files }}",
            "services":"{{ services }}",
            "windowsRoles":"{{ windowsRoles }}",
            "windowsRegistry":"{{ windowsRegistry}}",
            "windowsUpdates":"{{ windowsUpdates }}",
            "instanceDetailedInformation":"{{ instanceDetailedInformation }}",
            "customInventory":"{{ customInventory }}"
         }
      }
   ]
}

Inputs

applications

(Facoltativo) Consente di raccogliere i metadati per le applicazioni installate.

Tipo: string

Campo obbligatorio: no

awsComponents

(Facoltativo) Raccogli metadati per AWS componenti come amazon-ssm-agent.

Tipo: string

Campo obbligatorio: no

files

(Facoltativo, richiede la versione di SSM Agent 2.2.64.0 o successiva) Consente di raccogliere i metadati dei file, tra cui nomi, data e ora di creazione, data e ora dell'ultimo accesso e aggiornamento, e dimensioni, per citarne alcuni. Per ulteriori informazioni sulla raccolta dell'inventario dei file, consulta Utilizzo dell'inventario dei file e del registro di sistema di Windows.

Tipo: string

Campo obbligatorio: no

networkConfig

(Facoltativo) Consente di raccogliere i metadati relativi alle configurazioni di rete.

Tipo: string

Campo obbligatorio: no

windowsUpdates

(Facoltativo) Consente di raccogliere i metadati per tutti gli aggiornamenti di Windows.

Tipo: string

Campo obbligatorio: no

instanceDetailedInformation

(Facoltativo) Raccogli più informazioni sull'istanza rispetto a quelle fornite dal plug-in di inventario predefinito (aws:instanceInformation), tra cui CPU modello, velocità e numero di core, solo per citarne alcuni.

Tipo: string

Campo obbligatorio: no

services

(Facoltativo, solo sistema operativo Windows, richiede SSM Agent versione 2.2.64.0 o successiva) Consente di raccogliere i metadati per le configurazioni dei servizi.

Tipo: string

Campo obbligatorio: no

windowsRegistry

(Facoltativo, solo sistema operativo Windows, richiede SSM Agent versione 2.2.64.0 o successiva) Consente di raccogliere chiavi e valori del registro di Windows. È possibile scegliere un percorso chiave e raccogliere tutte le chiavi e i valori in modo ricorsivo. È possibile inoltre raccogliere una determinata chiave di registro e il relativo valore per un percorso specifico. Inventory raccoglie il percorso, il nome, il tipo e il valore delle chiave. Per ulteriori informazioni sulla raccolta dell'inventario del Registro di sistema di Windows, consulta Utilizzo dell'inventario dei file e del registro di sistema di Windows.

Tipo: string

Campo obbligatorio: no

windowsRoles

(Facoltativo, solo sistema operativo Windows, richiede SSM Agent versione 2.2.64.0 o successiva) Consente di raccogliere i metadati per le configurazioni dei ruoli Microsoft Windows.

Tipo: string

Campo obbligatorio: no

customInventory

(Facoltativo) Consente di raccogliere i dati dell'inventario personalizzato. Per ulteriori informazioni sull'inventario personalizzato, consulta Utilizzo di inventari personalizzati

Tipo: string

Campo obbligatorio: no

aws:updateAgent

Aggiorna il EC2Config servizio alla versione più recente o specifica una versione precedente. Questo plugin funziona solo sui sistemi operativi Microsoft Windows Server. Per ulteriori informazioni sul EC2Config servizio, consulta Configurazione di un'istanza Windows utilizzando il EC2Config servizio (legacy) nella Amazon EC2 User Guide.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:updateAgent
mainSteps:
- action: aws:updateAgent
  name: updateAgent
  inputs:
    agentName: Ec2Config
    source: https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:updateAgent",
  "mainSteps": [
    {
      "action": "aws:updateAgent",
      "name": "updateAgent",
      "inputs": {
        "agentName": "Ec2Config",
        "source": "https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json"
      }
    }
  ]
}

Schema 1.2

YAML
---
runtimeConfig:
  aws:updateAgent:
    properties:
      agentName: Ec2Config
      source: https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json
      allowDowngrade: "{{ allowDowngrade }}"
      targetVersion: "{{ version }}"
JSON
{
   "runtimeConfig":{
      "aws:updateAgent":{
         "properties":{
            "agentName":"Ec2Config",
            "source":"https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json",
            "allowDowngrade":"{{ allowDowngrade }}",
            "targetVersion":"{{ version }}"
         }
      }
   }
}

Proprietà

agentName

EC2Config. Questo è il nome dell'agente che esegue il EC2Config servizio.

Tipo: stringa

Campo obbligatorio: sì

allowDowngrade

Consenti il downgrade del EC2Config servizio a una versione precedente. Se impostato su "false", il servizio può essere aggiornato solo a versioni più recenti (impostazione predefinita). Se impostato su "true", specifica la versione precedente.

Tipo: Booleano

Campo obbligatorio: no

source

La posizione in cui Systems Manager copia la versione EC2Config da installare. Non puoi modificare questa posizione.

Tipo: stringa

Campo obbligatorio: sì

targetVersion

Una versione specifica del EC2Config servizio da installare. Se non è specificata, il servizio verrà aggiornato alla versione più recente.

Tipo: string

Campo obbligatorio: no

aws:updateSsmAgent

Aggiorna SSM Agent alla versione più recente o specifica una versione precedente. Questo plugin funziona su Linux e sistemi operativi Windows Server. Per ulteriori informazioni, consulta Utilizzo di SSM Agent.

Sintassi

Schema 2.2

YAML
---
schemaVersion: '2.2'
description: aws:updateSsmAgent
parameters:
  allowDowngrade:
    default: 'false'
    description: "(Optional) Allow the Amazon SSM Agent service to be downgraded to
      an earlier version. If set to false, the service can be upgraded to newer versions
      only (default). If set to true, specify the earlier version."
    type: String
    allowedValues:
    - 'true'
    - 'false'
mainSteps:
- action: aws:updateSsmAgent
  name: updateSSMAgent
  inputs:
    agentName: amazon-ssm-agent
    source: https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json
    allowDowngrade: "{{ allowDowngrade }}"
JSON
{
  "schemaVersion": "2.2",
  "description": "aws:updateSsmAgent",
  "parameters": {
    "allowDowngrade": {
      "default": "false",
      "description": "(Required) Allow the Amazon SSM Agent service to be downgraded to an earlier version. If set to false, the service can be upgraded to newer versions only (default). If set to true, specify the earlier version.",
      "type": "String",
      "allowedValues": [
        "true",
        "false"
      ]
    }
  },
  "mainSteps": [
    {
      "action": "aws:updateSsmAgent",
      "name": "awsupdateSsmAgent",
      "inputs": {
        "agentName": "amazon-ssm-agent",
        "source": "https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json",
        "allowDowngrade": "{{ allowDowngrade }}"
      }
    }
  ]
}

Schema 1.2

YAML
---
runtimeConfig:
  aws:updateSsmAgent:
    properties:
    - agentName: amazon-ssm-agent
      source: https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json
      allowDowngrade: "{{ allowDowngrade }}"
JSON
{
   "runtimeConfig":{
      "aws:updateSsmAgent":{
         "properties":[
            {
               "agentName":"amazon-ssm-agent",
               "source":"https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json",
               "allowDowngrade":"{{ allowDowngrade }}"
            }
         ]
      }
   }
}

Proprietà

agentName

amazon-ssm-agent. Questo è il nome dell'agente Systems Manager che elabora le richieste ed esegue i comandi nell'istanza.

Tipo: stringa

Campo obbligatorio: sì

allowDowngrade

Consenti il downgrade di SSM Agent a una versione precedente. Se impostato su "false", l'agente può essere aggiornato solo a versioni più recenti (impostazione predefinita). Se impostato su "true", specifica la versione precedente.

Tipo: Booleano

Campo obbligatorio: sì

source

La posizione in cui Systems Manager copia la versione di SSM Agent da installare. Non puoi modificare questa posizione.

Tipo: stringa

Campo obbligatorio: sì

targetVersion

Una versione specifica di SSM Agent da installare. Se non è specificata, l'agente verrà aggiornato alla versione più recente.

Tipo: string

Campo obbligatorio: no