ModifyInvocationAttribute - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengubah informasi eksekusi Tugas terjadwal Asisten Cloud, termasuk konten perintah, metode eksekusi terjadwal, dan penambahan Instance ECS atau instans terkelola ke dalam tugas.

Deskripsi operasi

Anda dapat mengubah tugas dengan mode eksekusi berikut (lihat nilai RepeatMode yang dikembalikan oleh DescribeInvocations):
- Period: eksekusi berkala.
- NextRebootOnly: secara otomatis mengeksekusi perintah saat Instance dimulai berikutnya.
- EveryReboot: secara otomatis mengeksekusi perintah setiap kali Instance 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 Instance adalah Pending, status eksekusi keseluruhan adalah Pending.
- Running: Perintah sedang berjalan di Instance. Jika status eksekusi perintah pada setidaknya satu Instance adalah Running, status eksekusi keseluruhan adalah Running.
- Scheduled: Perintah terjadwal telah dikirim dan menunggu untuk dijalankan. Jika status eksekusi perintah pada setidaknya satu Instance adalah Scheduled, status eksekusi keseluruhan adalah Scheduled.
- Stopping: Tugas sedang dihentikan. Jika status eksekusi perintah pada setidaknya satu Instance 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 menjalankan tugas harus lebih baru dari versi berikut:
- Linux: 2.2.3.541
- Windows: 2.1.3.541
- Jika hasil panggilan 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, sebuah perintah baru dibuat untuk penyimpanan jangka panjang, yang dihitung terhadap 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 mencari 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 dari instance ECS atau instans terkelola yang akan ditambahkan ke tugas.
	string	No	ID instance dari instance ECS atau instans terkelola yang akan ditambahkan ke tugas. Jumlah total instance yang ditambahkan dan instance yang telah menjalankan tugas tidak boleh melebihi 100.	i-bp1i7gg30r52z2em****
InvokeId	string	Yes	ID eksekusi perintah dari 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 pengodean Base64 tidak boleh melebihi 24 KB. Jika konten perintah Anda dienkode Base64, Anda harus mengatur `ContentEncoding=Base64`. Anda dapat mengaktifkan fitur parameter kustom dalam konten perintah dengan menentukan `EnableParameter=true`: Tentukan parameter kustom dengan melampirkannya dalam `{{}}`. Spasi dan baris baru sebelum dan sesudah nama parameter dalam `{{}}` diabaikan. Jumlah parameter kustom tidak boleh melebihi 20. Nama parameter kustom dapat berisi karakter 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. Satu nama parameter kustom tidak boleh melebihi 64 byte. Anda dapat menentukan parameter lingkungan bawaan sebagai parameter kustom. Saat perintah dieksekusi, Anda tidak perlu secara manual menetapkan nilai ke parameter. Asisten Cloud secara otomatis menggantinya dengan nilai yang sesuai di lingkungan. Parameter lingkungan bawaan berikut didukung: `{{ACS::RegionId}}`: ID wilayah. `{{ACS::AccountId}}`: ID akun Alibaba Cloud. `{{ACS::InstanceId}}`: ID Instance. Saat perintah dikirim ke beberapa Instance, untuk menentukan `{{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 Instance. Saat perintah dikirim ke beberapa Instance, untuk menentukan `{{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 menentukan `{{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 menentukan `{{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 akan menyertakan parameter kustom dalam perintah yang dimodifikasi. 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 dari 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 didefinisikan 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 jika `RepeatMode` diatur ke `Period`. Tiga jenis eksekusi terjadwal didukung: eksekusi interval tetap (berdasarkan ekspresi Rate), eksekusi satu kali pada waktu tertentu, dan eksekusi terjadwal berbasis jam (berdasarkan ekspresi Cron). Eksekusi interval tetap: Berdasarkan ekspresi Rate, perintah dieksekusi pada interval waktu yang ditentukan. Interval waktu dapat ditentukan dalam detik (s), menit (m), jam (h), atau hari (d). Ini berlaku untuk skenario di mana tugas dieksekusi pada interval tetap. Format: `rate(<nilai interval><satuan interval>)`. Misalnya, untuk mengeksekusi setiap 5 menit, gunakan `rate(5m)`. Eksekusi interval tetap memiliki batasan berikut: Interval waktu tidak boleh melebihi 7 hari atau kurang dari 60 detik, dan harus lebih besar dari periode waktu habis yang ditentukan saat Tugas terjadwal dibuat. Interval eksekusi hanya didasarkan pada laju tetap dan tidak terkait dengan waktu aktual yang diperlukan untuk eksekusi tugas. Misalnya, jika perintah diatur untuk dieksekusi setiap 5 menit dan tugas membutuhkan 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 waktu tertentu: Perintah dieksekusi sekali pada zona waktu dan titik waktu yang ditentukan. Format: `at(tttt-BB-hh JJ:mm:dd <zona waktu>)`, yaitu `at(tahun-bulan-hari jam:menit:detik <zona waktu>)`. Jika tidak ada zona waktu yang ditentukan, defaultnya adalah UTC. 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 waktu Timur 8) atau `GMT-7:00` (zona waktu Barat 7). Saat menggunakan format GMT, nol di depan tidak didukung untuk nilai jam. Singkatan zona waktu: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk mengeksekusi 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 mengeksekusi sekali pada pukul 13:15:30 tanggal 6 Juni 2022 di zona waktu Barat 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 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, defaultnya adalah zona waktu sistem internal dari Instance yang menjalankan Tugas terjadwal. 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 waktu Timur 8) atau `GMT-7:00` (zona waktu Barat 7). Saat menggunakan format GMT, nol di depan tidak didukung untuk nilai jam. Singkatan zona waktu: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk mengeksekusi sekali setiap hari pada pukul 10:15 pagi dalam waktu China/Shanghai pada tahun 2022, gunakan `0 15 10 ? * * 2022 Asia/Shanghai`. Untuk mengeksekusi setiap setengah jam dari pukul 10:00 pagi hingga 11:30 pagi setiap hari pada tahun 2022 di zona waktu Timur 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 di bulan Oktober setiap dua tahun mulai dari 2022 dalam UTC, gunakan `0 0/5 14 * 10 ? 2022/2 UTC`. Catatan Interval waktu minimum harus lebih besar atau sama dengan periode waktu habis yang ditentukan saat Tugas terjadwal dibuat, dan tidak boleh kurang dari 10 detik.	0 /20 * * *
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, itu 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 berbagai permintaan. Nilai 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
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
CommandId	string	ID perintah. Perintah baru dibuat dan `CommandId` baru dikembalikan hanya jika `CommandContent` diubah. Jika `CommandContent` tidak diubah, tidak ada perintah baru yang dibuat, dan `CommandId` dari perintah yang sedang dieksekusi saat ini dikembalikan. Jika Anda memanggil InvokeCommand, atau memanggil RunCommand dengan `KeepCommand` diatur ke `true`, perintah baru dipertahankan. Jika tidak, saat eksekusi selesai atau tugas dihentikan secara manual, semua perintah yang terkait dengan tugas dihapus.	c-hz01272yr52****

Contoh

Respons sukses

JSONformat

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

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 menggunakan Base64.
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.
500	InternalError	An error occurred when you dispatched the request.	Terjadi kesalahan saat mengirim permintaan. Coba lagi nanti.
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 InstanceId tidak mendukung operasi ini.
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.	Pengguna RAM saat ini tidak memiliki izin untuk melakukan operasi ini.
403	InvalidParameters.CountLimitExceeded	The count of the parameter Parameters exceeds the limit of 10.	Jumlah entri 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.	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.
404	InvalidInvokeId.NotFound	The specified parameter InvokeId does not exist.	ID pemanggilan perintah yang ditentukan tidak ada.
404	InvalidInstanceId.NotFound	The specified parameter InstanceId does not exist.	ID instans yang ditentukan tidak valid.
404	InvalidRegionId.NotFound	The specified parameter RegionId does not exist.	Informasi wilayah tidak valid.
404	InvalidCommandId.NotFound	The specified CommandId does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.