本文介绍如何管理文件访问权限。
文件的访问权限(ACL)有以下四种:
访问权限 | 描述 | 访问权限值 |
---|---|---|
继承Bucket | 文件遵循存储空间的访问权限。 | CannedAccessControlList.Default |
私有 | 文件的拥有者和授权用户有该文件的读写权限,其他用户没有权限操作该文件。 | CannedAccessControlList.Private |
公共读 | 文件的拥有者和授权用户有该文件的读写权限,其他用户只有文件的读权限。请谨慎使用该权限。 | CannedAccessControlList.PublicRead |
公共读写 | 所有用户都有该文件的读写权限。请谨慎使用该权限。 | CannedAccessControlList.PublicReadWrite |
文件的访问权限优先级高于存储空间的访问权限。例如存储空间的访问权限是私有,而文件的访问权限是公共读写,则所有用户都有该文件的读写权限。如果某个文件没有设置过访问权限,则遵循存储空间的访问权限。
设置文件访问权限的完整代码请参见GitHub。 获取文件访问权限的完整代码请参见GitHub。
以下是设置并获取文件访问权限的完整代码:
using Aliyun.OSS; using Aliyun.OSS.Common; var endpoint = "<yourEndpoint>"; var accessKeyId = "<yourAccessKeyId>"; var accessKeySecret = "<yourAccessKeySecret>"; var bucketName = "<yourBucketName>"; var objectName = "<yourObjectName>"; // 创建OssClient实例。 var client = new OssClient(endpoint, accessKeyId, accessKeySecret); // 设置文件权限。 try { // 通过SetObjectAcl设置文件权限。 client.SetObjectAcl(bucketName, objectName, CannedAccessControlList.PublicRead); Console.WriteLine("Set Object:{0} ACL succeeded ", objectName); } catch (Exception ex) { Console.WriteLine("Set Object ACL failed with error info: {0}", ex.Message); } // 获取文件权限。 try { // 通过GetObjectAcl获取文件权限。 var result = client.GetObjectAcl(bucketName, objectName); Console.WriteLine("Get Object ACL succeeded, Id: {0} ACL: {1}", result.Owner.Id, result.ACL.ToString()); } catch (OssException ex) { Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID: {2}\tHostID: {3}", ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId); } catch (Exception ex) { Console.WriteLine("Failed with error info: {0}", ex.Message); }
文件权限的详细说明请参见权限控制。