DescribeZoneInfo - 获取zone详细信息_云解析DNS(DNS)-阿里云帮助中心

获取指定zone的详细信息。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
pvtz:DescribeZoneInfo		Zone acs:pvtz::{#accountId}:zone/{#ZoneId}	无	无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	语言。	en
ZoneId	string	是	Zone ID。	AgIDE1MA_149

返回参数

名称	类型	描述	示例值
	object
RequestId	string	唯一请求识别码。	F73F41A3-B6DD-42CA-A793-FFF93277835D
SlaveDns	boolean	是否开启辅助 DNS。取值： true：已开启 false：未开启	true
ResourceGroupId	string	资源组 ID。	rg-xxxxxxxx
ZoneId	string	Zone ID。	AgIDE0OQ_149<
ProxyPattern	string	ZONE：当前 Zone 不进行递归解析； RECORD：递归解析代理。	ZONE
CreateTime	string	创建时间。	2018-01-23T03:15Z
ZoneType	string	zone 类型： AUTH_ZONE：权威 Zone； CLOUD_PRODUCT_ZONE：云产品权威 Zone。	CLOUD_PRODUCT_ZONE
Remark	string	备注。	specialZone
ZoneName	string	Zone 名称。	test.com
ZoneTag	string	若查权威 Zone 列表，则忽略此参数；若查使用或者管理的云产品 PrivateZone，则查询对应的云产品类型 Zone 列表。	pvtz
UpdateTime	string	更新时间。	2018-01-24T06:35Z
UpdateTimestamp	long	更新时间（时间戳）。	1516775741000
RecordCount	integer	含有的解析记录总数。	2
CreateTimestamp	long	创建时间（时间戳）。	1516775741000
BindVpcs	object []	绑定的 Vpc 列表。
VpcName	string	Vpc 名称。	daily-vpc-name
VpcId	string	Vpc ID。	daily-vpc-id
VpcType	string	vpc 类型： STANDARD：标准 VPC。 EDS：无影工作区 VPC。	STANDARD
RegionName	string	地域名称。	1304
VpcUserId	long	vpc 归属的用户 Id；若为 null 则归属当前用户。	vpc-bp1aevy8sofi8mh1q****
RegionId	string	地域 ID。	cn-hangzhou
IsPtr	boolean	true，是反解 zone false，非反解 zone	false
DnsGroup	string	内置权威位置区普通区：NORMAL_ZONE 快速区：FAST_ZONE	FAST_ZONE
Creator	string	Zone 创建者	2312234523451342
CreatorType	string	操作者类型。	USER
DnsGroupChanging	boolean	Zone 切换位置区状态切换中：true 未切换：false	false

示例

正常返回示例

JSON格式

{
  "RequestId": "F73F41A3-B6DD-42CA-A793-FFF93277835D",
  "SlaveDns": true,
  "ResourceGroupId": "rg-xxxxxxxx",
  "ZoneId": "AgIDE0OQ_149<",
  "ProxyPattern": "ZONE",
  "CreateTime": "2018-01-23T03:15Z",
  "ZoneType": "CLOUD_PRODUCT_ZONE",
  "Remark": "specialZone",
  "ZoneName": "test.com",
  "ZoneTag": "pvtz",
  "UpdateTime": "2018-01-24T06:35Z",
  "UpdateTimestamp": 1516775741000,
  "RecordCount": 2,
  "CreateTimestamp": 1516775741000,
  "BindVpcs": {
    "Vpc": [
      {
        "VpcName": "daily-vpc-name",
        "VpcId": "daily-vpc-id",
        "VpcType": "STANDARD",
        "RegionName": "1304",
        "VpcUserId": 0,
        "RegionId": "cn-hangzhou"
      }
    ]
  },
  "IsPtr": false,
  "DnsGroup": "FAST_ZONE",
  "Creator": "2312234523451342",
  "CreatorType": "USER",
  "DnsGroupChanging": false
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	The specified value parameter is not valid.	-
400	IllegalUser	The user is illegal.	-
400	Zone.Invalid.Name	Zone name is invalid.	-
400	Zone.Invalid.Id	Zone id is invalid.	Zone的ID不正确
400	Zone.Invalid.UserId	Zone userid is invalid.	-
400	Zone.NotExists	Zone is not exists	-
400	Zone.VpcExists	Zone have vpc bound.	-

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