Queries the overview information of one or more ApsaraDB for MongoDB instances.
Operation description
- If you do not specify an instance when you call this operation, the overview information of all instances in a specific region within this account is returned.
- Paged query is disabled for this operation.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the instance. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
InstanceIds | string | No | The ID of the instance for which you want to query the overview information. Note
| dds-bp12c5b040dc**** |
InstanceStatus | string | No | The state of the instance. For more information about valid values, see Instance states. | Running |
ChargeType | string | No | The billing method of the instance. Valid values:
| PostPaid |
NetworkType | string | No | The network type of the instance. Valid values:
| Classic |
EngineVersion | string | No | The database engine version of the instance. Valid values: 5.0, 4.4, 4.2, 4.0, and 3.4. | 4.0 |
InstanceClass | string | No | The instance type. The instance type varies based on the instance architecture. For more information about instance types supported by different instance architectures, see the following references: | dds.mongo.2xlarge |
VpcId | string | No | The ID of the VPC in which the instance is deployed. | vpc-bp1nme44gek34slfc**** |
VSwitchId | string | No | The ID of the vSwitch to which the instance is connected. | vsw-bp1e7clcw529l773d**** |
InstanceType | string | No | The architecture of the instance. Valid values:
Note
| replicate |
ZoneId | string | No | The zone ID of the instance. | cn-hangzhou-b |
ResourceGroupId | string | No | The ID of the resource group to which the instance belongs. For more information, see View the basic information of a resource group. | rg-acfmyiu4ekp**** |
Response parameters
Examples
Sample success responses
JSON
format
{
"TotalCount": "1",
"RequestId": "52820D2B-B2DD-59F0-BDF2-83EC19C6F1CA",
"DBInstances": [
{
"CreationTime": "2022-01-05T03:18:53Z",
"ExpireTime": "2022-02-05T16:00Z",
"Tags": [
{
"Key": "testdatabase",
"Value": "apitest"
}
],
"LastDowngradeTime": "2021-05-08",
"ShardList": [
{
"NodeClass": "dds.shard.mid",
"NodeDescription": "testshard",
"NodeStorage": 10,
"NodeId": "d-bp1cac6f2083****",
"ReadonlyReplicas": 2
}
],
"DBInstanceType": "replicate",
"DestroyTime": "2021-12-10T16:00:00Z",
"ChargeType": "PrePaid",
"CapacityUnit": "100",
"VpcAuthMode": "Open",
"DBInstanceStatus": "Running",
"NetworkType": "VPC",
"LockMode": "Unlock",
"EngineVersion": "4.2",
"MongosList": [
{
"NodeClass": "dds.mongos.standard",
"NodeDescription": "mongos node describe.",
"NodeId": "s-bp10e3b0d02f****"
}
],
"RegionId": "cn-hangzhou",
"DBInstanceStorage": 20,
"ResourceGroupId": "rg-acfm22cdcgc****",
"ZoneId": "cn-hangzhou-i",
"DBInstanceId": "dds-bp12c5b040dc****",
"DBInstanceClass": "dds.mongo.mid",
"Engine": "MongoDB",
"ReplicationFactor": "3",
"DBInstanceDescription": "test db",
"KindCode": "0"
}
]
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2022-01-11 | Add Operation | see changesets |