功能介紹
查詢一個(gè)異步請(qǐng)求任務(wù)（Job）的執(zhí)行狀態(tài)。
對(duì)于創(chuàng)建 云服務(wù)器 、刪除云服務(wù)器、云服務(wù)器批量操作和網(wǎng)卡操作等異步API，命令下發(fā)后，會(huì)返回任務(wù)ID（Job_id），通過(guò)Job_id可以查詢本次異步請(qǐng)求任務(wù)的執(zhí)行狀態(tài)。
如何獲取job_id，請(qǐng)參考響應(yīng)（任務(wù)類）。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /v1/{project_id}/jobs/{job_id}
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請(qǐng)參見(jiàn)獲取項(xiàng)目ID。 |
|
job_id |
是 |
異步請(qǐng)求的任務(wù)ID。 |
請(qǐng)求消息
無(wú)
響應(yīng)消息
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
status |
String |
Job的狀態(tài)。
|
|
entities |
Object |
Job操作的對(duì)象。 根據(jù)不同Job類型，顯示不同的內(nèi)容，云服務(wù)器相關(guān)操作顯示server_id，網(wǎng)卡相關(guān)操作顯示nic_id。有子Job時(shí)為子job的詳情。 |
|
job_id |
String |
異步請(qǐng)求的任務(wù)ID。 |
|
job_type |
String |
異步請(qǐng)求的任務(wù)類型。 |
|
begin_time |
String |
開始時(shí)間。 |
|
end_time |
String |
結(jié)束時(shí)間。 |
|
error_code |
String |
Job執(zhí)行失敗時(shí)的錯(cuò)誤碼。 Job執(zhí)行成功后，該值為null。 |
|
fail_reason |
String |
Job執(zhí)行失敗時(shí)的錯(cuò)誤原因。 Job執(zhí)行成功后，該值為null。 |
|
message |
String |
查詢Job的API請(qǐng)求出現(xiàn)錯(cuò)誤時(shí)，返回的錯(cuò)誤消息。 |
|
code |
String |
查詢Job的API請(qǐng)求出現(xiàn)錯(cuò)誤時(shí)，返回的錯(cuò)誤碼。 錯(cuò)誤碼和其對(duì)應(yīng)的含義請(qǐng)參考通用請(qǐng)求返回值。 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
sub_jobs_total |
Integer |
子任務(wù)數(shù)量。 |
|
sub_jobs |
Array of objects |
每個(gè)子任務(wù)的執(zhí)行信息。 |
請(qǐng)求示例
查詢一個(gè)異步請(qǐng)求任務(wù)（Job）的執(zhí)行狀態(tài)。
GET https://{endpoint}/v1/{project_id}/jobs/{job_id}
響應(yīng)示例
{
"status": "SUCCESS",
"entities": {
"sub_jobs_total": 1,
"sub_jobs": [
{
"status": "SUCCESS",
"entities": {
"server_id": "bae51750-0089-41a1-9b18-5c777978ff6d"
},
"job_id": "2c9eb2c5544cbf6101544f0635672b60",
"job_type": "createSingleServer",
"begin_time": "2016-04-25T20:04:47.591Z",
"end_time": "2016-04-25T20:08:21.328Z",
"error_code": null,
"fail_reason": null
}
]
},
"job_id": "2c9eb2c5544cbf6101544f0602af2b4f",
"job_type": "createServer",
"begin_time": "2016-04-25T20:04:34.604Z",
"end_time": "2016-04-25T20:08:41.593Z",
"error_code": null,
"fail_reason": null
}
返回值
請(qǐng)參考通用請(qǐng)求返回值。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
