查詢異步任務列表。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
bdrc:DescribeTasks | none |
|
| 無 |
請求語法
GET /api/v1/tasks HTTP/1.1
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
TaskStatus | string | 否 | CREATED: 創建, RUNNING: 正在執行, COMPLETE: 任務成功完成, FAILED: 任務執行失敗, EXPIRED: 任務已過期, CANCELED: 任務已被取消 | RUNNING |
NextToken | string | 否 | 查詢憑證(Token),取值為上一次 API 調用返回的 NextToken 參數值。有關本接口查看返回數據的設置方式,請參見上文接口說明。 | cae**********699 |
MaxResults | integer | 否 | 返回的最大數。取值范圍:10~500。默認值:當不設置值或者設置的值小于 10,默認值為 10。當設置的值大于 500 時,默認值為 500。 | 10 |
返回參數
示例
正常返回示例
JSON
格式
{
"Data": {
"Content": [
{
"TaskId": "t-0000e4w0u1v592zdf6s7",
"TaskName": " empty",
"TaskDescription": " empty",
"TaskType": "UPDATE_RESOURCES",
"TaskPriority": "HIGH",
"RequestId": "AE43C4CB-8074-5EBD-9806-8CA6D12800B1",
"TaskDetail": "{\"resourceTypes\":[\"ACS::ECS::Instance\",\"ACS::OSS::Bucket\",\"ACS::OTS::Instance\",\"ACS::NAS::FileSystem\"]}",
"ExecutionId": "empty",
"Progress": 100,
"TaskStatus": "RUNNING",
"ErrorMessage": "device not online",
"StartTime": 1724983927,
"CompleteTime": 1724983927,
"ExpireTime": 1724983927
}
],
"NextToken": "f4b8c2504545a3b41af5e75147d17d12e3818a0b9b2ff9a2",
"MaxResults": 10,
"TotalCount": 100
},
"RequestId": "AE43C4CB-8074-5EBD-9806-8CA6D12800B1"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。