使用DescribeDBInstanceAttribute查询实例属性-云数据库 MongoDB 版-阿里云-云数据库 MongoDB 版(MongoDB)-阿里云帮助中心

查询云数据库 MongoDB 实例的信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dds:DescribeDBInstanceAttribute

get

*dbinstance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

无

请求参数

名称	类型	必填	描述	示例值
Engine	string	否	数据库引擎，固定取值：MongoDB。枚举值： MongoDB : MongoDB 数据库引擎	MongoDB
DBInstanceId	string	是	实例 ID。	dds-bp11483712c1****
ResourceGroupId	string	否	资源组 ID。资源组详情请参见查看资源组基本信息。说明目前仅中国站支持配置该参数。	rg-acfmyiu4ekp****
IsDelete	boolean	否	实例是否已删除，取值说明： false：实例正常运行，查询运行中实例信息。 true：实例已删除，查询被删除实例的信息。	false

返回参数

名称	类型	描述	示例值
	object	实例详细信息。
RequestId	string	请求 ID。	A935A8EE-A6CC-53DE-98BA-20ABAA7E632B
DBInstances	object
DBInstance	array<object>	实例详细信息。
	array<object>	实例详细信息。
CreationTime	string	实例的创建时间，格式为yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2022-01-02T07:43:59Z
ReplicaSets	object
ReplicaSet	array<object>	副本集实例信息。说明当实例类型为副本集实例时，返回该参数。
	object	副本集实例信息。说明当实例类型为副本集实例时，返回该参数。
VSwitchId	string	交换机 ID。说明当实例的网络类型为专有网络时，返回该参数。	vpc-bp1jk5vwkcri27qme****
ConnectionPort	string	节点的连接端口。	3717
ReplicaSetRole	string	节点的角色，取值说明： Primary：主节点。 Secondary：从节点。	Primary
ConnectionDomain	string	节点的连接地址。	dds-bp11483712c1****.mongodb.rds.aliyuncs.com
VPCCloudInstanceId	string	副本集节点的 vpc 实例 ID。说明当实例的网络类型为专有网络时，返回该参数。	dds-bp11483712c1****
NetworkType	string	网络类型，取值说明： Classic：经典网络。 VPC：专有网络。	VPC
VPCId	string	专有网络 ID。说明当实例的网络类型为专有网络时，返回该参数。	vpc-bp1jk5vwkcri27qme****
ReplacateId	string	全球多活实例的逻辑 ID。说明 MongoDB 当前不支持新购该类型实例，该参数仅适用于老版本全球多活实例。	bls-m****
Tags	object
Tag	array<object>	实例的标签信息列表。
	object	实例的标签信息列表。
Key	string	实例的标签键。	test
Value	string	实例的标签值。	api
VpcAuthMode	string	私网免密访问模式，取值说明： Open：开启私网免密访问。 Close：关闭私网免密访问，需要使用密码访问。 NotSupport：不支持该功能。	Open
NetworkType	string	实例的网络类型，取值说明： Classic：经典网络。 VPC：专有网络。	VPC
LockMode	string	实例的锁定状态，取值说明： Unlock：正常，没有被锁定。 ManualLock：手动触发锁定。 LockByExpiration：实例过期自动锁定。 LockByRestoration：实例回滚前自动锁定。 LockByDiskQuota：实例空间满自动锁定。	Unlock
EngineVersion	string	数据库大版本。	4.4
MaxIOPS	integer	实例最大 IOPS。	1000
MaxMBPS	integer	实例的最大云盘吞吐量，单位 MB/s。	350
VPCCloudInstanceIds	string	vpc 实例的 ID。说明当实例的网络类型为专有网络时，返回该参数。重要参数已废弃	dds-bp11483712c1****
MongosList	object
MongosAttribute	array<object>	Mongos 节点信息列表。说明当实例类型为分片集群实例时，返回该参数。
	object	Mongos 节点信息列表。说明当实例类型为分片集群实例时，返回该参数。
VpcCloudInstanceId	string	Mongos 节点的 vpc 实例 ID。	s-bp1d8c262a158****
LockMode	string	实例的锁定状态，取值说明： Unlock：正常。 ManualLock：手动触发锁定。 LockByExpiration：实例过期自动锁定。 LockByRestoration：实例回滚前自动锁定。 LockByDiskQuota：实例空间满自动锁定。	Unlock
MaxIOPS	integer	Mongos 节点的最大 IOPS。	800
VSwitchId	string	交换机 ID。说明当实例的网络类型为专有网络时，返回该参数。	vsw-bp1vj604nj5a9zz74****
NodeClass	string	Mongos 节点的规格。	dds.mongos.mid
MaxConnections	integer	Mongos 节点的最大连接数。	1000
Port	integer	Mongos 节点的连接端口。	3717
VPCId	string	专有网络 ID。说明当实例的网络类型为专有网络时，返回该参数。	vpc-bp1n3i15v90el48nx****
ConnectSting	string	Mongos 节点的连接地址。警告此参数即将下线，请替换使用 ConnectString 参数	s-bp1d8c262a15****.mongodb.rds.aliyuncs.com
NodeDescription	string	Mongos 节点的名称。	mongos1
NodeId	string	Mongos 节点的 ID。	s-bp1d8c262a15****
Status	string	Mongos 节点的状态。具体请参见实例状态表。	Running
CurrentKernelVersion	string	MongoDB 节点当前内核小版本号。	mongodb_20220518_4.0.21
ConnectString	string	Mongos 节点的连接地址。	s-bp1d8c262a15****.mongodb.rds.aliyuncs.com
ProtocolType	string	实例的访问协议类型，取值说明： mongodb：MongoDB 协议。 dynamodb：DynamoDB 协议。说明当实例类型为分片集群实例时，返回该参数。	mongodb
DBInstanceDescription	string	实例名称。	测试数据库
CurrentKernelVersion	string	实例当前数据库的小版本号。	5.0.5-20220721143518_0
DBInstanceReleaseProtection	boolean	是否开启实例释放保护，取值说明： true：已开启。 false：未开启。	false
ExpireTime	string	包年包月实例的到期时间，格式为yyyy-MM-ddTHH:mmZ（UTC 时间）。说明当实例的付费类型为包年包月时返回该参数。	2022-02-05T16:00Z
MaintainStartTime	string	实例可维护时间段的开始时间，格式为HH:mmZ（UTC 时间）。	18:00Z
DBInstanceType	string	实例类型，取值说明： replicate：副本集实例。 sharding：分片集群实例。 serverless：Serverless 实例。	replicate
LastDowngradeTime	string	实例最近一次降配时间，格式为 YYYY-MM-DD。	2022-01-08
ShardList	object
ShardAttribute	array<object>	Shard 节点信息列表。说明当实例类型为分片集群实例时返回该参数。
	object	Shard 节点信息列表。说明当实例类型为分片集群实例时返回该参数。
LockMode	string	集群的锁定模式，取值说明： Unlock：正常。 ManualLock：手动触发锁定。 LockByExpiration：集群过期自动锁定。 LockByRestoration：集群回滚前的自动锁定。 LockByDiskQuota：集群空间满自动锁定。	Unlock
MaxIOPS	integer	Shard 节点的最大 IOPS。	8000
ConnectString	string	Shard 节点的连接地址。	d-bp1af0680a9c6d3**.mongodb.rds.aliyuncs.com:**
NodeClass	string	Shard 节点的规格。	dds.shard.mid
MaxConnections	integer	Shard 节点的最大连接数。	8000
Port	integer	Shard 节点的端口。	3717
NodeDescription	string	Shard 节点的名称。	testshard
NodeId	string	Shard 节点的 ID。	d-bp16e09d9c5d****
NodeStorage	integer	Shard 节点的存储空间，单位为 GB。	10
ReadonlyReplicas	integer	Shard 节点中只读节点的个数，取值范围为 0~5（整数）。	0
Status	string	Shard 节点的状态，具体请参见实例状态表。	Running
MaxDiskMbps	string	shard 节点的最大云盘吞吐量。	350
CurrentKernelVersion	string	MongoDB 节点当前内核小版本号。	mongodb_20220518_4.0.21
ReplicaSetName	string	Shard 节点的名称。	mgset-xxxx
EcsIOPS	integer	机头 IOPS	0
EbsIOPS	integer	磁盘 IOPS	0
EcsBandwidth	integer	机头 MBPS	0
EbsBandwidth	integer	机头 MBPS	0
MaintainEndTime	string	实例可维护时间段的结束时间，格式为HH:mmZ（UTC 时间）。	03:00Z
DBInstanceStatus	string	实例状态，具体请参见实例状态表。	Running
VPCId	string	专有网络 ID。说明当实例的网络类型为专有网络时，返回该参数。	vpc-bp1n3i15v90el48nx****
RegionId	string	实例所属地域 ID。	cn-hangzhou
DBInstanceStorage	integer	实例存储空间。	10
ReplicaSetName	string	副本集实例的名称。说明当实例类型为副本集实例时，返回该参数。	mgset-10ace****
VSwitchId	string	交换机 ID。说明当实例的网络类型为专有网络时，返回该参数。	vsw-bp1oo2a7isyrb8igf****
StorageEngine	string	实例的存储引擎类型。	WiredTiger
ConfigserverList	object
ConfigserverAttribute	array<object>	Configserver 节点信息列表。说明当实例类型为分片集群实例时，返回该参数。
	object	Configserver 节点的信息列表。说明当实例类型为分片集群实例时，返回该参数。
MaxIOPS	integer	Configserver 节点的最大 IOPS。	1000
LockMode	string	实例的锁定状态，取值说明： Unlock：正常。 ManualLock：手动触发锁定。 LockByExpiration：实例过期自动锁定。 LockByRestoration：实例回滚前自动锁定。 LockByDiskQuota：实例空间满自动锁定。	Unlock
ConnectString	string	Configserver 节点的连接地址。	dds-bp18b0934e7053e4-cs****.mongodb.rds.aliyuncs.com
NodeClass	string	Configserver 节点的规格。	dds.cs.mid
MaxConnections	integer	Configserver 节点的最大连接数。	1000
Port	integer	Configserver 节点的端口。	3717
NodeDescription	string	Configserver 节点的名称。	testConfigserver
NodeId	string	Configserver 节点 ID。	dds-bp11483712c1****-cs
NodeStorage	integer	Configserver 节点的存储空间，单位为 GB。	20
Status	string	ConfigServer 节点的状态。具体请参见实例状态表。	Running
CurrentKernelVersion	string	MongoDB 节点当前内核小版本号。	mongodb_20220518_4.0.21
ResourceGroupId	string	实例所属资源组 ID。说明目前仅中国站支持返回该参数。	rg-acfmyiu4ekp****
ZoneId	string	实例所属可用区 ID。	cn-hangzhou-b
MaxConnections	integer	实例最大连接数。	500
DBInstanceId	string	实例 ID。	dds-bp11483712c1****
DBInstanceClass	string	实例规格。	dds.mongo.mid
Engine	string	数据库引擎。	MongoDB
ReadonlyReplicas	string	实例的只读节点个数。	1
ReplicationFactor	string	实例节点数量。说明实例类型为副本集实例时，返回该参数。	3
KindCode	string	实例的类型，取值说明： 0：本地盘版实例。 3：单节点实例。 18：云盘版实例。	18
CapacityUnit	string	实例消耗的读写吞吐量。	100
ChargeType	string	实例的付费类型，取值说明： PrePaid：预付费，包年包月。 PostPaid：后付费，按量付费。	PostPaid
StorageType	string	存储类型，取值说明： cloud_essd1：ESSD PL1 云盘。 cloud_essd2：ESSD PL2 云盘。 cloud_essd3：ESSD PL3 云盘。 local_ssd：SSD 本地盘。 cloud_essd_dbfs_s：DBFS 共享存储云盘。	cloud_essd1
SecondaryZoneId	string	实现多可用区部署时，实例的备可用区 1，取值说明： cn-hangzhou-g：杭州可用区 G。 cn-hangzhou-h：杭州可用区 H。 cn-hangzhou-i：杭州可用区 I。 cn-hongkong-b：香港可用区 B。 cn-hongkong-c：香港可用区 C。 cn-hongkong-d：香港可用区 D。 cn-wulanchabu-a：乌兰察布可用区 A。 cn-wulanchabu-b：乌兰察布可用区 B。 cn-wulanchabu-c：乌兰察布可用区 C。 ap-southeast-1a：新加坡可用区 A。 ap-southeast-1b：新加坡可用区 B。 ap-southeast-1c：新加坡可用区 C。 ap-southeast-5a：雅加达可用区 A。 ap-southeast-5b：雅加达可用区 B。 ap-southeast-5c：雅加达可用区 C。 eu-central-1a：法兰克福可用区 A。 eu-central-1b：法兰克福可用区 B。 eu-central-1c：法兰克福可用区 C。说明当实例为 4.4 或 5.0 版本的多可用区副本集实例或分片集群实例时，返回该参数。目前仅中国站支持返回该参数。	cn-hangzhou-i
HiddenZoneId	string	实现多可用区部署时，实例的备可用区 2，取值说明： cn-hangzhou-g：杭州可用区 G。 cn-hangzhou-h：杭州可用区 H。 cn-hangzhou-i：杭州可用区 I。 cn-hongkong-b：香港可用区 B。 cn-hongkong-c：香港可用区 C。 cn-hongkong-d：香港可用区 D。 cn-wulanchabu-a：乌兰察布可用区 A。 cn-wulanchabu-b：乌兰察布可用区 B。 cn-wulanchabu-c：乌兰察布可用区 C。 ap-southeast-1a：新加坡可用区 A。 ap-southeast-1b：新加坡可用区 B。 ap-southeast-1c：新加坡可用区 C。 ap-southeast-5a：雅加达可用区 A。 ap-southeast-5b：雅加达可用区 B。 ap-southeast-5c：雅加达可用区 C。 eu-central-1a：法兰克福可用区 A。 eu-central-1b：法兰克福可用区 B。 eu-central-1c：法兰克福可用区 C。说明当实例为 4.4 或 5.0 版本的多可用区副本集实例或分片集群实例时，返回该参数。目前仅中国站支持返回该参数。	cn-hangzhou-h
DestroyTime	string	实例数据销毁时间，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2021-12-10T16:00:00Z
DBInstanceOrderStatus	string	当前该实例已生成的订单状态，取值说明： all_completed：所有订单均处于生产中或已经生产完成。 order_unpaid：当前有未支付的订单。 order_wait_for_produce：当前有正在下发生产的订单。说明订单生产流程依次为用户下单、支付订单、订单下发生产、进行生产和完成生产。如果订单状态长时间处于order_wait_for_produce，说明下发生产流程遇到了问题，系统会自动重试。订单在进行生产和完成生产时，实例状态才会发生变化，例如变配中和运行中。	all_completed
Encrypted	boolean	是否开启云盘加密	true
EncryptionKey	string	云盘加密对应的 kms-key	07609cc3-3109-408f-a35e-c548e776da0b
SyncPercent	string	数据同步进度百分比。当实例处在变配中时，需要进行数据同步等操作，可以通过该字段判断同步进度。	0.8
UseClusterBackup	boolean	是否使用集群备份模式。取值说明： true：启用集群备份模式。 false 未启用集群备份模式。	true
BurstingEnabled	boolean	是否已开启突发	true
ProvisionedIops	integer	预配置性能	1960
DisasterRecoveryInfo	string	全球多活的源实例与目标实例信息	{"relations":[{"destInsName":"dds-bp11483712c1**","destRegionId":"cn-hangzhou","srcInsName":"dds-7xv054b9c43c**","srcRegionId":"cn-guangzhou"}]}
SearchNodeClass	string	变配的 Search 节点规格	mdb.shard.2x.xlarge.d
SearchNodeStorage	integer	变配的 Search 节点容量	20
SearchNodeCount	integer	变配的 Search 节点数	2
ColdDataEnabled	boolean	是否开启数据归档功能
AIGatewayEnabled	boolean	实例是否开通 AI 网关
ShardSearchNodes	object
ShardSearchNodes	array<object>	分片集群实例中各 Shard 节点关联的 Search 节点信息列表。
	object
NodeId	string	Shard 节点 ID。
SearchNodeId	string	Search 节点 ID。
SearchNodeClass	string	Search 节点规格。
SearchNodeStorage	string	Search 节点存储容量。
SearchNodeCount	string	Search 节点数量。
EcsIOPS	integer	机头 IOPS	0
EbsIOPS	integer	磁盘 IOPS	0
EcsBandwidth	integer	机头 MBPS	0
EbsBandwidth	integer	磁盘 MBPS	0

示例

正常返回示例

JSON格式

{
  "RequestId": "A935A8EE-A6CC-53DE-98BA-20ABAA7E632B",
  "DBInstances": {
    "DBInstance": [
      {
        "CreationTime": "2022-01-02T07:43:59Z",
        "ReplicaSets": {
          "ReplicaSet": [
            {
              "VSwitchId": "vpc-bp1jk5vwkcri27qme****",
              "ConnectionPort": "3717",
              "ReplicaSetRole": "Primary",
              "ConnectionDomain": "dds-bp11483712c1****.mongodb.rds.aliyuncs.com",
              "VPCCloudInstanceId": "dds-bp11483712c1****",
              "NetworkType": "VPC",
              "VPCId": "vpc-bp1jk5vwkcri27qme****"
            }
          ]
        },
        "ReplacateId": "bls-m****",
        "Tags": {
          "Tag": [
            {
              "Key": "test",
              "Value": "api"
            }
          ]
        },
        "VpcAuthMode": "Open",
        "NetworkType": "VPC",
        "LockMode": "Unlock",
        "EngineVersion": "4.4",
        "MaxIOPS": 1000,
        "MaxMBPS": 350,
        "VPCCloudInstanceIds": "dds-bp11483712c1****",
        "MongosList": {
          "MongosAttribute": [
            {
              "VpcCloudInstanceId": "s-bp1d8c262a158****",
              "LockMode": "Unlock",
              "MaxIOPS": 800,
              "VSwitchId": "vsw-bp1vj604nj5a9zz74****",
              "NodeClass": "dds.mongos.mid",
              "MaxConnections": 1000,
              "Port": 3717,
              "VPCId": "vpc-bp1n3i15v90el48nx****",
              "ConnectSting": "s-bp1d8c262a15****.mongodb.rds.aliyuncs.com",
              "NodeDescription": "mongos1",
              "NodeId": "s-bp1d8c262a15****",
              "Status": "Running",
              "CurrentKernelVersion": "mongodb_20220518_4.0.21",
              "ConnectString": "s-bp1d8c262a15****.mongodb.rds.aliyuncs.com"
            }
          ]
        },
        "ProtocolType": "mongodb",
        "DBInstanceDescription": "测试数据库",
        "CurrentKernelVersion": "5.0.5-20220721143518_0",
        "DBInstanceReleaseProtection": false,
        "ExpireTime": "2022-02-05T16:00Z",
        "MaintainStartTime": "18:00Z",
        "DBInstanceType": "replicate",
        "LastDowngradeTime": "2022-01-08",
        "ShardList": {
          "ShardAttribute": [
            {
              "LockMode": "Unlock",
              "MaxIOPS": 8000,
              "ConnectString": "d-bp1af0680a9c6d3****.mongodb.rds.aliyuncs.com:****",
              "NodeClass": "dds.shard.mid",
              "MaxConnections": 8000,
              "Port": 3717,
              "NodeDescription": "testshard",
              "NodeId": "d-bp16e09d9c5d****",
              "NodeStorage": 10,
              "ReadonlyReplicas": 0,
              "Status": "Running",
              "MaxDiskMbps": "350",
              "CurrentKernelVersion": "mongodb_20220518_4.0.21",
              "ReplicaSetName": "mgset-xxxx",
              "EcsIOPS": 0,
              "EbsIOPS": 0,
              "EcsBandwidth": 0,
              "EbsBandwidth": 0
            }
          ]
        },
        "MaintainEndTime": "03:00Z",
        "DBInstanceStatus": "Running",
        "VPCId": "vpc-bp1n3i15v90el48nx****",
        "RegionId": "cn-hangzhou",
        "DBInstanceStorage": 10,
        "ReplicaSetName": "mgset-10ace****",
        "VSwitchId": "vsw-bp1oo2a7isyrb8igf****",
        "StorageEngine": "WiredTiger",
        "ConfigserverList": {
          "ConfigserverAttribute": [
            {
              "MaxIOPS": 1000,
              "LockMode": "Unlock",
              "ConnectString": "dds-bp18b0934e7053e4-cs****.mongodb.rds.aliyuncs.com",
              "NodeClass": "dds.cs.mid",
              "MaxConnections": 1000,
              "Port": 3717,
              "NodeDescription": "testConfigserver",
              "NodeId": "dds-bp11483712c1****-cs",
              "NodeStorage": 20,
              "Status": "Running",
              "CurrentKernelVersion": "mongodb_20220518_4.0.21"
            }
          ]
        },
        "ResourceGroupId": "rg-acfmyiu4ekp****",
        "ZoneId": "cn-hangzhou-b",
        "MaxConnections": 500,
        "DBInstanceId": "dds-bp11483712c1****",
        "DBInstanceClass": "dds.mongo.mid",
        "Engine": "MongoDB",
        "ReadonlyReplicas": "1",
        "ReplicationFactor": "3",
        "KindCode": "18",
        "CapacityUnit": "100",
        "ChargeType": "PostPaid",
        "StorageType": "cloud_essd1",
        "SecondaryZoneId": "cn-hangzhou-i",
        "HiddenZoneId": "cn-hangzhou-h",
        "DestroyTime": "2021-12-10T16:00:00Z",
        "DBInstanceOrderStatus": "all_completed",
        "Encrypted": true,
        "EncryptionKey": "07609cc3-3109-408f-a35e-c548e776da0b",
        "SyncPercent": "0.8",
        "UseClusterBackup": true,
        "BurstingEnabled": true,
        "ProvisionedIops": 1960,
        "DisasterRecoveryInfo": "{\"relations\":[{\"destInsName\":\"dds-bp11483712c1****\",\"destRegionId\":\"cn-hangzhou\",\"srcInsName\":\"dds-7xv054b9c43c****\",\"srcRegionId\":\"cn-guangzhou\"}]}",
        "SearchNodeClass": "mdb.shard.2x.xlarge.d",
        "SearchNodeStorage": 20,
        "SearchNodeCount": 2,
        "ColdDataEnabled": true,
        "AIGatewayEnabled": true,
        "ShardSearchNodes": {
          "ShardSearchNodes": [
            {
              "NodeId": "",
              "SearchNodeId": "",
              "SearchNodeClass": "",
              "SearchNodeStorage": "",
              "SearchNodeCount": ""
            }
          ]
        },
        "EcsIOPS": 0,
        "EbsIOPS": 0,
        "EcsBandwidth": 0,
        "EbsBandwidth": 0
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	VpcCloudInstanceIdNumError	Get vpcCloudInstanceId number error.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。