调用DescribeRoleZoneInfo查询Redis实例中各节点的详细信息,包含类型、小版本、带宽和所属的可用区等信息。

调试

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

请求参数

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

系统规定参数,取值:DescribeRoleZoneInfo

InstanceId String r-t4nlenc2p04uvb****

实例ID,可调用DescribeInstances接口获取。

RegionId String cn-hangzhou

实例所属的地域ID,可调用DescribeRegions接口获取。

QueryType Integer 0

查询的目标节点类型,取值:

  • 0:Proxy(代理)节点。
  • 1:数据节点,默认值。
PageNumber Integer 1

页码,大于0且不超过Integer数据类型的最大值,默认值为1

PageSize Integer 10

每页可展示的记录数,取值:102050,默认值为10.

返回数据

名称 类型 示例值 描述
Node Array of NodeInfo

Redis实例中各节点的详细信息。

NodeInfo
CurrentBandWidth Long 100

节点当前的带宽,单位为MB/s,由节点的默认带宽和增加的带宽组成。

说明
  • 您可以调用EnableAdditionalBandwidth接口设置要增加的带宽。
  • 通过本参数也可推算出增加的带宽大小,例如节点默认带宽为96 MB/s,本参数返回值为100,则增加了4 MB/s的带宽。
CurrentMinorVersion String redis-5.0_0.3.10

节点当前的小版本。

CustinsId String 30381****

本参数仅作为Redis实例内部维护使用。

DefaultBandWidth Long 96

节点默认的默认带宽,单位为MB/s。

InsName String r-t4nlenc2p04uvb****

节点ID。

InsType Integer 3

是否为只读节点,如果为只读节点,本参数返回值为3

说明 如果不是只读节点,不返回本参数。
IsLatestVersion Integer 1

是否为最新的小版本,返回值:

  • 0:不是最新版本。
  • 1:是最新版本。
说明 如需升级小版本,请调用ModifyInstanceMinorVersion接口。
IsOpenBandWidthService Boolean true

该节点是否增加了带宽,取值:

  • true:未增加带宽。
  • false:已增加带宽。
NodeId String 10065****

本参数仅作为Redis实例内部维护使用。

NodeType String normal

节点类型,返回值:

  • db:数据节点。
  • proxy:代理节点。
  • normal:普通节点(标准架构的实例会返回该值)。
Role String master

节点角色,返回值:

  • master:主节点。
  • slave:从节点。
ZoneId String cn-hangzhou-b

可用区ID。

PageNumber Integer 1

页码。

PageSize Integer 10

每页可展示的记录数。

RequestId String 224B97FB-A275-4EAC-86E9-8922FEA2****

请求ID。

TotalCount Integer 2

总记录数。

示例

请求示例

https://r-kvstore.aliyuncs.com/?Action=DescribeRoleZoneInfo
&InstanceId=r-t4nlenc2p04uvb****
&<公共请求参数>

正常返回示例

XML格式

<DescribeRoleZoneInfoResponse>
      <TotalCount>2</TotalCount>
      <RequestId>224B97FB-A275-4EAC-86E9-8922FEA2****</RequestId>
      <PageSize>10</PageSize>
      <PageNumber>1</PageNumber>
      <Node>
            <NodeInfo>
                  <Role>slave</Role>
                  <IsLatestVersion>1</IsLatestVersion>
                  <ZoneId>cn-hangzhou-b</ZoneId>
                  <NodeType>normal</NodeType>
                  <IsOpenBandWidthService>true</IsOpenBandWidthService>
                  <NodeId>10065****</NodeId>
                  <CurrentMinorVersion>redis-5.0_0.3.10</CurrentMinorVersion>
                  <CustinsId>30381****</CustinsId>
                  <DefaultBandWidth>96</DefaultBandWidth>
                  <InsName>r-t4nlenc2p04uvb****</InsName>
                  <CurrentBandWidth>100</CurrentBandWidth>
            </NodeInfo>
            <NodeInfo>
                  <Role>master</Role>
                  <IsLatestVersion>1</IsLatestVersion>
                  <ZoneId>cn-hangzhou-b</ZoneId>
                  <NodeType>normal</NodeType>
                  <IsOpenBandWidthService>true</IsOpenBandWidthService>
                  <NodeId>10065****</NodeId>
                  <CurrentMinorVersion>redis-5.0_0.3.10</CurrentMinorVersion>
                  <CustinsId>30381****</CustinsId>
                  <DefaultBandWidth>96</DefaultBandWidth>
                  <InsName>r-t4nlenc2p04uvb****</InsName>
                  <CurrentBandWidth>100</CurrentBandWidth>
            </NodeInfo>
      </Node>
</DescribeRoleZoneInfoResponse>

JSON格式

{
	"TotalCount": 2,
	"RequestId": "224B97FB-A275-4EAC-86E9-8922FEA2****",
	"PageSize": 10,
	"PageNumber": 1,
	"Node": {
		"NodeInfo": [
			{
				"Role": "slave",
				"IsLatestVersion": 1,
				"ZoneId": "cn-hangzhou-b",
				"NodeType": "normal",
				"IsOpenBandWidthService": true,
				"NodeId": "10065****",
				"CurrentMinorVersion": "redis-5.0_0.3.10",
				"CustinsId": "30381****",
				"DefaultBandWidth": 96,
				"InsName": "r-t4nlenc2p04uvb****",
				"CurrentBandWidth": 100
			},
			{
				"Role": "master",
				"IsLatestVersion": 1,
				"ZoneId": "cn-hangzhou-b",
				"NodeType": "normal",
				"IsOpenBandWidthService": true,
				"NodeId": "10065****",
				"CurrentMinorVersion": "redis-5.0_0.3.10",
				"CustinsId": "30381****",
				"DefaultBandWidth": 96,
				"InsName": "r-t4nlenc2p04uvb****",
				"CurrentBandWidth": 100
			}
		]
	}
}

错误码

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