DescribeInvocationResults - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri hasil eksekusi satu atau beberapa perintah Asisten Cloud, khususnya hasil eksekusi aktual pada Instans ECS.

Deskripsi operasi

Setelah Anda mengeksekusi perintah, keberhasilan perintah atau hasil yang diharapkan tidak dijamin. Panggil operasi ini untuk melihat hasil eksekusi aktual berdasarkan output sebenarnya.
Anda dapat mengkueri informasi eksekusi dari 30 hari terakhir. Maksimal 10.000 catatan informasi 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 token untuk mengkueri halaman berikutnya. Saat mengkueri halaman berikutnya, tetapkan NextToken ke nilai 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 agregasi di seluruh beberapa instans.
  - DescribeInvocationResults hanya mengembalikan status eksekusi individu pada setiap instans, tanpa status agregasi di seluruh beberapa instans.
- Ketika satu panggilan RunCommand/InvokeCommand menentukan satu instans:
  - DescribeInvocations dan DescribeInvocationResults sebagian besar dapat saling menggantikan. Anda dapat mengganti salah satunya dengan yang lain.
- Ketika Anda perlu melihat detail eksekusi Tugas terjadwal (periodik) atau Tugas yang dieksekusi pada setiap startup sistem (RepeatMode=Period, EveryReboot), hanya DescribeInvocationResults yang dapat mengembalikan catatan historis eksekusi masa lalu (Anda harus menentukan IncludeHistory=true). DescribeInvocations hanya mengembalikan status Tugas terbaru.
- Ketika Anda perlu melihat konten atau 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:DescribeInvocationResults

get

Command.

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

Instans.

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

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 menjalankan perintah. Parameter ini memfilter hasil eksekusi perintah yang sesuai.	rg-bp67acfmxazb4p****
InvokeId	string	No	ID eksekusi perintah. Anda dapat memanggil DescribeInvocations untuk mengkueri InvokeId.	t-hz0jdfwd9f****
InstanceId	string	No	ID instans.	i-bp1i7gg30r52z2em****
CommandId	string	No	ID perintah.	c-hz0jdfwcsr****
InvokeRecordStatus	string	No	Status eksekusi perintah. Nilai valid: Running: Perintah sedang Berjalan. Eksekusi terjadwal: Status eksekusi tetap Berjalan hingga Anda secara manual menghentikan perintah terjadwal. Eksekusi satu kali: Status eksekusi keseluruhan Berjalan selama ada proses perintah yang Berjalan. Finished: Eksekusi perintah selesai. Eksekusi terjadwal: Proses perintah tidak dapat memiliki status finished. Eksekusi satu kali: Semua instans telah menyelesaikan eksekusi, atau Anda secara manual menghentikan proses perintah pada beberapa instans dan instans sisanya telah menyelesaikan eksekusi. Success: Eksekusi satu kali: Eksekusi perintah selesai dan kode keluar adalah 0. Eksekusi terjadwal: Eksekusi terakhir berhasil dengan kode keluar 0, dan periode eksekusi yang ditentukan telah berakhir. Failed: Eksekusi perintah gagal. Eksekusi terjadwal: Proses perintah tidak dapat memiliki status failed. Eksekusi satu kali: Semua instans gagal mengeksekusi perintah. PartialFailed: Eksekusi perintah sebagian gagal. Eksekusi terjadwal: Proses perintah tidak dapat memiliki status partially failed. Eksekusi satu kali: Beberapa instans memiliki proses perintah yang gagal, sehingga status eksekusi keseluruhan adalah partially failed. Stopped: Eksekusi perintah telah dihentikan. Stopping: Eksekusi perintah sedang dihentikan.	Running
IncludeHistory	boolean	No	Apakah akan mengembalikan catatan historis eksekusi perintah terjadwal. Nilai valid: true: Mengembalikan hasil eksekusi perintah terjadwal. Ketika parameter ini diatur ke true, parameter InvokeId tidak boleh kosong dan harus berupa ID eksekusi dari perintah terjadwal (RepeatMode adalah Period) atau perintah yang berjalan pada setiap startup sistem (RepeatMode adalah EveryReboot). false: Tidak mengembalikan catatan. Nilai default: false.	false
ContentEncoding	string	No	Metode pengkodean untuk bidang `CommandContent` dan `Output` dalam tanggapan. Nilai valid: PlainText: Mengembalikan konten dan output perintah asli. Base64: Mengembalikan konten dan output perintah yang dienkode Base64. Nilai default: Base64.	PlainText
PageNumber	integer	No	Catatan Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk melakukan operasi kueri berhalaman.	1
PageSize	integer	No	Catatan Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk melakukan operasi kueri berhalaman.	1
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
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 Sumber daya dengan tag tersebut tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah Sumber daya dengan semua tag yang ditentukan tidak boleh melebihi 1.000. Jika jumlah Sumber daya melebihi 1.000, panggil ListTagResources untuk menjalankan 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
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE*****
Invocation	object	Koleksi hasil eksekusi perintah.
PageSize	integer	Jumlah entri per halaman dalam kueri berhalaman.	1
PageNumber	integer	Nomor halaman saat ini.	1
TotalCount	integer	Jumlah total perintah.	1
NextToken	string	Token paginasi yang dikembalikan dalam panggilan ini.	AAAAAdDWBF2
InvocationResults	object
InvocationResult	array<object>	Set hasil eksekusi perintah.
	array<object>
Dropped	integer	Panjang teks yang dipotong dan dibuang setelah panjang teks dalam bidang `Output` melebihi 24 KB.	0
OssOutputDelivery	string	Konfigurasi pengiriman OSS untuk output eksekusi perintah.	oss://testBucket/testPrefix
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 berjalan, dan perintah harus dapat dikirimkan dalam waktu 1 menit. Running: Perintah sedang dieksekusi pada instans. Success: Eksekusi satu kali: Eksekusi perintah selesai dan kode keluar adalah 0. Eksekusi terjadwal: Eksekusi terakhir berhasil dengan kode keluar 0, pengatur waktu eksekusi 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, pengatur waktu eksekusi yang ditentukan akan dihentikan. Error: Terjadi pengecualian selama eksekusi perintah dan perintah tidak dapat dilanjutkan. Timeout: Eksekusi perintah mengalami timeout. Cancelled: Aksi eksekusi perintah telah dibatalkan. Perintah tidak pernah dimulai. Stopping: Eksekusi perintah sedang dihentikan. Terminated: Perintah dihentikan selama eksekusi. Scheduled: Eksekusi satu kali: Tidak berlaku. Nilai ini tidak terjadi. Eksekusi terjadwal: Menunggu eksekusi.	Success
InstanceId	string	ID instans.	i-bp1i7gg30r52z2em****
ExitCode	integer	Kode keluar perintah. Untuk instans Linux, ini adalah kode keluar perintah shell. Untuk instans Windows, ini adalah kode keluar perintah 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 grup keamanan menolak akses ke layanan Asisten Cloud. The specified instance does not exist: Instans yang ditentukan tidak ada atau telah dilepaskan. The specified instance was released during task execution: Instans dilepaskan selama eksekusi Tugas. The specified instance was not running during task execution: Instans tidak Berjalan saat eksekusi Tugas dimulai. 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 ditingkatkan. The aliyun service in the instance need to be upgraded to at least version to support the feature: Agen Asisten Cloud perlu ditingkatkan. adalah versi minimum yang didukung untuk 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: 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 dilepaskan selama pengiriman file.	the specified instance does not exists
StartTime	string	Waktu ketika perintah mulai dieksekusi pada instans.	2019-12-20T06:15:55Z
Repeats	integer	Jumlah kali perintah dieksekusi 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 dieksekusi.	0
InvokeRecordStatus	string	Status eksekusi perintah. Nilai valid: Running: Perintah sedang Berjalan. Eksekusi terjadwal: Status eksekusi tetap Berjalan hingga Anda secara manual menghentikan perintah terjadwal. Eksekusi satu kali: Status eksekusi keseluruhan Berjalan selama ada proses perintah yang Berjalan. Finished: Eksekusi perintah selesai. Eksekusi terjadwal: Proses perintah tidak dapat memiliki status finished. Eksekusi satu kali: Semua instans telah menyelesaikan eksekusi, atau Anda secara manual menghentikan proses perintah pada beberapa instans dan instans sisanya telah menyelesaikan eksekusi. Failed: Eksekusi perintah gagal. Eksekusi terjadwal: Proses perintah tidak dapat memiliki status failed. Eksekusi satu kali: Semua instans gagal mengeksekusi perintah. PartialFailed: Eksekusi perintah sebagian gagal. Eksekusi terjadwal: Proses perintah tidak dapat memiliki status partially failed. Eksekusi satu kali: Beberapa instans memiliki proses perintah yang gagal, sehingga status eksekusi keseluruhan adalah partially failed. Stopped: Eksekusi perintah telah dihentikan. Stopping: Eksekusi perintah sedang dihentikan.	Running
FinishedTime	string	Waktu ketika eksekusi perintah selesai. Jika eksekusi perintah mengalami timeout, waktu penyelesaian dihitung sebagai `StartTime` ditambah periode timeout perintah `Timeout`.	2019-12-20T06:15:56Z
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 ketika pengiriman gagal. Bidang 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 memenuhi spesifikasi, termasuk nama objek yang tidak ditentukan, nama objek yang melebihi batas panjang, atau nama objek yang 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
Username	string	Nama pengguna yang digunakan untuk mengeksekusi perintah pada Instans ECS.	test
ContainerId	string	ID kontainer.	ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****
ContainerName	string	Nama kontainer.	test-container
Output	string	Output eksekusi perintah. Jika ContentEncoding diatur ke PlainText, output asli dikembalikan. Jika ContentEncoding diatur ke Base64, output yang dienkode Base64 dikembalikan.	MTU6MzA6MDEK
Launcher	string	Launcher yang digunakan untuk mengeksekusi skrip. Panjangnya tidak boleh melebihi 1 KB.	python3 -u {{ACS::ScriptFileName\|Ext(".py")}}
CommandId	string	ID perintah.	c-hz0jdfwcsr****
ErrorCode	string	Kode kesalahan untuk kegagalan pengiriman perintah atau kegagalan eksekusi. Nilai valid: Empty: Perintah dieksekusi secara normal. InstanceNotExists: Instans yang ditentukan tidak ada atau telah dilepaskan. InstanceReleased: Instans dilepaskan selama eksekusi konkuren. InstanceNotRunning: Instans tidak Berjalan selama eksekusi konkuren. CommandNotApplicable: Perintah tidak berlaku untuk instans yang ditentukan. AccountNotExists: Nama pengguna yang ditentukan untuk eksekusi konkuren 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 mengalami timeout. ExecutionTimeout: Eksekusi konkuren mengalami timeout. ExecutionException: Terjadi pengecualian selama eksekusi konkuren. ExecutionInterrupted: Eksekusi konkuren terganggu. ExitCodeNonzero: Eksekusi konkuren selesai dengan kode keluar bukan nol. SecurityGroupRuleDenied: Aturan grup keamanan menolak akses ke layanan Asisten Cloud. TaskConcurrencyLimit: Jumlah eksekusi Tugas konkuren melebihi kuota maksimum.	InstanceNotExists
InvokeId	string	ID eksekusi perintah.	t-hz0jdfwd9f****
TerminationMode	string	Mode yang digunakan saat menghentikan Tugas (penghentian manual atau interupsi karena timeout eksekusi). 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.	owner
TagValue	string	Nilai tag eksekusi perintah.	zhangsan
StopTime	string	Waktu ketika `StopInvocation` dipanggil untuk menghentikan eksekusi perintah.	2020-01-19T09:15:47Z

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE*****",
  "Invocation": {
    "PageSize": 1,
    "PageNumber": 1,
    "TotalCount": 1,
    "NextToken": "AAAAAdDWBF2",
    "InvocationResults": {
      "InvocationResult": [
        {
          "Dropped": 0,
          "OssOutputDelivery": "oss://testBucket/testPrefix",
          "InvocationStatus": "Success",
          "InstanceId": "i-bp1i7gg30r52z2em****",
          "ExitCode": 0,
          "ErrorInfo": "the specified instance does not exists",
          "StartTime": "2019-12-20T06:15:55Z",
          "Repeats": 0,
          "InvokeRecordStatus": "Running",
          "FinishedTime": "2019-12-20T06:15:56Z",
          "OssOutputUri": "oss://testBucket/testPrefix/output.txt",
          "OssOutputStatus": "Finished",
          "OssOutputErrorCode": "CloudAssistant.UnsupportedInvocationStatus",
          "OssOutputErrorInfo": "The invocation status does not support output delivery.",
          "Username": "test",
          "ContainerId": "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
          "ContainerName": "test-container",
          "Output": "MTU6MzA6MDEK",
          "Launcher": "python3 -u {{ACS::ScriptFileName|Ext(\".py\")}}",
          "CommandId": "c-hz0jdfwcsr****",
          "ErrorCode": "InstanceNotExists",
          "InvokeId": "t-hz0jdfwd9f****",
          "TerminationMode": "ProcessTree",
          "Tags": {
            "Tag": [
              {
                "TagKey": "owner",
                "TagValue": "zhangsan"
              }
            ]
          },
          "StopTime": "2020-01-19T09:15:47Z"
        }
      ]
    }
  }
}

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.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.
500	InternalError	The request processing has failed due to some unknown error.
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.