• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo degli pseudo parametri durante la registrazione delle attività della finestra di manutenzione
Quando si registra un'attività in Maintenance Windows, uno strumento di AWS Systems Manager, è possibile specificare i parametri univoci per ciascuno dei quattro tipi di attività. (Nei comandi CLI, questi vengono forniti utilizzando l'opzione `--task-invocation-parameters`.)
Puoi anche fare riferimento a determinati valori utilizzando la sintassi degli *pseudoparametri*, ad esempio `{{RESOURCE_ID}}`, `{{TARGET_TYPE}}` e `{{WINDOW_TARGET_ID}}`. Quando viene eseguita, l'operazione della finestra di manutenzione trasmette i valori corretti invece dei segnaposto degli pseudoparametri. L'elenco completo degli pseudo parametri che è possibile utilizzare è fornito di seguito in questo argomento in [Pseudoparametri supportati](#pseudo-parameters).
**Importante**
Per il tipo di destinazione `RESOURCE_GROUP`, a seconda del formato ID necessario per l'attività, è possibile scegliere tra utilizzare `{{TARGET_ID}}` e `{{RESOURCE_ID}}` e fare riferimento alla risorsa quando viene eseguita l'attività. `{{TARGET_ID}}` restituisce l'ARN completo della risorsa. `{{RESOURCE_ID}}` restituisce solo un nome o un ID più breve della risorsa, come mostrato in questi esempi.
`{{TARGET_ID}}` format: `arn:aws:ec2:us-east-1:123456789012:instance/i-02573cafcfEXAMPLE`
`{{RESOURCE_ID}}` format: `i-02573cafcfEXAMPLE`
Per il tipo di destinazione `INSTANCE`, i parametri sia `{{TARGET_ID}}` sia `{{RESOURCE_ID}}` restituiscono solo l'ID istanza. Per ulteriori informazioni, consulta [Pseudoparametri supportati](#pseudo-parameters).
`{{TARGET_ID}}`e `{{RESOURCE_ID}}` può essere utilizzato per passare gli ID delle AWS risorse solo alle attività di Automation, Lambda e Step Functions. Questi due pseudo parametri non possono essere usati con attività Run Command.
## Esempi di pseudoparametri
Supponiamo che il payload per un' AWS Lambda attività debba fare riferimento a un'istanza tramite il relativo ID.
Sia che si utilizzi una destinazione della finestra di manutenzione `INSTANCE` o `RESOURCE_GROUP`, è possibile ottenere questo risultato utilizzando lo pseudoparametro `{{RESOURCE_ID}}`. Ad esempio:
```
"TaskArn": "arn:aws:lambda:us-east-2:111122223333:function:SSMTestFunction",
"TaskType": "LAMBDA",
"TaskInvocationParameters": {
"Lambda": {
"ClientContext": "ew0KICAi--truncated--0KIEXAMPLE",
"Payload": "{ \"instanceId\": \"{{RESOURCE_ID}}\" }",
"Qualifier": "$LATEST"
}
}
```
Se l'attività Lambda è destinata a essere eseguita su un altro tipo di destinazione supportato oltre alle istanze Amazon Elastic Compute Cloud (Amazon EC2), ad esempio una tabella Amazon DynamoDB, è possibile utilizzare la stessa sintassi e `{{RESOURCE_ID}}` restituisce solo il nome della tabella. Tuttavia, se si richiede l'ARN completo della tabella, utilizzare `{{TARGET_ID}}`, come illustrato nell'esempio seguente.
```
"TaskArn": "arn:aws:lambda:us-east-2:111122223333:function:SSMTestFunction",
"TaskType": "LAMBDA",
"TaskInvocationParameters": {
"Lambda": {
"ClientContext": "ew0KICAi--truncated--0KIEXAMPLE",
"Payload": "{ \"tableArn\": \"{{TARGET_ID}}\" }",
"Qualifier": "$LATEST"
}
}
```
La stessa sintassi funziona per il targeting di istanze o altri tipi di risorse. Quando più tipi di risorse sono stati aggiunti a un gruppo di risorse, l'attività viene eseguita su ciascuna delle risorse appropriate.
**Importante**
Non tutti i tipi di risorse che potrebbero essere inclusi in un gruppo di risorse producono un valore per il parametro `{{RESOURCE_ID}}`. Per un elenco dei tipi di risorse supportati, vedere [Pseudoparametri supportati](#pseudo-parameters).
A titolo di esempio aggiuntivo, per eseguire un task di automazione che interrompa l'esecuzione delle istanze EC2, devi specificare il documento di Systems Manager `AWS-StopEC2Instance` (documento SSM) come valore `TaskArn` e utilizzare lo pseudoparametro `{{RESOURCE_ID}}`:
```
"TaskArn": "AWS-StopEC2Instance",
"TaskType": "AUTOMATION"
"TaskInvocationParameters": {
"Automation": {
"DocumentVersion": "1",
"Parameters": {
"instanceId": [
"{{RESOURCE_ID}}"
]
}
}
}
```
Per eseguire un'attività di automazione che copia uno snapshot di un volume Amazon Elastic Block Store (Amazon EBS), specificare il documento SSM `AWS-CopySnapshot` come valore `TaskArn` e utilizzare lo pseudoparametro `{{RESOURCE_ID}}`.
```
"TaskArn": "AWS-CopySnapshot",
"TaskType": "AUTOMATION"
"TaskInvocationParameters": {
"Automation": {
"DocumentVersion": "1",
"Parameters": {
"SourceRegion": "us-east-2",
"targetType":"RESOURCE_GROUP",
"SnapshotId": [
"{{RESOURCE_ID}}"
]
}
}
}
```
## Pseudoparametri supportati
Nell'elenco seguente sono riportati gli pseudoparametri che puoi specificare utilizzando la sintassi `{{{{PSEUDO_PARAMETER}}}}` nell'opzione `--task-invocation-parameters`.
+ **`WINDOW_ID`**: ID della finestra di manutenzione di destinazione.
+ **`WINDOW_TASK_ID`**: l'ID dell'attività della finestra che è in esecuzione.
+ **`WINDOW_TARGET_ID`**: l'ID della destinazione della finestra che include la destinazione (ID destinazione).
+ **`WINDOW_EXECUTION_ID`**: l'ID dell'esecuzione della finestra corrente.
+ **`TASK_EXECUTION_ID`**: l'ID dell'esecuzione dell'attività corrente.
+ **`INVOCATION_ID`**: l'ID dell'invocazione corrente.
+ **`TARGET_TYPE`**: il tipo di destinazione. I tipi supportati includono `RESOURCE_GROUP` e `INSTANCE`.
+ **`TARGET_ID`**:
Se il tipo di destinazione specificato è `INSTANCE`, lo pseudoparametro `TARGET_ID` viene sostituito dall'ID dell'istanza. Ad esempio, `i-078a280217EXAMPLE`.
Se il tipo di destinazione specificato è `RESOURCE_GROUP`, il valore a cui si fa riferimento per l'esecuzione dell'attività è l'ARN completo della risorsa. Ad esempio: `arn:aws:ec2:us-east-1:123456789012:instance/i-078a280217EXAMPLE`. Nella tabella seguente sono riportati i valori `TARGET_ID` di esempio per particolari tipi di risorse in un gruppo di risorse.
**Nota**
`TARGET_ID` non è supportato per le attività Run Command.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/maintenance-window-tasks-pseudo-parameters.html)
+ **`RESOURCE_ID`**: ID breve di un tipo di risorsa contenuto in un gruppo di risorse. Nella tabella seguente sono riportati i valori `RESOURCE_ID` di esempio per particolari tipi di risorse in un gruppo di risorse.
**Nota**
`RESOURCE_ID` non è supportato per le attività Run Command.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/maintenance-window-tasks-pseudo-parameters.html)
**Nota**
Se il gruppo di AWS risorse specificato include tipi di risorse che non producono alcun `RESOURCE_ID` valore e non sono elencati nella tabella precedente, il `RESOURCE_ID` parametro non viene compilato. Una chiamata di esecuzione verrà comunque eseguita per tale risorsa. In questi casi, utilizzare invece lo pseudo parametro `TARGET_ID`, che verrà sostituito con l'ARN completo della risorsa.