添加共享访问规则allowAccess_共享访问规则

华为云计算云知识添加共享访问规则allowAccess

新客秒杀 2核2G 2M L实例

38元/年

普惠上云领千元上云礼券

立即前往

企业专享 X实例 4核8G 5M

888元/年

热门域名 1元随心购

1元/年起

添加共享访问规则allowAccess

时间: 2023-08-29 11:40:35

API网关云服务器云主机云计算弹性伸缩

猜你想看：

实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

接口说明

共享规则添加。

约束说明

 该接口为异步接口,返回为200只是表示接口下发接收成功,后续可以通过"查询共享访问规则接口",判断添加共享访问规则是否完成以及是否成功。  API的microversions从2.28到2.42以后版本,支持添加共享访问规则时忽略已存在的访问规则的错误状态。API的microversions通过请求头的X-Openstack-Manila-Api-Version参数指定。

URL

POST https://sfs.cn-south-2.myhuaweicloud.com/v2/{project_id}/shares/{share_id}/action

请求参数

名称	类型	IN	必选	描述
X-Auth-Token	string	header	是	用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
X-Openstack-Manila-Api-Version	float	header	否	指定微版本号。
project_id	string	path	是	操作用户的项目ID。
share_id	string	path	是	共享的UUID。
vpc_ip_base_acl	string	query	否	IP地址授权场景的标识符,当前可用值只有enable。值为enable时,表示创建IP地址授权场景的共享访问规则。须知为了兼容性,当不设置该参数,或者设置了该参数但是值不为enable时,仍然可以使用接口创建IP地址授权场景的共享访问规则,但是,这种方式已废弃,且后续不再维护

Body参数

名称	类型	必选	描述
allow_access	os-allow_access object	否

参数：

allow_access

名称	类型	必选	描述
access_level	string	否	共享访问的权限级别,取值为ro(只读),rw(读写)。默认为rw(读写)。
access_to	string	是	定义访问规则的值,长度为1~255。根据场景取值: 按照VPC授权的场景,填写VPCID。按照IP地址授权的场景进行填写: − 如果是NFS共享, 填写格式为“VPCID#IP#优先级#用户权限”,其中VPCID、IP、优先级和用户权限字段之间使用“#”分隔,例如“0157b53f-4974-4e80-91c9-098532bcaf00#2.2.2.2/16#100#all_squash,root_squash”。 − 如果是CIFS共享,填写格式为“VPCID#IP#优先级”。例如“0157b53f-4974-4e80-91c9-098532bcaf00#2.2.2.2/16#0”。
access_type	string	是	共享访问规则的类型,NFS、CIFS共享。

名称

类型

必选

描述

access_level

string

否

共享访问的权限级别,取值为ro(只读),rw(读写)。默认为rw(读写)。

access_to

string

是

定义访问规则的值,长度为1~255。根据场景取值:

按照VPC授权的场景,填写VPCID。
按照IP地址授权的场景进行填写: − 如果是NFS共享, 填写格式为“VPCID#IP#优先级#用户权限”,其中VPCID、IP、优先级和用户权限字段之间使用“#”分隔,例如“0157b53f-4974-4e80-91c9-098532bcaf00#2.2.2.2/16#100#all_squash,root_squash”。 − 如果是CIFS共享,填写格式为“VPCID#IP#优先级”。例如“0157b53f-4974-4e80-91c9-098532bcaf00#2.2.2.2/16#0”。

access_type

string

是

共享访问规则的类型,NFS、CIFS共享。

返回参数

返回码: 202

Accepted

名称	类型	必选	描述
access	access object	是	access对象,如果共享访问规则未更新,这个值为null。

202 access

名称	类型	必选	描述
access_key	string	否	访问规则的访问凭据。请求消息头指定的X-Openstack-Manila-Api-Version的值大于等于2.21到2.42时,该字段才存在。
access_level	string	是	共享访问规则级别。
access_to	string	是	后端允许或拒绝访问的对象。
access_type	string	是	共享访问规则类型。
created_at	string	否	共享访问规则的创建时间。请求消息头指定的X-Openstack-Manila-Api-Version的值大于等于2.33时,该字段才存在。
id	string	是	共享访问规则的UUID。
share_id	string	是	添加访问规则共享的UUID。
state	string	是	共享访问规则的状态。API版本在2.28之前,共享访问规则的状态为new, active,或者error;在2.28到到2.42之后的版本,共享访问规则的状态为queued_to_apply,applying, active, error, queued_to_deny或者 denying。
updated_at	string	否	共享访问规则的更新时间。请求消息头指定的X-Openstack-Manila-Api-Version的值大于等于2.33时,该字段才存在。

请求示例

示例 1

NFS共享添加访问规则

"POST /v2/{project_id}/shares/{share_id}/action?vpc_ip_base_acl=enable"

{ "allow_access": { "access_level": "rw", "access_to": "0560a527-0e77-40a6-aa3b-110bee cad 368#0.0.0.0/0#1#all_squash,root_squash", "access_type": "cert" } }

示例 2

CIFS共享添加访问规则

"POST /v2/{project_id}/shares/{share_id}/action?vpc_ip_base_acl=enable"

{ "allow_access": { "access_level": "rw", "access_to": "0560a527-0e77-40a6-aa3b-110beecad368#0.0.0.0/0#0", "access_type": "cert" } }

返回示例

返回码：202

Accepted

示例 1

{
"access": {
"access_key": null,
"access_level": "rw",
"access_to": "0560a527-0e77-40a6-aa3b-110beecad368#0.0.0.0/0#1#all_squash,root_squash",
"access_type": "cert",
"created_at": "2017-07-07T03:15:06.858662",
"id": "24615391-d58d-4a74-ac5a-520233c9c396",
"share_id": "7ec1115f-518b-40ff-a998-5599ce2da332",
"state": "queued_to_apply",
"updated_at": "2018-07-07T03:15:06.858662"
}
}

错误码

请参考错误码说明。