DescribeDBInstanceNetInfo - 查看实例的网络信息 - 云数据库 Tair（兼容 Redis®）

查看云数据库 Tair（兼容 Redis）实例的网络信息。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

kvstore:DescribeDBInstanceNetInfo

get

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	r-bp1zxszhcgatnx****
NetType	string	否

返回参数

名称	类型	描述	示例值
	object
InstanceNetworkType	string	网络类型，返回值： CLASSIC：经典网络。 VPC：专有网络。	CLASSIC
RequestId	string	请求 ID。	FC77D4E1-2A7C-4F0B-A4CC-CE0B9C314B9B
NetInfoItems	object
InstanceNetInfo	array<object>	实例的网络信息列表。
	object	实例的网络信息列表。
DirectConnection	integer	是否为直连地址，返回值： 0：非直连地址。 1：直连地址。	0
VSwitchId	string	虚拟交换机的 ID。	vsw-bp1e7clcw529l773d****
DBInstanceNetType	string	该网络信息所属的网络类型： 0：公网。 1：经典网络。 2：专有网络。	1
Upgradeable	string	经典网络连接地址的过期时间，即剩余有效时间，单位为秒。说明 0 表示不会过期。	0
ExpiredTime	string	实例经典网络地址的有效时间，单位：秒。	5183778
ConnectionString	string	实例的连接地址。	r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com
IPType	string	IP 地址的网络类型，返回值： Public：公网。 Inner：经典网络。 Private：VPC 网络。	Inner
VPCInstanceId	string	实例 ID。	r-bp1ky7j6qc7umk****
Port	string	实例的服务端口。	6379
VPCId	string	实例所属的专有网络（VPC）的 ID。	vpc-bp1nme44gek34slfc****
IPAddress	string	IP 地址。	172.16.49.***
IsSlaveProxy	integer	表示该地址为备可用区的连接地址，取值为 1，表示备可用区。说明该地址仅在开通多可用区读写分离架构后返回。	1

示例

正常返回示例

JSON格式

{
  "InstanceNetworkType": "CLASSIC",
  "RequestId": "FC77D4E1-2A7C-4F0B-A4CC-CE0B9C314B9B",
  "NetInfoItems": {
    "InstanceNetInfo": [
      {
        "DirectConnection": 0,
        "VSwitchId": "vsw-bp1e7clcw529l773d****",
        "DBInstanceNetType": "1",
        "Upgradeable": "0",
        "ExpiredTime": "5183778",
        "ConnectionString": "r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com",
        "IPType": "Inner",
        "VPCInstanceId": "r-bp1ky7j6qc7umk****",
        "Port": "6379",
        "VPCId": "vpc-bp1nme44gek34slfc****",
        "IPAddress": "172.16.49.***",
        "IsSlaveProxy": 1
      }
    ]
  }
}

异常返回示例

JSON格式

{
 "RequestId":"314C4FB3-4256-424F-9AD9-1A6B3444160A",
 "InstanceNetworkType":"Classic",
 "NetInfoItems":{
   "InstanceNetInfo":[{
     "DBInstanceNetType":"1",
     "Port":"6379",
     "ConnectionString":"r-xxxxxxxxxxxxxxx.redis.rds.aliyuncs.com",
     "VPCId":"",
     "IPAddress":"xxx.xxx.xxx.xxx",
     "IPType":"Inner",
     "Upgradeable":"0"
   				   }]
   			 }
}

错误码

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

变更历史

更多信息，参考变更详情。