接口說明
列出可用區(qū)。查詢manila中AZ,用于創(chuàng)建share,該接口是在manila原有接口的基礎(chǔ)上擴展,通過增加可選參數(shù)share_az,來決定時查詢所有AZ(包括scheduler中的AZ),還是僅查詢用于創(chuàng)建共享的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
請求參數(shù)
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。 |
|
X-Openstack-Manila-Api-Version
|
float | header | 否 |
指定微版本號。 |
|
project_id
|
string | path | 是 |
指定微版本號。 |
|
share_az
|
boolean | query | 否 |
取值為true時,表示當(dāng)前租戶可以查詢所有能夠創(chuàng)建共享的可用區(qū),取值為false時,表示可以查詢所有可用區(qū),包含能創(chuàng)建共享和不能創(chuàng)建共享的AZ。 |
返回參數(shù)
返回碼: 200
OK
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
availability_zones
|
Array of availability_zone objects | 是 |
manila返回的AZ信息列表 |
200 availability_zones
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
created_at
|
string | 是 |
創(chuàng)建可用分區(qū)的時間標(biāo)簽。 |
|
id
|
string | 是 |
可用分區(qū)的UUID。 |
|
name
|
string | 是 |
可用分區(qū)的名稱。 |
|
updated_at
|
string | 是 |
修改可用分區(qū)的時間標(biāo)簽。 |
請求示例
示例 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
}
]
}
錯誤碼
請參考 錯誤碼說明。
