文档数据库 MongoDB 版
文档数据库 MongoDB 版
文档指南
请输入
- 文档首页
文档数据库 MongoDB 版API 参考实例管理DescribeDBInstanceDetail
复制全文
下载 pdfDescribeDBInstanceDetail
文档反馈
问问助手调用 DescribeDBInstanceDetail 接口查询目标 MongoDB 实例的详细信息。
请求类型
同步请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
InstanceId String 必选 示例值：mongo-shard-3d7141824182
实例 ID。
说明
返回参数
DBInstance Object 示例值：
实例详细信息列表。
AutoRenew Boolean 示例值：false
包年包月实例是否开启自动续费。取值范围如下：
- false：未开启。
- true：已开启。
说明
仅包年包月实例支持返回该参数。
ChargeStatus String 示例值：Normal
实例计费状态，取值范围如下：
- Normal：正常。
- WaitingPaid：等待支付。
- ChangingPayType：计费变更中。
- Renewing：续费中。
- Overdue：已到期。
- Owing：欠费中。
- Unsubscribing：退订中。
ChargeType String 示例值：Prepaid
实例计费类型，取值范围如下：
- Prepaid：包年包月（也称预付费）。
- PostPaid：按量计费（也称后付费）。
ClosedTime String 示例值：2022-03-19T04:00:00Z
计划关停时间（UTC）。
说明
仅包年包月实例支持返回该参数。
ConfigServers Object[]
ConfigServers 的信息列表。
说明
仅分片集群实例支持返回该参数。
ConfigServerNodeId String 示例值：mongo-shard-3d714182****-config-0
ConfigServer 的节点 ID。
NodeRole String 示例值：Primary
节点角色，取值范围如下：
- Primary：主节点。
- Secondary：从节点。
- Hidden：隐藏节点。
NodeStatus String 示例值：Running
节点状态。
TotalMemoryGB Double 示例值：4
总内存。单位：GiB。
TotalvCPU Double 示例值：2
总核数。
UsedMemoryGB Double 示例值：0.33296966552734375
已用内存。单位：GiB。
UsedvCPU Double 示例值：0.004654006
已用核数。
ZoneId String 示例值：cn-beijing-a
当前节点所属的可用区 ID。
说明
ConfigServersId String 示例值：mongo-shard-fa8cd21d****-config
ConfigServer 的 ID。
说明
仅分片集群实例支持返回该参数。
CreateTime String 示例值：2022-03-15T03:57:15Z
实例创建时间（UTC）。
DBEngine String 示例值：MongoDB
数据库引擎。取值固定为 MongoDB。
DBEngineVersion String 示例值：MongoDB_5_0
DBEngineVersionStr String 示例值：MongoDB 5.0
数据库引擎版本的字符串。
ExpiredTime String 示例值：22022-03-19T03:45:28Z
实例到期时间（UTC）。
说明
仅包年包月实例支持返回该参数。
InstanceId String 示例值：mongo-replica-9b3f8fb9****
实例 ID。
InstanceName String 示例值：test-mongo
实例名称。
InstanceStatus String 示例值：Running
InstanceType String 示例值：ReplicaSet
MongoDB 的实例类型，取值范围如下：
- ReplicaSet：副本集。
- ShardedCluster：分片集群 。
Nodes Object[]
副本集实例中各节点或分片集群 Shard 分片中各节点的信息列表。
说明
仅副本集实例或分片集群实例的 Shard 分片中支持返回该参数。
NodeDelayTime Integer 示例值：0
主从延迟时间。单位：毫秒（ms）。
NodeId String 示例值：mongo-replica-c70a99ee****-0
节点 ID。
NodeRole String 示例值：Primary
节点角色，取值范围如下：
- Primary：主节点。
- Secondary：从节点。
- Hidden：隐藏节点。
- ReadOnly：只读节点。
- 说明
- 仅副本集实例和分片集群实例的 Shard 分片节点支持使用只读节点。
- 仅当实例中存在只读节点时，才会返回只读节点 ReadOnly 的相关信息。更多关于只读节点的信息，请参见 MongoDB 只读节点。
NodeSpec String 示例值：mongo.2c4g
节点规格。
NodeStatus String 示例值：Running
节点状态。
TotalMemoryGB Double 示例值：4
总内存。单位：GiB。
TotalStorageGB Double 示例值：20
该节点的总存储空间。单位：GiB。
TotalvCPU Double 示例值：2
总核数。
UsedMemoryGB Double 示例值：0.4655952453613281
已用内存。单位：GiB。
UsedStorageGB Double 示例值：0.9955019280314445
该节点已用的存储空间。单位：GiB。
UsedvCPU Double 示例值：0.003100326
已用核数。
ZoneId String 示例值：cn-beijing-a
当前节点所属的可用区 ID。
说明
Mongos Object[]
Mongos 的信息列表。
说明
仅分片集群实例支持返回该参数。
MongosNodeId String 示例值：mongo-shard-011d2479****-0
Mongos 的节点 ID。
NodeSpec String 示例值：mongo.mongos.2c4g
节点规格。
NodeStatus String 示例值：Running
节点状态。
TotalMemoryGB Double 示例值：4
总内存。单位：GiB。
TotalvCPU Double 示例值：2
总核数。
UsedMemoryGB Double 示例值：0.09878921508789062
已用内存。单位：GiB。
UsedvCPU Double 示例值：0.002623241
已用核数。
ZoneId String 示例值：cn-beijing-a
当前节点所属的可用区 ID。
说明
MongosId String 示例值：mongo-shard-011d2479****
Mongos 的 ID。
说明
仅分片集群实例支持返回该参数。
ReclaimTime String 示例值：2022-03-26T03:45:28Z
实例的计划回收时间（UTC）。
说明
仅包年包月实例支持返回该参数。
Shards Object[]
Shards 的信息列表。
说明
仅分片集群实例支持返回该参数。
Nodes Object[]
Shard分片中各节点的信息列表。
NodeDelayTime Integer 示例值：0
主从延迟时间。单位：毫秒（ms）。
NodeId String 示例值：mongo-shard-011d2479****-s1-0
节点 ID。
NodeRole String 示例值：Primary
节点角色，取值范围如下：
- Primary：主节点。
- Secondary：从节点。
- Hidden：隐藏节点。
- ReadOnly：只读节点。
- 说明
- 仅副本集实例和分片集群实例的 Shard 分片节点支持使用只读节点。
- 仅当实例中存在只读节点时，才会返回只读节点 ReadOnly 的相关信息。更多关于只读节点的信息，请参见 MongoDB 只读节点。
NodeSpec String 示例值：mongo.shard.2c4g
节点规格。
NodeStatus String 示例值：Running
节点状态。
TotalMemoryGB Double 示例值：4
总内存。单位：GiB。
TotalStorageGB Double 示例值：20
该节点的总存储空间。单位：GiB。
TotalvCPU Double 示例值：2
总核数。
UsedMemoryGB Double 示例值：0.4655952453613281
已用内存。单位：GiB。
UsedStorageGB Double 示例值：0.9955019280314445
该节点已用的存储空间。单位：GiB。
UsedvCPU Double 示例值：0.003100326
已用核数。
ZoneId String 示例值：cn-beijing-a
当前节点所属的可用区 ID。
说明
ShardId String 示例值：mongo-shard-011d2479****-s0
Shard 节点的 ID。
说明
仅分片集群实例支持返回该参数。
ProjectName String 示例值：default
实例所属的项目名称。
SubnetId String 示例值：subnet-2743n265pa8zk7fap8st3****
实例所属的子网 ID。
Tags Object[] 示例值：-
实例已绑定的标签信息。
说明
仅已绑定了标签的实例才会返回该参数。
Key String 示例值：instancetype
当前实例所绑定标签的标签键。
Value String 示例值：replica
当前实例所绑定标签的标签值。
UpdateTime String 示例值：2022-03-19T03:45:28Z
实例的更新时间（UTC）。
VpcId String 示例值：vpc-3tfam26vmy3v****
实例所属的私有网络 ID。
ZoneId String 示例值：cn-beijing-a
实例所属的可用区 ID。
说明
StorageType String 示例值：LocalSSD
实例的存储类型。当前仅支持本地 SSD 盘（即 LocalSSD）存储。
PrivateEndpoint String 示例值：mongodb://:@mongoshard3d714182\*\*\*\*0.mongodb.ivolces.com:3717,mongoshard3d714182\*\*\*\*1.mongodb.ivolces.com:3717,mongoshard3d714182\*\*\*\*2.mongodb.ivolces.com:3717/?authSource=admin&retryWrites=true
实例私网连接地址的字符串信息。
ReadOnlyNodeNumber Integer 示例值：3
实例中的只读节点数量。
说明
- 0 表示当前实例中未添加任何只读节点。
- 针对分片集群实例，该参数的取值表示实例中所有 Shard 分片里的只读节点总数。更多关于只读节点的功能介绍和使用限制，请参见 MongoDB 只读节点。
MaintenanceTime String
可维护时间段
BackupVersion String
backup 版本
MongoClusterVersion String
mgc 版本
MongotInfos Object[]
Mongot 节点信息。
ShardId String 示例值：mongo-shard-011d2479****-s0
Shard 节点 ID。
说明
仅分片集群实例支持返回该参数。
NodeInfos Object[] 示例值：-
Mongot 节点的详细信息。
NodeId String 示例值：mongo-mongot-011d2479****-node-0
节点 ID。
ZoneId String 示例值：cn-beijing-a
节点所属的可用区 ID。
NodeSpec String
节点规格
UsedvCPU Double 示例值：0.00256789
节点已用核数。
TotalvCPU Double 示例值：2
节点总核数。
UsedMemoryGB Double 示例值： 0.33296966552734375
节点已用内存，单位 GiB。
TotalMemoryGB Double 示例值：4
节点总内存，单位 GiB。
UsedStorageGB Double 示例值：1.56789
节点已使用存储空间，单位 GiB。
TotalStorageGB Double 示例值：20
节点总存储空间，单位 GiB。
MongotEnable Boolean
是否开启 Mongot。
示例
请求示例 1
查询按量计费分片集群实例详情。
POST https://mongodb.cn-beijing.volcengineapi.com/?Action=DescribeDBInstanceDetail&Version=2022-01-01 HTTP/1.1
Host: mongodb.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/mongodb/request,SignedHeaders=content-type;host;x-date,Signature=****
{
"InstanceId": "mongo-shard-3d7141824182"
}
返回示例 1
按量计费分片集群实例返回示例。如下示例仅展示了实例部分节点信息，具体返回数据以接口调用的实际返回结果为准。
{
"ResponseMetadata": {
"RequestId": "20260722165540B81A1414CCB9269A4B3D-24057c",
"Action": "DescribeDBInstanceDetail",
"Version": "2022-01-01",
"Service": "mongodb",
"Region": "cn-guilin-boe"
},
"Result": {
"DBInstance": {
"AutoRenew": false,
"BackupVersion": "25.12.2",
"ChargeStatus": "Normal",
"ChargeType": "PostPaid",
"ClosedTime": "",
"CreateTime": "2026-07-20T12:06:02Z",
"DBEngine": "MongoDB",
"DBEngineVersion": "MongoDB_8_3",
"DBEngineVersionStr": "MongoDB 8.3",
"InstanceId": "mongo-replica-49d441f6387f",
"InstanceName": "mengyuantest-83",
"InstanceStatus": "Running",
"InstanceType": "ReplicaSet",
"MaintenanceTime": "18:00Z-22:00Z",
"MongoClusterVersion": "6.6.1",
"MongotEnable": true,
"MongotInfos": [
{
"NodeInfos": [
{
"NodeId": "mongo-replica-49d441f6387f-mongot-cn-guilin-c-0",
"NodeSpec": "mongo.mongot.2c4g",
"TotalMemoryGB": 4,
"TotalStorageGB": 200,
"TotalvCPU": 2,
"UsedMemoryGB": 0.9510612487792969,
"UsedStorageGB": 57.73587917815894,
"UsedvCPU": 0.17534521141611104,
"ZoneId": "cn-guilin-c"
},
{
"NodeId": "mongo-replica-49d441f6387f-mongot-cn-guilin-c-1",
"NodeSpec": "mongo.mongot.2c4g",
"TotalMemoryGB": 4,
"TotalStorageGB": 200,
"TotalvCPU": 2,
"UsedMemoryGB": 1.0714073181152344,
"UsedStorageGB": 57.712479719892144,
"UsedvCPU": 0.183387033451654,
"ZoneId": "cn-guilin-c"
}
],
"ShardId": "mongo-replica-49d441f6387f"
}
],
"NetworkType": "Private",
"Nodes": [
{
"Cluster": "mix-azc-database",
"NodeDelayTime": 0,
"NodeId": "mongo-replica-49d441f6387f-0",
"NodeRole": "Primary",
"NodeSpec": "mongo.2c4g",
"NodeStatus": "Running",
"TotalMemoryGB": 4,
"TotalStorageGB": 200,
"TotalvCPU": 2,
"UsedMemoryGB": 1.4145698547363281,
"UsedStorageGB": 1.535832087509334,
"UsedvCPU": 0.02365425482349663,
"ZoneId": "cn-guilin-c"
},
{
"Cluster": "mix-azc-database",
"NodeDelayTime": 0,
"NodeId": "mongo-replica-49d441f6387f-1",
"NodeRole": "Secondary",
"NodeSpec": "mongo.2c4g",
"NodeStatus": "Running",
"TotalMemoryGB": 4,
"TotalStorageGB": 200,
"TotalvCPU": 2,
"UsedMemoryGB": 1.5751991271972656,
"UsedStorageGB": 1.5077232401818037,
"UsedvCPU": 0.031676946309643704,
"ZoneId": "cn-guilin-c"
},
{
"Cluster": "mix-azc-database",
"NodeDelayTime": 0,
"NodeId": "mongo-replica-49d441f6387f-2",
"NodeRole": "Hidden",
"NodeSpec": "mongo.2c4g",
"NodeStatus": "Running",
"TotalMemoryGB": 4,
"TotalStorageGB": 200,
"TotalvCPU": 2,
"UsedMemoryGB": 1.5390701293945312,
"UsedStorageGB": 1.473611656576395,
"UsedvCPU": 0.021968421217316177,
"ZoneId": "cn-guilin-c"
}
],
"PrivateEndpoint": "mongodb://\u003cuser\u003e:\u003cpassword\u003e@mongoreplica49d441f6387f0.mongodb-boe.ivolces.com:3717,mongoreplica49d441f6387f1.mongodb-boe.ivolces.com:3717/?authSource=admin\u0026replicaSet=rs-mongo-replica-49d441f6387f\u0026retryWrites=true",
"ProjectName": "default",
"ReadOnlyNodeNumber": 0,
"ReclaimTime": "",
"SpecType": "GENERAL",
"StorageType": "LocalSSD",
"SubnetId": "subnet-1el48uidyuku81jcpwich01b3",
"Tags": [
{
"Key": "sys:tag:createdBy",
"Value": "Root:2100001228"
}
],
"Tenant": "2100001228",
"UpdateTime": "2026-07-21T03:39:43Z",
"VpcId": "vpc-1elkrq4tg3ta81jcpwjx5j6s4",
"ZoneId": "cn-guilin-c"
}
}
}
请求示例 2
查询包年包月副本集实例详情。
POST https://mongodb.cn-beijing.volcengineapi.com/?Action=DescribeDBInstanceDetail&Version=2022-01-01 HTTP/1.1
Host: mongodb.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/mongodb/request,SignedHeaders=content-type;host;x-date,Signature=****
{
"InstanceId": "mongo-replica-c70a99ee99ee"
}
返回示例 2
包年包月副本集实例返回示例。如下示例仅展示了实例部分节点信息，具体返回数据以接口调用的实际返回结果为准。
{
"ResponseMetadata": {
"RequestId": "20260722171217F545F2157F3E6A87395E-fcb9ab",
"Action": "DescribeDBInstanceDetail",
"Version": "2022-01-01",
"Service": "mongodb",
"Region": "cn-guilin-boe"
},
"Result": {
"DBInstance": {
"AutoRenew": false,
"BackupVersion": "25.12.2",
"ChargeStatus": "Normal",
"ChargeType": "Prepaid",
"ClosedTime": "2026-08-23T04:00:00Z",
"CreateTime": "2026-07-22T09:06:15Z",
"DBEngine": "MongoDB",
"DBEngineVersion": "MongoDB_8_3",
"DBEngineVersionStr": "MongoDB 8.3",
"ExpiredTime": "2026-08-22T15:59:59Z",
"InstanceId": "mongo-replica-fbe4cdd7de82",
"InstanceName": "lwy",
"InstanceStatus": "Running",
"InstanceType": "ReplicaSet",
"MaintenanceTime": "18:00Z-22:00Z",
"MongoClusterVersion": "6.6.1",
"MongotEnable": true,
"MongotInfos": [
{
"NodeInfos": [
{
"NodeId": "mongo-replica-fbe4cdd7de82-mongot-cn-guilin-c-0",
"NodeSpec": "mongo.mongot.2c4g",
"TotalMemoryGB": 4,
"TotalStorageGB": 100,
"TotalvCPU": 2,
"UsedMemoryGB": 0.22394943237304688,
"UsedStorageGB": 0.00039912760257720947,
"UsedvCPU": 0.025126908079432367,
"ZoneId": "cn-guilin-c"
},
{
"NodeId": "mongo-replica-fbe4cdd7de82-mongot-cn-guilin-c-1",
"NodeSpec": "mongo.mongot.2c4g",
"TotalMemoryGB": 4,
"TotalStorageGB": 100,
"TotalvCPU": 2,
"UsedMemoryGB": 0.24459457397460938,
"UsedStorageGB": 0.0004052901640534401,
"UsedvCPU": 0.022484653968326006,
"ZoneId": "cn-guilin-c"
}
],
"ShardId": "mongo-replica-fbe4cdd7de82"
}
],
"NetworkType": "Private",
"Nodes": [
{
"Cluster": "mix-azc-database",
"NodeDelayTime": 0,
"NodeId": "mongo-replica-fbe4cdd7de82-0",
"NodeRole": "Primary",
"NodeSpec": "mongo.2c4g",
"NodeStatus": "Running",
"TotalMemoryGB": 4,
"TotalStorageGB": 100,
"TotalvCPU": 2,
"UsedMemoryGB": 0.16679763793945312,
"UsedStorageGB": 0.19842858891934156,
"UsedvCPU": 0.020273914465585765,
"ZoneId": "cn-guilin-c"
},
{
"Cluster": "mix-azc-database",
"NodeDelayTime": 0,
"NodeId": "mongo-replica-fbe4cdd7de82-1",
"NodeRole": "Secondary",
"NodeSpec": "mongo.2c4g",
"NodeStatus": "Running",
"TotalMemoryGB": 4,
"TotalStorageGB": 100,
"TotalvCPU": 2,
"UsedMemoryGB": 0.17724609375,
"UsedStorageGB": 0.19857225101441145,
"UsedvCPU": 0.021979507733426294,
"ZoneId": "cn-guilin-c"
},
{
"Cluster": "mix-azc-database",
"NodeDelayTime": 0,
"NodeId": "mongo-replica-fbe4cdd7de82-2",
"NodeRole": "Hidden",
"NodeSpec": "mongo.2c4g",
"NodeStatus": "Running",
"TotalMemoryGB": 4,
"TotalStorageGB": 100,
"TotalvCPU": 2,
"UsedMemoryGB": 0.18416976928710938,
"UsedStorageGB": 0.19868833664804697,
"UsedvCPU": 0.019592978678410478,
"ZoneId": "cn-guilin-c"
}
],
"PrivateEndpoint": "mongodb://\u003cuser\u003e:\u003cpassword\u003e@mongoreplicafbe4cdd7de820.mongodb-boe.ivolces.com:3717,mongoreplicafbe4cdd7de821.mongodb-boe.ivolces.com:3717/?authSource=admin\u0026replicaSet=rs-mongo-replica-fbe4cdd7de82\u0026retryWrites=true",
"ProjectName": "default",
"ReadOnlyNodeNumber": 0,
"ReclaimTime": "2026-08-29T15:59:59Z",
"SpecType": "GENERAL",
"StorageType": "LocalSSD",
"SubnetId": "subnet-1el48uidyuku81jcpwich01b3",
"Tags": [
{
"Key": "sys:tag:createdBy",
"Value": "Root:2100001228"
}
],
"Tenant": "2100001228",
"UpdateTime": "2026-07-22T09:09:55Z",
"VpcId": "vpc-1elkrq4tg3ta81jcpwjx5j6s4",
"ZoneId": "cn-guilin-c"
}
}
}
错误码
最近更新时间：2026.07.22 20:22:55
这个页面对您有帮助吗？
有用
有用
无用
无用