Elastic Compute Service:ModifyInvocationAttribute

ID wilayah.

The region ID.

ID eksekusi perintah dalam tugas yang akan diubah.

Konten perintah yang telah diubah. Konten perintah dapat berupa teks biasa atau konten yang dienkode Base64. Perhatikan hal-hal berikut:

• Jika Anda memilih untuk menyimpan perintah saat membuat tugas yang akan diubah, ukuran konten perintah yang dienkode Base64 tidak boleh melebihi 18 KB. Jika Anda memilih untuk tidak menyimpan perintah, ukuran konten perintah yang dienkode Base64 tidak boleh melebihi 24 KB.

• Jika konten perintah dienkode Base64, Anda harus mengatur ContentEncoding=Base64.

• Atur EnableParameter=true untuk mengaktifkan fitur parameter kustom dalam konten perintah:

  • Parameter kustom didefinisikan menggunakan {{}}. Di dalam {{}}, spasi dan baris baru sebelum dan sesudah nama parameter akan diabaikan.

  • Jumlah parameter kustom tidak boleh melebihi 20.

  • Nama parameter kustom mengizinkan kombinasi a-zA-Z0-9-_. Awalan acs:: tidak didukung untuk menentukan parameter lingkungan non-bawaan. Karakter lain tidak didukung. Nama parameter tidak peka huruf besar/kecil.

  • Ukuran satu nama parameter kustom tidak boleh melebihi 64 byte.

• Anda dapat menentukan parameter lingkungan bawaan sebagai parameter kustom. Kemudian, saat Anda menjalankan perintah, Cloud Assistant secara otomatis mengganti parameter dengan nilai di lingkungan. Anda dapat menentukan parameter lingkungan bawaan berikut:

  • {{ACS::RegionId}}: ID wilayah.

  • {{ACS::AccountId}}: UID akun Alibaba Cloud.

  • {{ACS::InstanceId}}: ID instans. Saat perintah dijalankan pada beberapa instans, jika Anda ingin menentukan {{ACS::InstanceId}} sebagai parameter lingkungan bawaan, Asisten Cloud Assistant Agent tidak lebih lama dari versi berikut:

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309

  • {{ACS::InstanceName}}: nama instans. Saat perintah dijalankan pada beberapa instans, jika Anda ingin menentukan {{ACS::InstanceName}} sebagai parameter lingkungan bawaan, Asisten Cloud Assistant Agent tidak lebih lama dari versi berikut:

    • Linux: 2.2.3.344

    • Windows: 2.1.3.344

  • {{ACS::InvokeId}}: ID eksekusi perintah. Jika Anda ingin menentukan {{ACS::InvokeId}} sebagai parameter lingkungan bawaan, Asisten Cloud Assistant Agent 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 menjalankan perintah, jika Anda ingin menentukan {{ACS::CommandId}} sebagai parameter lingkungan bawaan, Asisten Cloud Assistant Agent tidak lebih lama dari versi berikut:

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309.

Apakah perintah yang diubah berisi parameter kustom.

• Saat Anda mengaktifkan fitur parameter kustom atau mengubah parameter kustom Parameters, parameter ini harus diatur ke true.

• Saat Anda tidak mengubah parameter kustom Parameters, jangan atur parameter ini, atau atur parameter ini ke false.

Pasangan kunci-nilai dari parameter kustom yang diteruskan saat perintah yang berisi parameter kustom dijalankan.

Jumlah parameter kustom berkisar dari 0 hingga 10. Perhatikan hal-hal berikut:

• Kunci tidak boleh berupa string kosong dan panjangnya dapat mencapai 64 karakter.

• Nilai dapat berupa string kosong.

• Setelah parameter kustom dan konten perintah asli dienkode Base64, jika Anda memilih untuk menyimpan perintah saat membuat tugas yang akan diubah, ukuran konten perintah yang dienkode Base64 tidak boleh melebihi 18 KB. Jika Anda memilih untuk tidak menyimpan perintah, ukuran konten perintah yang dienkode Base64 tidak boleh melebihi 24 KB.

• Himpunan nama parameter kustom yang Anda tentukan harus merupakan subset dari himpunan parameter yang didefinisikan saat Anda membuat perintah. Anda dapat menggunakan string kosong untuk merepresentasikan parameter yang tidak diteruskan.

Nilai default kosong, yang menunjukkan bahwa tidak ada pasangan kunci-nilai parameter kustom yang diubah.

Jadwal yang telah diubah tempat perintah dijalankan. Parameter ini hanya berlaku ketika RepeatMode diatur ke Periode. Saat ini didukung tiga jenis jadwal: eksekusi interval tetap (berdasarkan ekspresi laju), eksekusi satu kali pada waktu tertentu, dan eksekusi terjadwal berbasis jam (berdasarkan Ekspresi cron).

• Eksekusi interval tetap: berdasarkan ekspresi laju. Perintah dijalankan pada interval yang ditentukan. Interval dapat ditentukan dalam detik (s), menit (m), jam (h), dan hari (d). Opsi ini cocok untuk skenario di mana tugas perlu dilakukan pada interval tetap. Formatnya adalah rate(<nilai interval eksekusi><unit interval eksekusi>). Misalnya, rate(5m) menunjukkan bahwa perintah dijalankan setiap 5 menit. Batasan berikut berlaku untuk eksekusi interval tetap:

  • Interval tidak boleh kurang dari 60 detik dan tidak lebih dari 7 hari, serta harus lebih besar dari periode yang ditentukan saat Tugas terjadwal dibuat.

  • Interval hanya didasarkan pada frekuensi tetap, dan tidak bergantung pada waktu eksekusi aktual tugas. Misalnya, jika perintah diatur untuk dijalankan setiap 5 menit dan tugas membutuhkan waktu 2 menit untuk selesai, putaran tugas berikutnya akan dijalankan 3 menit setelah tugas selesai.

  • Waktu eksekusi berikutnya dihitung berdasarkan waktu pembuatan tugas (lihat CreationTime yang dikembalikan oleh DescribeInvocations. Perhatikan bahwa ini bukan waktu pengubahan) dan interval eksekusi yang telah diubah.

• Eksekusi satu kali pada waktu tertentu: Perintah hanya dijalankan satu kali pada waktu dan zona yang ditentukan. Formatnya adalah at(yyyy-MM-dd HH:mm:ss <zona>), yaitu at(tahun-bulan-hari jam:menit:detik <zona>). Jika tidak ada zona yang ditentukan, zona default adalah UTC. Tiga format zona berikut didukung:

  • Nama zona lengkap: seperti Asia/Shanghai (waktu China/Shanghai), America/Los_Angeles (waktu America/Los Angeles), dan lainnya.

  • Offset dari Greenwich Mean Time: seperti GMT+8:00 (UTC+8) dan GMT-7:00 (UTC-7). Angka nol di depan tidak didukung pada digit jam saat format GMT digunakan.

  • 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, formatnya adalah 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, formatnya adalah at(2022-06-06 13:15:30 GMT-7:00).

• Eksekusi terjadwal berbasis jam (berdasarkan Ekspresi cron): berdasarkan Ekspresi cron. Perintah dijalankan pada jadwal yang ditentukan. Formatnya adalah <detik> <menit> <jam> <hari> <bulan> <hari dalam minggu> <tahun (opsional)> <zona>, yaitu <Ekspresi cron> <zona>. Dalam zona yang ditentukan, sistem menghitung waktu eksekusi Tugas terjadwal berdasarkan Ekspresi cron dan menjalankan tugas. Jika tidak ada zona yang ditentukan, zona default adalah zona sistem internal Instans tempat Tugas terjadwal dijalankan. Untuk informasi lebih lanjut tentang Ekspresi cron, lihat Cron expression. Tiga format zona berikut didukung:

  • Nama zona lengkap: seperti Asia/Shanghai (waktu China/Shanghai), America/Los_Angeles (waktu America/Los Angeles), dan lainnya.

  • Offset dari Greenwich Mean Time: seperti GMT+8:00 (UTC+8) dan GMT-7:00 (UTC-7). Angka nol di depan tidak didukung pada digit jam saat format GMT digunakan.

  • Singkatan zona: Hanya UTC (Coordinated Universal Time) yang didukung. Misalnya, untuk menjalankan perintah pada pukul 10:15 setiap pagi di tahun 2022 dalam waktu China/Shanghai, formatnya adalah 0 15 10 ? * * 2022 Asia/Shanghai. Untuk menjalankan perintah setiap setengah jam dari pukul 10:00 hingga 11:30 setiap pagi di tahun 2022 dalam waktu UTC+8, formatnya adalah 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 tahun 2022 dalam waktu UTC, formatnya adalah 0 0/5 14 * 10 ? 2022/2 UTC.

  Catatan

  Interval minimum harus lebih besar atau sama dengan periode yang ditentukan saat Tugas terjadwal dibuat, dan tidak kurang dari 10 detik.

Mode pengodean konten perintah (CommandContent). Nilai valid (tidak peka huruf besar/kecil):

• PlainText: Konten perintah tidak dienkode dan ditransmisikan dalam teks biasa.

• Base64: Konten perintah dienkode Base64.

Nilai default: PlainText. Jika nilai tidak valid, PlainText digunakan secara default.

Token klien yang digunakan untuk memastikan permintaan idempoten. Anda dapat menggunakan Klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya mendukung karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat How to ensure idempotence.