调用DescribeDBInstancePerformance接口查询MongoDB实例性能数据。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDBInstancePerformance

要执行的操作,取值:DescribeDBInstancePerformance

Key String MongoDB_DetailedSpaceUsage

性能指标,取值详情请参见性能参数表

说明 如需传入多个指标使用英文逗号(,)分隔。
StartTime String 2019-03-11T12:30Z

查询开始时间,格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

EndTime String 2019-03-11T12:30Z

查询结束时间,必须晚于查询开始时间,格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

DBInstanceId String dds-bpxxxxxxxx

实例ID。

说明 当本参数传入的是分片集群实例ID时,还需要传入 NodeId参数。
NodeId String d-bpxxxxxxxx

分片集群实例中Mongos节点ID或Shard节点ID,可用于查询单个节点的性能情况。

说明DBInstanceId参数传入的是分片集群实例ID时,本参数才可用。
RoleId String 60xxxxx

实例的节点角色ID,可通过DescribeReplicaSetRole接口查询。

说明DBInstanceId参数传入的是单节点实例ID或副本集实例ID时,本参数才可用。
ReplicaSetRole String Primary

节点角色,取值:

  • Primary:主节点。
  • Secondary:从节点。
说明DBInstanceId参数传入的是单节点实例,本参数的取值仅支持 Primary
RegionId String cn-hangzhou

实例所属的地域ID,您可以通过调用DescribeDBInstanceAttribute进行查询。

AccessKeyId String LTAIgbTGpxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

名称 类型 示例值 描述
RequestId String 267F98DC-367D-4F20-B137-8B5B664D1C5D

请求ID。

StartTime String 2019-03-11T12:20Z

查询开始时间,格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

EndTime String 2019-03-11T12:30Z

查询结束时间,格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

PerformanceKeys

性能指标信息列表。

Key String MongoDB_DetailedSpaceUsage

性能指标。

PerformanceValues

性能指标值列表。

Date String 2019-03-11T12:21:51Z

性能指标值产生的日期。

Value String 0.6

性能指标值。

Unit String MB

展示单位。

ValueFormat String cpu_usage

性能指标值的格式。如果该性能指标包含多个字段,通常以&分隔。

例如查询磁盘空间使用量,返回的ValueFormat即为ins_size&data_size&log_size

示例

请求示例


http(s)://mongodb.aliyuncs.com/?Action=DescribeDBInstancePerformance
&Key=MongoDB_DetailedSpaceUsage
&StartTime=2019-03-11T12:30Z
&EndTime=2019-03-11T12:30Z
&DBInstanceId=dds-bpxxxxxxxx
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDBInstancePerformanceResponse>
	  <RequestId>267F98DC-367D-4F20-B137-8B5B664D1C5D</RequestId>
	  <PerformanceKeys>
		    <PerformanceKey>
			      <Key>MongoDB_DetailedSpaceUsage</Key>
			      <PerformanceValues>
				        <PerformanceValue>
					          <Value>1768&amp;1282&amp;486</Value>
					          <Date>2019-03-11T12:21:51Z</Date>
				        </PerformanceValue>
				        <PerformanceValue>
					          <Value>1768&amp;1282&amp;486</Value>
					          <Date>2019-03-11T12:26:52Z</Date>
				        </PerformanceValue>
			      </PerformanceValues>
			      <Unit>MB</Unit>
			      <ValueFormat>ins_size&amp;data_size&amp;log_size</ValueFormat>
		    </PerformanceKey>
	  </PerformanceKeys>
	  <EndTime>2019-03-11T12:30Z</EndTime>
	  <StartTime>2019-03-11T12:20Z</StartTime>
</DescribeDBInstancePerformanceResponse>

JSON 格式

{
	"RequestId":"267F98DC-367D-4F20-B137-8B5B664D1C5D",
	"PerformanceKeys":{
		"PerformanceKey":[
			{
				"Key":"MongoDB_DetailedSpaceUsage",
				"PerformanceValues":{
					"PerformanceValue":[
						{
							"Value":"1768&1282&486",
							"Date":"2019-03-11T12:21:51Z"
						},
						{
							"Value":"1768&1282&486",
							"Date":"2019-03-11T12:26:52Z"
						}
					]
				},
				"Unit":"MB",
				"ValueFormat":"ins_size&data_size&log_size"
			}
		]
	},
	"EndTime":"2019-03-11T12:30Z",
	"StartTime":"2019-03-11T12:20Z"
}

错误码

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