创建文件共享。创建文件系统成功后,您还需前往弹性云服务器执行挂载操作,才能实现多个云服务器共享文件存储。挂载相关操作请参考弹性文件服务快速入门。
该接口为异步接口,返回为200只是表示接口下发接收成功,后续可以通过查询共享详细信息查询共享的共享状态和共享路径,判断创建共享是否完成以及是否成功,如果共享状态变为available,或者共享路径已经生成,说明创建已经成功。
通过该接口创建共享成功后,用户还需要参考添加共享访问规则添加共享访问规则,之后才可正常使用创建的共享。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
操作用户的项目ID,获取方法请参见获取项目ID。 |
该操作消息头与普通请求一样,请参见表3。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
share |
是 |
Object |
详见share字段说明 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
share_proto |
是 |
String |
文件系统共享协议,有效值为NFS(适用于linux系统)、CIFS(适用于windows系统)。 |
size |
是 |
Integer |
共享容量,单位GB。申请的共享容量不能大于配额值,需要查看配额,请参考配额查询接口。 |
name |
否 |
String |
共享名称,长度为0~255,只支持英文字母、数字、中划线、下划线。 |
description |
否 |
String |
共享描述信息,长度为0~255,只支持英文字母、数字、中划线、下划线。 |
snapshot_id |
否 |
String |
创建共享的源快照的UUID,长度为0~36,当前不支持快照,该字段无意义。 |
is_public |
否 |
Boolean |
(API 微版本2.8到2.42支持)共享的可见程度。设置为true时公共可见,设置为false时私有个人可见,默认值为false。 |
share_type |
否 |
String |
共享类型的名称,共享类型用于指定分配哪些类型的存储服务,例如高性能类型(由SSD磁盘组成)、大容量类型(由SATA盘组成),当前支持一种类型的存储服务,用户不用指定本参数,后台会自动把本参数指定为系统支持的存储类型,用户若要输入系统不支持的服务类型,将导致文件服务申请失败。 |
consistency_group_id |
否 |
String |
(API 微版本2.31到2.42支持) 共享将创建到的一致性组的UUID。当前文件服务不支持一致性组,该字段无意义,这个参数不填写。 |
availability_zone |
否 |
String |
AZ( availability zone)的名称,如果不输入AZ信息,后台会当成默认AZ处理,默认AZ中如果无存储资源,共享创建会失败。长度为0~255。 |
metadata |
否 |
Object |
创建共享的metadata信息,一到多个字典形式组织的键值对组成,见metadata字段说明。 注意:
|
share_network_id |
否 |
String |
共享服务所属或即将创建到的共享网络的UUID,长度为0~36,当前不支持共享网络管理,该字段无意义。 |
键 |
值类型 |
是否必选 |
说明 |
---|---|---|---|
#sfs_crypt_key_id |
String |
是 |
加密密钥ID。 该字段与“#sfs_crypt_domain_id”和“#sfs_crypt_alias”字段同时存在时表示启动数据加密功能。 |
#sfs_crypt_domain_id |
String |
是 |
租户的Domain id。 该字段与“#sfs_crypt_key_id”和“#sfs_crypt_alias”字段同时存在时表示启动数据加密功能。 |
#sfs_crypt_alias |
String |
是 |
加密密钥别名。 该字段与“#sfs_crypt_key_id”和“#sfs_crypt_domain_id”字段同时存在时表示启动数据加密功能。 |
键 |
值类型 |
是否必选 |
说明 |
---|---|---|---|
enterprise_project_id |
String |
是 |
企业项目ID。 在租户开启企业项目功能的情况下,enterprise_project_id作为key,value为企业项目ID,给共享绑定企业项目ID。 |
{ "share": { "share_type": null, "name": "test", "snapshot_id": null, "description": "test description", "metadata": { "key1": "value1", "key2": "value2" }, "share_proto": "NFS", "share_network_id": null, "size": 1, "is_public": false } }
{ "share": { "share_type": null, "name": "test", "snapshot_id": null, "description": "test description", "metadata": { "#sfs_crypt_key_id": "9130c90d-73b8-4203-b790-d49f98d503df", "#sfs_crypt_domain_id": "3b2d9670690444c582942801ed7d457b", "#sfs_crypt_alias": "sfs/default" }, "share_proto": "NFS", "share_network_id": null, "size": 1, "is_public": false } }
{ "share": { "share_type": null, "name": "test", "snapshot_id": null, "description": "test description", "metadata": { "enterprise_project_id": "9130c90d-73b8-4203-b790-d49f98d503df" }, "share_proto": "NFS", "share_network_id": null, "size": 1, "is_public": false } }
参数 |
参数类型 |
描述 |
---|---|---|
share |
Object |
详细参数说明请参见share字段说明 |
参数 |
参数类型 |
描述 |
---|---|---|
links |
array |
共享链接。 |
availability_zone |
string |
可用区AZ(availability zone)。 |
share_server_id |
string |
共享服务管理的UUID |
share_network_id |
string |
共享网络的UUID,当前不支持共享网络管理,该字段无意义。 |
snapshot_id |
string |
创建共享的源快照的UUID,当前不支持快照,该字段当前无意义。 |
snapshot_support |
boolean |
是否支持快照,当前不支持快照,该字段当前无意义。(API 微版本2.2以后支持)。 |
id |
string |
共享的UUID。 |
size |
integer |
共享容量,单位GB。 |
consistency_group_id |
string |
一致性组的UUID,当前不支持一致性组,该字段当前无意义。(API 微版本2.31到2.42支持) |
project_id |
string |
创建共享的项目的UUID。 |
metadata |
object |
一到多个字典形式组织的键值对。其中share_used作为key,对应的value表示共享已经使用的容量,单位是Bytes;enterprise_project_id作为key,对应的value是共享所属的企业项目ID。 |
status |
string |
共享的状态。 |
task_state |
string |
数据迁移状态,当前不支持数据迁移,该字段无意义。(API 微版本2.5以后支持) |
has_replicas |
boolean |
是否有复制,当前不支持复制,该字段无意义。(API 微版本2.11到2.42支持)。 |
replication_type |
string |
复制类型,当前不支持复制,该字段无意义。(API 微版本2.11到2.42支持)。 |
description |
string |
共享描述。 |
host |
string |
共享主机名。 |
name |
string |
共享名称。 |
created_at |
string |
共享创建的时间标签。 |
share_proto |
string |
文件系统的共享协议。 |
share_type_name |
string |
共享类型的名称,共享类型用于指定分配哪些类型的存储服务,例如高性能类型(由SSD磁盘组成)、大容量类型(由SATA盘组成)。(API 微版本2.6以后支持)。 |
share_type |
string |
共享类型的UUID。 |
volume_type |
string |
卷类型,,与share_type含义相同。 |
export_locations |
array |
共享挂载路径信息列表,当前只支持有一个共享。当请求消息头指定的X-Openstack-Manila-Api-Version的值低于2.9,该字段存在,若为2.9到2.42之间,该消息不存在。 |
export_location |
string |
共享挂载路径,当请求消息头指定的X-Openstack-Manila-Api-Version的值低于2.9,该字段存在,若为2.9到2.42之间,该消息不存在。 |
is_public |
bool |
共享的可见程度。设置为true时公共可见,设置为false时私有个人可见,默认值为false。 |
{ "share": { "status": "creating", "project_id": "16e1ab15c35a457e9c2b2aa189f544e1", "name": "share_London", "share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7", "availability_zone": "az1.dc1", "created_at": "2015-09-18T10:25:24.533287", "export_location": null, "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" } ], "share_network_id": null, "export_locations": [], "share_proto": "NFS", "host": null, "volume_type": "default", "snapshot_id": null, "is_public": true, "metadata": { "project": "my_app", "aim": "doc" }, "id": "011d21e2-fbc3-4e4a-9993-9ea223f73264", "size": 1, "description": "My custom share London" } }
客户端收到系统响应时,共享创建任务还未结束,因此,共享路径不能马上查询到,当创建任务完成后,用户可以通过共享路径信息查询接口查询出来。
状态码 |
说明 |
---|---|
400 Bad Request |
服务器未能处理请求。 |
401 Unauthorized |
被请求的页面需要用户名和密码。 |
403 Forbidden |
对被请求页面的访问被禁止。 |
404 Not Found |
服务器无法找到被请求的页面。 |
405 Method Not Allowed |
请求中指定的方法不被允许。 |
406 Not Acceptable |
服务器生成的响应无法被客户端所接受。 |
407 Proxy Authentication Required |
用户必须首先使用代理服务器进行验证,这样请求才会被处理。 |
408 Request Timeout |
请求超出了服务器的等待时间。 |
409 Conflict |
由于冲突,请求无法被完成。 |
500 Internal Server Error |
请求未完成。服务异常。 |
501 Not Implemented |
请求未完成。服务器不支持所请求的功能。 |
502 Bad Gateway |
请求未完成。服务器从上游服务器收到一个无效的响应。 |
503 Service Unavailable |
请求未完成。系统暂时异常。 |
504 Gateway Timeout |
网关超时。 |
域名 和空间怎么购买?域名和空间购买,首先是选择一家提供域名空间的服务商,在...
每年Web开发趋势都会发生变化,从而为企业所有者和Web开发人员指明新的方向。渐...
本文介绍了如何通过ECS管理控制台购买一个存储容量单位包SCU。 前提条件 创建SCU...
操作场景 通过设置云耀云服务器告警规则,用户可自定义监控目标与通知策略,及时...
二手 域名 在哪里买?二手域名的购买途径并不唯一,在买二手域名之前,可以查看...
本文转载自微信公众号「接地气学堂」,作者接地气的陈老师。转载本文请联系接地...
1.背景介绍 PV/UV统计是流式分析一个常见的场景。通过PV可以对访问的网站做流量...
好消息 从Hologres V0.10.25版本开始 Hologres的默认连接数增加一倍啦 这就意味...
数据分析,包括大数据分析,在企业的业务中,特别是在传统的商务行业,已有多年...
本文转载自公众号读芯术(ID:AI_Discovery) 拿破仑有句名言:战争需要三样东西钱...