Mengkueri hasil eksekusi satu atau beberapa perintah Asisten Cloud, yang merupakan hasil eksekusi aktual pada Instans ECS.
Deskripsi operasi
Deskripsi operasi
-
Setelah Anda menjalankan perintah, perintah tersebut tidak dijamin berhasil atau menghasilkan output yang diharapkan. Panggil operasi ini untuk melihat 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 melakukan kueri halaman pertama, tetapkan hanya
MaxResultsuntuk membatasi jumlah entri yang dikembalikan. NilaiNextTokendalam tanggapan digunakan sebagai kredensial untuk mengkueri halaman berikutnya. Saat melakukan kueri halaman berikutnya, tetapkanNextTokenke nilaiNextTokenyang diperoleh dari tanggapan sebelumnya dan tetapkanMaxResultsuntuk membatasi jumlah entri yang dikembalikan. -
Perbedaan antara
DescribeInvocationsdanDescribeInvocationResults:- Saat satu panggilan
RunCommand/InvokeCommandmenentukan beberapa instans:DescribeInvocationsmengembalikan status eksekusi pada setiap instans dan status agregat di seluruh beberapa instans.DescribeInvocationResultshanya mengembalikan status eksekusi individual pada setiap instans, tanpa status agregat di seluruh beberapa instans.
- Saat satu panggilan
RunCommand/InvokeCommandmenentukan satu instans:DescribeInvocationsdanDescribeInvocationResultssebagian besar dapat saling menggantikan.
Saat Anda perlu melihat riwayat eksekusi Tugas terjadwal (periode) atau Tugas yang berjalan pada setiap startup sistem (
RepeatMode=Period, EveryReboot), hanyaDescribeInvocationResultsyang dapat mengembalikan catatan eksekusi historis (Anda harus menentukanIncludeHistory=true).DescribeInvocationshanya mengembalikan status Tugas terbaru.Saat Anda perlu melihat konten atau parameter perintah, hanya
DescribeInvocationsyang mengembalikanCommandContent.
- Saat satu panggilan
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ecs:DescribeInvocationResults |
get |
Command.
Instance.
|
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 dari eksekusi perintah. Setelah Anda menentukan parameter ini, ID kelompok sumber daya juga harus ditentukan saat Anda menjalankan perintah. Parameter ini digunakan untuk 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 |
| IncludeHistory |
boolean |
No |
Apakah akan mengembalikan catatan riwayat eksekusi perintah terjadwal. Nilai valid:
Nilai default: false. |
false |
| ContentEncoding |
string |
No |
Tipe pengkodean bidang
Nilai default: Base64. |
PlainText |
| PageNumber |
integer |
No |
Catatan
Parameter ini akan segera ditinggalkan. Gunakan NextToken dan MaxResults untuk melakukan kueri penomoran halaman. |
1 |
| PageSize |
integer |
No |
Catatan
Parameter ini akan segera ditinggalkan. Gunakan NextToken dan MaxResults untuk melakukan kueri penomoran halaman. |
1 |
| MaxResults |
integer |
No |
Jumlah entri maksimum per halaman untuk kueri penomoran halaman. Nilai maksimum: 50. Nilai default: 10. |
10 |
| NextToken |
string |
No |
Token penomoran halaman. Tetapkan parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya. |
AAAAAdDWBF2 |
| Tag |
array<object> |
No |
Tag. |
|
|
object |
No |
Tag. |
||
| Key |
string |
No |
Kunci tag dari eksekusi perintah. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Jika Anda menggunakan satu tag untuk memfilter Sumber daya, jumlah Sumber daya dengan tag ini tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah Sumber daya yang dilampirkan ke semua tag yang ditentukan tidak boleh melebihi 1.000. Jika jumlah Sumber daya melebihi 1.000, panggil ListTagResources untuk mengkueri Sumber daya. Panjang kunci tag dapat mencapai 64 karakter dan tidak boleh diawali dengan |
TestKey |
| Value |
string |
No |
Nilai tag dari eksekusi perintah. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh mengandung |
TestValue |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| Invocation |
object |
Kumpulan hasil eksekusi perintah. |
|
| InvocationResults |
object |
||
| InvocationResult |
array<object> |
Set hasil eksekusi perintah. |
|
|
array<object> |
|||
| CommandId |
string |
ID perintah. |
c-hz0jdfwcsr**** |
| ContainerId |
string |
ID kontainer. |
ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea**** |
| ContainerName |
string |
Nama kontainer. |
test-container |
| Dropped |
integer |
Ukuran teks yang dipotong dan dibuang saat bidang |
0 |
| ErrorCode |
string |
Kode kesalahan untuk kegagalan pengiriman atau eksekusi perintah. Nilai valid:
|
InstanceNotExists |
| ErrorInfo |
string |
Alasan detail untuk kegagalan pengiriman atau eksekusi perintah. Nilai valid:
|
the specified instance does not exists |
| ExitCode |
integer |
Kode keluar perintah.
|
0 |
| FinishedTime |
string |
Waktu saat eksekusi perintah selesai. Jika eksekusi perintah mencapai pengatur waktu, waktu penyelesaian dihitung sebagai |
2019-12-20T06:15:56Z |
| InstanceId |
string |
ID instans. |
i-bp1i7gg30r52z2em**** |
| InvocationStatus |
string |
Status eksekusi perintah pada satu instans. Nilai valid:
|
Success |
| InvokeId |
string |
ID eksekusi perintah. |
t-hz0jdfwd9f**** |
| InvokeRecordStatus |
string |
Status eksekusi perintah. Nilai valid:
|
Running |
| Launcher |
string |
Program bootstrap untuk eksekusi skrip. Nilai dapat memiliki panjang hingga 1 KB. |
python3 -u {{ACS::ScriptFileName|Ext(".py")}} |
| OssOutputDelivery |
string |
Konfigurasi pengiriman OSS untuk output eksekusi perintah. |
oss://testBucket/testPrefix |
| OssOutputErrorCode |
string |
Kode kesalahan saat pengiriman gagal. Parameter ini hanya dikembalikan saat OssOutputStatus adalah Failed. Nilai valid:
|
CloudAssistant.UnsupportedInvocationStatus |
| OssOutputErrorInfo |
string |
Detail error saat pengiriman gagal. Parameter ini hanya dikembalikan saat OssOutputStatus adalah Failed. |
The invocation status does not support output delivery |
| OssOutputStatus |
string |
Status pengiriman output eksekusi perintah. Nilai valid:
|
Finished |
| OssOutputUri |
string |
URI file yang dikirimkan ke OSS untuk output eksekusi perintah. Bidang ini berupa string kosong saat pengiriman gagal atau sedang berlangsung. |
oss://testBucket/testPrefix/output.txt |
| Output |
string |
Output dari eksekusi perintah.
|
MTU6MzA6MDEK |
| Repeats |
integer |
Jumlah kali perintah dijalankan pada instans.
|
0 |
| StartTime |
string |
Waktu saat perintah mulai berjalan pada instans. Waktu ditampilkan dalam format ISO 8601 dalam UTC. |
2019-12-20T06:15:55Z |
| StopTime |
string |
Waktu saat |
2020-01-19T09:15:47Z |
| Tags |
object |
||
| Tag |
array<object> |
Informasi tag dari eksekusi perintah. |
|
|
object |
Informasi tag dari eksekusi perintah. |
||
| TagKey |
string |
Kunci tag dari eksekusi perintah. |
owner |
| TagValue |
string |
Nilai tag dari eksekusi perintah. |
zhangsan |
| TerminationMode |
string |
Mode yang digunakan saat Tugas dihentikan (dihentikan secara manual atau terganggu karena pengatur waktu). Nilai valid:
|
ProcessTree |
| Username |
string |
Nama pengguna yang digunakan untuk menjalankan perintah pada Instans ECS. |
test |
| NextToken |
string |
Token penomoran halaman yang dikembalikan dalam panggilan ini. |
AAAAAdDWBF2 |
| PageNumber |
integer |
Nomor halaman saat ini. |
1 |
| PageSize |
integer |
Jumlah entri per halaman yang ditetapkan untuk kueri penomoran halaman. |
1 |
| TotalCount |
integer |
Jumlah total perintah. |
1 |
| RequestId |
string |
ID permintaan. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE***** |
Contoh
Respons sukses
JSONformat
{
"Invocation": {
"InvocationResults": {
"InvocationResult": [
{
"CommandId": "c-hz0jdfwcsr****",
"ContainerId": "ab141ddfbacfe02d9dbc25966ed971536124527097398d419a6746873fea****",
"ContainerName": "test-kontainer",
"Dropped": 0,
"ErrorCode": "InstanceNotExists",
"ErrorInfo": "Instans yang ditentukan tidak ada",
"ExitCode": 0,
"FinishedTime": "2019-12-20T06:15:56Z",
"InstanceId": "i-bp1i7gg30r52z2em****",
"InvocationStatus": "Success",
"InvokeId": "t-hz0jdfwd9f****",
"InvokeRecordStatus": "Running",
"Launcher": "python3 -u {{ACS::ScriptFileName|Ext(\".py\")}}",
"OssOutputDelivery": "oss://testBucket/testPrefix",
"OssOutputErrorCode": "CloudAssistant.UnsupportedInvocationStatus",
"OssOutputErrorInfo": "The invocation status does not support output delivery",
"OssOutputStatus": "Finished",
"OssOutputUri": "oss://testBucket/testPrefix/output.txt",
"Output": "MTU6MzA6MDEK",
"Repeats": 0,
"StartTime": "2019-12-20T06:15:55Z",
"StopTime": "2020-01-19T09:15:47Z",
"Tags": {
"Tag": [
{
"TagKey": "owner",
"TagValue": "zhangsan"
}
]
},
"TerminationMode": "ProcessTree",
"Username": "test"
}
]
},
"NextToken": "AAAAAdDWBF2",
"PageNumber": 1,
"PageSize": 1,
"TotalCount": 1
},
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE*****"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | RegionId.ApiNotSupported | The api is not supported in this region. | Pemanggilan API tidak didukung di wilayah tertentu. Periksa apakah nilai parameter RegionId benar. |
| 400 | NumberExceed.Tags | The Tags parameter number is exceed. | Jumlah tag melebihi batas maksimum. Anda dapat menentukan hingga 20 tag untuk operasi ini. |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | Terdapat kunci duplikat dalam tag. Pastikan semua kunci unik. |
| 400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | Parameter kunci tag yang ditentukan tidak valid. |
| 400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | Parameter nilai tag yang ditentukan tidak valid. |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | Tentukan kunci tag. |
| 400 | InvalidParam.PageNumber | The specified parameter is invalid. | |
| 400 | InvalidParam.PageSize | The specified parameter is invalid. | |
| 400 | InvalidParameter.NextToken | The specified parameter NextToken is not valid. | |
| 400 | InvalidParameter.MaxResults | The specified parameter MaxResults is not valid. | Parameter MaxResults yang ditentukan tidak valid. |
| 500 | InternalError.Dispatch | An error occurred when you dispatched the request. | Terjadi kesalahan saat mengirim permintaan. Coba lagi nanti. |
| 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 | InvalidParameterCharacter | The specified parameter %s contains illegal characters. | |
| 403 | Operation.Forbidden | The operation is not permitted. | Operasi tidak diizinkan. |
| 404 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | RegionId yang ditentukan tidak ada. Periksa apakah produk tersedia di wilayah ini. |
| 404 | InvalidCommandId.NotFound | The specified commandId does not exist |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.