All Products
Search
Document Center

Elastic Compute Service:DescribeInvocations

Last Updated:Sep 21, 2026

Mengkueri daftar eksekusi dan status perintah Asisten Cloud.

Deskripsi operasi

  • Setelah Anda menjalankan perintah, perintah tersebut tidak selalu berhasil dijalankan atau menghasilkan hasil yang diharapkan. Periksa hasil eksekusi aktual berdasarkan nilai kembalian dari operasi ini. Output aktual yang diutamakan.

  • Anda dapat mengkueri informasi eksekusi dari 30 hari terakhir. Maksimal 10.000 catatan eksekusi disimpan.

  • Anda dapat berlangganan event status Tugas Asisten Cloud untuk mendapatkan hasil Tugas melalui event, menghindari polling yang sering, dan meningkatkan efisiensi.

  • Saat mengkueri halaman pertama dari kueri halaman, atur hanya MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken dalam tanggapan berfungsi sebagai kredensial untuk mengkueri halaman berikutnya. Saat mengkueri halaman berikutnya, atur parameter NextToken ke nilai NextToken yang diperoleh dari tanggapan sebelumnya, dan atur MaxResults untuk membatasi jumlah entri yang dikembalikan.

  • Perbedaan antara DescribeInvocations dan DescribeInvocationResults:

    • Saat satu panggilan RunCommand/InvokeCommand menentukan beberapa instans:
      • DescribeInvocations mengembalikan status eksekusi pada setiap instans dan status agregasi di seluruh instans.

      • DescribeInvocationResults hanya mengembalikan status eksekusi individual pada setiap instans, tanpa status agregasi di beberapa instans.

    • Saat satu panggilan RunCommand/InvokeCommand menentukan satu instans:
      • DescribeInvocations dan DescribeInvocationResults sebagian besar dapat dipertukarkan dan dapat saling menggantikan.

    • Untuk Tampilan riwayat eksekusi Tugas terjadwal (periode) atau Tugas yang dieksekusi secara otomatis saat instans dimulai (RepeatMode=Period, EveryReboot), hanya DescribeInvocationResults yang dapat mengambil catatan eksekusi sebelumnya (dengan menentukan IncludeHistory=true). DescribeInvocations hanya mengembalikan status Tugas terbaru.

    • Untuk Tampilan konten dan parameter perintah, hanya DescribeInvocations yang mengembalikan CommandContent.

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

get

Instance.

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

Command.

acs:ecs:{#regionId}:{#accountId}:command/{#commandId}

None 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. Setelah Anda menentukan parameter ini, Anda juga harus menentukan ResourceGroupId saat perintah Berjalan. Parameter ini memfilter hasil eksekusi perintah yang sesuai.

rg-bp67acfmxazb4p****

InvokeId

string

No

ID eksekusi perintah.

t-hz0jdfwd9f****

CommandId

string

No

ID perintah. Anda dapat memanggil DescribeCommands untuk mengkueri semua ID perintah yang tersedia.

c-hz0jdfwcsr****

CommandName

string

No

Nama perintah. Parameter ini tidak berlaku jika parameter InstanceId juga ditentukan.

CommandTestName

CommandType

string

No

Tipe perintah. Nilai valid:

  • RunBatScript: Skrip Bat yang berjalan pada instans Windows.

  • RunPowerShellScript: Skrip PowerShell yang berjalan pada instans Windows.

  • RunShellScript: Skrip Shell yang berjalan pada instans Linux.

RunShellScript

Timed

boolean

No

Apakah akan menjalankan perintah yang dikueri secara otomatis di masa mendatang. Nilai valid:

  • true: Mengkueri perintah yang parameter RepeatMode-nya diatur ke Period, NextRebootOnly, atau EveryReboot saat RunCommand atau InvokeCommand dipanggil.

  • false: Mengkueri perintah dalam dua status berikut:
    • Perintah yang parameter RepeatMode-nya diatur ke Once saat RunCommand atau InvokeCommand dipanggil.

    • Perintah yang telah dibatalkan, dihentikan, atau diselesaikan.

Nilai default: false.

true

InvokeStatus

string

No

Status eksekusi keseluruhan perintah. Status eksekusi keseluruhan bergantung pada status eksekusi umum dari satu atau beberapa instans dalam eksekusi. Nilai valid:

  • Running:
    • Eksekusi terjadwal: Status eksekusi tetap Running hingga Anda menghentikan perintah terjadwal secara manual.

    • Eksekusi satu kali: Status eksekusi keseluruhan adalah Running selama ada proses perintah yang berjalan.

  • Finished:
    • Eksekusi terjadwal: Proses perintah tidak pernah mencapai status Finished.

    • Eksekusi satu kali: Semua instans telah menyelesaikan eksekusi, atau Anda menghentikan proses perintah pada beberapa instans secara manual sementara instans lainnya menyelesaikan eksekusi.

  • Success: Status eksekusi perintah pada setiap instans adalah Stopped atau Success, dan status eksekusi perintah pada setidaknya satu instans adalah Success. Status eksekusi keseluruhan kemudian menjadi Success.
    • Tugas segera: Eksekusi perintah selesai dan kode keluar adalah 0.

    • Tugas terjadwal: Eksekusi terbaru berhasil dengan kode keluar 0, dan semua waktu eksekusi yang ditentukan telah berlalu.

  • Failed:
    • Eksekusi terjadwal: Proses perintah tidak pernah mencapai status Failed.

    • Eksekusi satu kali: Semua instans gagal mengeksekusi perintah.

  • Stopped: Perintah dihentikan.

  • Stopping: Perintah sedang dihentikan.

  • PartialFailed: Kegagalan parsial. Nilai ini tidak berlaku jika parameter InstanceId juga ditentukan.

  • Pending: Sistem sedang memvalidasi atau mengirim perintah. Status eksekusi keseluruhan adalah Pending jika status eksekusi perintah pada setidaknya satu instans adalah Pending.

  • Scheduled: Perintah terjadwal telah dikirim dan menunggu untuk dijalankan. Status eksekusi keseluruhan adalah Scheduled jika status eksekusi perintah pada setidaknya satu instans adalah Scheduled.

Finished

InstanceId

string

No

ID instans. Jika Anda menentukan parameter ini, semua catatan eksekusi perintah untuk instans akan dikueri.

i-bp1i7gg30r52z2em****

ContentEncoding

string

No

Mode pengodean bidang CommandContent dan Output dalam tanggapan. Nilai valid:

  • PlainText: Mengembalikan konten dan output perintah asli.

  • Base64: Mengembalikan konten dan output perintah yang dikodekan Base64.

Nilai default: Base64.

PlainText

IncludeOutput

boolean

No

Apakah akan mengembalikan output perintah dalam hasil.

  • true: Mengembalikan output. Anda harus menentukan setidaknya parameter InvokeId atau InstanceId.

  • false: Tidak mengembalikan output.

Nilai default: false.

false

PageNumber

integer

No

Catatan

Parameter ini akan segera ditinggalkan. Gunakan NextToken dan MaxResults untuk melakukan operasi kueri halaman.

1

PageSize

integer

No

Catatan

Parameter ini akan segera ditinggalkan. Gunakan NextToken dan MaxResults untuk melakukan operasi kueri halaman.

10

MaxResults

integer

No

Jumlah entri maksimum per halaman untuk kueri halaman.

Nilai maksimum: 50.

Nilai default: 10.

10

NextToken

string

No

Token halaman. Atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.

AAAAAdDWBF2

RepeatMode

string

No

Mode eksekusi perintah. Parameter ini tidak berlaku jika parameter InstanceId juga ditentukan. Nilai valid:

  • Once: Menjalankan perintah segera.

  • Period: Menjalankan perintah sesuai jadwal.

  • NextRebootOnly: Menjalankan perintah secara otomatis saat instans dimulai berikutnya.

  • EveryReboot: Menjalankan perintah secara otomatis setiap kali instans dimulai.

Nilai default: kosong, yang menunjukkan bahwa semua mode eksekusi dikueri.

Once

Tag

array<object>

No

Tag.

object

No

Tag.

Key

string

No

Kunci tag dari 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, panggil ListTagResources untuk mengeksekusi kueri.

Panjang kunci tag dapat mencapai 64 karakter dan tidak boleh diawali dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.

TestKey

Value

string

No

Nilai tag dari eksekusi perintah. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh mengandung http:// atau https://.

TestValue

Elemen respons

Element

Type

Description

Example

object

Invocations

object

Invocation

array<object>

Catatan eksekusi perintah.

array<object>

Waktu saat Tugas dibuat.

CommandContent

string

Konten perintah.

  • Jika ContentEncoding diatur ke PlainText, konten skrip asli dikembalikan.

  • Jika ContentEncoding diatur ke Base64, konten skrip yang dikodekan Base64 dikembalikan.

cnBtIC1xYSB8IGdyZXAgdnNm****

CommandDescription

string

Deskripsi perintah.

testSkrip

CommandId

string

ID perintah.

c-hz0jdfwcsr****

CommandName

string

Nama perintah.

CommandTestName

CommandType

string

Tipe perintah.

RunShellScript

ContainerId

string

ID kontainer.

ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****

ContainerName

string

Nama kontainer.

test-Kontainer

CreationTime

string

Waktu saat Tugas dibuat. Waktu ditampilkan dalam format ISO 8601 dalam UTC.

2020-01-19T09:15:46Z

Frequency

string

Jadwal saat perintah dijalankan.

0 */20 * * * *

InvocationStatus

string

Status eksekusi keseluruhan perintah. Status eksekusi keseluruhan bergantung pada status eksekusi umum dari semua instans dalam pemanggilan ini. Nilai valid:

  • Pending: Sistem sedang memvalidasi atau mengirim perintah. Status eksekusi keseluruhan adalah Pending jika status eksekusi perintah pada setidaknya satu instans adalah Pending.

  • Scheduled: Perintah terjadwal telah dikirim dan menunggu untuk dijalankan. Status eksekusi keseluruhan adalah Scheduled jika status eksekusi perintah pada setidaknya satu instans adalah Scheduled.

  • Running: Perintah sedang berjalan pada instans. Status eksekusi keseluruhan adalah Running jika status eksekusi perintah pada setidaknya satu instans adalah Running.

  • Success: Status eksekusi perintah pada setiap instans adalah Stopped atau Success, dan status eksekusi perintah pada setidaknya satu instans adalah Success. Status eksekusi keseluruhan kemudian menjadi Success.
    • Tugas segera: Eksekusi perintah selesai dan kode keluar adalah 0.

    • Tugas terjadwal: Eksekusi terbaru berhasil dengan kode keluar 0, dan semua waktu eksekusi yang ditentukan telah berlalu.

  • Failed: Status eksekusi perintah pada setiap instans adalah Stopped atau Failed. Status eksekusi keseluruhan kemudian menjadi Failed. Status eksekusi keseluruhan adalah Failed ketika status eksekusi perintah pada satu atau beberapa instans adalah salah satu dari berikut:
    • Validasi perintah gagal (Invalid).

    • Pengiriman perintah gagal (Aborted).

    • Eksekusi perintah selesai dengan kode keluar bukan nol (Failed).

    • Eksekusi perintah melebihi batas waktu (Timeout).

    • Eksekusi perintah mengalami pengecualian (Error).

  • Stopping: Tugas sedang dihentikan. Status eksekusi keseluruhan adalah Stopping jika status eksekusi perintah pada setidaknya satu instans adalah Stopping.

  • Stopped: Tugas dihentikan. Status eksekusi keseluruhan adalah Stopped ketika status eksekusi perintah pada semua instans adalah Stopped. Status adalah Stopped ketika status eksekusi perintah pada instans adalah salah satu dari berikut:
    • Tugas dibatalkan (Cancelled).

    • Tugas dihentikan (Terminated).

  • PartialFailed: Beberapa instans berhasil dan beberapa instans gagal. Status eksekusi keseluruhan adalah PartialFailed ketika status eksekusi perintah pada setiap instans adalah Success, Failed, atau Stopped.

Catatan

Parameter respons InvokeStatus memiliki arti yang serupa, tetapi kami menyarankan Anda memeriksa parameter ini sebagai gantinya.

Running

InvokeId

string

ID eksekusi perintah.

t-hz0jdfwd9f****

InvokeInstances

object

InvokeInstance

array<object>

Tipe set instans target untuk eksekusi.

object

Daftar status eksekusi.

CreationTime

string

Waktu saat eksekusi perintah dimulai. Waktu ditampilkan dalam format ISO 8601 dalam UTC.

2019-12-20T06:15:54Z

Dropped

integer

Panjang teks yang dipotong dan dibuang setelah teks dalam bidang Output melebihi 24 KB.

0

ErrorCode

string

Kode kesalahan untuk kegagalan pengiriman perintah atau kegagalan eksekusi. Nilai valid:

  • Empty: Perintah berjalan normal.

  • InstanceNotExists: Instans yang ditentukan tidak ada atau telah dilepas.

  • InstanceReleased: Instans dilepas selama eksekusi bersamaan.

  • InstanceNotRunning: Instans tidak dalam status Running saat perintah mulai berjalan.

  • CommandNotApplicable: Perintah tidak berlaku untuk instans yang ditentukan.

  • AccountNotExists: Nama pengguna yang ditentukan untuk menjalankan perintah tidak ada.

  • DirectoryNotExists: Direktori yang ditentukan tidak ada.

  • BadCronExpression: Ekspresi cron yang ditentukan tidak valid.

  • ClientNotRunning: Agen Asisten Cloud tidak berjalan.

  • ClientNotResponse: Agen Asisten Cloud tidak merespons.

  • ClientIsUpgrading: Agen Asisten Cloud sedang ditingkatkan.

  • ClientNeedUpgrade: Agen Asisten Cloud perlu ditingkatkan.

  • DeliveryTimeout: Pengiriman perintah melebihi batas waktu.

  • ExecutionTimeout: Eksekusi bersamaan melebihi batas waktu.

  • ExecutionException: Pengecualian terjadi selama eksekusi bersamaan.

  • ExecutionInterrupted: Tugas eksekusi bersamaan terganggu.

  • ExitCodeNonzero: Eksekusi bersamaan selesai dengan kode keluar bukan nol.

  • SecurityGroupRuleDenied: Aturan grup keamanan menolak akses ke layanan Asisten Cloud.

  • TaskConcurrencyLimit: Jumlah eksekusi Tugas bersamaan melebihi kuota maksimum.

InstanceNotExists

ErrorInfo

string

Alasan mendetail untuk kegagalan pengiriman perintah atau kegagalan eksekusi. Nilai valid:

  • Empty: Perintah berjalan normal.

  • The security group rules denied access to the aliyun service: Aturan grup keamanan menolak akses ke layanan Asisten Cloud.

  • The specified instance does not exist: Instans yang ditentukan tidak ada atau telah dilepas.

  • The specified instance was released during task execution: Instans dilepas selama eksekusi Tugas.

  • The specified instance was not running during task execution: Instans tidak dalam status Running saat perintah mulai berjalan.

  • The OS type of the instance does not support the specified command type: Perintah tidak berlaku untuk instans yang ditentukan.

  • The specified account does not exist: Akun yang ditentukan tidak ada.

  • The specified directory does not exist: Direktori yang ditentukan tidak ada.

  • The cron expression is invalid: Ekspresi cron yang ditentukan tidak valid.

  • The aliyun service is not running on the instance: Agen Asisten Cloud tidak berjalan.

  • The aliyun service in the instance does not response: Agen Asisten Cloud tidak memberikan tanggapan.

  • The aliyun service in the instance is upgrading during task execution: Agen Asisten Cloud sedang ditingkatkan.

  • The aliyun service in the instance need to be upgraded to at least version to support the feature: Agen Asisten Cloud perlu ditingkatkan. menunjukkan versi minimum yang didukung untuk fitur tersebut, dan menunjukkan fitur spesifik.

  • The command delivery has been timeout: Pengiriman perintah melebihi pengatur waktu.

  • The command execution has been timeout: Eksekusi perintah melebihi pengatur waktu.

  • The command execution got an exception: Pengecualian terjadi selama eksekusi perintah.

  • The command execution exit code is not zero: Eksekusi perintah selesai dengan kode keluar bukan nol.

  • The specified instance was released during task execution: Instans dilepas selama eksekusi Tugas.

instans yang ditentukan tidak ada

ExitCode

integer

Kode keluar dari proses perintah. Nilai valid:

  • Untuk instans Linux, kode keluar dari proses Shell.

  • Untuk instans Windows, kode keluar dari proses Bat atau PowerShell.

0

FinishTime

string

Waktu saat proses perintah berakhir. Waktu ditampilkan dalam format ISO 8601 dalam UTC.

2019-12-20T06:15:56Z

InstanceId

string

ID instans.

i-bp1i7gg30r52z2em****

InstanceInvokeStatus

string

Status eksekusi perintah pada satu instans.

Catatan

Kami menyarankan Anda memeriksa parameter respons InvocationStatus sebagai ganti parameter ini.

Finished

InvocationStatus

string

Status eksekusi perintah pada satu instans. Nilai valid:

  • Pending: Sistem sedang memvalidasi atau mengirim perintah.

  • Invalid: Tipe atau parameter perintah yang ditentukan tidak valid.

  • Aborted: Gagal mengirim perintah ke instans. Instans harus dalam status Running, dan perintah harus dapat dikirim dalam 1 menit.

  • Running: Perintah sedang berjalan pada instans.

  • Success:
    • Eksekusi satu kali: Eksekusi perintah selesai dan kode keluar adalah 0.

    • Eksekusi terjadwal: Eksekusi terbaru berhasil dengan kode keluar 0, dan jadwal yang ditentukan telah berakhir.

  • Failed:
    • Eksekusi satu kali: Eksekusi perintah selesai dan kode keluar bukan nol.

    • Eksekusi terjadwal: Eksekusi terbaru berhasil dengan kode keluar bukan nol, dan jadwal yang ditentukan akan dibatalkan.

  • Error: Pengecualian terjadi selama eksekusi perintah dan perintah tidak dapat dilanjutkan.

  • Timeout: Eksekusi perintah melebihi batas waktu.

  • Cancelled: Aksi eksekusi perintah telah dibatalkan dan perintah tidak pernah dimulai.

  • Stopping: Tugas sedang dihentikan.

  • Terminated: Perintah dihentikan selama eksekusi.

  • Scheduled:
    • Eksekusi satu kali: Tidak berlaku. Nilai ini tidak muncul.

    • Eksekusi terjadwal: Menunggu untuk dijalankan.

Success

OssOutputErrorCode

string

Kode kesalahan saat pengiriman gagal. Parameter ini hanya dikembalikan ketika OssOutputStatus adalah Failed. Nilai valid:

  • CloudAssistant.UnsupportedInvocationStatus: Status Tugas tidak mendukung pengiriman.

  • CloudAssistant.ClientNeedUpgrade: Versi Agen Asisten Cloud tidak mendukung pengiriman. Versi Agen Asisten Cloud pada instans Linux harus lebih baru dari 2.2.4.1007, dan versi pada instans Windows harus lebih baru dari 2.1.4.1007.

  • OSS.AccessDenied: Pengguna tidak memiliki izin akses pada bucket yang ditentukan.

  • OSS.NoSuchBucket: Bucket yang ditentukan tidak ada.

  • OSS.FileImmutable: Data dalam bucket berada dalam status perlindungan.

  • OSS.InvalidObjectName: Nama objek tidak valid. Kode kesalahan ini terjadi ketika nama objek tidak ditentukan, nama objek melebihi batas panjang, atau nama objek yang ditentukan tidak valid.

CloudAssistant.UnsupportedInvocationStatus

OssOutputErrorInfo

string

Detail error saat pengiriman gagal. Parameter ini hanya dikembalikan ketika OssOutputStatus adalah Failed.

The invocation status does not support output delivery

OssOutputStatus

string

Status pengiriman output eksekusi perintah ke OSS. Nilai valid:

  • InProgress: Pengiriman sedang berlangsung.

  • Finished: Pengiriman selesai.

  • Failed: Pengiriman gagal.

Finished

OssOutputUri

string

URI file di OSS tempat output eksekusi perintah dikirim. Bidang ini berupa string kosong saat pengiriman gagal atau sedang berlangsung.

oss://testBucket/testPrefix/output.txt

Output

string

Output perintah.

  • Jika ContentEncoding diatur ke PlainText, output asli dikembalikan.

  • Jika ContentEncoding diatur ke Base64, output yang dikodekan Base64 dikembalikan.

OutPutTestmsg

Repeats

integer

Jumlah kali perintah dieksekusi pada instans.

  • Untuk eksekusi satu kali, nilainya adalah 0 atau 1.

  • Untuk eksekusi terjadwal, nilainya adalah jumlah kali perintah telah dieksekusi.

0

StartTime

string

Waktu saat perintah mulai berjalan pada instans. Waktu ditampilkan dalam format ISO 8601 dalam UTC.

2019-12-20T06:15:55Z

StopTime

string

Waktu saat StopInvocation dipanggil untuk menghentikan eksekusi perintah. Waktu ditampilkan dalam format ISO 8601 dalam UTC.

2020-01-19T09:15:47Z

Timed

boolean

Apakah perintah yang dikueri dijadwalkan untuk berjalan secara otomatis di masa mendatang.

false

UpdateTime

string

Waktu saat status perintah terakhir diperbarui. Waktu ditampilkan dalam format ISO 8601 dalam UTC.

2020-01-19T09:15:47Z

InvokeStatus

string

Status eksekusi keseluruhan perintah.

Catatan

Kami menyarankan Anda memeriksa parameter respons InvocationStatus sebagai ganti parameter ini.

Finished

Launcher

string

Peluncur yang digunakan untuk menjalankan skrip. Panjang peluncur dapat mencapai 1 KB.

python3 -u {{ACS::ScriptFileName|Ext(".py")}}

OssOutputDelivery

string

Konfigurasi pengiriman OSS untuk output eksekusi perintah.

oss://testBucket/testPrefix

Parameters

string

Parameter kustom dalam perintah.

{}

RepeatMode

string

Mode eksekusi perintah. Nilai valid:

  • Once: Menjalankan perintah segera.

  • Period: Menjalankan perintah sesuai jadwal.

  • NextRebootOnly: Menjalankan perintah secara otomatis saat instans dimulai berikutnya.

  • EveryReboot: Menjalankan perintah secara otomatis setiap kali instans dimulai.

  • DryRun: Hanya menjalankan dry run permintaan. Perintah tidak benar-benar dieksekusi. Dry run memeriksa parameter permintaan, lingkungan eksekusi instans, dan status Agen Asisten Cloud.

Once

Tags

object

Tag

array<object>

Informasi tag dari eksekusi perintah.

object

Informasi tag dari eksekusi perintah.

TagKey

string

Kunci tag dari eksekusi perintah.

owner

TagValue

string

Nilai tag dari eksekusi perintah.

zhangsan

TerminationMode

string

Mode yang digunakan saat Tugas dihentikan (dihentikan secara manual atau terganggu karena melebihi batas waktu). Nilai valid:

  • Process: Menghentikan proses skrip saat ini.

  • ProcessTree: Menghentikan pohon proses saat ini (proses skrip dan semua proses turunan yang dibuatnya).

ProcessTree

Timed

boolean

Apakah perintah yang dikueri dijadwalkan untuk berjalan secara otomatis di masa mendatang.

false

Timeout

integer

Periode batas waktu maksimum untuk perintah berjalan pada instans ECS. Unit: seconds.

Jika perintah tidak dapat berjalan karena alasan tertentu, batas waktu akan tercapai. Saat batas waktu tercapai, proses perintah dihentikan secara paksa dengan membatalkan PID perintah.

60

Username

string

Nama pengguna yang digunakan untuk menjalankan perintah pada instans ECS.

test

WorkingDir

string

Direktori kerja perintah.

/home/

NextToken

string

Token halaman yang dikembalikan dalam panggilan ini.

AAAAAdDWBF2

PageNumber

integer

Nomor halaman dari hasil kueri.

1

PageSize

integer

Jumlah entri per halaman.

10

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

TotalCount

integer

Jumlah total perintah.

1

Contoh

Respons sukses

JSONformat

{
  "Invocations": {
    "Invocation": [
      {
        "CommandContent": "cnBtIC1xYSB8IGdyZXAgdnNm****",
        "CommandDescription": "deskripsiSkrip",
        "CommandId": "c-hz0jdfwcsr****",
        "CommandName": "CommandTestName",
        "CommandType": "RunShellScript",
        "ContainerId": "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
        "ContainerName": "test-Kontainer",
        "CreationTime": "2020-01-19T09:15:46Z",
        "Frequency": "0 */20 * * * *",
        "InvocationStatus": "Running",
        "InvokeId": "t-hz0jdfwd9f****",
        "InvokeInstances": {
          "InvokeInstance": [
            {
              "CreationTime": "2019-12-20T06:15:54Z",
              "Dropped": 0,
              "ErrorCode": "InstanceNotExists",
              "ErrorInfo": "Instans yang ditentukan tidak ada",
              "ExitCode": 0,
              "FinishTime": "2019-12-20T06:15:56Z",
              "InstanceId": "i-bp1i7gg30r52z2em****",
              "InstanceInvokeStatus": "Finished",
              "InvocationStatus": "Success",
              "OssOutputErrorCode": "CloudAssistant.UnsupportedInvocationStatus",
              "OssOutputErrorInfo": "The invocation status does not support output delivery",
              "OssOutputStatus": "Finished",
              "OssOutputUri": "oss://testBucket/testPrefix/output.txt",
              "Output": "OutPutTestmsg",
              "Repeats": 0,
              "StartTime": "2019-12-20T06:15:55Z",
              "StopTime": "2020-01-19T09:15:47Z",
              "Timed": false,
              "UpdateTime": "2020-01-19T09:15:47Z"
            }
          ]
        },
        "InvokeStatus": "Finished",
        "Launcher": "python3 -u {{ACS::ScriptFileName|Ext(\".py\")}}",
        "OssOutputDelivery": "oss://testBucket/testPrefix",
        "Parameters": "{}",
        "RepeatMode": "Once",
        "Tags": {
          "Tag": [
            {
              "TagKey": "owner",
              "TagValue": "zhangsan"
            }
          ]
        },
        "TerminationMode": "ProcessTree",
        "Timed": false,
        "Timeout": 60,
        "Username": "test",
        "WorkingDir": "/home/"
      }
    ]
  },
  "NextToken": "AAAAAdDWBF2",
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalCount": 1
}

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 NumberExceed.Tags The Tags parameter number is exceed. Jumlah tag melebihi batas maksimum. Anda dapat menentukan hingga 20 tag untuk operasi ini.
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 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. Parameter nilai tag yang ditentukan tidak valid.
400 MissingParameter.TagKey You must specify Tag.N.Key. Tentukan kunci tag.
400 InvalidParam.PageNumber The specified parameter is invalid.
400 InvalidParam.PageSize The specified parameter is invalid.
400 InvalidParameter.NextToken The specified parameter NextToken is not valid.
400 InvalidParameter.MaxResults The specified parameter MaxResults is not valid. Parameter MaxResults yang ditentukan 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 Operation.Forbidden The operation is not permitted. Operasi tidak diizinkan.
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 InvalidCommandId.NotFound The specified commandId does not exist

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.