All Products
Search
Document Center

Elastic Compute Service:DescribeInvocations

Last Updated:Jul 03, 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. Anda harus memeriksa hasil eksekusi aktual berdasarkan nilai kembalian 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, yang menghindari polling berulang dan meningkatkan efisiensi.

  • Saat melakukan kueri halaman pertama, tetapkan hanya MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken dalam tanggapan berfungsi sebagai token untuk mengkueri halaman berikutnya. Saat melakukan kueri halaman berikutnya, tetapkan NextToken ke nilai NextToken yang diperoleh dari tanggapan sebelumnya dan tetapkan 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 agregat di seluruh instans.

      • DescribeInvocationResults hanya mengembalikan status eksekusi individual pada setiap instans, tanpa status agregat.

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

    • Untuk Tampilan detail eksekusi setiap jalanan untuk Tugas terjadwal (periode) atau Tugas yang dipicu saat boot (RepeatMode=Period, EveryReboot), hanya DescribeInvocationResults yang dapat mengembalikan catatan eksekusi historis (dengan IncludeHistory=true ditentukan). 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, ID kelompok sumber daya juga harus ditentukan saat Anda menjalankan perintah. Parameter ini memfilter hasil eksekusi perintah yang sesuai.

rg-bp67acfmxazb4p****

InvokeId

string

No

ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

t-hz0jdfwd9f****

CommandId

string

No

ID eksekusi perintah.

c-hz0jdfwcsr****

CommandName

string

No

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

CommandTestName

CommandType

string

No

Nama perintah. Parameter ini tidak berlaku jika Anda juga menentukan InstanceId.

RunShellScript

Timed

boolean

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.

true

InvokeStatus

string

No

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

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

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

    • Perintah yang telah dibatalkan, dihentikan, atau diselesaikan.

Nilai default: false.

Finished

InstanceId

string

No

Status eksekusi keseluruhan perintah. Status eksekusi keseluruhan ditentukan oleh status eksekusi gabungan di satu atau beberapa instans. Nilai valid:

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

    • Eksekusi satu kali: Status keseluruhan adalah Running jika ada proses perintah yang sedang berlangsung.

  • Finished:
    • Eksekusi terjadwal: Status tidak akan pernah menjadi Finished.

    • Eksekusi satu kali: Semua instans telah menyelesaikan eksekusi, atau Anda secara manual menghentikan proses perintah 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 Success. Status 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 pengatur waktu eksekusi yang ditentukan telah berlalu.

  • Failed:
    • Eksekusi terjadwal: Status tidak akan pernah menjadi Failed.

    • Eksekusi satu kali: Semua instans gagal menjalankan perintah.

  • Stopped: Perintah telah dihentikan.

  • Stopping: Perintah sedang dihentikan.

  • PartialFailed: Beberapa instans berhasil sementara yang lain gagal. Nilai ini tidak berlaku jika Anda juga menentukan InstanceId.

  • Pending: Sistem sedang memvalidasi atau mengirimkan perintah. Status keseluruhan adalah Pending jika setidaknya satu instans memiliki status Pending.

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

i-bp1i7gg30r52z2em****

ContentEncoding

string

No

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

PlainText

IncludeOutput

boolean

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.

false

PageNumber

integer

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.

1

PageSize

integer

No

Catatan

Parameter ini akan segera dihentikan penggunaannya. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi paging.

10

MaxResults

integer

No

Catatan

Parameter ini akan segera dihentikan penggunaannya. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi paging.

10

NextToken

string

No

Jumlah entri maksimum per halaman untuk paging.

Nilai maksimum: 50.

Nilai default: 10.

AAAAAdDWBF2

RepeatMode

string

No

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

Once

Tag

array<object>

No

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

  • Once: segera menjalankan perintah.

  • Period: menjalankan perintah sesuai jadwal.

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

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

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

object

No

Tag.

Value

string

No

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

TestValue

Key

string

No

Kunci tag eksekusi perintah. Nilai N yang valid: 1 hingga 20. Kunci tag tidak boleh berupa string kosong.

Jika Anda menggunakan satu tag untuk memfilter sumber daya, jumlah sumber daya dengan tag yang ditentukan tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter sumber daya, jumlah sumber daya dengan semua tag yang ditentukan terlampir tidak boleh melebihi 1.000. Jika jumlah sumber daya melebihi 1.000, panggil ListTagResources untuk menjalankan kueri.

Kunci tag dapat memiliki panjang hingga 64 karakter dan tidak boleh dimulai dengan aliyun atau acs:, atau mengandung http:// atau https://.

TestKey

No

Tag.

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 pagination 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 yang 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 status eksekusi perintah pada setidaknya satu instans adalah Success.
    • Tugas segera: Eksekusi perintah selesai dan kode keluar adalah 0.

    • Tugas terjadwal: Eksekusi terakhir 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 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 kehabisan 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 telah dihentikan. Status eksekusi keseluruhan adalah Stopped ketika status eksekusi perintah pada semua instans adalah Stopped. Status berikut dikembalikan sebagai Stopped:
    • Tugas dibatalkan (Cancelled).

    • Tugas diterminasi (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 untuk memeriksa parameter ini sebagai gantinya.

Running

Parameters

string

Parameter kustom dalam perintah.

{}

Timed

boolean

Menunjukkan apakah perintah akan dijalankan secara otomatis di masa mendatang.

false

CommandDescription

string

Deskripsi perintah.

testDescription

Timeout

integer

Periode batas waktu maksimum untuk eksekusi perintah pada instans ECS. Unit: detik.

Jika perintah tidak dapat dijalankan karena alasan apa pun, batas waktu akan terjadi. Ketika batas waktu terjadi, 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 yang valid:

  • Pending: Sistem sedang memverifikasi atau mengirim perintah.

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

  • Aborted: Gagal mengirim perintah ke instans. Instans harus dalam status Running dan perintah harus dikirim dalam waktu 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: Terjadi pengecualian selama eksekusi perintah dan perintah tidak dapat dilanjutkan.

  • Timeout: Eksekusi perintah kehabisan waktu.

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

  • Stopping: Tugas sedang dihentikan.

  • Terminated: Perintah diterminasi selama eksekusi.

  • Scheduled:
    • Eksekusi satu kali: Tidak berlaku.

    • Eksekusi terjadwal: Menunggu untuk dijalankan.

Success

InstanceId

string

ID instans.

i-bp1i7gg30r52z2em****

Timed

boolean

Menunjukkan apakah perintah akan dijalankan secara otomatis di masa mendatang.

false

InstanceInvokeStatus

string

Status eksekusi perintah pada satu instans.

Catatan

Kami menyarankan Anda untuk memeriksa parameter InvocationStatus sebagai pengganti parameter ini.

Finished

ExitCode

integer

Kode keluar proses perintah. Nilai yang 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 yang valid:

  • Empty: Perintah berjalan secara normal.

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

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

  • The specified instance was released during task execution: Instans dirilis selama eksekusi perintah.

  • The specified instance was not running during task execution: Instans tidak dalam status Running 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: Cloud Assistant Agent tidak berjalan.

  • The aliyun service in the instance does not response: Cloud Assistant Agent tidak merespons.

  • The aliyun service in the instance is upgrading during task execution: Cloud Assistant Agent sedang diperbarui.

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

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

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

  • The command execution got an exception: Terjadi pengecualian 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 dirilis selama pengiriman file.

the specified instance does not exists

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 dikirimkan. Bidang ini berupa string kosong ketika pengiriman gagal atau sedang berlangsung.

oss://testBucket/testPrefix/output.txt

OssOutputStatus

string

Status pengiriman output eksekusi perintah. Nilai yang valid:

  • InProgress: Pengiriman sedang berlangsung.

  • Finished: Pengiriman selesai.

  • Failed: Pengiriman gagal.

Finished

OssOutputErrorCode

string

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

  • CloudAssistant.UnsupportedInvocationStatus: Status tugas tidak mendukung pengiriman.

  • CloudAssistant.ClientNeedUpgrade: Versi Cloud Assistant Agent tidak mendukung pengiriman. Versi 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 terlindungi.

  • OSS.InvalidObjectName: Nama objek tidak valid, termasuk nama objek yang tidak ditentukan, nama objek melebihi batas panjang, atau nama objek tidak valid.

CloudAssistant.UnsupportedInvocationStatus

OssOutputErrorInfo

string

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

The invocation status does not support output delivery.

FinishTime

string

Waktu berakhirnya 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 yang valid:

  • Empty: Perintah berjalan secara normal.

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

  • InstanceReleased: Instans dirilis selama eksekusi bersamaan.

  • InstanceNotRunning: Instans tidak dalam status Running 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: Cloud Assistant Agent tidak berjalan.

  • ClientNotResponse: Cloud Assistant Agent tidak merespons.

  • ClientIsUpgrading: Cloud Assistant Agent sedang diperbarui.

  • ClientNeedUpgrade: Cloud Assistant Agent perlu diperbarui.

  • DeliveryTimeout: Pengiriman perintah kehabisan waktu.

  • ExecutionTimeout: Eksekusi bersamaan kehabisan waktu.

  • ExecutionException: Terjadi pengecualian selama eksekusi bersamaan.

  • ExecutionInterrupted: Tugas eksekusi bersamaan terputus.

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

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

  • TaskConcurrencyLimit: Jumlah eksekusi tugas bersamaan 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 yang valid:

  • Once: Perintah langsung dijalankan.

  • Period: Perintah dijalankan sesuai jadwal.

  • NextRebootOnly: Perintah dijalankan secara otomatis saat instans dimulai berikutnya.

  • EveryReboot: Perintah dijalankan secara otomatis setiap kali instans dimulai.

  • DryRun: Hanya uji coba permintaan yang dilakukan. Perintah tidak benar-benar dijalankan. Sistem memeriksa parameter permintaan, lingkungan eksekusi instans, dan status Cloud Assistant Agent.

Once

InvokeStatus

string

Status eksekusi keseluruhan perintah.

Catatan

Kami menyarankan Anda untuk memeriksa parameter InvocationStatus sebagai pengganti parameter ini.

Finished

CommandType

string

Jenis 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-container

CreationTime

string

Waktu saat tugas dibuat.

2020-01-19T09:15:46Z

Frequency

string

Jadwal untuk eksekusi perintah terjadwal.

0 */20 * * * *

Launcher

string

Peluncur untuk eksekusi skrip. Peluncur tidak boleh melebihi panjang 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 untuk menghentikan tugas (penghentian manual atau interupsi batas waktu). Nilai yang valid:

  • Process: Menghentikan proses skrip saat ini.

  • ProcessTree: Menghentikan pohon proses saat ini (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.

owner

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.
400 NumberExceed.Tags The Tags parameter number is exceed.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
400 MissingParameter.TagKey You must specify Tag.N.Key.
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.
500 InternalError.Dispatch An error occurred when you dispatched the request.
403 Operation.Forbidden The operation is not permitted.
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.