Todos os produtos
Search
Central de documentação

:DescribeZoneInfo

Última atualização: Jun 27, 2026

Consulta informações de uma zona privada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeZoneInfo

Operação a ser executada. Defina o valor como DescribeZoneInfo.

Lang

String

Não

en

Idioma.

ZoneId

String

Sim

AgIDE1MA_149

ID da zona privada.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdStringF73F41A3-B6DD-42CA-A793-FFF93277835D

ID da solicitação.

SlaveDnsBooleantrue

Indica se o Secondary DNS está ativado. Valores válidos:

  • true: Secondary DNS ativado.
  • false: Secondary DNS desativado.
ResourceGroupIdStringrg-xxxxxxxx

ID do grupo de recursos.

ZoneIdStringAgIDE0OQ_149<

ID da zona privada.

ProxyPatternStringZONE
  • ZONE: recurso de proxy de resolução recursiva desativado para a zona privada.
  • RECORD: recurso de proxy de resolução recursiva ativado para a zona privada.
CreateTimeString2018-01-23T03:15Z

Data e hora de criação da zona privada.

ZoneTypeStringCLOUD_PRODUCT_ZONE

Tipo da zona privada. Valores válidos:

  • AUTH_ZONE: zona autoritativa
  • CLOUD_PRODUCT_ZONE: zona hospedada em serviço de nuvem
RemarkStringspecialZone

Descrição da zona privada.

ZoneNameStringtest.com

Nome da zona privada.

ZoneTagStringpvtz
  • Se o parâmetro ZoneType for AUTH_ZONE, este parâmetro será nulo.
  • Se o parâmetro ZoneType for CLOUD_PRODUCT_ZONE, este valor indicará o serviço correspondente da Alibaba Cloud.
UpdateTimeString2018-01-24T06:35Z

Data e hora da última modificação da zona privada.

UpdateTimestampLong1516775741000

Timestamp UNIX da última modificação da zona privada. Representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC.

RecordCountInteger2

Número total de registros DNS.

CreateTimestampLong1516775741000

Timestamp UNIX de criação da zona privada. Representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC.

BindVpcsArray of Vpc

Virtual Private Clouds (VPCs) associadas à zona privada.

Vpc
VpcNameStringdaily-vpc-name

Nome da VPC.

VpcIdStringdaily-vpc-id

ID da VPC.

RegionNameString1304

Nome da região.

VpcUserIdLongvpc-bp1aevy8sofi8mh1q****

ID do usuário proprietário da VPC. Valor nulo indica que a VPC pertence ao usuário atual.

RegionIdStringcn-hangzhou

ID da região.

IsPtrBooleanfalse
  • true: a zona privada é uma zona de pesquisa reversa.
  • false: a zona privada não é uma zona de pesquisa reversa.

Exemplos

Solicitações de exemplo

http(s)://pvtz.aliyuncs.com/?Action=DescribeZoneInfo
&Lang=en
&ZoneId=AgIDE1MA_149
&UserClientIp=192.0.2.0
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeZoneInfoResponse>
    <RequestId>F73F41A3-B6DD-42CA-A793-FFF93277835D</RequestId>
    <SlaveDns>true</SlaveDns>
    <ResourceGroupId>rg-xxxxxxxx</ResourceGroupId>
    <ZoneId>AgIDE0OQ_149&lt;</ZoneId>
    <ProxyPattern>ZONE</ProxyPattern>
    <CreateTime>2018-01-23T03:15Z</CreateTime>
    <ZoneType>CLOUD_PRODUCT_ZONE</ZoneType>
    <Remark>specialZone</Remark>
    <ZoneName>test.com</ZoneName>
    <ZoneTag>pvtz</ZoneTag>
    <UpdateTime>2018-01-24T06:35Z</UpdateTime>
    <UpdateTimestamp>1516775741000</UpdateTimestamp>
    <RecordCount>2</RecordCount>
    <CreateTimestamp>1516775741000</CreateTimestamp>
    <BindVpcs>
        <VpcName>daily-vpc-name</VpcName>
        <VpcId>daily-vpc-id</VpcId>
        <RegionName>1304</RegionName>
        <RegionId>cn-hangzhou</RegionId>
    </BindVpcs>
    <IsPtr>false</IsPtr>
</DescribeZoneInfoResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/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" : [ {
    "VpcName" : "daily-vpc-name",
    "VpcId" : "daily-vpc-id",
    "RegionName" : "1304",
    "RegionId" : "cn-hangzhou"
  } ],
  "IsPtr" : false
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

Zone.Invalid.Id

Zone id is invalid.

O ID da zona privada é inválido.

Para obter uma lista de códigos de erro, visite o API Error Center.