接口說明
創(chuàng)建文件共享。創(chuàng)建文件系統(tǒng)成功后,您還需前往彈性 云服務(wù)器 執(zhí)行掛載操作,才能實(shí)現(xiàn)多個(gè)云服務(wù)器共享文件存儲(chǔ)
約束說明
- 該接口為異步接口,返回為200只是表示接口下發(fā)接收成功,后續(xù)可以通過6.2.4 查詢共享詳細(xì)信息查詢共享的共享狀態(tài)和共享路徑,判斷創(chuàng)建共享是否完成以及是否成功,如果共享狀態(tài)變?yōu)閍vailable,或者共享路徑已經(jīng)生成,說明創(chuàng)建已經(jīng)成功。
- 通過該接口創(chuàng)建共享成功后,用戶還需要參考接口"添加共享訪問規(guī)則添加共享訪問規(guī)則",之后才可正常使用創(chuàng)建的共享。
URL
POST https://sfs.cn-south-2.myhuaweicloud.com/v2/{project_id}/shares
請(qǐng)求參數(shù)
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用 |
|
X-Openstack-Manila-Api-Version
|
float | header | 否 |
指定API微版本號(hào) |
|
project_id
|
string | path | 是 |
操作用戶的項(xiàng)目ID |
Body參數(shù)
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
share
|
share object | 是 |
詳見share字段說明 |
返回參數(shù)
返回碼: 202
Accepted
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
share
|
share_response object | 是 |
詳細(xì)參數(shù)說明請(qǐng)參見share_response字段說明 |
請(qǐng)求示例
示例 1
創(chuàng)建共享
"POST https://{endpoint}/v2/{project_id}/shares"
{ "share": { "description": "test description", "is_public": false, "metadata": { "key1": "value1", "key2": "value2" }, "name": "test", "share_network_id": null, "share_proto": "NFS", "share_type": null, "size": 1, "snapshot_id": null } }
返回示例
返回碼：202
Accepted
示例 1
{
"share": {
"availability_zone": "az1.dc1",
"created_at": "2015-09-18T10:25:24.533287",
"description": "My custom share London",
"export_location": null,
"export_locations": [],
"host": null,
"id": "011d21e2-fbc3-4e4a-9993-9ea223f73264",
"is_public": true,
"links": [
{
"href": "http://192.168.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "self"
},
{
"href": "http://192.168.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "bookmark"
}
],
"metadata": {
"aim": "doc",
"project": "my_app"
},
"name": "share_London",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"share_network_id": null,
"share_proto": "NFS",
"share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
"size": 1,
"snapshot_id": null,
"status": "creating",
"volume_type": "default"
}
}
"share": {
"availability_zone": "az1.dc1",
"created_at": "2015-09-18T10:25:24.533287",
"description": "My custom share London",
"export_location": null,
"export_locations": [],
"host": null,
"id": "011d21e2-fbc3-4e4a-9993-9ea223f73264",
"is_public": true,
"links": [
{
"href": "http://192.168.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "self"
},
{
"href": "http://192.168.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "bookmark"
}
],
"metadata": {
"aim": "doc",
"project": "my_app"
},
"name": "share_London",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"share_network_id": null,
"share_proto": "NFS",
"share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
"size": 1,
"snapshot_id": null,
"status": "creating",
"volume_type": "default"
}
}
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說明。
猜你喜歡
