Tous les produits
Search
Centre de documentation

:DescribeZoneInfo

Dernière mise à jour :Aug 09, 2026

Récupère les informations d’une zone privée.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d’appeler cette opération dans OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre Type Obligatoire Exemple Description
Action String Oui DescribeZoneInfo

L’opération à effectuer. Définissez la valeur sur DescribeZoneInfo.

Lang String Non en

La langue.

ZoneId String Oui AgIDE1MA_149

L’ID de la zone privée.

Paramètres de réponse

ParamètreTypeExempleDescription
RequestIdStringF73F41A3-B6DD-42CA-A793-FFF93277835D

L’ID de la requête.

SlaveDnsBooleantrue

Indique si le DNS secondaire est activé. Valeurs possibles :

  • true : le DNS secondaire est activé.
  • false : le DNS secondaire est désactivé.
ResourceGroupIdStringrg-xxxxxxxx

L’ID du groupe de ressources.

ZoneIdStringAgIDE0OQ_149<

L’ID de la zone privée.

ProxyPatternStringZONE
  • ZONE : la fonctionnalité de proxy de résolution récursive est désactivée pour la zone privée.
  • RECORD : la fonctionnalité de proxy de résolution récursive est activée pour la zone privée.
CreateTimeString2018-01-23T03:15Z

La date de création de la zone privée.

ZoneTypeStringCLOUD_PRODUCT_ZONE

Le type de la zone privée. Valeurs possibles :

  • AUTH_ZONE : zone faisant autorité
  • CLOUD_PRODUCT_ZONE : zone hébergée par un service cloud
RemarkStringspecialZone

La description de la zone privée.

ZoneNameStringtest.com

Le nom de la zone privée.

ZoneTagStringpvtz
  • Si la valeur du paramètre ZoneType est AUTH_ZONE, la valeur de ce paramètre est nulle.
  • Si la valeur du paramètre ZoneType est CLOUD_PRODUCT_ZONE, la valeur de ce paramètre indique le service Alibaba Cloud correspondant.
UpdateTimeString2018-01-24T06:35Z

La date de la dernière modification de la zone privée.

UpdateTimestampLong1516775741000

La date de la dernière modification de la zone privée. Cette valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC.

RecordCountInteger2

Le nombre total d’enregistrements DNS.

CreateTimestampLong1516775741000

La date de création de la zone privée. Cette valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC.

BindVpcsArray of Vpc

Les clouds privés virtuels (VPC) associés à la zone privée.

Vpc
VpcNameStringdaily-vpc-name

Le nom du VPC.

VpcIdStringdaily-vpc-id

L’ID du VPC.

RegionNameString1304

Le nom de la région.

VpcUserIdLongvpc-bp1aevy8sofi8mh1q****

L’ID de l’utilisateur auquel le VPC appartient. Une valeur nulle indique que le VPC appartient à l’utilisateur actuel.

RegionIdStringcn-hangzhou

L’ID de la région.

IsPtrBooleanfalse
  • true : indique que la zone privée est une zone de recherche inverse.
  • false : indique que la zone privée n’est pas une zone de recherche inverse.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format 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>

Format 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
}

Codes d'erreur

Code d'état HTTP Code d'erreur Message d'erreur Description
400 Zone.Invalid.Id Zone id is invalid. L’ID de la zone privée n’est pas valide.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.