You need to enable JavaScript to run this app.
导航

DescribeInstances

最近更新时间2023.08.11 14:31:54

首次发布时间2023.07.12 16:22:33

调用 DescribeInstances 接口获取当前账户下的实例列表。

使用说明

DescribeInstances 是分页式的查询接口,返回符合筛选条件的实例列表及概览信息。如需获取指定实例的详细信息,可以指定实例 ID 进行查询,或直接使用 DescribeInstanceDetail 接口。

请求参数

参数

参数类型

是否必选

示例值

说明

PageSize

Integer

10

查询结果分页展示时,此参数用于表示每页的数据量。取值范围为1~100。

PageNumber

Integer

1

查询结果分页展示时,此参数用于表示页码。支持的最小值为 1。

InstanceId

String

rocketmq-cnaib413a08c****

实例 ID。指定实例 ID 时,表示查看指定实例的信息,此时 InstanceName 等其他筛选项不生效。
精确查询。

InstanceName

String

myinstance

根据实例名称筛选。支持模糊查询。

VpcId

String

根据实例绑定的 VPC ID 筛选。精确查询。

Version

String

4.8

支持的 RocketMQ 版本。当前支持的版本包括:

  • 4.8:兼容 RocketMQ 4.x 版本系列

InstanceStatus

String

Running

实例当前的状态。

ChargeType

String

PostPaid

根据付费类型查询。精确查询。支持设置为:

  • PostPaid:按量付费
  • PrePaid:包年包月

Spec

String

rocketmq.n1.x2.small

实例的计算规格。精确查询。

ZoneId

String

cn-shanghai-a

实例所在的可用区 ID。

说明

消息队列 RocketMQ版实例支持跨 AZ 部署,查看指定可用区下提供哪些计算规格时,可以指定多个可用区。多个可用区ID之间以逗号(,)间隔。
您可以调用 DescribeAvailabilityZones 查询当前提供服务的可用区列表。

SortBy

String

Status

实例查询结果排序字段。默认使用 Status 进行排序。可设置为:

  • Status:实例状态
  • CreateTime:实例创建时间
  • UsedTopicNumber:实例的 Topic 数量
  • UsedGroupNumber:实例的 Group 数量

SortOrder

String

Desc

实例查询使用的排序方式。默认为 Desc,即降序。

  • Asc:升序
  • Desc:降序。

Tags

Map<String, Array of String>

{ "tag-wzx" : ["11"] }

实例的标签。

ProjectName

String

testProject

根据实例所属的 IAM 项目进行筛选。不指定此参数时,返回该操作账号具备查看权限的实例列表。

响应参数

参数

参数类型

示例值

说明

Total

Integer

1

实例总数。

InstancesInfo

Array of BasicInstanceInfoObject

实例的名称、版本等基本信息。详细信息请参考BasicInstanceInfoObject

示例

请求示例

POST /?Action=DescribeInstances&Version=2023-01-01 HTTP/1.1
Content-Type: application/json
Host: rocketmq.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-shanghai/rocketmq/request, SignedHeaders=x-date, Signature=********

{
  "PageSize": 10,
  "PageNumber": 1
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "2023050817364118132DDDCE5933454CEB",
        "Action": "DescribeInstances",
        "Version": "2023-01-01",
        "Service": "RocketMQ",
        "Region": "cn-shanghai"
    },
    "Result": {
        "InstancesInfo": [
            {
                "AccountId": "2000006376",
                "ApplyPrivateDNSToPublic": false,
                "AvailableQueueNumber": 3944,
                "ChargeDetail": {
                    "ChargeExpireTime": "1970-01-01T00:00:00Z",
                    "ChargeStatus": "Normal",
                    "ChargeType": "PostPaid",
                    "OverdueReclaimTime": "1970-01-01T00:00:00Z",
                    "OverdueTime": "1970-01-01T00:00:00Z",
                    "PeriodUnit": "Monthly"
                },
                "ComputeSpec": "rocketmq.n1.x2.micro",
                "CreateTime": "2023-05-08T09:11:15Z",
                "Defer": false,
                "DiskEncrypted": false,
                "EipId": "eip-22j06qkez64u87r2qr105****",
                "EnableByteProxyRateLimit": false,
                "EnableSSL": true,
                "FileReservedTime": 0,
                "HTTPProxy": false,
                "InstanceDescription": "",
                "InstanceId": "rocketmq-cnai1f0c29ca****",
                "InstanceName": "rocketmq-cnai1f0c29ca****",
                "InstanceStatus": "Running",
                "ProjectName": "",
                "RegionId": "cn-shanghai",
                "SSLMode": "enforcing",
                "StorageSpace": 300,
                "StorageType": "flexPL",
                "SubnetId": "subnet-22j3oc7a7rvuo7r2qr29u****",
                "Tags": {
                    "tag": "1"
                },
                "UsedGroupNumber": 0,
                "UsedStorageSpace": 0,
                "UsedTopicNumber": 0,
                "Version": "4.8",
                "VpcId": "vpc-3qe3nxqooqccg7prmkznr****",
                "ZoneId": "cn-shanghai-a"
            }
        ],
        "Total": 1
    }
}