You can call this operation to query the details of a private zone.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeZoneInfo

The operation that you want to perform. Set the value to DescribeZoneInfo.

Lang String No en

The language of the specific content returned in the response.

ZoneId String No AgIDE1MA_149

The ID of the private zone.

UserClientIp String No 1.1.1.1

The IP address of the client.

Response parameters

Parameter Type Example Description
RequestId String F73F41A3-B6DD-42CA-A793-FFF93277835D

The ID of the request.

ZoneId String AgIDE0OQ_149<

The ID of the private zone.

ZoneName String test.com

The name of the private zone.

Remark String specialZone

The description of the private zone.

RecordCount Integer 2

The total number of Domain Name System (DNS) records.

CreateTime String 2018-01-23T03:15Z

The time when the private zone was created.

CreateTimestamp Long 1516775741000

The timestamp when the private zone was created.

UpdateTime String 2018-01-24T06:35Z

The time when the private zone was updated.

UpdateTimestamp Long 1516775741000

The timestamp when the private zone was updated.

IsPtr Boolean false
  • Indicates whether the private zone is a reverse lookup zone. Valid values:
  • true: yes. false: no.
ProxyPattern String ZONE
  • Indicates whether recursive resolution is performed when a queried subdomain name is not recorded in the private zone. Valid values: ZONE: no
  • RECORD: yes
SlaveDns Boolean true

Indicates whether Alibaba Cloud Secondary DNS is enabled. Valid values:

  • true: yes
  • false: no
BindVpcs Array

The list of the Virtual Private Clouds (VPCs) with which the private zone is associated.

RegionId String cn-hangzhou

The ID of the region.

VpcId String daily-vpc-id

The ID of the VPC.

VpcName String daily-vpc-name

The name of the VPC.

RegionName String 1304

The name of the region.

RegionId String cn-hangzhou

The ID of the region.

Examples

Sample requests

http://pvtz.aliyuncs.com/?Action=DescribeZoneInfo&ZoneId=AgIDE1MA_149&<Common request parameters>

Sample success responses

XML format

<DescribeZoneInfoResponse>    <ZoneName>niu.com</ZoneName>    <IsPtr>false</IsPtr>    <CreateTimestamp>1516677356000</CreateTimestamp>    <RecordCount>2</RecordCount>    <BindVpcs>    <Vpc>    <VpcName>daily-vpc-name</VpcName>    <RegionName>1304</RegionName>    <ReionId>cn-hangzhou</ReionId>    <VpcId>daily-vpc-id</VpcId>    </Vpc>    </BindVpcs>    <UpdateTimestamp>1516775741000</UpdateTimestamp>    <CreateTime>2018-01-23T03:15Z</CreateTime>    <RequestId>F73F41A3-B6DD-42CA-A793-FFF93277835D</RequestId>    <UpdateTime>2018-01-24T06:35Z</UpdateTime>    <ZoneId>AgIDE0OQ_149</ZoneId>    <Remark>specialZone</Remark></DescribeZoneInfoResponse>

JSON format

{“ZoneName”: “niu.com”,“IsPtr”: false,“CreateTimestamp”: 1516677356000,“RecordCount”: 2,“BindVpcs”: {“Vpc”: [{“VpcName”: “daily-vpc-name”,“RegionName”: “1304”,“ReionId”: “cn-hangzhou”,“VpcId”: “daily-vpc-id”}]},“UpdateTimestamp”: 1516775741000,“CreateTime”: “2018-01-23T03:15Z”,“RequestId”: “29D0F8F8-5499-4F6C-9FDC-1EE13BF55925”,“UpdateTime”: “2018-01-24T06:35Z”,“ZoneId”: “AgIDE0OQ_149”,“Remark”: “specialZone”}

Error codes

HTTP status code Error code Error message Description
400 Zone.Invalid.Id Zone id is invalid. The error message returned because the ID of the private zone is invalid.

For a list of error codes, visit the API Error Center.