全部產品
Search
文件中心

:擷取zone列表

更新時間:Feb 25, 2025

調用DescribeZones查詢使用者的zone列表。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String DescribeZones

系統規定參數。取值:DescribeZones

Lang String en

語言。

PageNumber Integer 1

當前頁數,起始值為1,預設為1

PageSize Integer 100

分頁查詢時設定的每頁行數,最大值100,預設為20

Keyword String test

關鍵字,按照“%KeyWord%”模式搜尋,不區分大小寫。

SearchMode String LIKE

搜尋模式。取值:

  • LIKE:模糊搜尋
  • EXACT:精確搜尋,預設不填為精確搜尋
QueryRegionId String cn-hangzhou

所屬地區ID。

QueryVpcId String vpc-xxxxx

VPC ID。

ResourceGroupId String rg-xxxxx

資源群組ID。

ZoneType String CLOUD_PRODUCT_ZONE

Zone查詢類型;預設取值AUTH_ZONE,查權威Zone列表。

取值範圍:

  • AUTH_ZONE: 查權威Zone列表。
  • CLOUD_PRODUCT_ZONE:使用的雲產品Zone列表。
ZoneTag.N RepeatList BLINK
  • 若查權威Zone列表,則忽略此參數;
  • 若查使用或者管理的雲產品PrivateZone,則查詢對應的雲產品類型Zone列表。
ResourceTag.N.Key String env

資源標籤鍵。

ResourceTag.N.Value String daily

資源標籤值。

返回資料

名稱 類型 樣本值 描述
PageNumber Integer 1

頁碼。

PageSize Integer 20

頁面大小。

RequestId String 6856BCF6-11D6-4D7E-AC53-FD579933522B

請求ID。

TotalItems Integer 3

總個數。

TotalPages Integer 3

總頁數。

Zones Array of Zone

zone列表。

Zone
CreateTime String 2017-12-28T13:08Z

建立時間。

CreateTimestamp Long 1514466483000

建立時間(時間戳記)。

IsPtr Boolean true
  • true,是反解zone
  • false,非反解zone
ProxyPattern String ZONE
  • ZONE: 全部劫持
  • RECORD:開啟遞迴解析代理
RecordCount Integer 2

解析記錄數。

Remark String test

zone備忘資訊。

ResourceGroupId String rg-xxxxx

資源群組ID。

ResourceTags Array of ResourceTag

資源標籤列表。

ResourceTag
Key String env

資源標籤鍵。

Value String daily

資源標籤值。

UpdateTime String 2018-01-03T08:57Z

更新時間。

UpdateTimestamp Long 1514969843000

更新時間(時間戳記)。

ZoneId String ICAgICAgI_24

zone ID。

ZoneName String test.com

zone名稱。

ZoneTag String BLINK

雲產品類型:

  • 若ZoneType為權威zone,則此為空白;
  • 若ZoneType為雲產品zone,則此為雲產品類型。
ZoneType String CLOUD_PRODUCT_ZONE

Zone類型:

  • AUTH_ZONE: 權威Zone。
  • CLOUD_PRODUCT_ZONE: 雲產品PrivateZone。

樣本

請求樣本

http(s)://pvtz.aliyuncs.com/?Action=DescribeZones
&<公用請求參數>

正常返回樣本

XML格式

<PageSize>20</PageSize>
<RequestId>6856BCF6-11D6-4D7E-AC53-FD579933522B</RequestId>
<PageNumber>1</PageNumber>
<TotalPages>3</TotalPages>
<TotalItems>3</TotalItems>
<Zones>
    <Zone>
        <ZoneName>test.com</ZoneName>
        <ResourceGroupId>rg-xxxxx</ResourceGroupId>
        <ZoneId>ICAgICAgI_24</ZoneId>
        <ProxyPattern>ZONE</ProxyPattern>
        <ZoneTag>BLINK</ZoneTag>
        <CreateTime>2017-12-28T13:08Z</CreateTime>
        <UpdateTime>2018-01-03T08:57Z</UpdateTime>
        <UpdateTimestamp>1514969843000</UpdateTimestamp>
        <CreateTimestamp>1514466483000</CreateTimestamp>
        <RecordCount>2</RecordCount>
        <IsPtr>true</IsPtr>
        <ZoneType>CLOUD_PRODUCT_ZONE</ZoneType>
        <Remark>test</Remark>
        <ResourceTags>
            <ResourceTag>
                <Value>daily</Value>
                <Key>env</Key>
            </ResourceTag>
        </ResourceTags>
    </Zone>
</Zones>

JSON格式

{
    "PageSize": "20",
    "RequestId": "6856BCF6-11D6-4D7E-AC53-FD579933522B",
    "PageNumber": "1",
    "TotalPages": "3",
    "TotalItems": "3",
    "Zones": {
        "Zone": [
            {
                "ZoneName": "test.com",
                "ResourceGroupId": "rg-xxxxx",
                "ZoneId": "ICAgICAgI_24",
                "ProxyPattern": "ZONE",
                "ZoneTag": "BLINK",
                "CreateTime": "2017-12-28T13:08Z",
                "UpdateTime": "2018-01-03T08:57Z",
                "UpdateTimestamp": "1514969843000",
                "CreateTimestamp": "1514466483000",
                "RecordCount": "2",
                "IsPtr": "true",
                "ZoneType": "CLOUD_PRODUCT_ZONE",
                "Remark": "test",
                "ResourceTags": {
                    "ResourceTag": [
                        {
                            "Value": "daily",
                            "Key": "env"
                        }
                    ]
                }
            }
        ]
    }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。