預留實例、SCU覆蓋率明細查詢。
接口說明
- 與費用中心“資源實例管理”菜單中的“覆蓋率概況”的列表數據一致。
- 當前支持 RI 和 SCU 兩種資源的覆蓋率查詢。
- 提供“小時”、“天”,“月”三種維度的覆蓋率查詢。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
bssapi:DescribeResourceCoverageDetail | Read |
|
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
StartPeriod | string | 是 | 格式:yyyy-MM-dd HH:mm:ss; 查詢邏輯為包括該時間 | 2021-01-01 00:00:00 |
EndPeriod | string | 否 | 格式:yyyy-MM-dd HH:mm:ss;查詢邏輯為不包括該時間;為空表示截止到當前時間 | 2021-01-02 00:00:00 |
PeriodType | string | 是 | MONTH:月維度; DAY:天維度; HOUR:小時維度; | HOUR |
NextToken | string | 否 | 分頁 token,首頁查詢時傳空,查詢結果中返回下一頁 token 地址。當結果 token 為空時表示全部查完。 | eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9 |
MaxResults | integer | 否 | 本次讀取的最大數據記錄數量。默認值:20,最大值:300。 | 200 |
BillOwnerId | long | 否 | 資源歸屬賬號的 ID,資源歸屬賬號是實際使用資源的賬號。 | 123745698925000 |
ResourceType | string | 是 | RI:預留實例;SCU:存儲容量單位包 | RI |
返回參數
示例
正常返回示例
JSON
格式
{
"Code": "Success",
"Message": "Successful!",
"RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
"Success": true,
"Data": {
"NextToken": "eyJwYWdlTnVtIjoyLCJwYWdlU2l6ZSI6MTB9",
"TotalCount": 10000,
"MaxResults": 200,
"Items": [
{
"CommodityCode": "ecs",
"ProductName": "云服務器 ECS",
"TotalQuantity": 1,
"RegionNo": "cn-hangzhou-dg-a01",
"UserId": "123745698925000",
"CommodityName": "云服務器ECS-按量付費",
"CapacityUnit": "算力*小時",
"InstanceId": "i-bp1d9x623987rlj0dx4xx",
"Currency": "CNY",
"ZoneName": "杭州 可用區I",
"InstanceSpec": "ecs.t5-lc2m1.nano",
"EndTime": "2021-04-01 01:00:00",
"StartTime": "2021-04-01 00:00:00",
"PaymentAmount": 0,
"CoveragePercentage": 1,
"Region": "華東1(杭州)",
"DeductQuantity": 1,
"Zone": "cn-hangzhou-i",
"UserName": "test13@test.aliyun.com",
"ProductCode": "ecs"
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。