All Products
Search
Document Center

Elastic Compute Service:DescribeInvocations

Last Updated:Aug 28, 2026

Mengkueri daftar eksekusi dan status perintah Asisten Cloud.

Deskripsi operasi

  • Setelah Anda menjalankan perintah, perintah tersebut belum tentu berhasil dijalankan atau menghasilkan hasil yang diharapkan. Anda perlu memeriksa hasil eksekusi aktual dengan melihat nilai kembalian dari operasi ini. Output aktual menjadi acuan utama.

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

  • Anda dapat berlangganan event status tugas Asisten Cloud untuk memperoleh hasil tugas melalui event, sehingga menghindari polling berulang dan meningkatkan efisiensi.

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

  • Perbedaan antara DescribeInvocations dan DescribeInvocationResults:

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

      • DescribeInvocationResults hanya mengembalikan status eksekusi individu pada setiap instans, tanpa status agregat di seluruh beberapa instans.

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

    • Ketika Anda perlu melihat riwayat eksekusi Tugas terjadwal (periode) atau Tugas yang dieksekusi otomatis saat Instans dimulai (RepeatMode=Period, EveryReboot), hanya DescribeInvocationResults yang dapat mengembalikan catatan eksekusi historis (Anda harus menentukan IncludeHistory=true). DescribeInvocations hanya mengembalikan status Tugas terbaru.

    • Ketika Anda perlu melihat konten perintah dan parameter, 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

Instans.

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 tempat eksekusi perintah berada. Setelah Anda menentukan parameter ini, hasil eksekusi perintah difilter berdasarkan ResourceGroupId yang ditentukan saat perintah dijalankan.

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 Anda juga menentukan InstanceId.

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 perintah akan dijalankan secara otomatis di masa depan. 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 keadaan 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 di satu atau lebih instans dalam eksekusi. Nilai valid:

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

    • Eksekusi satu kali: Status eksekusi keseluruhan adalah Running selama proses perintah berjalan pada instans mana pun.

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

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

  • Success: Status eksekusi perintah pada setiap instans adalah Stopped atau Success, dan setidaknya satu instans memiliki status eksekusi perintah Success.
    • Tugas langsung jalankan: Eksekusi perintah selesai dan kode keluar adalah 0.

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

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

    • Eksekusi satu kali: Semua instans gagal menjalankan perintah.

  • Stopped: Perintah dihentikan.

  • Stopping: Perintah sedang dihentikan.

  • PartialFailed: Perintah berhasil pada beberapa instans tetapi gagal pada instans lainnya. Nilai ini tidak berlaku jika Anda juga menentukan InstanceId.

  • Pending: Sistem sedang memverifikasi 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 tersebut akan dikueri.

i-bp1i7gg30r52z2em****

ContentEncoding

string

No

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

  • PlainText: Mengembalikan konten perintah dan output asli.

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

Nilai default: Base64.

PlainText

IncludeOutput

boolean

No

Apakah akan mengembalikan output perintah dalam hasil.

  • true: Output perintah dikembalikan. Anda harus menentukan setidaknya InvokeId atau InstanceId.

  • false: Output perintah tidak dikembalikan.

Nilai default: false.

false

PageNumber

integer

No

Catatan

Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri berhalaman.

1

PageSize

integer

No

Catatan

Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri berhalaman.

10

MaxResults

integer

No

Jumlah maksimum entri per halaman untuk kueri berhalaman.

Nilai maksimum: 50.

Nilai default: 10.

10

NextToken

string

No

Token paginasi. Tetapkan parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.

AAAAAdDWBF2

RepeatMode

string

No

Mode eksekusi perintah. Parameter ini tidak berlaku jika Anda juga menentukan InstanceId. Nilai valid:

  • Once: Perintah langsung dijalankan.

  • Period: Perintah dijalankan sesuai jadwal.

  • NextRebootOnly: Perintah otomatis dijalankan saat instans dimulai berikutnya.

  • EveryReboot: Perintah otomatis dijalankan setiap kali instans dimulai.

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

Once

Tag

array<object>

No

Tag.

object

No

Tag.

Value

string

No

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

TestValue

Key

string

No

Kunci tag 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 resource dengan tag ini tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah resource dengan semua tag yang ditentukan terlampir tidak boleh melebihi 1.000. Jika jumlah resource melebihi 1.000, gunakan operasi ListTagResources untuk melaksanakan kueri.

Panjang kunci tag maksimal 64 karakter dan tidak boleh dimulai dengan aliyun atau acs:, atau mengandung http:// atau https://.

TestKey

Elemen respons

Element

Type

Description

Example

object

PageSize

integer

Jumlah entri per halaman.

10

RequestId

string

ID permintaan.

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

PageNumber

integer

Nomor halaman hasil kueri.

1

TotalCount

integer

Jumlah total perintah.

1

NextToken

string

Token paginasi yang dikembalikan dalam panggilan ini.

AAAAAdDWBF2

Invocations

object

Invocation

array<object>

Catatan eksekusi perintah.

array<object>

Pengatur waktu saat Tugas dibuat.

OssOutputDelivery

string

Konfigurasi pengiriman OSS untuk output eksekusi perintah.

oss://testBucket/testPrefix

InvocationStatus

string

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

  • Pending: Sistem sedang memverifikasi 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 setidaknya satu instans memiliki status eksekusi perintah Success.
    • Tugas langsung jalankan: Eksekusi perintah selesai dan kode keluar adalah 0.

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

  • Failed: Status eksekusi perintah pada setiap instans adalah Stopped atau Failed. Status eksekusi keseluruhan adalah Failed ketika status eksekusi perintah pada satu atau lebih 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 mengalami timeout (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 telah dihentikan. Status eksekusi keseluruhan adalah Stopped ketika status eksekusi perintah pada semua instans adalah Stopped. Status adalah Stopped ketika status tingkat instans adalah salah satu dari berikut:
    • Tugas dibatalkan (Cancelled).

    • Tugas dihentikan (Terminated).

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

Catatan

Parameter respons InvokeStatus memiliki makna serupa, namun kami menyarankan Anda memeriksa parameter ini sebagai gantinya.

Running

Parameters

string

Parameter kustom dalam perintah.

{}

Timed

boolean

Apakah perintah akan dijalankan secara otomatis di masa mendatang.

false

CommandDescription

string

Deskripsi perintah.

skrip uji

Timeout

integer

Periode pengatur waktu maksimum untuk eksekusi perintah pada Instans ECS. Unit: detik.

Jika perintah tidak dapat dijalankan karena alasan tertentu, terjadi timeout. Saat terjadi timeout, proses perintah dihentikan secara paksa dengan membatalkan PID perintah.

60

InvokeInstances

object

InvokeInstance

array<object>

Tipe set instans target.

object

Daftar status eksekusi.

Dropped

integer

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

0

InvocationStatus

string

Status eksekusi perintah pada satu instans. Nilai valid:

  • Pending: Sistem sedang memverifikasi atau mengirim perintah.

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

  • Aborted: Gagal mengirim perintah ke instans. Instans harus berjalan, 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 terakhir 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 terakhir berhasil dengan kode keluar bukan nol, dan jadwal yang ditentukan akan dihentikan.

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

  • Timeout: Eksekusi perintah mengalami timeout.

  • Cancelled: Aksi eksekusi 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

InstanceId

string

ID instans.

i-bp1i7gg30r52z2em****

Timed

boolean

Apakah perintah akan dijalankan secara otomatis di masa mendatang.

false

InstanceInvokeStatus

string

Status eksekusi perintah pada satu instans.

Catatan

Kami menyarankan Anda memeriksa parameter InvocationStatus sebagai ganti parameter ini.

Finished

ExitCode

integer

Kode keluar proses perintah. Nilai valid:

  • Untuk instans Linux, kode keluar proses Shell.

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

0

ErrorInfo

string

Detail kegagalan pengiriman perintah atau kegagalan eksekusi. Nilai valid:

  • Empty: Perintah berjalan normal.

  • The security group rules denied access to the aliyun service: Aturan kelompok 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 berjalan saat perintah mulai dijalankan.

  • 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 merespons.

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

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

  • The command delivery has been timeout: Pengiriman perintah mengalami timeout.

  • The command execution has been timeout: Eksekusi perintah mengalami timeout.

  • 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 pengiriman file.

Instans yang ditentukan tidak ada

StartTime

string

Waktu saat perintah mulai dijalankan pada instans.

2019-12-20T06:15:55Z

Repeats

integer

Jumlah kali perintah dijalankan pada instans.

  • Jika mode eksekusi adalah eksekusi satu kali, nilainya adalah 0 atau 1.

  • Jika mode eksekusi adalah eksekusi terjadwal, nilainya adalah jumlah kali perintah telah dijalankan.

0

OssOutputUri

string

URI file OSS tempat output eksekusi perintah dikirim. Bidang ini adalah string kosong ketika pengiriman gagal atau sedang berlangsung.

oss://testBucket/testPrefix/output.txt

OssOutputStatus

string

Status pengiriman output eksekusi perintah. Nilai valid:

  • InProgress: Pengiriman sedang berlangsung.

  • Finished: Pengiriman selesai.

  • Failed: Pengiriman gagal.

Finished

OssOutputErrorCode

string

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

  • CloudAssistant.UnsupportedInvocationStatus: Status tugas tidak mendukung pengiriman.

  • CloudAssistant.ClientNeedUpgrade: Asisten Cloud Assistant Agent tidak mendukung pengiriman. Asisten Cloud Assistant Agent 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, termasuk kasus di mana nama objek tidak ditentukan, nama objek melebihi batas panjang, atau nama objek yang ditentukan tidak valid.

CloudAssistant.UnsupportedInvocationStatus

OssOutputErrorInfo

string

Detail kesalahan saat pengiriman gagal. Bidang ini hanya dikembalikan ketika OssOutputStatus adalah Failed.

The invocation status does not support output delivery

FinishTime

string

Waktu akhir proses perintah.

2019-12-20T06:15:56Z

Output

string

Output perintah.

  • Jika ContentEncoding diatur ke PlainText, output asli dikembalikan.

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

OutPutTestmsg

CreationTime

string

Waktu mulai eksekusi perintah.

2019-12-20T06:15:54Z

UpdateTime

string

Waktu saat status perintah diperbarui.

2020-01-19T09:15:47Z

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 konkuren.

  • InstanceNotRunning: Instans tidak berjalan saat perintah mulai dijalankan.

  • 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 diupgrade.

  • ClientNeedUpgrade: Agen Asisten Cloud perlu diupgrade.

  • DeliveryTimeout: Pengiriman perintah mengalami timeout.

  • ExecutionTimeout: Eksekusi konkuren mengalami timeout.

  • ExecutionException: Pengecualian terjadi selama eksekusi konkuren.

  • ExecutionInterrupted: Tugas eksekusi konkuren terganggu.

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

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

  • TaskConcurrencyLimit: Jumlah eksekusi Tugas konkuren melebihi kuota maksimum.

InstanceNotExists

StopTime

string

Waktu saat StopInvocation dipanggil untuk menghentikan eksekusi perintah.

2020-01-19T09:15:47Z

CommandContent

string

Konten perintah.

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

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

cnBtIC1xYSB8IGdyZXAgdnNm****

WorkingDir

string

Direktori kerja eksekusi perintah.

/home/

RepeatMode

string

Mode eksekusi perintah. Nilai valid:

  • Once: Perintah langsung dijalankan.

  • Period: Perintah dijalankan sesuai jadwal.

  • NextRebootOnly: Perintah otomatis dijalankan saat instans dimulai berikutnya.

  • EveryReboot: Perintah otomatis dijalankan setiap kali instans dimulai.

  • DryRun: Hanya dry run permintaan yang dilakukan. Perintah tidak benar-benar dijalankan. Sistem memeriksa parameter permintaan, lingkungan eksekusi instans, dan status Agen Asisten Cloud.

Once

InvokeStatus

string

Status eksekusi keseluruhan perintah.

Catatan

Kami menyarankan Anda memeriksa parameter InvocationStatus sebagai ganti parameter ini.

Finished

CommandType

string

Tipe perintah.

RunShellScript

Username

string

Nama pengguna yang digunakan untuk menjalankan perintah pada Instans ECS.

test

ContainerId

string

ID kontainer.

ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****

ContainerName

string

Nama kontainer.

test-Kontainer

CreationTime

string

Pengatur waktu saat Tugas dibuat.

2020-01-19T09:15:46Z

Frequency

string

Jadwal untuk eksekusi perintah terjadwal.

0 */20 * * * *

Launcher

string

Launcher untuk eksekusi skrip. Panjang launcher tidak boleh melebihi 1 KB.

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

CommandId

string

ID perintah.

c-hz0jdfwcsr****

CommandName

string

Nama perintah.

CommandTestName

InvokeId

string

ID eksekusi perintah.

t-hz0jdfwd9f****

TerminationMode

string

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

  • Process: Menghentikan proses skrip saat ini.

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

ProcessTree

Tags

object

Tag

array<object>

Informasi tag eksekusi perintah.

object

Informasi tag eksekusi perintah.

TagKey

string

Kunci tag eksekusi perintah.

pemilik

TagValue

string

Nilai tag eksekusi perintah.

zhangsan

Contoh

Respons sukses

JSONformat

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

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 mengoperasikan maksimal 20 tag per operasi.
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 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.