Menjalankan perintah Asisten Cloud pada satu atau beberapa Instans ECS dengan menentukan parameter seperti CommandId, InstanceId, dan ResourceGroupId.
Deskripsi operasi
Deskripsi operasi
-
Batasan berikut berlaku untuk Instans ECS target. Jika Anda memilih beberapa Instans ECS dan salah satunya tidak memenuhi kondisi eksekusi, Anda harus memanggil operasi ini lagi.
-
Instans target harus dalam status Running. Anda dapat memanggil DescribeInstances untuk mengkueri status instans target.
-
Agen Asisten Cloud harus diinstal pada instans target sebelumnya.
-
Untuk menjalankan perintah PowerShell, instans target harus memiliki modul PowerShell yang dikonfigurasi.
-
-
Eksekusi satu kali: Perintah hanya dieksekusi satu kali.
-
Eksekusi terjadwal:
Perintah dieksekusi sesuai frekuensi yang ditentukan oleh parameter Frequency. Hasil eksekusi sebelumnya tidak memengaruhi eksekusi berikutnya.
Jika Anda menentukan zona saat menjalankan Tugas terjadwal berdasarkan Ekspresi cron, pengatur waktu eksekusi terjadwal akan didasarkan pada zona yang ditentukan. Jika Anda tidak menentukan zona, pengatur waktu eksekusi terjadwal akan didasarkan pada zona sistem Instans ECS. Pastikan pengatur waktu atau zona Instans ECS konsisten dengan pengatur waktu yang Anda harapkan. Untuk informasi selengkapnya tentang zona, lihat Kelola layanan sinkronisasi waktu.
Versi Agen Asisten Cloud harus setidaknya versi berikut untuk mendukung fitur baru 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 nonaktifkan Peningkatan untuk Agen Asisten Cloud untuk melakukan Peningkatan agen ke versi terbaru.
Linux: 2.2.3.282
Windows: 2.1.3.282
-
Perintah mungkin gagal dieksekusi karena status instans tidak normal, pengecualian jaringan, atau pengecualian Agen Asisten Cloud. Tidak ada informasi eksekusi yang dihasilkan saat perintah gagal dieksekusi. Untuk informasi selengkapnya, lihat Kesalahan umum dan solusi untuk kegagalan eksekusi.
-
Jika Anda mengaktifkan fitur parameter kustom saat membuat perintah, Anda harus meneruskan parameter kustom (
Parameters) saat mengeksekusi perintah. -
Panggil DescribeCloudAssistantStatus untuk mengkueri status Asisten Cloud instans target terlebih dahulu. Jalankan perintah hanya ketika CloudAssistantStatus bernilai true, terutama untuk instans yang baru dibeli.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ecs:InvokeCommand |
update |
*Command.
*Instance.
|
|
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 Anda menentukan parameter ini:
|
rg-bp67acfmxazb4p**** |
| CommandId |
string |
Yes |
ID perintah. Anda dapat memanggil DescribeCommands untuk mengkueri semua ID perintah yang tersedia. Catatan
Anda dapat menjalankan perintah publik dengan menentukan nama perintah. Untuk informasi selengkapnya, lihat Lihat dan jalankan perintah publik Asisten Cloud. |
c-e996287206324975b5fbe1d**** |
| RepeatMode |
string |
No |
Menentukan cara perintah dieksekusi. Nilai valid:
Nilai default:
Catatan:
|
Once |
| Timed |
boolean |
No |
Catatan
Parameter ini tidak digunakan lagi dan tidak memiliki efek jika ditentukan. |
true |
| Frequency |
string |
No |
Jadwal eksekusi perintah. Tiga jenis eksekusi terjadwal didukung: interval tetap (berdasarkan ekspresi laju), eksekusi satu kali pada pengatur waktu tertentu, dan penjadwalan berbasis jam (berdasarkan Ekspresi cron).
|
0 */20 * * * ? |
| Parameters |
object |
No |
Pasangan kunci-nilai parameter kustom yang akan diteruskan saat fitur parameter kustom diaktifkan. Jumlah parameter kustom berkisar dari 0 hingga 10.
Anda dapat menghapus pengaturan parameter ini untuk menonaktifkan parameter kustom. |
{"name":"Jack", "accessKey":"LTAI************"} |
| Username |
string |
No |
Nama pengguna yang digunakan untuk mengeksekusi perintah pada Instans ECS. Nilai dapat memiliki panjang hingga 255 karakter.
Anda juga dapat menentukan pengguna lain yang ada pada instans untuk mengeksekusi perintah. Mengeksekusi perintah Asisten Cloud sebagai pengguna biasa lebih aman. Untuk informasi selengkapnya, lihat Konfigurasi pengguna biasa untuk menjalankan perintah Asisten Cloud. |
test |
| WindowsPasswordName |
string |
No |
Nama kata sandi yang digunakan oleh pengguna untuk mengeksekusi perintah pada instans Windows. Nilai dapat memiliki panjang hingga 255 karakter. Jika Anda ingin mengeksekusi perintah sebagai pengguna non-default (System) pada instans Windows, Anda harus menentukan 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 |
Daftar instans tempat perintah akan dieksekusi. Anda dapat menentukan hingga 100 ID instans. Nilai valid N: 1 hingga 100. Anda juga dapat mengajukan peningkatan kuota di Pusat Kuota (nama kuota: Jumlah maksimum instans yang didukung untuk eksekusi perintah). |
i-bp185dy2o3o6n**** |
|
string |
No |
ID instans tempat perintah akan dieksekusi. |
i-bp185dy2o3o6n**** |
|
| ContainerId |
string |
No |
ID Kontainer. Hanya string heksadesimal 64-bit yang didukung. Anda dapat menggunakan awalan Catatan:
|
ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea**** |
| ContainerName |
string |
No |
Nama Kontainer. Catatan:
|
test-Kontainer |
| Timeout |
integer |
No |
Periode waktu tunggu untuk eksekusi perintah. Unit: detik.
|
60 |
| Tag |
array<object> |
No |
Tag. |
|
|
object |
No |
Tag. |
||
| Key |
string |
No |
Kunci tag untuk eksekusi perintah. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Jika Anda menggunakan satu tag untuk memfilter Sumber daya, jumlah Sumber daya dengan tag ini tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah Sumber daya dengan semua tag yang ditentukan terpasang tidak boleh melebihi 1.000. Jika jumlah Sumber daya melebihi 1.000, jalankan operasi ListTagResources untuk mengkueri Sumber daya. Kunci tag dapat memiliki panjang hingga 64 karakter dan tidak boleh diawali dengan |
TestKey |
| Value |
string |
No |
Nilai tag untuk eksekusi perintah. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh mengandung |
TestValue |
| 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. Nilai ClientToken hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi. |
123e4567-e89b-12d3-a456-42665544**** |
| ResourceTag |
array<object> |
No |
Tag yang digunakan untuk memfilter instans. Anda dapat menggunakan tag untuk menjalankan perintah secara batch pada instans dengan tag yang sama tanpa menentukan InstanceId. |
|
|
object |
No |
Tag yang digunakan untuk memfilter instans. Anda dapat menggunakan tag untuk menjalankan perintah secara batch pada instans dengan tag yang sama tanpa menentukan InstanceId. |
||
| Key |
string |
No |
Kunci tag yang digunakan untuk memfilter instans. Catatan:
|
TestKey |
| Value |
string |
No |
Nilai tag yang digunakan untuk memfilter instans. Catatan:
|
TestValue |
| TerminationMode |
string |
No |
Mode penghentian Tugas (dihentikan secara manual atau terganggu karena periode waktu tunggu). Nilai valid:
|
ProcessTree |
| Launcher |
string |
No |
Program bootstrap untuk eksekusi skrip. Nilai tidak boleh melebihi panjang 1 KB. |
python3 -u {{ACS::ScriptFileName|Ext(".py")}} |
| WorkingDir |
string |
No |
Direktori tempat perintah dieksekusi pada Instans ECS. Nilai dapat memiliki panjang hingga 200 karakter.
|
/home/user |
| OssOutputDelivery |
string |
No |
Konfigurasi pengiriman OSS untuk output eksekusi perintah.
|
oss://testBucket/testPrefix |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| InvokeId |
string |
ID eksekusi perintah. |
t-7d2a745b412b4601b2d47f6a768d**** |
| RequestId |
string |
ID permintaan. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
Contoh
Respons sukses
JSONformat
{
"InvokeId": "t-7d2a745b412b4601b2d47f6a768d****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ResourceBusy.SlrCreation | The ServiceLinkedRole is still being created or has not taken effect yet. Please try again later. | |
| 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 | InvalidParameter.WorkingDir | The specified parameter WorkingDir is not valid. | Parameter WorkingDir yang ditentukan tidak valid. |
| 400 | MissingParam.InstanceId | The parameter instanceId is missing or empty. | ID instans kosong. |
| 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 | 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 | Parameter.MissingValue | The parameter value of this command is required. | |
| 400 | Parameter.Disabled | Parameters cannot be passed in when the command customization function is disabled. | |
| 400 | InvalidParameter.Parameters | The specified parameter Parameters is not valid. | Parameter Parameters 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 | 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 maximum number of parameters is exceeded. | Jumlah parameter melebihi batas maksimum yang diizinkan. |
| 403 | ParameterKey.ExceedLimit | The maximum length of a parameter name is exceeded. | Panjang kunci parameter yang ditentukan melebihi panjang maksimum yang diizinkan. |
| 403 | CmdContent.ExceedLimit | The maximum length of a command is exceeded. | Konten perintah Anda terlalu panjang. Sederhanakan konten perintah Anda. |
| 403 | ParameterKey.Duplicate | Parameter names cannot be duplicated. | Nama parameter tidak boleh duplikat. Verifikasi nama dan coba lagi. |
| 403 | Parameter.NotMatched | The passed-in parameters do not match the parameters defined when you created the command. | Parameter kustom yang diteruskan tidak cocok dengan parameter kustom yang didefinisikan saat perintah dibuat. |
| 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 | WindowsPasswordName.Missed | WindowsPasswordName must be specified when you create a Windows task. | Nilai parameter permintaan CommandType (WindowsPasswordName) tidak disediakan. |
| 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 | 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 | 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 | 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.