文档首页/弹性文件服务 SFS/API参考/API说明/访问规则管理/设置通用文件系统ACL - PutACL
更新时间：2025-12-17 GMT+08:00
查看PDF
分享

设置通用文件系统ACL - PutACL

功能介绍

设置通用文件系统ACL。

通用文件系统ACL设置生效会有30s的滞后时间。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /

表1 Query参数

参数

是否必选

参数类型

描述

sfsacl

是

String

/

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Date

是

String

请求消息时间

Authorization

是

String

请求签名信息

Host

是

String

表明主机地址。

表3 请求Body参数

参数

是否必选

参数类型

描述

Statement

否

Array of Statement objects

Unique identification

表4 Statement

参数

是否必选

参数类型

描述

Sid

否

String

statement Id，描述statement的字符串

Action

是

String

本条statement作用的操作，取值范围：FullControl（读写）、Read（只读）。

枚举值：

  • FullControl
  • Read

Effect

是

String

效果，指定本条statement的权限是允许，必须为Allow。

枚举值：

  • Allow

Condition

是

Condition object

本条statement生效的条件。

表5 Condition

参数

是否必选

参数类型

描述

SourceVpc

是

String

指定VPC的VPCid。

VpcSourceIp

否

Array of strings

指定的IP或IP范围（暂不支持该参数）。

响应参数

该请求的响应消息使用公共消息头，具体请参考 表1。

请求示例

设置通用文件系统ACL，授予读写权限，VPC ID为“241dbf6b-dc5d-41b2-9108-ca5e56b48386”，IP范围为["127.0.0.1/24", "192.168.1.85/24"]。

PUT /?sfsacl HTTP/1.1
Host: examplefilesystem.sfs3.example.region.com
Date: WED, 01 Jul 2015 02:32:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA=

{
	"Statement": [{
		"Sid": "Stmt1375240018061",
		"Action": "FullControl",
		"Effect": "Allow",
		"Condition": {
			"SourceVpc": "241dbf6b-dc5d-41b2-9108-ca5e56b48386",
			"VpcSourceIp": ["127.0.0.1/24", "192.168.1.85/24"]
		}
	}]
}

响应示例

HTTP/1.1 204 OK
Server: OBS
X-Obs-Request-Id: 0000018893B8073AC04721AA7EE3408B
X-Obs-Id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCS5QDe0QLbFNz6FXoKuXHzD2wS0eJQaj
Date: Wed, 07 Jun 2023 02:38:11 GMT

状态码

状态码

描述

204

设置通用文件系统ACL成功

错误码

请参见错误码。

父主题：访问规则管理