Docs
api
Cloud MongoDB Database(UDB NVMe)
DescribeUMongoDBInstance

Describe MongoDB Instance - DescribeUMongoDBInstance

Overview

Describe MongoDB Instance

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is DescribeUMongoDBInstance.Yes
PublicKeystringThe user’s public key can be obtained from ConsoleYes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
RegionstringRegion. See List of Regions and Availability ZonesYes
ZonestringAvailability Zone. See Availability Zone ListNo
ProjectIdstringProject ID. If not filled in, the default project is used, sub-accounts must be filled in. Please refer to the GetProjectList interface.No
ClusterIdstringInstance Resource IDYes
ClusterTypestringCluster Type, ReplicaSet: Replica Set, SharedCluster: Sharded ClusterNo

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
ClusterInfoClusterInfoReplica Set InformationNo

Data Model

ClusterInfo

Field NameTypeDescription InformationRequired
ZonestringAvailability ZoneNo
ZoneIdintNo
ClusterTypestringCluster Type, ReplicaSet: Replica Set, SharedCluster: Sharded ClusterNo
ClusterIdstringCluster IDNo
InstanceNamestringInstance NameNo
StatestringReplica Set/Sharded Cluster Status Tags: Initing: Initializing, InitFailed: Installation Failed, Starting: Starting, StartFailed: Start Failed, Running: Running, Stopping: Shutting Down, Stopped: Shut Down, StopFailed: Shutdown Failed, Deleting: Deleting, Deleted: Deleted, DeleteFailed: Deletion Failed, Restarting: Restarting, RestartFailed: Restart Failed.No
DBVersionstringVersion of Mongodb Replica SetNo
DiskSpaceintDisk Space (GB), default according to configuration modelNo
MachineTypeIdstringComputing SpecificationsNo
CreateTimeintDB Instance Creation TimeNo
ConfigReplicaInfoReplicaInfoConfigSrv InformationNo
DataReplicaInfosarray[ReplicaInfo]Data Replica InformationNo
MongosInfoarray[NodeInfo]Mongos Node InformationNo
ConnectURLstringAccess address of the replica setNo
DeleteTimeintDB Instance Deletion TimeNo
SubnetIdstringSubnet IDNo
VPCIdstringID of VPCNo
ShardCountintNumber of Shards, Valid Shard SetNo
ShardNodeCountintThe number of nodes per shard, the shard set is valid.No
MongosCountintThe number of Mongos nodes, the shard set is validNo
ConfigNodeCountintConfigure the number of cluster nodes, effective shard setNo
ConfigMachineTypestringConfig configuration cluster node configuration, effective shard setNo
TagstringUBINo

ReplicaInfo

Field NameTypeDescription InformationRequired
ReplicaIdstringReplica Set IDNo
ClusterIdstringCluster IDNo
ReplicaTypestringReplica Type, ConfigRepl or DataReplNo
StatestringReplica Set/Sharded Cluster Status Tags: Initing: Initializing, InitFailed: Installation Failed, Starting: Starting, StartFailed: Start Failed, Running: Running, Stopping: Shutting Down, Stopped: Shut Down, StopFailed: Shutdown Failed, Deleting: Deleting, Deleted: Deleted, DeleteFailed: Deletion Failed, Restarting: Restarting, RestartFailed: Restart Failed.No
MachineTypestringMachine TypeNo
MachineTypeIdstringMachine Type IdNo
IsolationGroupIdstringIsolation Group IDNo
NodeInfosarray[NodeInfo]Node information under the replica setNo
NodeCountintThe number of nodes under the replica setNo
CreateTimeintReplica Set Creation TimeNo
DeleteTimeintReplica Set Deletion TimeNo
ModifyTimeintReplica Set Modification TimeNo

NodeInfo

Field NameTypeDescription InformationRequired
ZonestringAvailability ZoneNo
ZoneIdintAvailability Zone IDNo
NodeIdstringNode IDNo
NodeRolestringNode Role, Primary/Secondary/Arbiter/Startup, etc.No
NodeTypestringNode TypeNo
StatestringReplica Set/Sharded Cluster Status Tags: Initing: Initializing, InitFailed: Installation Failed, Starting: Starting, StartFailed: Start Failed, Running: Running, Stopping: Shutting Down, Stopped: Shut Down, StopFailed: Shutdown Failed, Deleting: Deleting, Deleted: Deleted, DeleteFailed: Deletion Failed, Restarting: Restarting, RestartFailed: Restart Failed.No
DBVersionstringVersion of Mongodb Replica SetNo
ClusterIdstringID of the replica set to which the node belongsNo
VirtualClusterIdstringVirtual Node IDNo
MachineTypestringModel InformationNo
MachineTypeIdstringModel Information IDNo
CreateTimeintDB Instance Creation TimeNo
DataDiskDiskInfoData Disk InformationNo
SysDiskDiskInfoSystem Disk InformationNo

DiskInfo

Field NameTypeDescription InformationRequired
DiskIdstringDisk IDNo
DiskSizeintDisk Capacity Unit GBNo

Example

Request Example

https://api.dezai.com/?Action=DescribeUMongoDBInstance
&Region=cn-zj
&Zone=cn-zj-01
&ProjectId=pismPnWj
&ClusterId=qhvujvIg
&ClusterType=Hxrfshbu

Response Example

{
  "Action": "DescribeUMongoDBInstanceResponse",
  "ClusterInfo": {},
  "RetCode": 0
}