# 查询VPN网关可用区(V5) - QueryAZs(V5)
#### 功能介绍
查询VPN网关可用区，响应体信息比v5.1接口更少（例如IPv6、边缘站点等新特性）。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-vpn/vpn_api_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpn/vpn_api_0044.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项                    | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| vpn:vpnGateways:create | list | vpnGateways | -   | -  | -      |
   
#### URI
GET /v5/{project_id}/vpn-gateways/availability-zones
表1参数说明 
| 名称         | 类型     | 是否必选 | 说明                                                                                  |
|:---|:---|:---|:---|
| project_id | String | 是    | 项目ID，可以通过[获取项目ID](https://support.huaweicloud.com/api-vpn/vpn_api_0051.html)获取项目ID。 |
   
#### 请求消息
- 请求参数 无。
  
- 请求样例
  ```
  GET https://{Endpoint}/v5/{project_id}/vpn-gateways/availability-zones
  ```
  
 
#### 响应消息
- 响应参数 返回状态码为 200: successful operation。
  表2响应Body参数列表 
  | 名称                 | 类型                                                                    | 描述     |
  |:---|:---|:---|
  | availability_zones | [AvailabilityZones] object | 可用区列表。 |
  | request_id         | String                                                                | 请求ID。  |
     
   表3AvailabilityZones 
  | 名称                       | 类型                                                                              | 描述                            |
  |:---|:---|:---|
  | basic                    | [VpnGatewayAvailabilityZones] object | Basic网关规格。                    |
  | professional1            | [VpnGatewayAvailabilityZones] object | Professional1网关规格。            |
  | Professional1-NonFixedIP | [VpnGatewayAvailabilityZones] object | Professional1-NonFixedIP网关规格。 |
  | professional2            | [VpnGatewayAvailabilityZones] object | Professional2网关规格。            |
  | Professional2-NonFixedIP | [VpnGatewayAvailabilityZones] object | Professional2-NonFixedIP网关规格。 |
  | gm                       | [VpnGatewayAvailabilityZones] object | GM网关规格。                       |
     
  以上网关规格的实际可选范围请参考VPN控制台创建VPN网关页面的Specification选项。
   表4VpnGatewayAvailabilityZones 
  | 名称  | 类型              | 描述             |
  |:---|:---|:---|
  | vpc | Array of String | 关联VPC类型的可用区列表。 |
  | er  | Array of String | 关联ER类型的可用区列表。  |
     
  
- 响应样例
  ```
  {
      "availability_zones": {
          "basic": {
              "vpc": ["cn-south-1f"],
              "er": []
          },
          "professional1": {
              "vpc": ["cn-south-1f", "cn-south-1e", "cn-south-1c"],
              "er": ["cn-south-1f"]
          },
          "professional2": {
              "vpc": ["cn-south-1f", "cn-south-1e", "cn-south-1c"],
              "er": ["cn-south-1f"]
          },
          "Professional1-NonFixedIP": {
              "vpc": [],
              "er": []
          },
          "Professional2-NonFixedIP": {
              "vpc": [],
              "er": []
          },
         "gm": {
              "vpc": ["cn-south-1f", "cn-south-1e", "cn-south-1c"],
              "er": ["cn-south-1f"]
          }
      },
      "request_id": "b60309ab-812c-4269-9de4-fb9a65e6db16"
  }
  ```
  
 
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。