AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

A list of all ACL permissions. For more information, refer to http://docs.amazonwebservices.com/AmazonS3/latest/S3_ACLs.html#S3_ACLs_Permissions.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.ConstantClass
    Amazon.S3.S3Permission

Namespace: Amazon.S3
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z

Syntax

C#
public sealed class S3Permission : ConstantClass

The S3Permission type exposes the following members

Constructors

NameDescription
Public Method S3Permission(string)

Construct S3Permission.

Public Method S3Permission(string, string)

Construct instance of S3Permission. It is not intended for this constructor to be called. Instead users should call the FindValue.

Properties

NameTypeDescription
Public Property HeaderName System.String

Gets and sets the HeaderName property.

Public Property Value System.String Inherited from Amazon.Runtime.ConstantClass.

Methods

Note:

Asynchronous operations (methods ending with Async) in the table below are for .NET 4.5 or higher. For .NET 3.5 the SDK follows the standard naming convention of BeginMethodName and EndMethodName to indicate asynchronous operations - these method pairs are not shown in the table below.

NameDescription
Public Method Static Method FindValue(string)

Finds the constant for the unique value.

Fields

NameTypeDescription
Field Static Field FULL_CONTROL Amazon.S3.S3Permission

Provides READ, WRITE, READ_ACP, and WRITE_ACP permissions. It does not convey additional rights and is provided only for convenience.

Field Static Field READ Amazon.S3.S3Permission

When applied to a bucket, grants permission to list the bucket. When applied to an object, this grants permission to read the object data and/or metadata.

Field Static Field READ_ACP Amazon.S3.S3Permission

Grants permission to read the ACL for the applicable bucket or object. The owner of a bucket or object always has this permission implicitly.

Field Static Field RESTORE_OBJECT Amazon.S3.S3Permission

Gives permission to restore an object that is currently stored in Amazon Glacier for archival storage.

Field Static Field WRITE Amazon.S3.S3Permission

When applied to a bucket, grants permission to create, overwrite, and delete any object in the bucket. This permission is not supported for objects.

Field Static Field WRITE_ACP Amazon.S3.S3Permission

Gives permission to overwrite the ACP for the applicable bucket or object. The owner of a bucket or object always has this permission implicitly. Granting this permission is equivalent to granting FULL_CONTROL because the grant recipient can make any changes to the ACP.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer, 3.5