查询所有实例列表 - ListInstances
功能介绍
查询租户的实例列表,支持按照条件查询。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
dms:instance:list
List
rabbitmq *
g:EnterpriseProjectId
-
-
URI
GET /v2/{project_id}/instances
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| engine | 是 | String | 参数解释: 引擎类型:rabbitmq。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| name | 否 | String | 参数解释: 实例名称。获取方式:调用查询所有实例列表接口,从响应体中获取实例名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| instance_id | 否 | String | 参数解释: 实例ID。获取方法如下:调用查询所有实例列表接口,从响应体中获取实例ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| status | 否 | String | 参数解释: 实例状态,详细状态说明请参考实例状态说明。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| include_failure | 否 | String | 参数解释: 是否返回创建失败的实例数。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| exact_match_name | 否 | String | 参数解释: 是否按照实例名称进行精确匹配查询。 约束限制: 不涉及。 取值范围: 默认取值: false |
| enterprise_project_id | 否 | String | 参数解释: 企业项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| offset | 否 | String | 参数解释: 偏移量,表示从此偏移量开始查询。 约束限制: 不涉及。 取值范围: 大于等于0 默认取值: 不涉及。 |
| limit | 否 | String | 参数解释: 当次查询返回的最大实例个数。 约束限制: 不涉及。 取值范围: 1~50 默认取值: 10 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| instances | Array of ShowInstanceResp objects | 参数解释: 实例列表。 |
| instance_num | Integer | 参数解释: 实例个数。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| access_user | String | 参数解释: 认证用户名。 取值范围: 不涉及。 |
| broker_num | Integer | 参数解释: 代理个数。 取值范围: |
| name | String | 参数解释: 实例名称。 取值范围: 不涉及。 |
| engine | String | 参数解释: 消息引擎类型。 取值范围: rabbitmq:RabbitMQ引擎。 |
| engine_version | String | 参数解释: 消息引擎版本。 取值范围: |
| specification | String | 参数解释: 实例规格。 取值范围: |
| storage_space | Integer | 参数解释: 消息存储空间,单位:GB。 取值范围: 不涉及。 |
| used_storage_space | Integer | 参数解释: 已使用的消息存储空间,单位:GB。 取值范围: 不涉及。 |
| dns_enable | Boolean | 参数解释: 实例是否开启域名访问功能。 取值范围: |
| connect_address | String | 参数解释: 实例内网连接IP地址。 取值范围: 不涉及。 |
| connect_domain_name | String | 参数解释: 实例内网连接域名。 取值范围: 不涉及。 |
| public_connect_address | String | 参数解释: 实例公网连接IP地址。 取值范围: 不涉及。 |
| public_connect_domain_name | String | 参数解释: 实例公网连接域名。 取值范围: 不涉及。 |
| port | Integer | 参数解释: 实例连接端口。 取值范围: 不涉及。 |
| status | String | 参数解释: 实例状态。 取值范围: 详细状态说明请参考实例状态说明。 |
| description | String | 参数解释: 实例描述。 取值范围: 不涉及。 |
| instance_id | String | 参数解释: 实例ID。 取值范围: 不涉及。 |
| resource_spec_code | String | 参数解释: 资源规格标识。 取值范围:
|
| charging_mode | Integer | 参数解释: 付费模式。 取值范围: |
| vpc_id | String | 参数解释: VPC ID。 取值范围: 不涉及。 |
| vpc_name | String | 参数解释: VPC的名称。 取值范围: 不涉及。 |
| created_at | String | 参数解释: 完成创建时间。格式为时间戳,指从格林威治时间 1970年01月01日00时00分00秒起至指定时间的偏差总毫秒数。 取值范围: 不涉及。 |
| user_id | String | 参数解释: 用户ID。 取值范围: 不涉及。 |
| user_name | String | 参数解释: 用户名。 取值范围: 不涉及。 |
| order_id | String | 参数解释: 订单ID,只有在包周期计费时才会有order_id值,其他计费方式order_id值为空。 取值范围: 不涉及。 |
| maintain_begin | String | 参数解释: 维护时间窗开始时间,格式为HH:mm:ss。 取值范围: 不涉及。 |
| maintain_end | String | 参数解释: 维护时间窗结束时间,格式为HH:mm:ss。 取值范围: 不涉及。 |
| enable_publicip | Boolean | 参数解释: RabbitMQ实例是否开启公网访问功能。 取值范围: |
| publicip_address | String | 参数解释: RabbitMQ实例绑定的弹性IP地址。 如果未开启公网访问功能,该字段值为null。 取值范围: |
| publicip_id | String | 参数解释: RabbitMQ实例绑定的弹性IP地址的ID。 如果未开启公网访问功能,该字段值为null。 取值范围: 不涉及。 |
| management_connect_address | String | 参数解释: RabbitMQ实例的管理地址。 取值范围: 不涉及。 |
| management_connect_domain_name | String | 参数解释: RabbitMQ实例的管理域名。 取值范围: 不涉及。 |
| public_management_connect_address | String | 参数解释: RabbitMQ实例的公网管理地址。 取值范围: 不涉及。 |
| public_management_connect_domain_name | String | 参数解释: RabbitMQ实例的公网管理域名。 取值范围: 不涉及。 |
| ssl_enable | Boolean | 参数解释: 是否开启安全认证。 取值范围: |
| enterprise_project_id | String | 参数解释: 企业项目ID。 取值范围: 不涉及。 |
| is_logical_volume | Boolean | 参数解释: 实例扩容时用于区分老实例与新实例。 取值范围: |
| extend_times | Integer | 参数解释: 实例扩容磁盘次数。 取值范围: 不涉及。 |
| type | String | 参数解释: 实例类型。 取值范围: |
| product_id | String | 参数解释: 产品标识。 取值范围: 不涉及。 |
| security_group_id | String | 参数解释: 安全组ID。 取值范围: 不涉及。 |
| security_group_name | String | 参数解释: 租户安全组名称。 取值范围: 不涉及。 |
| subnet_id | String | 参数解释: 子网ID。 取值范围: 不涉及。 |
| available_zones | Array of strings | 参数解释: 实例节点所在的可用区ID。 |
| available_zone_names | Array of strings | 参数解释: 实例节点所在的可用区名称。 |
| total_storage_space | Integer | 参数解释: 总共消息存储空间,单位:GB。 取值范围: 不涉及。 |
| storage_resource_id | String | 参数解释: 存储资源ID。 取值范围: 不涉及。 |
| storage_spec_code | String | 参数解释: IO规格。 取值范围: 不涉及。 |
| ipv6_enable | Boolean | 参数解释: 是否开启IPv6。 取值范围: |
| ipv6_connect_addresses | Array of strings | 参数解释: IPv6的连接地址。 |
| tags | Array of TagEntity objects | 参数解释: 标签列表。 |
| service_type | String | 参数解释: 服务类型。 取值范围: advanced:服务类型。 |
| storage_type | String | 参数解释: 存储类型。 取值范围: hec:存储类型。 |
| disk_encrypted | Boolean | 参数解释: 是否开启磁盘加密。 取值范围: |
| disk_encrypted_key | String | 参数解释: 磁盘加密key,未开启磁盘加密时为空。 取值范围: 不涉及。 |
请求示例
查询所有实例列表。
GET https://{endpoint}/v2/{project_id}/instances 响应示例
状态码:200
查询所有实例列表成功。
{
"instances" : [ {
"name" : "api-explorer",
"engine" : "rabbitmq",
"port" : 5672,
"status" : "RUNNING",
"type" : "single",
"specification" : "2vCPUs 4GB",
"engine_version" : "3.8.35",
"connect_address" : "192.168.0.74",
"instance_id" : "de873040-d661-4770-aa96-9329c71d7c8a",
"resource_spec_code" : "dms.instance.rabbitmq.single.c3.2u4g",
"charging_mode" : 1,
"vpc_id" : "40a6501e-85ca-4449-a0db-b8bc7f0cec28",
"vpc_name" : "vpc-a400",
"created_at" : "1590047080687",
"product_id" : "00300-30109-0--0",
"security_group_id" : "bfd68e26-f8ef-4a91-a373-0a8f5c198601",
"security_group_name" : "Sys-default",
"subnet_id" : "a7f9a564-30dd-4059-8124-364ca6554578",
"available_zones" : [ "9f1c5806706d4c1fb0eb72f0a9b18c77" ],
"available_zone_names" : [ "AZ1" ],
"user_id" : "3df5acbc24a54fadb62a043c9000a307",
"user_name" : "********",
"maintain_begin" : "22:00:00",
"maintain_end" : "02:00:00",
"storage_space" : 88,
"total_storage_space" : 100,
"used_storage_space" : 4,
"enable_publicip" : false,
"ssl_enable" : false,
"management_connect_address" : "http://192.168.0.74:15672",
"storage_resource_id" : "52be287d-1d6a-4d30-937e-185b3f176fc4",
"storage_spec_code" : "dms.physical.storage.normal",
"enterprise_project_id" : "0",
"tags" : [ {
"key" : "key1",
"value" : "value1"
}, {
"key" : "key2",
"value" : "value2"
} ],
"is_logical_volume" : true,
"extend_times" : 0,
"ipv6_enable" : false,
"ipv6_connect_addresses" : [ ]
} ],
"instance_num" : 1
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询所有实例列表成功。 |
错误码
请参见错误码。