DescribeInvocationResults - Elastic Compute Service - Alibaba Cloud Documentation Center

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

Deskripsi operasi

Setelah Anda menjalankan perintah, perintah tidak dijamin berhasil atau menghasilkan hasil yang diharapkan. Panggil operasi ini untuk Tampilan hasil eksekusi aktual berdasarkan output aktual.
Anda dapat mengkueri informasi eksekusi dari 30 hari terakhir. Maksimal 10.000 entri informasi eksekusi dapat disimpan.
Anda dapat menggunakan langganan event status Tugas Asisten Cloud untuk mendapatkan hasil Tugas melalui event, yang menghindari polling berulang dan meningkatkan efisiensi.
Saat mengkueri halaman pertama secara terpaginasi, tetapkan hanya MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken dalam tanggapan berfungsi sebagai token untuk mengkueri halaman berikutnya. Saat mengkueri halaman berikutnya secara terpaginasi, 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 di seluruh Instans.
- Saat satu panggilan RunCommand/InvokeCommand menentukan satu Instans:
  - DescribeInvocations dan DescribeInvocationResults sebagian besar dapat dipertukarkan.
- Saat Anda ingin Tampilan riwayat eksekusi Tugas terjadwal (periode) atau Tugas yang berjalan pada setiap startup sistem (RepeatMode=Period, EveryReboot), hanya DescribeInvocationResults yang dapat mengembalikan catatan eksekusi historis (Anda harus menentukan IncludeHistory=true). DescribeInvocations hanya mengembalikan status Tugas terbaru.
- Saat Anda ingin 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:DescribeInvocationResults

get

Command

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

Instance

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 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****
InstanceId	string	No	ID eksekusi perintah. Anda dapat memanggil DescribeInvocations untuk mengkueri InvokeId.	i-bp1i7gg30r52z2em****
CommandId	string	No	ID instans	c-hz0jdfwcsr****
InvokeRecordStatus	string	No	ID perintah.	Running
IncludeHistory	boolean	No	Status eksekusi perintah. Nilai valid: Running: Perintah sedang Berjalan. Scheduled execution: Status eksekusi tetap Berjalan hingga Anda menghentikan perintah terjadwal secara manual. One-time execution: Status eksekusi keseluruhan Berjalan selama ada proses perintah yang Berjalan. Finished: Eksekusi perintah selesai. Scheduled execution: Proses perintah tidak dapat memiliki status finished. One-time execution: Semua Instans telah menyelesaikan eksekusi, atau Anda menghentikan proses perintah secara manual pada beberapa Instans dan Instans yang tersisa telah menyelesaikan eksekusi. Success: One-time execution: Eksekusi perintah selesai dan kode keluar adalah 0. Scheduled execution: Eksekusi terakhir berhasil dengan kode keluar 0, dan pengatur waktu eksekusi yang ditentukan telah berakhir. Failed: Eksekusi perintah gagal. Scheduled execution: Proses perintah tidak dapat memiliki status failed. One-time execution: Eksekusi perintah gagal pada semua Instans. PartialFailed: Eksekusi perintah gagal sebagian. Scheduled execution: Proses perintah tidak dapat memiliki status partially failed. One-time execution: Eksekusi perintah gagal pada beberapa Instans, sehingga status eksekusi keseluruhan adalah partially failed. Stopped: Eksekusi perintah telah dihentikan. Stopping: Eksekusi perintah sedang dihentikan.	false
ContentEncoding	string	No	Apakah akan mengembalikan riwayat eksekusi perintah terjadwal. Nilai valid: true: Mengembalikan hasil eksekusi perintah terjadwal. Saat parameter ini ditetapkan ke true, parameter InvokeId diperlukan dan harus berupa ID eksekusi perintah terjadwal (RepeatMode adalah Period) atau perintah yang berjalan pada setiap startup sistem (RepeatMode adalah EveryReboot). false: Tidak mengembalikan riwayat eksekusi. Nilai default: false.	PlainText
PageNumber	integer	No	Metode pengodean 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.	1
PageSize	integer	No	Catatan Parameter ini akan segera dihentikan. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri terpaginasi.	1
MaxResults	integer	No	Catatan Parameter ini akan segera dihentikan. Gunakan NextToken dan MaxResults untuk menyelesaikan operasi kueri terpaginasi.	10
NextToken	string	No	Jumlah maksimum entri per halaman dalam kueri terpaginasi. Nilai maksimum: 50. Nilai default: 10.	AAAAAdDWBF2
Tag	array<object>	No	Token paginasi. Tetapkan parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.
	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 dapat mencapai 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 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 menjalankan kueri. Panjang kunci tag dapat mencapai 64 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag tidak boleh mengandung `http://` atau `https://`.	TestKey
		No	Tag.

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE*****
Invocation	object	Kumpulan hasil eksekusi perintah.
PageSize	integer	Jumlah entri per halaman. Nilai ini adalah nilai PageSize yang ditentukan dalam pengaturan kueri terpaginasi.	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 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 dikirim dalam waktu 1 menit. Running: Perintah sedang dijalankan pada instans. Success: One-time execution: Eksekusi perintah selesai dan kode keluar adalah 0. Scheduled execution: Eksekusi terakhir berhasil dengan kode keluar 0, pengatur waktu eksekusi yang ditentukan telah berakhir. Failed: One-time execution: Eksekusi perintah selesai dan kode keluar bukan 0. Scheduled execution: Eksekusi terakhir berhasil dengan kode keluar bukan 0, pengatur waktu eksekusi yang ditentukan akan dihentikan. Error: Terjadi pengecualian selama eksekusi perintah dan perintah tidak dapat dilanjutkan. Timeout: Eksekusi perintah mencapai batas waktu. Cancelled: Eksekusi perintah telah dibatalkan. Perintah tidak pernah dimulai. Stopping: Eksekusi perintah sedang dihentikan. Terminated: Perintah dihentikan selama eksekusi. Scheduled: One-time execution: Tidak berlaku. Nilai ini tidak akan muncul. Scheduled execution: 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 atau eksekusi perintah. Nilai valid: Empty: Perintah berjalan normal. The security group rules denied access to the aliyun service: Aturan grup keamanan menolak akses ke layanan aliyun. 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 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 ditingkatkan. The aliyun service in the instance need to be upgraded to at least version <version> to support the <feature> feature: Agen Asisten Cloud perlu ditingkatkan. <version> adalah versi minimum yang didukung untuk fitur tersebut, dan <feature> adalah fitur spesifik. The command delivery has been timeout: Pengiriman perintah mencapai batas waktu. The command execution has been timeout: Eksekusi perintah mencapai batas 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 ketika 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
InvokeRecordStatus	string	Status eksekusi perintah. Nilai valid: Running: Perintah sedang berjalan. Scheduled execution: Status eksekusi tetap berjalan hingga Anda menghentikan perintah terjadwal secara manual. One-time execution: Status eksekusi keseluruhan berjalan selama ada proses perintah yang berjalan. Finished: Eksekusi perintah selesai. Scheduled execution: Proses perintah tidak dapat memiliki status finished. One-time execution: Semua instans telah menyelesaikan eksekusi, atau Anda menghentikan proses perintah secara manual pada beberapa instans dan instans yang tersisa telah menyelesaikan eksekusi. Failed: Eksekusi perintah gagal. Scheduled execution: Proses perintah tidak dapat memiliki status failed. One-time execution: Semua instans gagal menjalankan perintah. PartialFailed: Eksekusi perintah sebagian gagal. Scheduled execution: Proses perintah tidak dapat memiliki status partially failed. One-time execution: 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 mencapai pengatur waktu, waktu penyelesaian dihitung sebagai StartTime ditambah periode pengatur waktu Timeout.	2019-12-20T06:15:56Z
OssOutputUri	string	URI file di OSS tempat output eksekusi perintah dikirim. Bidang ini berupa string kosong jika pengiriman sedang berlangsung atau gagal.	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 yang dikembalikan 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 harus lebih baru dari 2.2.4.1007 untuk instans Linux dan lebih baru dari 2.1.4.1007 untuk instans Windows. OSS.AccessDenied: Pengguna tidak memiliki izin akses pada bucket yang ditentukan. OSS.NoSuchBucket: Bucket yang ditentukan tidak ada. OSS.FileImmutable: Data di bucket dalam status perlindungan. OSS.InvalidObjectName: Nama objek tidak valid. Nama objek tidak ditentukan, melebihi batas panjang, atau tidak valid.	CloudAssistant.UnsupportedInvocationStatus
OssOutputErrorInfo	string	Detail error yang dikembalikan 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 menjalankan perintah pada Instans ECS.	test
ContainerId	string	ID kontainer.	ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****
ContainerName	string	Nama kontainer.	test-container
Output	string	Output eksekusi perintah. Jika ContentEncoding ditetapkan ke PlainText, output asli dikembalikan. Jika ContentEncoding ditetapkan ke Base64, output yang dikodekan Base64 dikembalikan.	MTU6MzA6MDEK
Launcher	string	Program bootstrap untuk eksekusi skrip. Panjang nilai tidak boleh melebihi 1 KB.	python3 -u {{ACS::ScriptFileName\|Ext(".py")}}
CommandId	string	ID perintah.	c-hz0jdfwcsr****
ErrorCode	string	Kode kesalahan untuk kegagalan pengiriman atau eksekusi perintah. Nilai valid: Empty: Perintah berjalan normal. InstanceNotExists: Instans yang ditentukan tidak ada atau telah dirilis. InstanceReleased: Instans dirilis selama eksekusi bersamaan. InstanceNotRunning: Instans tidak berjalan selama eksekusi bersamaan. CommandNotApplicable: Perintah tidak berlaku untuk instans yang ditentukan. AccountNotExists: Nama pengguna yang ditentukan untuk eksekusi bersamaan 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 mencapai batas waktu. ExecutionTimeout: Eksekusi bersamaan mencapai batas waktu. ExecutionException: Terjadi pengecualian selama eksekusi bersamaan. ExecutionInterrupted: 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
InvokeId	string	ID eksekusi perintah.	t-hz0jdfwd9f****
TerminationMode	string	Mode yang digunakan ketika tugas dihentikan (dihentikan secara manual atau terganggu karena batas waktu). 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
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.
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.
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.