查询可用区queryAZ
接口说明
列出可用区。查询manila中AZ,用于创建share,该接口是在manila原有接口的基础上扩展,通过增加可选参数share_az,来决定时查询所有AZ(包括scheduler中的AZ),还是仅查询用于创建共享的AZ
约束说明
如果X-Openstack-Manila-Api-Version的值小于于等于2.6,使用os-availability-zone代替availability-zones,否则直接使用上述的接口形式。
URL
GET https://sfs.cn-south-2.myhuaweicloud.com/v2/{project_id}/availability-zones
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
X-Openstack-Manila-Api-Version
|
float | header | 否 |
指定微版本号。 |
|
project_id
|
string | path | 是 |
指定微版本号。 |
|
share_az
|
boolean | query | 否 |
取值为true时,表示当前租户可以查询所有能够创建共享的可用区,取值为false时,表示可以查询所有可用区,包含能创建共享和不能创建共享的AZ。 |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
availability_zones
|
Array of availability_zone objects | 是 |
manila返回的AZ信息列表 |
200 availability_zones
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
created_at
|
string | 是 |
创建可用分区的时间标签。 |
|
id
|
string | 是 |
可用分区的UUID。 |
|
name
|
string | 是 |
可用分区的名称。 |
|
updated_at
|
string | 是 |
修改可用分区的时间标签。 |
请求示例
示例 1
查询可用AZ
"GET /v2/{project_id}/availability-zones?share_az={share_az}"
返回示例
返回码：200
OK
示例 1
{
"availability_zones": [
{
"created_at": "2018-07-10T19:11:49.831107",
"id": "ddafcb71-face-4526-a637-9768d19b20f3",
"name": "az1.dc1",
"updated_at": null
}
]
}
"availability_zones": [
{
"created_at": "2018-07-10T19:11:49.831107",
"id": "ddafcb71-face-4526-a637-9768d19b20f3",
"name": "az1.dc1",
"updated_at": null
}
]
}
错误码
请参考 错误码说明。
