RunCommand - Elastic Compute Service - Alibaba Cloud Documentation Center

Membuat dan menjalankan perintah Asisten Cloud pada satu atau beberapa Instance ECS. Operasi ini mendukung skrip Shell, PowerShell, dan Bat, serta menyediakan fitur seperti eksekusi terjadwal, parameter kustom, dan eksekusi perintah di dalam Kontainer pada Instans.

Deskripsi operasi

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

Sebelum memulai

Instans target harus dalam status Berjalan (Running). Anda dapat memanggil DescribeInstances untuk mengkueri status Instans.
Instans target harus memiliki Agen Asisten Cloud yang 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 yang terinstal secara default.
Untuk menjalankan perintah PowerShell, pastikan modul PowerShell telah dikonfigurasi pada sistem operasi Windows Instance ECS target.

Catatan penting

Dalam satu Wilayah, Anda dapat menyimpan 500 hingga 50.000 perintah Asisten Cloud. Anda juga dapat meminta Tingkatkan Kuota. Untuk informasi lebih lanjut, lihat Manajemen Kuota.
Agen Asisten Cloud harus berada pada versi berikut atau yang lebih baru untuk mendukung fitur baru pada Tugas terjadwal (eksekusi pada interval tetap, eksekusi satu kali pada pengatur waktu tertentu, dan penentuan tahun atau zona untuk eksekusi terjadwal berbasis Ekspresi cron). Jika kode kesalahan ClientNeedUpgrade dikembalikan, lihat Peningkatan atau menonaktifkan Peningkatan 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 Ekspresi cron dengan zona yang ditentukan, waktu eksekusi terjadwal didasarkan pada zona yang ditentukan. Saat Anda tidak menentukan zona, waktu eksekusi terjadwal didasarkan pada zona sistem Instance ECS, dan waktu eksekusi ditentukan oleh pengatur waktu sistem Instans. Pastikan pengatur waktu atau zona Instance ECS sesuai dengan ekspektasi Anda. Untuk informasi lebih lanjut tentang zona, lihat Mengonfigurasi zona dan layanan NTP untuk Instans Linux atau Mengonfigurasi layanan NTP untuk Instans Windows.

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 Instance ECS yang ditentukan oleh InstanceId termasuk dalam kelompok sumber daya non-default, Instance ECS tersebut harus termasuk dalam kelompok sumber daya ini. Anda dapat memfilter hasil eksekusi perintah dengan menentukan parameter ini (dengan memanggil DescribeInvocations atau DescribeInvocationResults).	rg-bp67acfmxazb4p****
Name	string	No	Nama perintah. Semua set karakter didukung. Nama dapat memiliki panjang hingga 128 karakter.	testName
Description	string	No	Deskripsi perintah. Semua set karakter didukung. Deskripsi dapat memiliki panjang hingga 512 karakter.	testSkrip
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 hal-hal 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`, Anda dapat mengaktifkan fitur parameter kustom dalam konten perintah: Tentukan parameter kustom dengan mengapitnya dalam `{{}}`. Spasi dan jeda baris sebelum dan sesudah nama parameter di dalam `{{}}` akan 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 perintah Berjalan, Anda tidak perlu menetapkan nilai secara manual ke parameter ini karena Asisten Cloud secara otomatis menggantinya dengan nilai yang sesuai. Parameter lingkungan bawaan berikut didukung: `{{ACS::RegionId}}`: ID Wilayah. `{{ACS::AccountId}}`: UID akun Alibaba Cloud. `{{ACS::InstanceId}}`: ID Instans. Saat perintah dikirim ke beberapa Instans dan Anda ingin menggunakan `{{ACS::InstanceId}}` sebagai parameter lingkungan bawaan, pastikan Agen Asisten Cloud berada pada versi berikut atau yang lebih baru: 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 Agen Asisten Cloud berada pada versi berikut atau yang lebih baru: Linux: 2.2.3.344 Windows: 2.1.3.344 `{{ACS::InvokeId}}`: ID pemanggilan. Untuk menggunakan `{{ACS::InvokeId}}` sebagai parameter lingkungan bawaan, pastikan Agen Asisten Cloud berada pada versi berikut atau yang lebih baru: Linux: 2.2.3.309 Windows: 2.1.3.309 `{{ACS::CommandId}}`: ID perintah. Saat memanggil operasi ini untuk menjalankan perintah dan Anda ingin menggunakan `{{ACS::CommandId}}` sebagai parameter lingkungan bawaan, pastikan Agen Asisten Cloud berada pada versi berikut atau yang lebih baru: Linux: 2.2.3.309 Windows: 2.1.3.309	ZWNobyAxMjM=
WorkingDir	string	No	Direktori kerja perintah pada Instance ECS. Nilai dapat memiliki panjang hingga 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 pengatur waktu untuk eksekusi perintah. Unit: detik. Saat perintah tidak dapat Berjalan karena masalah proses, modul yang hilang, atau Agen Asisten Cloud yang hilang, pengatur waktu tunggu akan terjadi. Saat pengatur waktu tunggu terjadi, proses perintah akan dihentikan secara paksa. Nilai default: 60.	3600
EnableParameter	boolean	No	Apakah akan menyertakan parameter kustom dalam perintah. Nilai default: false.	false
RepeatMode	string	No	Mode eksekusi perintah. Nilai valid: Once: Menjalankan perintah segera. Period: Menjalankan perintah secara terjadwal. Saat parameter ini ditetapkan ke `Period`, Anda juga harus menentukan parameter `Frequency`. NextRebootOnly: Menjalankan perintah secara otomatis saat instans dimulai berikutnya. EveryReboot: Menjalankan perintah secara otomatis setiap kali instans dimulai. DryRun: Hanya menjalankan dry run pada permintaan. Perintah tidak benar-benar dieksekusi. Dry run memeriksa parameter permintaan, lingkungan eksekusi instans, dan status Agen Asisten Cloud. Nilai default: Saat parameter `Frequency` tidak ditentukan, nilai default adalah `Once`. Saat parameter `Frequency` ditentukan, perintah diproses sebagai `Period` terlepas dari apakah parameter ini ditetapkan. Catatan penting: Anda dapat memanggil StopInvocation untuk menghentikan perintah yang tertunda atau terjadwal. Saat parameter ini ditetapkan ke `Period` atau `EveryReboot`, Anda dapat memanggil DescribeInvocationResults dan menentukan `IncludeHistory=true` untuk Tampilan riwayat eksekusi perintah terjadwal.	Once
Timed	boolean	No	[Tidak digunakan lagi] Parameter ini tidak digunakan lagi. Menentukan parameter ini tidak memiliki efek.	true
Frequency	string	No	Jadwal untuk menjalankan perintah. Tiga metode penjadwalan didukung: eksekusi pada interval tetap (berdasarkan ekspresi laju), eksekusi satu kali pada pengatur waktu tertentu, dan eksekusi terjadwal berbasis jam (berdasarkan Ekspresi cron). Eksekusi pada interval tetap: Berdasarkan ekspresi laju, perintah Berjalan pada interval yang ditentukan. Interval dapat ditentukan dalam detik (s), menit (m), jam (h), atau hari (d). Metode ini cocok untuk skenario yang memerlukan eksekusi 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 melebihi 7 hari atau kurang dari 60 detik, dan harus lebih besar dari periode Tugas terjadwal. Interval didasarkan pada frekuensi tetap dan tidak terkait dengan pengatur waktu eksekusi aktual Tugas. Misalnya, jika perintah diatur untuk Berjalan setiap 5 menit dan Tugas membutuhkan waktu 2 menit untuk selesai, putaran berikutnya dimulai 3 menit setelah Tugas selesai. Tugas tidak Berjalan segera setelah dibuat. Misalnya, jika perintah diatur untuk Berjalan setiap 5 menit, perintah tidak Berjalan segera saat Tugas dibuat. Sebaliknya, perintah mulai Berjalan 5 menit setelah Tugas dibuat. Eksekusi satu kali pada pengatur waktu tertentu: Menjalankan perintah satu kali pada zona dan pengatur waktu yang ditentukan. Format: `at(yyyy-MM-dd HH:mm:ss <zona>)`. Jika tidak ada zona yang ditentukan, UTC digunakan secara default. Zona mendukung tiga format berikut: Nama zona lengkap: seperti `Asia/Shanghai` (waktu China/Shanghai) atau `America/Los_Angeles` (waktu AS/Los Angeles). Offset GMT dari Greenwich Mean Time: seperti `GMT+8:00` (UTC+8) atau `GMT-7:00` (UTC-7). Saat menggunakan format GMT, nol di depan tidak didukung untuk nilai jam. Singkatan zona: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk menjalankan perintah satu kali 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 satu kali pada pukul 13:15:30 tanggal 6 Juni 2022 dalam UTC-7, gunakan: `at(2022-06-06 13:15:30 GMT-7:00)`. Eksekusi terjadwal berbasis jam (berdasarkan Ekspresi cron): Berdasarkan Ekspresi cron, perintah Berjalan sesuai jadwal yang ditentukan. Format: `<detik> <menit> <jam> <hari dalam bulan> <bulan> <hari dalam minggu> <tahun (opsional)> <zona>`. Pengatur waktu eksekusi Tugas terjadwal dihitung berdasarkan Ekspresi cron dalam zona yang ditentukan. Jika tidak ada zona yang ditentukan, zona sistem Instans yang menjalankan Tugas terjadwal digunakan. Untuk informasi lebih lanjut tentang Ekspresi cron, lihat Ekspresi cron. Zona mendukung tiga format berikut: Nama zona lengkap: seperti `Asia/Shanghai` (waktu China/Shanghai) atau `America/Los_Angeles` (waktu AS/Los Angeles). Offset GMT dari Greenwich Mean Time: seperti `GMT+8:00` (UTC+8) atau `GMT-7:00` (UTC-7). Saat menggunakan format GMT, nol di depan tidak didukung untuk nilai jam. Singkatan zona: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk menjalankan perintah satu kali setiap hari pada pukul 10:15 dalam waktu China/Shanghai pada tahun 2022, gunakan `0 15 10 ? * * 2022 Asia/Shanghai`. Untuk menjalankan perintah setiap 30 menit dari pukul 10:00 hingga 11:30 setiap hari dalam UTC+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 pada 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 Tugas terjadwal dan tidak kurang dari 10 detik.	0 /20 * * ?
Parameters	object	No	Pasangan kunci-nilai parameter kustom yang akan diteruskan saat perintah 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 hal-hal berikut: Kunci tidak boleh berupa string kosong dan dapat memiliki panjang hingga 64 karakter. Nilai dapat berupa string kosong. Setelah parameter kustom dan konten perintah asli dienkode Base64, ukuran total konten perintah tidak boleh melebihi 24 KB. Anda dapat menggunakan `KeepCommand` untuk menentukan apakah akan menyimpan perintah. Kumpulan nama parameter kustom harus merupakan subset dari kumpulan parameter yang ditentukan 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. Anda dapat menjalankannya kembali dengan memanggil InvokeCommand. Perintah dihitung dalam kuota penyimpanan Asisten Cloud Assistant. false: Tidak menyimpan perintah. Perintah dihapus secara otomatis setelah eksekusi dan tidak dihitung dalam kuota penyimpanan Asisten Cloud Assistant. 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. Jika nilai tidak valid ditentukan, nilai tersebut diperlakukan sebagai PlainText.	Base64
Username	string	No	Nama pengguna untuk perintah Berjalan pada Instance ECS. Nilai dapat memiliki panjang hingga 255 karakter. Untuk Instance ECS Linux, perintah Berjalan sebagai pengguna root secara default. Untuk Instance ECS Windows, perintah Berjalan sebagai pengguna System secara default. Anda juga dapat menentukan pengguna lain yang ada pada Instans untuk menjalankan perintah. Menjalankan Asisten Cloud sebagai pengguna biasa lebih aman. Untuk informasi lebih lanjut, lihat Mengonfigurasi pengguna biasa untuk menjalankan Asisten Cloud.	test
WindowsPasswordName	string	No	Nama kata sandi untuk pengguna yang mengeksekusi perintah pada instans Windows. Nama dapat memiliki panjang hingga 255 karakter. Jika 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 di Pengaturan dan tentukan hanya nama kata sandi di sini. Untuk informasi lebih lanjut, lihat Parameter Enkripsi dan Mengonfigurasi pengguna biasa untuk mengeksekusi perintah Asisten Cloud. Catatan Anda tidak perlu menentukan parameter ini jika Anda mengeksekusi perintah sebagai pengguna root pada instans Linux atau pengguna System pada instans Windows.	axtSecretPassword
InstanceId	array	No	Array ID Instance ECS. Panjang array: 1 hingga 100. Jika salah satu Instans yang ditentukan tidak memenuhi kondisi untuk mengeksekusi perintah, Anda harus memilih ulang Instans tersebut. Anda juga dapat meminta Tingkatkan Kuota di Pusat Kuota (nama Kuota: Jumlah maksimum Instans yang dapat mengeksekusi perintah).	i-bp185dy2o3o6neg****
	string	No	ID Instans ECS.	i-bp185dy2o3o6neg****
Tag	array<object>	No	Tag. Panjang array: 0 hingga 20.
	object	No	Tag.
Key	string	No	Kunci tag yang digunakan saat Anda mengeksekusi perintah. Jika nilai ini ditentukan, nilai tersebut 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 tag dapat memiliki panjang hingga 64 karakter dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Kunci tag tidak boleh mengandung `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag untuk eksekusi perintah. Nilai dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh mengandung `http://` atau `https://`.	TestValue
ContainerId	string	No	ID Kontainer. Hanya string heksadesimal 64-bit yang didukung. Anda dapat menggunakan awalan `docker://`, `containerd://`, atau `cri-o://` untuk menentukan runtime kontainer. Catatan penting: Jika parameter ini ditentukan, Asisten Cloud menjalankan skrip di dalam Kontainer yang ditentukan pada Instans. Jika parameter ini ditentukan, perintah hanya dapat Berjalan pada Instans Linux dengan Agen Asisten Cloud versi 2.2.3.344 atau yang lebih baru. Jika parameter ini ditentukan, parameter `Username` dan `WorkingDir` tidak berlaku. Perintah hanya Berjalan sebagai pengguna Kontainer default di direktori kerja default Kontainer. Untuk informasi lebih lanjut, lihat Asisten Cloud untuk menjalankan perintah di dalam Kontainer. Catatan Hanya skrip Shell yang didukung di dalam Kontainer Linux. Anda tidak dapat menggunakan format seperti `#!/usr/bin/python` di awal skrip untuk menentukan interpreter. Untuk informasi lebih lanjut, lihat Asisten Cloud untuk menjalankan perintah di dalam Kontainer.	ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****
ContainerName	string	No	Nama kontainer. Catatan penting: Jika parameter ini ditentukan, Cloud Assistant menjalankan skrip di dalam kontainer yang ditentukan pada instans. Jika parameter ini ditentukan, perintah hanya dapat berjalan pada instans Linux dengan Cloud Assistant Agent versi 2.2.3.344 atau yang lebih baru. Jika parameter ini ditentukan, parameter `Username` dan `WorkingDir` tidak berlaku. Perintah hanya berjalan sebagai pengguna kontainer default di direktori kerja default kontainer. Untuk informasi lebih lanjut, lihat Asisten Cloud Assistant untuk menjalankan perintah di dalam kontainer. Catatan Hanya skrip Shell yang didukung di dalam kontainer Linux. Anda tidak dapat menggunakan format seperti `#!/usr/bin/python` di awal skrip untuk menentukan interpreter. Untuk informasi lebih lanjut, lihat Asisten Cloud Assistant untuk menjalankan perintah di dalam kontainer.	test-Kontainer
ClientToken	string	No	Token Klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan Klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. ClientToken hanya dapat berisi karakter ASCII dan tidak boleh melebihi panjang 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 yang memiliki tag yang sama tanpa menentukan InstanceId.
	object	No	Tag yang digunakan untuk memfilter instans. Anda dapat menjalankan perintah secara batch pada instans yang memiliki tag yang sama tanpa menentukan InstanceId.
Key	string	No	Kunci tag yang digunakan untuk memfilter Instans. Catatan penting: Parameter ini bertentangan dengan parameter InstanceId. Anda tidak dapat menentukan kedua parameter secara bersamaan. Jika nilai ini ditentukan, nilai tersebut tidak boleh berupa string kosong. Jumlah Instans di bawah tag tidak boleh melebihi batas InstanceId.N. Jika jumlah Instans melebihi batas, kendalikan jumlah Instans dengan menambahkan tag Batch, seperti batch: b1. Kunci tag dapat memiliki panjang hingga 64 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.	TestKey
Value	string	No	Nilai tag yang digunakan untuk memfilter instans. Catatan penting: Nilai dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh mengandung http:// atau https://.	TestValue
TerminationMode	string	No	Mode untuk menghentikan Tugas (penghentian manual atau interupsi pengatur waktu). Nilai valid: Process: Menghentikan proses skrip saat ini. ProcessTree: Menghentikan pohon proses saat ini (kumpulan proses skrip dan semua proses turunan yang dibuatnya).	ProcessTree
Launcher	string	No	Program bootstrap untuk eksekusi skrip. Nilai tidak boleh melebihi panjang 1 KB.	python3 -u {{ACS::ScriptFileName\|Ext(".py")}}

Elemen respons

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	Pemanggilan API tidak didukung di wilayah tertentu. Periksa apakah nilai parameter RegionId benar.
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 melebihi batas maksimum. Anda dapat menentukan hingga 20 tag untuk operasi ini.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Parameter nilai tag yang ditentukan tidak valid.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Terdapat kunci duplikat dalam tag. Pastikan semua kunci unik.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Parameter kunci tag yang ditentukan tidak valid.
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 idempoten yang ditentukan tidak valid.
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.	Nilai parameter CommandContent tertentu tidak dapat didekode Base64. Periksa apakah nilai parameter benar.
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 diteruskan 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.	Jangan meneruskan parameter kustom ketika fitur parameter kustom dari perintah dinonaktifkan.
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	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
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.	Konten perintah Anda terlalu panjang. Sederhanakan konten perintah Anda.
403	CmdName.ExceedLimit	The length of the command name exceeds the upper limit.	Panjang nama perintah melebihi batas maksimum.
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.	Nama parameter kustom Anda melebihi batas panjang.
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 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 melebihi batas maksimum yang diizinkan.
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.	Operasi tidak diizinkan.
403	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	Parameter permintaan tidak cocok dengan permintaan yang memiliki ClientToken yang sama.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Permintaan idempoten sebelumnya masih 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 berisi karakter yang tidak valid.
403	InvalidParameterCharacter.CommandDescription	The command Description contains illegal characters.	Deskripsi perintah berisi karakter yang tidak valid.
403	InvalidParameterCharacter.CommandWorkingDir	The command WorkingDir contains illegal characters.	Jalur eksekusi perintah berisi 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.
403	InvalidParameterCharset.Parameters	The parameter Parameters contains illegal charset.	Parameter command berisi 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 terkait layanan.
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.	Mode eksekusi perintah yang ditentukan tidak ada.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	RegionId yang ditentukan tidak ada. Periksa apakah produk tersedia di wilayah ini.
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 tertentu tidak valid. Periksa apakah nilai parameter benar. Anda dapat memanggil DescribeCommands untuk mengkueri semua nilai CommandId yang tersedia.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya tidak ditemukan dalam catatan.
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.