Class GetACLRequest

Namespace

Amazon.S3.Model

Assembly

AWSSDK.S3.dll

Container for the parameters to the GetACL operation. This implementation of the

GET

action uses the

acl

subresource to return the access control list (ACL) of a bucket. To use

GET

to return the ACL of the bucket, you must have

READ_ACP

access to the bucket. If

READ_ACP

permission is granted to the anonymous user, you can return

the ACL of the bucket without using an authorization header.

note

If your bucket uses the bucket owner enforced setting for S3 Object Ownership, requests to read ACLs are still supported and return the

bucket-owner-full-control

ACL with the owner being the account that created the bucket. For more information, see Controlling object ownership and disabling ACLs in the Amazon S3 User Guide.

Related Resources

• ListObjects

public class GetACLRequest : AmazonWebServiceRequest

Inheritance

object

GetACLRequest

Constructors

GetACLRequest()

public GetACLRequest()

Properties

BucketName

The bucket name that contains the object for which to get the ACL information.

When using this API with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this operation with an access point through the AWS SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using Access Points in the Amazon Simple Storage Service Developer Guide.

public string BucketName { get; set; }

Property Value

string

ExpectedBucketOwner

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

public string ExpectedBucketOwner { get; set; }

Property Value

string

Key

The key of the S3 object to be queried.

public string Key { get; set; }

Property Value

string

Remarks

This property will be used as part of the resource path of the HTTP request. In .NET the System.Uri class is used to construct the uri for the request. The System.Uri class will canonicalize the uri string by compacting characters like "..". /// For example an object key of "foo/../bar/file.txt" will be transformed into "bar/file.txt" because the ".." is interpreted as use parent directory. For further information view the documentation for the Uri class: https://docs.microsoft.com/en-us/dotnet/api/system.uri

VersionId

VersionId used to reference a specific version of the object.

public string VersionId { get; set; }

Property Value

string