RunCommand - Elastic Compute Service - Alibaba Cloud Documentation Center

Membuat dan menjalankan perintah Asisten Cloud pada satu atau beberapa Instans ECS. Mendukung tipe skrip Shell, PowerShell, atau Bat, serta menyediakan fitur seperti eksekusi terjadwal, parameter kustom, dan eksekusi dalam kontainer pada instans.

Deskripsi operasi

Ini adalah operasi asinkron. Setelah permintaan berhasil dikirim, Anda dapat memanggil DescribeInvocations atau DescribeInvocationResults untuk mengkueri hasil eksekusi dengan menggunakan ID perintah atau ID pemanggilan yang dikembalikan.

Sebelum Anda memulai

Instans target harus berada dalam status Running. Anda dapat memanggil DescribeInstances untuk mengkueri status instans.
Instans target harus memiliki Agen Asisten Cloud terinstal. Anda dapat menginstalnya dengan memanggil InstallCloudAssistant dan mengkueri status instalasi dengan memanggil DescribeCloudAssistantStatus.
Catatan
Instance ECS yang dibuat dari image publik setelah 1 Desember 2017 memiliki Agen Asisten Cloud terinstal secara default.
Untuk menjalankan perintah PowerShell, pastikan sistem operasi Windows pada Instance ECS target telah dikonfigurasi dengan modul PowerShell.

Perhatian

Dalam satu wilayah, Anda dapat menyimpan 500 hingga 50.000 perintah Asisten Cloud. Anda juga dapat meminta peningkatan kuota. Untuk informasi lebih lanjut, lihat Manajemen kuota.
Versi Agen Asisten Cloud harus tidak lebih lama dari versi berikut untuk mendukung fitur baru tugas terjadwal (eksekusi pada interval tetap, eksekusi satu kali pada waktu tertentu, dan eksekusi terjadwal berbasis Cron dengan tahun atau pengatur waktu yang ditentukan). Jika kode kesalahan ClientNeedUpgrade dikembalikan, lihat Mengupgrade atau menonaktifkan upgrade untuk Agen Asisten Cloud untuk memperbarui agen ke versi terbaru.
```
- Linux: 2.2.3.282
- Windows: 2.1.3.282
```
Saat Anda menjalankan tugas terjadwal berbasis Cron dengan pengatur waktu yang ditentukan, waktu eksekusi terjadwal didasarkan pada pengatur waktu yang ditentukan. Saat Anda tidak menentukan pengatur waktu, waktu eksekusi terjadwal didasarkan pada pengatur waktu sistem Instans ECS, dan waktu eksekusi ditentukan oleh waktu sistem instans. Pastikan waktu atau pengatur waktu Instans ECS konsisten dengan ekspektasi Anda. Untuk informasi lebih lanjut tentang pengatur waktu, lihat Mengonfigurasi pengatur waktu dan layanan NTP untuk instans Linux atau Mengonfigurasi layanan NTP untuk instans Windows.

Rekomendasi

Pengaturan timeout: Anda dapat menentukan parameter Timeout untuk mengatur periode timeout maksimum untuk eksekusi perintah pada Instans ECS. Saat perintah mengalami timeout, Agen Asisten Cloud secara paksa menghentikan proses.
- Setelah eksekusi satu kali mengalami timeout, status eksekusi (InvokeRecordStatus) berubah menjadi kesalahan eksekusi (Failed).
- Untuk eksekusi terjadwal, periode timeout berlaku untuk setiap catatan eksekusi. Timeout pada eksekusi sebelumnya tidak memengaruhi eksekusi berikutnya. Setelah timeout terjadi, status eksekusi (InvokeRecordStatus) berubah menjadi kesalahan eksekusi (Failed).
Kegagalan eksekusi: Perintah mungkin gagal dieksekusi karena status instans target yang abnormal, pengecualian jaringan, atau pengecualian Agen Asisten Cloud. Saat perintah gagal dieksekusi, tidak ada informasi eksekusi yang dihasilkan. Untuk informasi lebih lanjut, lihat Kesalahan umum dan solusi untuk kegagalan eksekusi.
Parameter kustom: Saat EnableParameter=true, fitur parameter kustom diaktifkan. Saat menetapkan CommandContent, Anda dapat mendefinisikan parameter kustom dalam format {{parameter}} dan meneruskan pasangan kunci-nilai parameter kustom saat menjalankan perintah.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:RunCommand

update

*Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

ecs:CommandRunAs

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ResourceGroupId	string	No	ID kelompok sumber daya untuk eksekusi perintah. Saat parameter ini ditentukan: Jika Instans ECS yang sesuai dengan InstanceId termasuk dalam kelompok sumber daya non-default, Instans ECS tersebut harus termasuk dalam kelompok sumber daya ini. Anda dapat memfilter hasil eksekusi perintah yang sesuai dengan menentukan parameter ini (dengan memanggil DescribeInvocations atau DescribeInvocationResults).	rg-bp67acfmxazb4p****
Name	string	No	Nama perintah. Semua set karakter didukung. Nama tidak boleh melebihi 128 karakter.	testName
Description	string	No	Deskripsi perintah. Semua set karakter didukung. Deskripsi tidak boleh melebihi 512 karakter.	testDescription
Type	string	Yes	Tipe perintah. Nilai valid: RunBatScript: Perintah Bat untuk instans Windows. RunPowerShellScript: Perintah PowerShell untuk instans Windows. RunShellScript: Perintah Shell untuk instans Linux.	RunShellScript
CommandContent	string	Yes	Konten perintah. Konten perintah dapat berupa teks biasa atau dienkode Base64. Perhatikan item berikut: Konten perintah tidak boleh melebihi 24 KB setelah pengodean Base64. Anda dapat menggunakan `KeepCommand` untuk menentukan apakah akan menyimpan perintah. Jika konten perintah dienkode Base64, Anda harus menetapkan `ContentEncoding=Base64`. Saat `EnableParameter=true` ditentukan, fitur parameter kustom diaktifkan dalam konten perintah: Definisikan parameter kustom dengan melampirkannya dalam `{{}}`. Spasi dan baris baru sebelum dan setelah nama parameter dalam `{{}}` diabaikan. Jumlah parameter kustom tidak boleh melebihi 20. Nama parameter kustom dapat berisi kombinasi a-zA-Z0-9-_. Awalan acs:: untuk menentukan parameter lingkungan non-bawaan tidak didukung. Karakter lain tidak didukung. Nama parameter tidak peka huruf besar-kecil. Setiap nama parameter kustom tidak boleh melebihi 64 byte. Anda dapat menentukan parameter lingkungan bawaan sebagai parameter kustom. Saat menjalankan perintah, Anda tidak perlu secara manual memberikan nilai pada parameter ini karena Asisten Cloud secara otomatis menggantinya dengan nilai yang sesuai. Parameter lingkungan bawaan berikut didukung: `{{ACS::RegionId}}`: ID wilayah. `{{ACS::AccountId}}`: ID akun Alibaba Cloud. `{{ACS::InstanceId}}`: ID instans. Saat perintah dikirim ke beberapa instans dan Anda ingin menggunakan `{{ACS::InstanceId}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari: Linux: 2.2.3.309 Windows: 2.1.3.309 `{{ACS::InstanceName}}`: Nama instans. Saat perintah dikirim ke beberapa instans dan Anda ingin menggunakan `{{ACS::InstanceName}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari: Linux: 2.2.3.344 Windows: 2.1.3.344 `{{ACS::InvokeId}}`: ID pemanggilan. Untuk menggunakan `{{ACS::InvokeId}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari: Linux: 2.2.3.309 Windows: 2.1.3.309 `{{ACS::CommandId}}`: ID perintah. Saat menjalankan perintah dengan memanggil operasi ini dan Anda ingin menggunakan `{{ACS::CommandId}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari: Linux: 2.2.3.309 Windows: 2.1.3.309	ZWNobyAxMjM=
WorkingDir	string	No	Direktori kerja perintah pada Instans ECS. Nilai tidak boleh melebihi 200 karakter. Nilai default: Untuk instans Linux, direktori default adalah direktori home pengguna root, yaitu `/root`. Untuk instans Windows, direktori default adalah direktori tempat proses Agen Asisten Cloud berada, seperti `C:\Windows\System32`.	/home/user
Timeout	integer	No	Periode timeout untuk eksekusi perintah. Unit: detik. Timeout terjadi saat perintah tidak dapat dijalankan karena masalah proses, modul yang hilang, atau Agen Asisten Cloud yang hilang. Saat timeout terjadi, proses perintah dihentikan secara paksa. Nilai default: 60.	3600
EnableParameter	boolean	No	Apakah perintah berisi parameter kustom. Nilai default: false.	false
RepeatMode	string	No	Mode eksekusi perintah. Nilai valid: Once: segera menjalankan perintah. Period: menjalankan perintah secara terjadwal. Saat parameter ini diatur ke `Period`, Anda juga harus menentukan parameter `Frequency`. NextRebootOnly: secara otomatis menjalankan perintah saat instans dimulai berikutnya. EveryReboot: secara otomatis menjalankan perintah setiap kali instans dimulai. DryRun: melakukan dry run pada permintaan tanpa benar-benar menjalankan perintah. Pemeriksaan mencakup parameter permintaan, lingkungan eksekusi instans, dan status Berjalan Agen Asisten Cloud. Nilai default: Saat parameter `Frequency` tidak ditentukan, nilai defaultnya adalah `Once`. Saat parameter `Frequency` ditentukan, perintah diproses sebagai `Period` terlepas dari apakah parameter ini diatur. Perhatian: Anda dapat memanggil StopInvocation untuk menghentikan perintah yang tertunda atau terjadwal. Saat parameter ini diatur ke `Period` atau `EveryReboot`, Anda dapat memanggil DescribeInvocationResults dan menentukan `IncludeHistory=true` untuk melihat riwayat eksekusi perintah terjadwal.	Once
Timed	boolean	No	[Deprecated] Parameter ini sudah tidak digunakan lagi. Meneruskan parameter ini tidak memiliki efek.	true
Frequency	string	No	Jadwal untuk menjalankan perintah. Tiga metode penjadwalan didukung: eksekusi pada interval tetap (berdasarkan ekspresi Rate), eksekusi satu kali pada waktu tertentu, dan eksekusi terjadwal berbasis jam (berdasarkan ekspresi Cron). Eksekusi pada interval tetap: Berdasarkan ekspresi Rate, perintah dijalankan pada interval yang ditentukan. Interval dapat ditentukan dalam detik (s), menit (m), jam (h), atau hari (d). Metode ini berlaku untuk skenario di mana tugas dijalankan pada interval tetap. Format: `rate(<nilai interval><unit interval>)`. Misalnya, untuk menjalankan perintah setiap 5 menit, gunakan `rate(5m)`. Batasan berikut berlaku untuk eksekusi interval tetap: Interval tidak boleh lebih besar dari 7 hari dan tidak kurang dari 60 detik, serta harus lebih besar dari periode timeout tugas terjadwal. Interval didasarkan pada frekuensi tetap dan tidak terkait dengan waktu eksekusi aktual tugas. Misalnya, jika perintah diatur untuk berjalan setiap 5 menit dan tugas membutuhkan 2 menit untuk selesai, putaran berikutnya dimulai 3 menit setelah tugas selesai. Tugas tidak langsung dijalankan saat dibuat. Misalnya, jika perintah diatur untuk berjalan setiap 5 menit, perintah tidak langsung dijalankan saat tugas dibuat. Sebaliknya, eksekusi dimulai 5 menit setelah tugas dibuat. Eksekusi satu kali pada waktu tertentu: Perintah dijalankan sekali pada zona waktu dan titik waktu yang ditentukan. Format: `at(yyyy-MM-dd HH:mm:ss <zona waktu>)`. Jika tidak ada zona waktu yang ditentukan, UTC digunakan secara default. Zona waktu mendukung tiga format berikut: Nama zona waktu lengkap: seperti `Asia/Shanghai` (waktu China/Shanghai) atau `America/Los_Angeles` (waktu AS/Los Angeles). Offset zona waktu dari Greenwich Mean Time: seperti `GMT+8:00` (zona Timur ke-8) atau `GMT-7:00` (zona Barat ke-7). Saat menggunakan format GMT, nol di depan tidak didukung di bidang jam. Singkatan zona waktu: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk menjalankan perintah sekali pada pukul 13:15:30 tanggal 6 Juni 2022 dalam waktu China/Shanghai, gunakan: `at(2022-06-06 13:15:30 Asia/Shanghai)`. Untuk menjalankan perintah sekali pada pukul 13:15:30 tanggal 6 Juni 2022 di zona Barat ke-7, gunakan: `at(2022-06-06 13:15:30 GMT-7:00)`. Eksekusi terjadwal berbasis jam (berdasarkan ekspresi Cron): Berdasarkan ekspresi Cron, perintah dijalankan sesuai dengan pengaturan tugas terjadwal. Format: `<detik> <menit> <jam> <hari dalam bulan> <bulan> <hari dalam minggu> <tahun (opsional)> <zona waktu>`, yaitu, `<ekspresi Cron> <zona waktu>`. Waktu eksekusi tugas terjadwal dihitung berdasarkan ekspresi Cron di zona waktu yang ditentukan. Jika tidak ada zona waktu yang ditentukan, zona waktu sistem instans yang menjalankan tugas terjadwal digunakan secara default. Untuk informasi lebih lanjut tentang ekspresi Cron, lihat Ekspresi cron. Zona waktu mendukung tiga format berikut: Nama zona waktu lengkap: seperti `Asia/Shanghai` (waktu China/Shanghai) atau `America/Los_Angeles` (waktu AS/Los Angeles). Offset zona waktu dari Greenwich Mean Time: seperti `GMT+8:00` (zona Timur ke-8) atau `GMT-7:00` (zona Barat ke-7). Saat menggunakan format GMT, nol di depan tidak didukung di bidang jam. Singkatan zona waktu: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk menjalankan perintah sekali setiap hari pada pukul 10:15 pagi dalam waktu China/Shanghai pada tahun 2022, gunakan `0 15 10 ? * * 2022 Asia/Shanghai`. Untuk menjalankan perintah setiap 30 menit dari pukul 10:00 pagi hingga 11:30 pagi setiap hari di zona Timur ke-8 pada tahun 2022, gunakan `0 0/30 10-11 * * ? 2022 GMT+8:00`. Untuk menjalankan perintah setiap 5 menit dari pukul 14:00 hingga 14:55 setiap hari di bulan Oktober setiap dua tahun mulai dari 2022 dalam UTC, gunakan `0 0/5 14 * 10 ? 2022/2 UTC`. Catatan Interval minimum harus lebih besar dari atau sama dengan periode timeout tugas terjadwal dan tidak kurang dari 10 detik.	0 /20 * * ?
Parameters	object	No	Pasangan kunci-nilai parameter kustom untuk diteruskan saat menjalankan perintah yang berisi parameter kustom. Misalnya, jika konten perintah adalah `echo {{name}}`, Anda dapat meneruskan pasangan kunci-nilai `{"name":"Jack"}` melalui parameter Parameter. Parameter kustom secara otomatis mengganti nilai variabel `name`, dan perintah aktual yang dieksekusi adalah `echo Jack`. Jumlah parameter kustom berkisar dari 0 hingga 10. Perhatikan item berikut: Kunci tidak boleh berupa string kosong dan dapat berisi hingga 64 karakter. Nilai dapat berupa string kosong. Setelah parameter kustom dan konten perintah asli dienkode Base64, ukuran total tidak boleh melebihi 24 KB. Anda dapat menggunakan `KeepCommand` untuk menentukan apakah akan menyimpan perintah. Himpunan nama parameter kustom harus merupakan subset dari himpunan parameter yang didefinisikan saat perintah dibuat. Untuk parameter yang tidak diteruskan, Anda dapat menggunakan string kosong sebagai pengganti. Nilai default: kosong, yang menonaktifkan parameter kustom.	{"name":"Jack", "accessKey":"LTAI*************"}
KeepCommand	boolean	No	Apakah akan menyimpan perintah setelah eksekusi. Nilai valid: true: menyimpan perintah. Perintah dapat dijalankan lagi dengan memanggil InvokeCommand. Ini dihitung terhadap kuota penyimpanan perintah Asisten Cloud. false: tidak menyimpan perintah. Perintah secara otomatis dihapus setelah eksekusi dan tidak dihitung terhadap kuota penyimpanan perintah Asisten Cloud. Nilai default: false.	false
ContentEncoding	string	No	Metode pengodean konten perintah (`CommandContent`). Nilai valid (tidak peka huruf besar-kecil): PlainText: tanpa pengodean. Konten ditransmisikan dalam teks biasa. Base64: pengodean Base64. Nilai default: PlainText. Nilai yang tidak valid diperlakukan sebagai PlainText.	Base64
Username	string	No	Nama pengguna untuk menjalankan perintah pada Instans ECS. Nilai tidak boleh melebihi 255 karakter. Untuk Instans ECS Linux, perintah dijalankan sebagai pengguna root secara default. Untuk Instans ECS Windows, perintah dijalankan sebagai pengguna System secara default. Anda juga dapat menentukan pengguna lain yang ada pada instans untuk menjalankan perintah. Menjalankan perintah Asisten Cloud sebagai pengguna biasa lebih aman. Untuk informasi lebih lanjut, lihat Mengonfigurasi pengguna biasa untuk menjalankan perintah Asisten Cloud.	test
WindowsPasswordName	string	No	Nama kata sandi untuk pengguna yang mengeksekusi perintah pada instans Windows. Nilai tidak boleh melebihi 255 karakter. Saat Anda ingin mengeksekusi perintah sebagai pengguna non-default (System) pada instans Windows, Anda harus menentukan `Username` dan parameter ini. Untuk mengurangi risiko kebocoran kata sandi, simpan kata sandi teks biasa di repositori parameter manajemen operasi, dan teruskan hanya nama kata sandi di sini. Untuk informasi lebih lanjut, lihat Parameter enkripsi dan Pengaturan untuk pengguna biasa mengeksekusi perintah Asisten Cloud. Catatan Parameter ini tidak diperlukan saat Anda mengeksekusi perintah sebagai pengguna root pada instans Linux atau pengguna System pada instans Windows.	axtSecretPassword
InstanceId	array	No	Array ID instans dari Instans ECS. Panjang array: 1 hingga 100. Jika ada instans yang ditentukan tidak memenuhi kondisi eksekusi, Anda harus memilih ulang instans. Anda juga dapat meminta peningkatan kuota di Pusat Kuota (nama kuota: Jumlah maksimum instans yang didukung untuk eksekusi perintah).	i-bp185dy2o3o6neg****
	string	No	ID Instans ECS.	i-bp185dy2o3o6neg****
Tag	array<object>	No	Pasangan tag. Panjang array: 0 hingga 20.
	object	No	Pasangan tag.
Value	string	No	Nilai tag dari eksekusi perintah. Nilai dapat berupa string kosong. Nilai dapat mencapai hingga 128 karakter dan tidak boleh mengandung `http://` atau `https://`.	TestValue
Key	string	No	Kunci tag dari eksekusi perintah. Jika nilai ini ditentukan, nilainya tidak boleh berupa string kosong. Saat Anda menggunakan satu tag untuk memfilter Sumber daya, jumlah Sumber daya di bawah tag tersebut tidak boleh melebihi 1.000. Saat Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah Sumber daya yang dilampirkan ke semua tag yang ditentukan tidak boleh melebihi 1.000. Jika jumlah Sumber daya melebihi 1.000, gunakan operasi ListTagResources untuk mengkueri Sumber daya. Kunci dapat mencapai hingga 64 karakter dan tidak boleh dimulai dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`.	TestKey
ContainerId	string	No	ID kontainer. Hanya string heksadesimal 64-bit yang didukung. Awalan `docker://`, `containerd://`, atau `cri-o://` dapat digunakan untuk secara eksplisit menentukan runtime kontainer. Perhatian: Jika parameter ini ditentukan, Asisten Cloud menjalankan skrip dalam kontainer yang ditentukan pada instans. Jika parameter ini ditentukan, perintah hanya dapat dijalankan pada instans Linux dengan versi Agen Asisten Cloud 2.2.3.344 atau lebih baru. Jika parameter ini ditentukan, parameter `Username` dan `WorkingDir` tidak berlaku. Perintah hanya dijalankan sebagai pengguna kontainer default di direktori kerja default kontainer. Untuk informasi lebih lanjut, lihat Menggunakan Asisten Cloud untuk menjalankan perintah dalam kontainer. Catatan Hanya skrip Shell yang didukung dalam kontainer Linux. Menentukan interpreter di awal skrip dalam format `#!/usr/bin/python` tidak didukung. Untuk informasi lebih lanjut, lihat Menggunakan Asisten Cloud untuk menjalankan perintah dalam kontainer.	ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****
ContainerName	string	No	Nama kontainer. Perhatian: Jika parameter ini ditentukan, Asisten Cloud menjalankan skrip dalam kontainer yang ditentukan pada instans. Jika parameter ini ditentukan, perintah hanya dapat dijalankan pada instans Linux dengan versi Agen Asisten Cloud 2.2.3.344 atau lebih baru. Jika parameter ini ditentukan, parameter `Username` dan `WorkingDir` tidak berlaku. Perintah hanya dijalankan sebagai pengguna kontainer default di direktori kerja default kontainer. Untuk informasi lebih lanjut, lihat Menggunakan Asisten Cloud untuk menjalankan perintah dalam kontainer. Catatan Hanya skrip Shell yang didukung dalam kontainer Linux. Menentukan interpreter di awal skrip dalam format `#!/usr/bin/python` tidak didukung. Untuk informasi lebih lanjut, lihat Menggunakan Asisten Cloud untuk menjalankan perintah dalam kontainer.	test-Kontainer
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token unik di antara permintaan yang berbeda. ClientToken hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000
OssOutputDelivery	string	No	Konfigurasi pengiriman OSS untuk output eksekusi perintah. Format: oss://${BucketName}/${Prefix}, di mana ${BucketName} adalah nama bucket OSS tujuan dan ${Prefix} adalah awalan direktori untuk pengiriman.	oss://testBucket/testPrefix
ResourceTag	array<object>	No	Tag yang digunakan untuk memfilter instans. Panjang array: 0 hingga 20. Anda dapat menjalankan perintah secara batch pada instans dengan tag yang sama tanpa menentukan InstanceId.
	object	No	Tag yang digunakan untuk memfilter instans. Anda dapat menjalankan perintah secara batch pada instans dengan tag yang sama tanpa menentukan InstanceId.
Value	string	No	Nilai tag yang digunakan untuk memfilter instans. Perhatian: Nilai dapat berupa string kosong. Nilai dapat mencapai hingga 128 karakter dan tidak boleh mengandung http:// atau https://.	TestValue
Key	string	No	Kunci tag yang digunakan untuk memfilter instans. Perhatian: Parameter ini berkonflik dengan parameter InstanceId. Keduanya tidak dapat ditentukan secara bersamaan. Jika nilai ini ditentukan, nilainya tidak boleh berupa string kosong. Jumlah instans di bawah tag tidak boleh melebihi batas kuantitas InstanceId.N. Jika jumlah instans melebihi batas, kendalikan jumlah instans dengan menambahkan tag batch, seperti batch: b1. Kunci dapat mencapai hingga 64 karakter dan tidak boleh dimulai dengan aliyun atau acs:, serta tidak boleh mengandung http:// atau https://.	TestKey
TerminationMode	string	No	Mode untuk menghentikan tugas (penghentian manual atau interupsi timeout). Nilai valid: Process: menghentikan proses skrip saat ini. ProcessTree: menghentikan pohon proses saat ini (kumpulan proses skrip dan semua proses anak yang dibuatnya).	ProcessTree
Launcher	string	No	Program bootstrap untuk eksekusi skrip. Nilai tidak boleh melebihi 1 KB.	python3 -u {{ACS::ScriptFileName\|Ext(".py")}}

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
CommandId	string	ID perintah.	c-7d2a745b412b4601b2d47f6a768d****
InvokeId	string	ID pemanggilan.	t-7d2a745b412b4601b2d47f6a768d****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "CommandId": "c-7d2a745b412b4601b2d47f6a768d****",
  "InvokeId": "t-7d2a745b412b4601b2d47f6a768d****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	API ini tidak didukung di wilayah saat ini.
400	ResourceBusy.SlrCreation	The ServiceLinkedRole is still being created or has not taken effect yet. Please try again later.
400	MissingParam.InstanceId	The parameter instanceId is missing or empty.	ID instans kosong.
400	NumberExceed.Tags	Ensure the number of tag parameters is not greater than 20.	Jumlah tag yang ditentukan melebihi batas.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Nilai tag yang ditentukan tidak valid. Nilai tag dapat berisi hingga 128 karakter dan tidak boleh mengandung "http://" atau "https://".
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Terdapat kunci duplikat dalam tag. Pastikan kunci unik.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Kunci tag yang ditentukan tidak valid. Kunci tag tidak boleh kosong atau null, dapat berisi hingga 128 karakter, dan tidak boleh dimulai dengan "aliyun" atau "acs:" atau mengandung "http://" atau "https://".
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tentukan kunci tag.
400	InvalidContainerId.Malformed	The specified parameter ContainerId is not valid.	ID kontainer yang ditentukan tidak valid.
400	InvalidContainerName.Malformed	The specified parameter ContainerName is not valid.	Nama kontainer yang ditentukan tidak valid.
400	InvalidClientToken.Malformed	The specified parameter clientToken is not valid.	Parameter ClientToken yang ditentukan tidak memenuhi persyaratan format. Parameter hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.
400	CmdParam.EmptyKey	Command parameters can not be empty.
400	CmdParam.InvalidParamName	A command parameter name is invalid.
400	CmdContent.DecodeError	The CommandContent can not be base64 decoded.	Konten perintah tidak dapat didekode Base64.
400	InvalidInstance.NotMatch	The specified instance type does not match the command.
400	MissingParam.Frequency	The frequency must be specified when you create a timed task.
400	InvalidParam.Frequency	The specified frequency is invalid.
400	ParameterKey.Duplicate	The parameter may not contain duplicate keys.	Nama parameter tidak boleh duplikat. Verifikasi nama dan coba lagi.
400	Parameter.NotMatched	The parameters of creation do not match those of invocation.	Parameter kustom yang dikirimkan tidak cocok dengan parameter kustom yang didefinisikan saat perintah dibuat.
400	WindowsPasswordName.Missed	WindowsPasswordName must be specified when you create a Windows task.
400	Parameter.Disabled	Parameters should not be passed when CreateCommand.EnableParameter is false.	Saat Anda menonaktifkan fitur parameter kustom untuk sebuah perintah, jangan kirimkan parameter kustom.
400	InvalidParameter.WorkingDir	The specified parameter WorkingDir is not valid.	Parameter WorkingDir yang ditentukan tidak valid.
400	NumberExceed.ResourceTags	The maximum number of ResourceTags is exceeded.
400	MissingParameter.ResourceTagKey	You must specify ResourceTag.N.Key.
400	InvalidResourceTagKey.Malformed	The specified ResourceTag key is not valid.
400	InvalidResourceTagValue.Malformed	The specified ResourceTag value is not valid.
400	Duplicate.ResourceTagKey	The ResourceTag contains duplicate keys.
400	InvalidResourceTag.InstanceNotFound	InstanceIds are not found by the specified ResourceTag.
400	InvalidResourceTag.ConflictWithInstanceIds	The specified param ResourceTag conflicts with InstanceId.
400	InvalidOssOutputDelivery.BucketInOtherRegion	The OSS bucket specified in the parameter OssOutputDelivery is in another region.	Bucket OSS yang ditentukan dalam parameter OssOutputDelivery berada di wilayah yang berbeda.
400	InvalidParameter.OssOutputDelivery	The specified parameter OssOutputDelivery is not valid.	Parameter OssOutputDelivery yang ditentukan tidak valid.
400	InvalidOssOutputDelivery.KeyPrefixMalformed	The prefix of the OSS key specified in the parameter OssOutputDelivery is not valid.	Awalan yang ditentukan dalam parameter OssOutputDelivery tidak valid.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Terjadi kesalahan saat mengirim permintaan. Coba lagi nanti.
403	InvalidOssOutputDelivery.BucketAccessDenied	The error message returned by the OSS API is: %s
403	CmdContent.ExceedLimit	The length of the command content exceeds the upper limit.	Panjang konten perintah melebihi batas atas.
403	CmdName.ExceedLimit	The length of the command name exceeds the upper limit.	Panjang nama perintah melebihi batas atas.
403	CmdDesc.ExceedLimit	The length of the command description exceeds the upper limit.	Panjang deskripsi perintah melebihi batas atas.
403	CmdCount.ExceedQuota	The total number of commands in the current region exceeds the quota.	Jumlah perintah Asisten Cloud di wilayah saat ini telah melebihi batas.
403	CmdParamCount.ExceedLimit	You've reached the limit on the count of command parameters.
403	CmdParamName.ExceedLimit	The length of the command parameter name exceeds the limit.	Panjang nama parameter kustom dalam perintah melebihi batas atas.
403	InstanceIds.ExceedLimit	The number of instance IDs exceeds the upper limit.	Jumlah instans target melebihi batas atas.
403	Invocation.ExceedQuota	The invocation quota in the current region has been reached for today.	Jumlah operasi eksekusi perintah di wilayah saat ini telah mencapai kuota harian.
403	ParameterCount.ExceedLimit	The number of command parameters exceeds the maximum number that can be set.	Jumlah parameter kustom melebihi batas.
403	ParameterKey.ExceedLimit	The length of the specified parameter key exceeds the maximum length that can be set.	Panjang kunci parameter yang ditentukan melebihi panjang maksimum yang diizinkan.
403	ParameterType.NotSupported	The type of parameter value is not supported.
403	Username.ExceedLimit	The length of the username exceeds the upper limit.	Panjang nama pengguna melebihi batas atas.
403	WindowsPasswordName.ExceedLimit	The length of the WindowsPasswordName exceeds the upper limit.	Panjang parameter WindowsPasswordName yang ditentukan melebihi batas atas.
403	ParameterStore.NotSupported	Parameter Store is not supported in this region.
403	TemporaryAccessKey.Error	The temporary accessKey is invalid.
403	ParameterStore.InvalidParameters	The parameter is invalid in Parameter Store.	Parameter yang ditentukan oleh {{oos:?}} dalam konten perintah tidak ditemukan.
403	ParameterStore.NoPermission	You have no access to Parameter Store.
403	OperationDenied.BidOwnResource	Bid user can not own resource.
403	Operation.Forbidden	The operation is not permitted.	Pengguna RAM saat ini tidak memiliki izin untuk melakukan operasi ini.
403	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	Token klien yang ditentukan telah digunakan.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Permintaan idempoten sebelumnya masih sedang diproses. Coba lagi nanti.
403	InvalidStatus.ResourceGroup	You cannot perform an operation on a resource group that is being created or deleted.	Operasi tidak diizinkan saat kelompok sumber daya sedang dibuat atau dihapus.
403	InvalidParameterCharacter.CommandName	The command Name contains illegal characters.	Nama perintah mengandung karakter yang tidak valid.
403	InvalidParameterCharacter.CommandDescription	The command Description contains illegal characters.	Deskripsi perintah mengandung karakter yang tidak valid.
403	InvalidParameterCharacter.CommandWorkingDir	The command WorkingDir contains illegal characters.	Jalur eksekusi perintah mengandung karakter yang tidak valid.
403	InvalidLauncher.LengthLimitExceeded	The length of the parameter Launcher exceeds the limit of 1 KB characters.	Panjang parameter Launcher melebihi batas 1 KB karakter.
403	InvalidParameterCharset.Parameters	The parameter Parameters contains illegal charset.	Parameter perintah mengandung set karakter yang tidak valid.
403	CreateServiceLinkedRole.NoPermission	You do not have permission to create ServiceLinkedRole for output delivery.	Anda tidak memiliki izin untuk membuat peran tertaut layanan untuk fitur pengiriman output.
403	InvalidTimeout.ExceedLimit	The specified parameter Timeout exceeds the upper limit.
404	InvalidCmdType.NotFound	The specified command type does not exist.
404	InvalidRepeatMode.NotFound	The specified repeat mode does not exist.	Metode eksekusi perintah yang ditentukan tidak ada.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	Informasi wilayah tidak valid.
404	InvalidInstance.NotFound	The specified instance does not exist.	Instans yang ditentukan tidak ada.
404	InvalidCmdId.NotFound	The specified command ID does not exist.	Parameter CommandId yang ditentukan tidak valid. Periksa apakah nilai parameter sudah benar. Anda dapat memanggil operasi DescribeCommands untuk mengkueri semua nilai CommandId yang tersedia.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya yang sesuai tidak ditemukan.
404	InvalidTerminationMode.NotFound	The specified parameter TerminationMode does not exist.	Parameter TerminationMode yang ditentukan tidak ada.
404	InvalidOssOutputDelivery.BucketNotFound	The OSS bucket specified in the parameter OssOutputDelivery does not exist.	Bucket yang ditentukan dalam parameter OssOutputDelivery tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.