• 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 dasbor Amazon CloudWatch 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.

# Jalankan perintah dalam skala besar
<a name="send-commands-multiple"></a>

Anda dapat menggunakan Run Command untuk menjalankan perintah pada armada node terkelola dengan menggunakan`targets`. `targets`Parameter menerima `Key,Value` kombinasi berdasarkan tag yang Anda tentukan untuk node terkelola. Ketika Anda menjalankan perintah, sistem akan menemukan dan mencoba menjalankan perintah pada semua node terkelola yang cocok dengan tag yang ditentukan. Untuk informasi selengkapnya tentang menandai instans terkelola, lihat [ Menandai AWS sumber daya Anda ](https://docs.aws.amazon.com/tag-editor/latest/userguide/tag-editor.html) di Panduan Pengguna Men * andai Sumber AWS Daya. * Untuk informasi tentang menandai perangkat IoT terkelola Anda, lihat Men [ andai AWS IoT Greengrass Version 2 sumber daya Anda ](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) di Panduan * Peng *AWS IoT Greengrass Version 2 embang. 

Anda juga dapat menggunakan `targets` parameter untuk menargetkan daftar ID node terkelola tertentu, seperti yang dijelaskan di bagian selanjutnya.

Untuk mengontrol bagaimana perintah berjalan di ratusan atau ribuan node terkelola, ser Run Command takan parameter untuk membatasi konkurensi. Anda dapat membatasi berapa banyak node yang memproses permintaan secara bersamaan dan berapa banyak kesalahan yang dapat terjadi sebelum perintah dibatalkan.

**Topics**
+ [Menargetkan beberapa node terkelola](#send-commands-targeting)
+ [Menggunakan pengendali rate](#send-commands-rate)

## Menargetkan beberapa node terkelola
<a name="send-commands-targeting"></a>

Anda dapat menjalankan perintah dan menargetkan node terkelola dengan menentukan tag, nama grup AWS sumber daya, atau ID node terkelola. 

Contoh berikut menunjukkan format perintah saat menggunakan Run Command dari AWS Command Line Interface (AWS CLI ). Ganti masing-masing {{example resource placeholder}} dengan informasi Anda sendiri. Contoh perintah di bagian ini disingkat menggunakan `[...]`.

**Contoh 1: Tag penargetan **

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{tag-name}},Values={{tag-value}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{tag-name}},Values={{tag-value}} ^
    [...]
```

------

**Contoh 2: Menargetkan grup AWS sumber daya berdasarkan nama **

Anda dapat menentukan maksimal satu nama resource group per perintah. Saat Anda membuat resource group, kami merekomendasikan untuk menyertakan `AWS::SSM:ManagedInstance` dan `AWS::EC2::Instance` sebagai jenis sumber daya dalam kriteria pengelompokan Anda. 

**catatan**  
Untuk mengirim perintah yang menargetkan grup sumber daya, Anda harus telah diberikan izin AWS Identity and Access Management (IAM) untuk membuat daftar atau melihat sumber daya milik grup tersebut. Untuk informasi selengkapnya, lihat Meng [ atur izin ](https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-prereqs.html#gettingstarted-prereqs-permissions) di Panduan *AWS Resource Groups Pengguna*. 

------
#### [ Linux & macOS ]

```
aws ssm send-command \    
    --document-name {{document-name}} \
    --targets Key=resource-groups:Name,Values={{resource-group-name}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^    
    --document-name {{document-name}} ^
    --targets Key=resource-groups:Name,Values={{resource-group-name}} ^
    [...]
```

------

**Contoh 3: Menargetkan grup AWS sumber daya berdasarkan jenis sumber daya **

Anda dapat menentukan maksimal lima jenis resource group per perintah. Saat Anda membuat resource group, kami merekomendasikan untuk menyertakan `AWS::SSM:ManagedInstance` dan `AWS::EC2::Instance` sebagai jenis sumber daya dalam kriteria pengelompokan Anda.

**catatan**  
Untuk mengirim perintah yang menargetkan grup sumber daya, Anda harus diberikan izin IAM untuk mencantumkan, atau melihat, sumber daya milik grup tersebut. Untuk informasi selengkapnya, lihat Meng [ atur izin ](https://docs.aws.amazon.com/ARG/latest/userguide/gettingstarted-prereqs.html#gettingstarted-prereqs-permissions) di Panduan *AWS Resource Groups Pengguna*. 

------
#### [ Linux & macOS ]

```
aws ssm send-command \    
    --document-name {{document-name}} \
    --targets Key=resource-groups:ResourceTypeFilters,Values={{resource-type-1}},{{resource-type-2}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^    
    --document-name {{document-name}} ^
    --targets Key=resource-groups:ResourceTypeFilters,Values={{resource-type-1}},{{resource-type-2}} ^
    [...]
```

------

**Contoh 4: Menargetkan ID instans **

Contoh berikut menunjukkan cara menargetkan node terkelola dengan menggunakan `instanceids` kunci dengan `targets` parameter. Anda dapat menggunakan kunci ini untuk menargetkan perangkat AWS IoT Greengrass inti yang dikelola karena setiap perangkat diberi mi-{{ID\_number}}. Anda dapat melihat ID perangkat diFleet Manager.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=instanceids,Values={{instance-ID-1}},{{instance-ID-2}},{{instance-ID-3}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=instanceids,Values={{instance-ID-1}},{{instance-ID-2}},{{instance-ID-3}} ^
    [...]
```

------

Jika Anda menandai node terkelola untuk lingkungan yang berbeda menggunakan `Key` nama `Environment` and `Values` of `Development``Test`,`Production`, `Pre-production` dan, maka Anda dapat mengirim perintah ke semua node terkelola di * * salah satu lingkungan ini dengan menggunakan `targets` parameter dengan sintaks berikut.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{Environment}},Values={{Development}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{Environment}},Values={{Development}} ^
    [...]
```

------

Anda dapat menargetkan node terkelola tambahan di lingkungan lain dengan menambahkan ke `Values` daftar. Pisahkan item menggunakan koma.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{Environment}},Values={{Development}},{{Test}},{{Pre-production}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{Environment}},Values={{Development}},{{Test}},{{Pre-production}} ^
    [...]
```

------

**Variasi**: Menyempurnakan target Anda menggunakan beberapa kriteria `Key`

Anda dapat menyempurnakan jumlah target untuk perintah Anda dengan menyertakan beberapa kriteria `Key`. Jika Anda menyertakan lebih dari satu `Key` kriteria, sistem menargetkan node terkelola yang memenuhi * semua * kriteria. Perintah berikut menargetkan semua node terkelola yang ditandai untuk Departemen Keuangan * dan * diberi tag untuk peran server database.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{Department}},Values={{Finance}} Key=tag:{{ServerRole}},Values={{Database}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{Department}},Values={{Finance}} Key=tag:{{ServerRole}},Values={{Database}} ^
    [...]
```

------

**Variasi**: Menggunakan beberapa `Key` dan kriteria `Value`

Berdasarkan contoh sebelumnya, Anda dapat menargetkan beberapa departemen dan beberapa peran server dengan memasukkan item tambahan di kriteria `Values`.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{Department}},Values={{Finance}},{{Marketing}} Key=tag:{{ServerRole}},Values={{WebServer}},{{Database}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{Department}},Values={{Finance}},{{Marketing}} Key=tag:{{ServerRole}},Values={{WebServer}},{{Database}} ^
    [...]
```

------

**Variasi**: Menargetkan node terkelola dengan tag menggunakan beberapa `Values` kriteria

Jika Anda menandai node terkelola untuk lingkungan yang berbeda menggunakan `Key` nama `Department` `Sales` dan `Values` dari dan`Finance`, maka Anda dapat mengirim perintah ke semua node di lingkungan ini dengan menggunakan `targets` parameter dengan sintaks berikut.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{Department}},Values={{Sales,Finance}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{Department}},Values={{Sales,Finance}} ^
    [...]
```

------

Anda dapat menentukan maksimum lima kunci, dan lima nilai untuk setiap kunci.

Jika salah satu kunci tag (nama tag) atau nilai tag termasuk spasi, lampirkan kunci tag atau nilai dalam tanda kutip, seperti yang ditunjukkan dalam contoh berikut.

**Contoh**: Spasi di tag `Value`

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{OS}},Values="{{Windows Server 2016"}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{OS}},Values="{{Windows Server 2016"}} ^
    [...]
```

------

**Contoh**: Spasi di kunci `tag` dan `Value`

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key="tag:{{Operating System}}",Values="{{Windows Server 2016"}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key="tag:{{Operating System}}",Values="{{Windows Server 2016"}} ^
    [...]
```

------

**Contoh**: Spasi dalam satu item dalam daftar `Values`

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --targets Key=tag:{{Department}},Values={{"Sales","Finance","Systems Mgmt"}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --targets Key=tag:{{Department}},Values={{"Sales","Finance","Systems Mgmt"}} ^
    [...]
```

------

## Menggunakan pengendali rate
<a name="send-commands-rate"></a>

Anda dapat mengontrol kecepatan pengiriman perintah ke node terkelola dalam grup dengan menggunakan kontrol * konkurensi * dan kontrol * * kesalahan.

### Menggunakan pengendali konkurensi
<a name="send-commands-velocity"></a>

Anda dapat mengontrol jumlah node terkelola yang menjalankan perintah secara bersamaan dengan menggunakan `max-concurrency` parameter (**opsi ** Concurrency di ** halaman ** Run a command). Anda dapat menentukan jumlah absolut node terkelola, misalnya**10**, atau persentase dari set target, misalnya**10%**. Sistem antrian mengirimkan perintah ke satu node dan menunggu sampai sistem mengakui pemanggilan awal sebelum mengirim perintah ke dua node lagi. Sistem secara eksponensial mengirimkan perintah ke lebih banyak node sampai sistem memenuhi nilai`max-concurrency`. default untuk nilai `max-concurrency` adalah 50. Contoh berikut ini menunjukkan kepada Anda cara menentukan nilai untuk parameter `max-concurrency`.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --max-concurrency {{10}} \
    --targets Key=tag:{{Environment}},Values={{Development}} \
    [...]
```

```
aws ssm send-command \
    --document-name {{document-name}} \
    --max-concurrency {{10}}% \
    --targets Key=tag:{{Department}},Values={{Finance}},{{Marketing}} Key=tag:{{ServerRole}},Values={{WebServer}},{{Database}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --max-concurrency {{10}} ^
    --targets Key=tag:{{Environment}},Values={{Development}} ^
    [...]
```

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --max-concurrency {{10}}% ^
    --targets Key=tag:{{Department}},Values={{Finance}},{{Marketing}} Key=tag:{{ServerRole}},Values={{WebServer}},{{Database}} ^
    [...]
```

------

### Menggunakan pengendali kesalahan
<a name="send-commands-maxerrors"></a>

Anda juga dapat mengontrol eksekusi perintah ke ratusan atau ribuan node terkelola dengan menetapkan batas kesalahan menggunakan `max-errors` parameter (**bidang ambang ** kesalahan di ** halaman ** Jalankan perintah). Parameter menentukan berapa banyak kesalahan yang diizinkan sebelum sistem berhenti mengirim perintah ke node terkelola tambahan. Anda dapat menentukan jumlah kesalahan mutlak, misalnya **10**, atau persentase target yang ditentukan, misalnya **10%**. Jika Anda menentukan **3**, misalnya, maka sistem akan berhenti mengirim perintah ketika kesalahan keempat diterima. Jika Anda menentukan**0**, maka sistem berhenti mengirim perintah ke node terkelola tambahan setelah hasil kesalahan pertama dikembalikan. Jika Anda mengirim perintah ke 50 node terkelola dan diatur `max-errors` ke**10%**, maka sistem berhenti mengirim perintah ke node tambahan ketika kesalahan keenam diterima.

Pemanggilan yang sudah menjalankan perintah saat `max-errors` tercapai diizinkan untuk diselesaikan, tetapi beberapa pemanggilan tersebut mungkin gagal juga. Jika Anda perlu memastikan bahwa tidak akan ada lebih dari pemanggilan yang `max-errors` gagal, setel `max-concurrency` **1** agar pemanggilan berlanjut satu per satu. default untuk maksimal kesalahan adalah 0. Contoh berikut ini menunjukkan kepada Anda cara menentukan nilai untuk parameter `max-errors`.

------
#### [ Linux & macOS ]

```
aws ssm send-command \
    --document-name {{document-name}} \
    --max-errors {{10}} \
    --targets Key=tag:{{Database}},Values={{Development}} \
    [...]
```

```
aws ssm send-command \
    --document-name {{document-name}} \
    --max-errors {{10}}% \
    --targets Key=tag:{{Environment}},Values={{Development}} \
    [...]
```

```
aws ssm send-command \
    --document-name {{document-name}} \
    --max-concurrency {{1}} \
    --max-errors {{1}} \
    --targets Key=tag:{{Environment}},Values={{Production}} \
    [...]
```

------
#### [ Windows ]

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --max-errors {{10}} ^
    --targets Key=tag:{{Database}},Values={{Development}} ^
    [...]
```

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --max-errors {{10}}% ^
    --targets Key=tag:{{Environment}},Values={{Development}} ^
    [...]
```

```
aws ssm send-command ^
    --document-name {{document-name}} ^
    --max-concurrency {{1}} ^
    --max-errors {{1}} ^
    --targets Key=tag:{{Environment}},Values={{Production}} ^
    [...]
```

------