• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola CloudWatch dasbor Amazon mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat [dokumentasi CloudWatch Dasbor Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan parameter semu saat mendaftarkan tugas jendela pemeliharaan
Saat Anda mendaftarkan tugas diMaintenance Windows, alat di AWS Systems Manager, Anda menentukan parameter yang unik untuk masing-masing dari empat jenis tugas. (Dalam perintah CLI, ini disediakan menggunakan `--task-invocation-parameters` opsi.)
Anda juga dapat mereferensikan nilai tertentu menggunakan sintaks *parameter semu*, seperti `{{RESOURCE_ID}}`, `{{TARGET_TYPE}}`, dan `{{WINDOW_TARGET_ID}}`. Ketika tugas jendela pemeliharaan berjalan, ia meneruskan nilai yang benar dan bukan placeholder parameter semu. Daftar lengkap parameter semu yang dapat Anda gunakan disediakan nanti dalam topik ini di[Parameter semu yang didukung](#pseudo-parameters).
**penting**
Untuk jenis target `RESOURCE_GROUP`, tergantung dari format ID yang diperlukan untuk tugas, Anda dapat memilih antara penggunaan `{{TARGET_ID}}` dan `{{RESOURCE_ID}}`untuk mereferensikan sumber daya saat tugas berjalan. `{{TARGET_ID}}`menampilkan ARN lengkap dari sumber daya. `{{RESOURCE_ID}}` menampilkan hanya nama atau ID dari sumber daya yang lebih singkat, seperti yang ditunjukkan dalam contoh ini.
Format `{{TARGET_ID}}`: `arn:aws:ec2:us-east-1:123456789012:instance/i-02573cafcfEXAMPLE`
Format `{{RESOURCE_ID}}`: `i-02573cafcfEXAMPLE`
Untuk jenis target `INSTANCE`, baik parameter `{{TARGET_ID}}` maupun `{{RESOURCE_ID}}` menghasilkan ID instans saja. Untuk informasi selengkapnya, lihat [Parameter semu yang didukung](#pseudo-parameters).
`{{TARGET_ID}}`dan `{{RESOURCE_ID}}` dapat digunakan untuk meneruskan IDs AWS sumber daya hanya ke tugas Otomasi, Lambda, dan Step Functions. Kedua parameter semu ini tidak dapat digunakan dengan Run Command tugas.
## Contoh parameter semu
Misalkan payload Anda untuk suatu AWS Lambda tugas perlu mereferensikan instance dengan ID-nya.
Baik Anda menggunakan target jendela `RESOURCE_GROUP` pemeliharaan `INSTANCE` atau pemeliharaan, ini dapat dicapai dengan menggunakan parameter `{{RESOURCE_ID}}` semu. Contoh:
```
"TaskArn": "arn:aws:lambda:us-east-2:111122223333:function:SSMTestFunction",
"TaskType": "LAMBDA",
"TaskInvocationParameters": {
"Lambda": {
"ClientContext": "ew0KICAi--truncated--0KIEXAMPLE",
"Payload": "{ \"instanceId\": \"{{RESOURCE_ID}}\" }",
"Qualifier": "$LATEST"
}
}
```
Jika tugas Lambda Anda dimaksudkan untuk dijalankan terhadap jenis target yang didukung lainnya selain instans Amazon Elastic Compute Cloud (Amazon EC2), seperti tabel Amazon DynamoDB, sintaks yang sama dapat digunakan, dan `{{RESOURCE_ID}}` menghasilkan nama tabel saja. Akan tetapi, jika Anda memerlukan ARN lengkap dari tabel, gunakan `{{TARGET_ID}}`, seperti yang ditunjukkan dalam contoh berikut.
```
"TaskArn": "arn:aws:lambda:us-east-2:111122223333:function:SSMTestFunction",
"TaskType": "LAMBDA",
"TaskInvocationParameters": {
"Lambda": {
"ClientContext": "ew0KICAi--truncated--0KIEXAMPLE",
"Payload": "{ \"tableArn\": \"{{TARGET_ID}}\" }",
"Qualifier": "$LATEST"
}
}
```
Sintaks yang sama berfungsi untuk penargetan instans atau jenis sumber daya lainnya. Ketika beberapa jenis sumber daya telah ditambahkan ke grup sumber daya, tugas berjalan terhadap masing-masing sumber daya yang sesuai.
**penting**
Tidak semua jenis sumber daya yang mungkin disertakan di grup sumber daya menghasilkan nilai untuk parameter `{{RESOURCE_ID}}`. Untuk daftar jenis sumber daya yang didukung, lihat [Parameter semu yang didukung](#pseudo-parameters).
Sebagai contoh lain, untuk menjalankan tugas Otomatisasi yang menghentikan instans EC2, Anda menentukan dokumen Systems Manager `AWS-StopEC2Instance` (dokumen SSM) sebagai nilai `TaskArn` dan menggunakan parameter semu `{{RESOURCE_ID}}`:
```
"TaskArn": "AWS-StopEC2Instance",
"TaskType": "AUTOMATION"
"TaskInvocationParameters": {
"Automation": {
"DocumentVersion": "1",
"Parameters": {
"instanceId": [
"{{RESOURCE_ID}}"
]
}
}
}
```
Untuk menjalankan tugas Otomatisasi yang menyalin snapshot volume Amazon Elastic Block Store (Amazon EBS), Anda menentukan dokumen SSM `AWS-CopySnapshot` sebagai nilai `TaskArn` dan menggunakan parameter semu `{{RESOURCE_ID}}`.
```
"TaskArn": "AWS-CopySnapshot",
"TaskType": "AUTOMATION"
"TaskInvocationParameters": {
"Automation": {
"DocumentVersion": "1",
"Parameters": {
"SourceRegion": "us-east-2",
"targetType":"RESOURCE_GROUP",
"SnapshotId": [
"{{RESOURCE_ID}}"
]
}
}
}
```
## Parameter semu yang didukung
Daftar berikut ini menjelaskan parameter semu yang dapat Anda tentukan menggunakan sintaks `{{PSEUDO_PARAMETER}}` di pilihan `--task-invocation-parameters`.
+ **`WINDOW_ID`**: ID dari jendela pemeliharaan target.
+ **`WINDOW_TASK_ID`**: ID tugas jendela yang sedang berjalan.
+ **`WINDOW_TARGET_ID`**: ID dari target jendela yang menyertakan target (ID target).
+ **`WINDOW_EXECUTION_ID`**: ID dari eksekusi jendela saat ini.
+ **`TASK_EXECUTION_ID`**: ID dari eksekusi tugas saat ini.
+ **`INVOCATION_ID`**: ID dari permintaan saat ini.
+ **`TARGET_TYPE`**: Jenis target. Jenis yang didukung termasuk `RESOURCE_GROUP` dan `INSTANCE`.
+ **`TARGET_ID`**:
Jika jenis target yang Anda tentukan adalah`INSTANCE`, parameter `TARGET_ID` semu diganti dengan ID instance. Misalnya, `i-078a280217EXAMPLE`.
Jika jenis target yang Anda tentukan adalah`RESOURCE_GROUP`, nilai yang direferensikan untuk eksekusi tugas adalah ARN penuh sumber daya. Sebagai contoh: `arn:aws:ec2:us-east-1:123456789012:instance/i-078a280217EXAMPLE`. Tabel berikut menyediakan sampel nilai `TARGET_ID` untuk jenis sumber daya tertentu dalam grup sumber daya.
**catatan**
`TARGET_ID`tidak didukung untuk Run Command tugas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/maintenance-window-tasks-pseudo-parameters.html)
+ **`RESOURCE_ID`**: ID singkat dari jenis sumber daya yang terkandung dalam grup sumber daya. Tabel berikut menyediakan sampel nilai `RESOURCE_ID` untuk jenis sumber daya tertentu dalam grup sumber daya.
**catatan**
`RESOURCE_ID`tidak didukung untuk Run Command tugas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/systems-manager/latest/userguide/maintenance-window-tasks-pseudo-parameters.html)
**catatan**
Jika grup AWS sumber daya yang Anda tentukan menyertakan tipe sumber daya yang tidak menghasilkan `RESOURCE_ID` nilai, dan tidak tercantum dalam tabel sebelumnya, maka `RESOURCE_ID` parameter tidak diisi. Permintaan eksekusi masih akan terjadi untuk sumber daya tersebut. Dalam hal ini, gunakan parameter semu `TARGET_ID` saja, yang akan diganti dengan ARN lengkap dari sumber daya.