检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 弹性文件服务所提供的接口分为SFS容量型接口、SFS Turbo接口、通用文件系统接口与OpenStack原生接口。 通过配合使用弹性文件服务所提供的接口和OpenStack原生接口,您可以完整的使用弹性文件服务的所有功能。 SFS容量型接口调用频率限制为:400次/
查询API版本 查询所有API版本 查询API版本的详细信息 父主题: SFS容量型API说明
查询API版本的详细信息 功能介绍 查询API版本的详细信息。 URI GET /{api_version}/ 参数说明 参数 是否必选 参数类型 描述 api_version 是 String API版本号。值为v1或v2。 请求消息头 该操作消息头与普通请求一样,请参见表3。
通用文件系统API说明 文件共享 共享访问规则 标签
查询所有API版本 功能介绍 查询SFS当前所有可用版本。 为了支持功能不断扩展,SFS API支持版本号区分。弹性文件服务有两种形式的版本号: 主版本号:具有独立的url,例如v1和v2 微版本号:通过Http请求头“X-Openstack-Manila-Api-Version
请参考对应API接口的异常返回值。 根据返回的文件系统id查询SFS Turbo文件系统详情,具体操作请参考查询文件系统详细信息。 查询文件系统详情返回状态status为“200”,则表示创建SFS Turbo文件系统成功。请求异常的返回值说明请参考对应API接口的异常返回值。其他的状态请参考SFS
如何调用SFS容量型/SFS Turbo API 构造请求 认证鉴权 返回结果
SFS容量型API说明 查询API版本 文件共享 共享访问规则 配额管理 扩容缩容 共享标签 可用区
如何调用通用文件系统API 构造请求 认证鉴权 返回结果
SFS Turbo API说明 生命周期管理 连接管理 共享标签 名称管理 文件系统管理 存储联动管理 目录管理 权限管理 任务管理
状态码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content DELETE操作正常返回。
} ] } 状态码 正常 状态码 描述 200 查询资源标签成功。 异常 状态码 描述 400 标签等参数非法 401 认证失败 403 鉴权失败 404 资源未找到 500 系统异常 父主题: 标签
调用删除共享标签接口删除标签时,如果标签的键中存在不被URL直接解析的特殊字符,需要对标签的键进行URL转义处理。 请求消息头 该操作消息头与普通请求一样,请参见表3。 请求消息 参数说明 无 请求样例 无 响应消息 参数说明 无 响应样例 无 状态码 正常 204 异常 状态码 说明
删除共享访问规则 功能介绍 共享规则删除。 该接口为异步接口,返回为202只是表示接口下发接收成功,后续可以通过查询共享访问规则接口,判断删除共享访问规则是否完成以及是否成功 URI POST /v2/{project_id}/shares/{share_id}/action 参数说明
功能介绍 列出可用区。 请参考查询API版本完成API版本查询后,如果version的值小于等于2.6,则添加请求头“X-Openstack-Manila-Api-Version: 微版本号”,例如:“X-Openstack-Manila-Api-Version: 2.4”。 URI
Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway
扩容共享 功能介绍 扩容共享。 该接口为异步接口,返回为202只是表示接口下发接收成功,后续可以通过查询共享详细信息接口判断扩容共享是否完成以及是否成功 URI POST /v2/{project_id}/shares/{share_id}/action 参数说明 参数 是否必选
删除共享 功能介绍 删除共享。 该接口为异步接口,返回为202只是表示接口下发接收成功,后续可以通过查询共享详细信息查询共享,判断删除共享是否完成以及是否成功。 URI DELETE /v2/{project_id}/shares/{share_id} 参数说明 参数 是否必选 参数类型
添加共享标签 功能介绍 指定共享添加一个标签。 一个共享上最多有10个标签。 一个共享上的多个标签的key不允许重复。 此接口为幂等接口:如果要添加的key在共享上已存在,则覆盖更新标签。 URI POST /v2/{project_id}/sfs/{share_id}/tags
缩容共享 功能介绍 缩容共享。 该接口为异步接口,返回为202只是表示接口下发接收成功,后续可以通过查询共享详细信息接口,判断缩容共享是否完成以及是否成功。 URI POST /v2/{project_id}/shares/{share_id}/action 参数说明 参数 是否必选