ModifyInvocationAttribute - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengubah informasi eksekusi Tugas terjadwal Asisten Cloud, termasuk konten perintah, mode eksekusi terjadwal, dan penambahan Instance ECS atau Instans terkelola ke Tugas.

Deskripsi operasi

Anda dapat mengubah Tugas dengan mode eksekusi berikut (lihat nilai RepeatMode yang dikembalikan oleh DescribeInvocations):
- Periode: eksekusi berkala.
- NextRebootOnly: secara otomatis mengeksekusi perintah saat Instans dimulai berikutnya.
- EveryReboot: secara otomatis mengeksekusi perintah setiap kali Instans dimulai.
Anda dapat mengubah Tugas dalam status berikut (lihat nilai InvocationStatus yang dikembalikan oleh DescribeInvocations):
- Pending: Sistem sedang memverifikasi atau mengirim perintah. Jika status eksekusi perintah pada setidaknya satu Instans adalah Pending, status eksekusi keseluruhan adalah Pending.
- Berjalan: Perintah sedang Berjalan pada Instans. Jika status eksekusi perintah pada setidaknya satu Instans adalah Berjalan, status eksekusi keseluruhan adalah Berjalan.
- Scheduled: Perintah terjadwal telah dikirim dan menunggu untuk dijalankan. Jika status eksekusi perintah pada setidaknya satu Instans adalah Scheduled, status eksekusi keseluruhan adalah Scheduled.
- Stopping: Tugas sedang dihentikan. Jika status eksekusi perintah pada setidaknya satu Instans adalah Stopping, status eksekusi keseluruhan adalah Stopping.
Sebelum mengubah informasi eksekusi Tugas terjadwal (termasuk konten perintah, parameter kustom, dan frekuensi eksekusi), versi Agen Asisten Cloud pada Instance ECS atau Instans terkelola yang telah mengeksekusi Tugas harus lebih baru dari versi berikut:
- Linux: 2.2.3.541
- Windows: 2.1.3.541
- Jika hasil pemanggilan mengembalikan kode kesalahan InvalidOperation.CloudAssistantVersionUnsupported, perbarui Agen Asisten Cloud ke versi terbaru.
Saat Anda mengeksekusi perintah umum Asisten Cloud, Anda tidak dapat mengubah konten perintah CommandContent.
Saat Anda mengubah konten perintah CommandContent, dan Tugas dibuat dengan memanggil InvokeCommand atau RunCommand dengan KeepCommand diatur ke true, perintah baru akan dibuat dan disimpan secara permanen, yang akan mengurangi Kuota perintah Asisten Cloud Anda. Anda dapat menyimpan hingga 500 hingga 50.000 perintah Asisten Cloud di satu Wilayah. Anda juga dapat meminta peningkatan Kuota. Untuk informasi tentang cara mengkueri dan meningkatkan Kuota, lihat Manajemen Kuota.

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:ModifyInvocationAttribute

update

*Invocation.

acs:ecs:{#regionId}:{#accountId}:invocation/{#invocationId}

Instance.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah.	cn-hangzhou
InstanceId	array	No	ID instance ECS atau instans terkelola yang akan ditambahkan ke tugas.
	string	No	ID instance ECS atau instans terkelola yang akan ditambahkan ke tugas. Jumlah total instance yang ditambahkan dan instance yang telah mengeksekusi tugas tidak boleh melebihi 100.	i-bp1i7gg30r52z2em****
InvokeId	string	Yes	ID eksekusi tugas yang akan diubah.	t-hz0jdfwd9f****
CommandContent	string	No	Konten perintah yang dimodifikasi. Konten perintah dapat berupa teks biasa atau dienkode Base64. Perhatikan hal-hal berikut: Ukuran konten perintah setelah pengkodean Base64 tidak boleh melebihi 24 KB. Jika konten perintah dienkode Base64, atur `ContentEncoding=Base64`. Atur `EnableParameter=true` untuk mengaktifkan fitur parameter kustom dalam konten perintah: Tentukan parameter kustom dengan mengapitnya dalam `{{}}`. Spasi dan baris baru sebelum dan sesudah nama parameter dalam `{{}}` akan diabaikan. Jumlah parameter kustom tidak boleh melebihi 20. Nama parameter kustom hanya dapat berisi a-z, A-Z, 0-9, tanda hubung (-), dan garis bawah (_). 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 dieksekusi, Asisten Cloud secara otomatis menggantinya dengan nilai yang sesuai di lingkungan tanpa penugasan manual. 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, untuk menggunakan `{{ACS::InstanceId}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari versi berikut: Linux: 2.2.3.309 Windows: 2.1.3.309 `{{ACS::InstanceName}}`: Nama Instans. Saat perintah dikirim ke beberapa Instans, untuk menggunakan `{{ACS::InstanceName}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari versi berikut: Linux: 2.2.3.344 Windows: 2.1.3.344 `{{ACS::InvokeId}}`: ID eksekusi perintah. Untuk menggunakan `{{ACS::InvokeId}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari versi berikut: Linux: 2.2.3.309 Windows: 2.1.3.309 `{{ACS::CommandId}}`: ID perintah. Saat Anda memanggil operasi ini untuk mengeksekusi perintah, untuk menggunakan `{{ACS::CommandId}}` sebagai parameter lingkungan bawaan, pastikan versi Agen Asisten Cloud tidak lebih lama dari versi berikut: Linux: 2.2.3.309 Windows: 2.1.3.309	ZWNobyAxMjM=
EnableParameter	boolean	No	Apakah perintah berisi parameter kustom. Saat Anda mengaktifkan parameter kustom atau mengubah parameter kustom Parameters, atur parameter ini ke `true`. Saat Anda tidak mengubah parameter kustom Parameters, jangan atur parameter ini atau atur ke `false`.	false
Parameters	object	No	Pasangan kunci-nilai parameter kustom yang akan dimodifikasi saat perintah berisi parameter kustom. Jumlah parameter kustom berkisar dari 0 hingga 10. Perhatikan hal-hal 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 konten perintah tidak boleh melebihi 24 KB. Himpunan nama parameter kustom harus merupakan subset dari himpunan parameter yang ditentukan saat perintah dibuat. Untuk parameter yang tidak diteruskan, Anda dapat menggunakan string kosong sebagai pengganti. Nilai default: kosong, yang menunjukkan bahwa tidak ada pasangan kunci-nilai parameter kustom yang dimodifikasi.	{"name":"Jack", "accessKey":"LTAI*************"}
Frequency	string	No	Frekuensi eksekusi terjadwal yang dimodifikasi. Parameter ini hanya berlaku saat RepeatMode diatur ke Periode. Tiga jenis eksekusi terjadwal 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 dieksekusi pada interval yang ditentukan. Interval dapat ditentukan dalam detik (s), menit (m), jam (h), atau hari (d). Ini berlaku untuk skenario di mana Tugas dieksekusi pada interval tetap. format: `laju(<nilai interval><unit interval>)`. Misalnya, untuk mengeksekusi setiap 5 menit, gunakan `laju(5m)`. Batasan berikut berlaku untuk eksekusi pada interval tetap: Interval tidak boleh melebihi 7 hari atau kurang dari 60 detik, dan harus lebih besar dari periode waktu tunggu yang ditentukan saat Tugas terjadwal dibuat. Interval eksekusi didasarkan pada frekuensi tetap dan tidak terkait dengan waktu eksekusi aktual Tugas. Misalnya, jika perintah diatur untuk dieksekusi setiap 5 menit dan Tugas membutuhkan waktu 2 menit untuk selesai, putaran eksekusi berikutnya dimulai 3 menit setelah Tugas selesai. Waktu eksekusi berikutnya dihitung berdasarkan waktu pembuatan Tugas (lihat CreationTime yang dikembalikan oleh `DescribeInvocations`, perhatikan bahwa ini bukan waktu modifikasi) dan interval eksekusi yang dimodifikasi. Eksekusi satu kali pada pengatur waktu tertentu: Perintah dieksekusi satu kali pada zona pengatur waktu dan pengatur waktu yang ditentukan. format: `at(yyyy-MM-dd HH:mm:ss <zona pengatur waktu>)`, yaitu `at(tahun-bulan-hari jam:menit:detik <zona pengatur waktu>)`. Jika tidak ada zona pengatur waktu yang ditentukan, UTC digunakan secara default. Zona pengatur waktu mendukung tiga format berikut: Nama zona pengatur waktu lengkap: seperti `Asia/Shanghai` (pengatur waktu Shanghai/Tiongkok) dan `America/Los_Angeles` (pengatur waktu Los Angeles/AS). Offset zona pengatur waktu dari Greenwich Mean Time: seperti `GMT+8:00` (UTC+8) dan `GMT-7:00` (UTC-7). Saat menggunakan format GMT, nol di depan tidak didukung untuk nilai jam. Singkatan zona pengatur waktu: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk mengeksekusi satu kali pada pukul 13:15:30 tanggal 6 Juni 2022 dalam pengatur waktu Shanghai/Tiongkok, gunakan: `at(2022-06-06 13:15:30 Asia/Shanghai)`. Untuk mengeksekusi 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 dieksekusi sesuai dengan pengaturan Tugas terjadwal. format: `<detik> <menit> <jam> <hari dalam bulan> <bulan> <hari dalam minggu> <tahun (opsional)> <zona pengatur waktu>`, yaitu `<Ekspresi cron> <zona pengatur waktu>`. Waktu eksekusi Tugas terjadwal dihitung berdasarkan Ekspresi cron di zona pengatur waktu yang ditentukan. Jika tidak ada zona pengatur waktu yang ditentukan, zona pengatur waktu internal sistem dari Instans yang Berjalan Tugas terjadwal digunakan secara default. Untuk informasi lebih lanjut tentang Ekspresi cron, lihat Ekspresi cron. Zona pengatur waktu mendukung tiga format berikut: Nama zona pengatur waktu lengkap: seperti `Asia/Shanghai` (pengatur waktu Shanghai/Tiongkok) dan `America/Los_Angeles` (pengatur waktu Los Angeles/AS). Offset zona pengatur waktu dari Greenwich Mean Time: seperti `GMT+8:00` (UTC+8) dan `GMT-7:00` (UTC-7). Saat menggunakan format GMT, nol di depan tidak didukung untuk nilai jam. Singkatan zona pengatur waktu: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk mengeksekusi satu kali pada pukul 10:15 setiap hari pada tahun 2022 dalam pengatur waktu Shanghai/Tiongkok, gunakan `0 15 10 ? * * 2022 Asia/Shanghai`. Untuk mengeksekusi setiap 30 menit dari pukul 10:00 hingga 11:30 setiap hari pada tahun 2022 dalam UTC+8, gunakan `0 0/30 10-11 * * ? 2022 GMT+8:00`. Untuk mengeksekusi setiap 5 menit dari pukul 14:00 hingga 14:55 setiap hari pada bulan Oktober setiap dua tahun mulai dari tahun 2022 dalam UTC, gunakan `0 0/5 14 * 10 ? 2022/2 UTC`. Catatan Interval minimum harus lebih besar dari atau sama dengan periode waktu tunggu yang ditentukan saat Tugas terjadwal dibuat, dan harus setidaknya 10 detik.	0 /20 * * *
ContentEncoding	string	No	Tipe pengkodean konten perintah (CommandContent). Nilai valid (tidak peka huruf besar-kecil): PlainText: Tanpa pengkodean. Konten ditransmisikan dalam teks biasa. Base64: Pengkodean Base64. Nilai default: PlainText. Jika nilai tidak valid ditentukan, nilai tersebut diperlakukan sebagai PlainText.	PlainText
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 panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000

Elemen respons

Element	Type	Description	Example
	object
CommandId	string	ID perintah. Perintah baru dibuat dan CommandId baru dikembalikan hanya saat CommandContent diubah. Saat CommandContent tidak diubah, tidak ada perintah baru yang dibuat, dan CommandId dari perintah yang sedang dieksekusi dikembalikan. Jika Anda memanggil InvokeCommand, atau memanggil RunCommand dengan KeepCommand diatur ke `true`, perintah baru akan disimpan. Jika tidak, saat eksekusi selesai atau tugas dihentikan secara manual, semua perintah yang terkait dengan tugas akan dihapus.	c-hz01272yr52****
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Contoh

Respons sukses

JSONformat

{
  "CommandId": "c-hz01272yr52****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameter.Frequency	The specified parameter Frequency is not valid.	Parameter Frequency yang ditentukan tidak valid.
400	InvalidParameters.KeyDuplicate	The key in the parameter Parameters cannot be duplicated.	Kunci dalam parameter Parameters tidak boleh duplikat.
400	InvalidParameters.KeyNotMatch	The key in the parameter Parameters do not match those defined when creating the command.	Kunci dalam parameter Parameters tidak cocok dengan kunci yang didefinisikan saat perintah dibuat.
400	InvalidParameters.KeyMalformed	The key in the parameter Parameters is not valid.	Kunci dalam parameter Parameters tidak valid.
400	InvalidParameters.KeyEmpty	The key in the parameter Parameters cannot be empty.	Kunci dalam parameter Parameters tidak boleh kosong.
400	InvalidCommandContent.DecodeError	The specified parameter CommandContent can not be Base64 decoded.	Parameter CommandContent tidak dapat didekode dengan Base64.
400	InvalidClientToken.Malformed	The specified parameter clientToken is not valid.	Parameter idempoten yang ditentukan tidak valid.
500	InternalError	An error occurred when you dispatched the request.	Terjadi error internal. Coba lagi.
403	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
403	InvalidInstanceId.OSTypeUnsupported	The OS type of the instance corresponding to the parameter InstanceId does not support the specified command type.	Tipe sistem operasi dari instans yang ditentukan oleh parameter InstanceId tidak mendukung tipe perintah yang ditentukan.
403	InvalidOperation.RepeatModeUnsupported	The operation is not supported for current repeat mode of invocation.	Metode eksekusi perintah saat ini tidak mendukung operasi ini.
403	InvalidOperation.InvokeAlreadyFinished	The operation is not supported for finished invocation.	Operasi ini tidak didukung untuk tugas yang telah selesai.
403	InvalidOperation.CloudAssistantVersionUnsupported	The operation is not supported for current CloudAssistant version of instance.	Versi Asisten Cloud pada instans saat ini tidak mendukung operasi ini.
403	InvalidOperation.ModifyPublicCommandUnsupported	Modification of the content of Public Command is not supported.	Mengubah konten perintah publik tidak didukung.
403	InvalidCommandContent.LengthLimitExceeded	The length of the parameter CommandContent exceeds the limit of %s KB characters.
403	Operation.Forbidden	The operation is not permitted.	Operasi tidak diizinkan.
403	InvalidParameters.CountLimitExceeded	The count of the parameter Parameters exceeds the limit of 10.	Jumlah kunci dalam parameter Parameters melebihi batas 10.
403	InvalidParameters.KeyLengthLimitExceeded	The length of the key in the parameter Parameters exceeds the limit of 64 characters.	Panjang kunci dalam parameter Parameters melebihi batas 64 karakter.
403	InvalidInstanceId.CountLimitExceeded	The count of the parameter InstanceId exceeds the limit of %s.
403	CommandLimitExceeded	The count of command in current region exceeds the limit of %s.
403	InvalidParameters.ValueTypeUnsupported	The type of the value in the parameter Parameters is not supported.	Tipe nilai dalam parameter Parameters tidak didukung.
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.
404	InvalidInvokeId.NotFound	The specified parameter InvokeId does not exist.	Parameter InvokeId yang ditentukan tidak ada. Pastikan parameter tersebut benar.
404	InvalidInstanceId.NotFound	The specified parameter InstanceId does not exist.	Instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.
404	InvalidRegionId.NotFound	The specified parameter RegionId does not exist.	RegionId yang ditentukan tidak ada. Periksa apakah produk tersedia di wilayah ini.
404	InvalidCommandId.NotFound	The specified CommandId does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.