You need to enable JavaScript to run this app.
导航
消息队列 RocketMQ版
  • 文档首页
    • /
  • 消息队列 RocketMQ版

DescribeInstances

最近更新时间：2024.03.06 16:49:22

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

我的收藏

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

注意事项

请求频率：该接口请求频率限制为 20 次/秒；单用户请求频率限制为 4 次/秒。

使用说明

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
    }
}