獲取指定專屬資源組中的機器實例列表。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
eas:ListResourceInstances | get |
|
| 無 |
請求語法
GET /api/v2/resources/{ClusterId}/{ResourceId}/instances HTTP/1.1
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ClusterId | string | 是 | 資源組所在的地域 ID。 | cn-shanghai |
ResourceId | string | 是 | 資源組的 ID。如何查詢資源組 ID,請參見 ListResources 。 | iot |
ChargeType | string | 否 | 過濾機器付費類型,取值如下:
| PrePaid |
PageNumber | integer | 否 | 專屬資源組機器列表的頁碼。起始值為 1,默認為 1。 | 1 |
PageSize | integer | 否 | 分頁查詢時設置的每頁顯示的機器數量,默認為 100。 | 20 |
InstanceName | string | 否 | 按實例名稱過濾。 | e-xxxx*** |
InstanceId | string | 否 | 按實例 ID 過濾。如何獲取實例 ID,請參見 ListResourceInstances 。 | i-bp1jd6x3uots****a |
InstanceIP | string | 否 | 機器 IP。 | 10.224.xx.xx |
Filter | string | 否 | 關鍵字搜索。支持按機器 ID 或 IP 進行搜索。 | 10.224.xx.xx |
InstanceStatus | string | 否 | 機器狀態。 枚舉值:
| Ready |
Sort | string | 否 | 排序字段。 枚舉值:
| CreateTime |
Order | string | 否 | 排序順序。 枚舉值:
| desc |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "40325405-579C-4D82****",
"Instances": [
{
"InstanceId": "eas-i-1800z74n30kao****",
"InstanceName": "eas01122713204*****",
"InstanceIp": "11.227.XX.XX",
"InstanceStatus": "Ready",
"InstanceCpuCount": 4,
"InstanceGpuCount": 0,
"InstanceMemory": "8192M",
"InstanceSystemDiskSize": 200,
"InstanceGpuMemory": "0G",
"InstanceUsedCpu": 2.4,
"InstanceUsedGpu": 0,
"InstanceUsedMemory": "1000M",
"InstanceType": "ecs.s6-c1m2.xlarge",
"CreateTime": "2020-07-05T22:51:32Z",
"ChargeType": "PrePaid",
"ExpiredTime": "2020-08-05T22:51:32Z",
"AutoRenewal": false,
"Arch": "arm64",
"Region": "cn-hangzhou",
"Zone": "cn-hangzhou-b",
"ResourceId": "eas-r-xxxxx",
"InstanceTenantIp": "192.168.xx.xx",
"InstanceUsedGpuMemory": "470M"
}
],
"PageNumber": 1,
"PageSize": 20,
"TotalCount": 2
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2023-05-06 | OpenAPI 入參發生變更 | 查看變更詳情 |
2022-11-29 | OpenAPI 入參發生變更 | 查看變更詳情 |