Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.S3.GetBucketAcl

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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.

Related Resources

ListObjects

Creating a Request

data GetBucketAcl Source #

See: newGetBucketAcl smart constructor.

Constructors

GetBucketAcl'
Fields expectedBucketOwner :: Maybe Text 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. bucket :: BucketName Specifies the S3 bucket whose ACL is being requested.

Instances

Instances details

Eq GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods (==) :: GetBucketAcl -> GetBucketAcl -> Bool # (/=) :: GetBucketAcl -> GetBucketAcl -> Bool #
Read GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods readsPrec :: Int -> ReadS GetBucketAcl # readList :: ReadS [GetBucketAcl] # readPrec :: ReadPrec GetBucketAcl # readListPrec :: ReadPrec [GetBucketAcl] #
Show GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods showsPrec :: Int -> GetBucketAcl -> ShowS # show :: GetBucketAcl -> String # showList :: [GetBucketAcl] -> ShowS #
Generic GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Associated Types type Rep GetBucketAcl :: Type -> Type # Methods from :: GetBucketAcl -> Rep GetBucketAcl x # to :: Rep GetBucketAcl x -> GetBucketAcl #
NFData GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods rnf :: GetBucketAcl -> () #
Hashable GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods hashWithSalt :: Int -> GetBucketAcl -> Int # hash :: GetBucketAcl -> Int #
AWSRequest GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Associated Types type AWSResponse GetBucketAcl # Methods request :: GetBucketAcl -> Request GetBucketAcl # response :: MonadResource m => Logger -> Service -> Proxy GetBucketAcl -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse GetBucketAcl))) #
ToHeaders GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods toHeaders :: GetBucketAcl -> [Header] #
ToPath GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods toPath :: GetBucketAcl -> ByteString #
ToQuery GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods toQuery :: GetBucketAcl -> QueryString #
type Rep GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl type Rep GetBucketAcl = D1 ('MetaData "GetBucketAcl" "Amazonka.S3.GetBucketAcl" "libZSservicesZSamazonka-s3ZSamazonka-s3" 'False) (C1 ('MetaCons "GetBucketAcl'" 'PrefixI 'True) (S1 ('MetaSel ('Just "expectedBucketOwner") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "bucket") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 BucketName)))
type AWSResponse GetBucketAcl Source #
Instance details Defined in Amazonka.S3.GetBucketAcl type AWSResponse GetBucketAcl = GetBucketAclResponse

newGetBucketAcl Source #

Arguments

:: BucketName	`$sel:bucket:GetBucketAcl'`
-> GetBucketAcl

Create a value of GetBucketAcl with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:expectedBucketOwner:GetBucketAcl', getBucketAcl_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.

$sel:bucket:GetBucketAcl', getBucketAcl_bucket - Specifies the S3 bucket whose ACL is being requested.

Request Lenses

getBucketAcl_expectedBucketOwner :: Lens' GetBucketAcl (Maybe Text) Source #

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.

getBucketAcl_bucket :: Lens' GetBucketAcl BucketName Source #

Specifies the S3 bucket whose ACL is being requested.

Destructuring the Response

data GetBucketAclResponse Source #

See: newGetBucketAclResponse smart constructor.

Constructors

GetBucketAclResponse'
Fields grants :: Maybe [Grant] A list of grants. owner :: Maybe Owner Container for the bucket owner's display name and ID. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq GetBucketAclResponse Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods (==) :: GetBucketAclResponse -> GetBucketAclResponse -> Bool # (/=) :: GetBucketAclResponse -> GetBucketAclResponse -> Bool #
Read GetBucketAclResponse Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods readsPrec :: Int -> ReadS GetBucketAclResponse # readList :: ReadS [GetBucketAclResponse] # readPrec :: ReadPrec GetBucketAclResponse # readListPrec :: ReadPrec [GetBucketAclResponse] #
Show GetBucketAclResponse Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods showsPrec :: Int -> GetBucketAclResponse -> ShowS # show :: GetBucketAclResponse -> String # showList :: [GetBucketAclResponse] -> ShowS #
Generic GetBucketAclResponse Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Associated Types type Rep GetBucketAclResponse :: Type -> Type # Methods from :: GetBucketAclResponse -> Rep GetBucketAclResponse x # to :: Rep GetBucketAclResponse x -> GetBucketAclResponse #
NFData GetBucketAclResponse Source #
Instance details Defined in Amazonka.S3.GetBucketAcl Methods rnf :: GetBucketAclResponse -> () #
type Rep GetBucketAclResponse Source #
Instance details Defined in Amazonka.S3.GetBucketAcl type Rep GetBucketAclResponse = D1 ('MetaData "GetBucketAclResponse" "Amazonka.S3.GetBucketAcl" "libZSservicesZSamazonka-s3ZSamazonka-s3" 'False) (C1 ('MetaCons "GetBucketAclResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "grants") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Grant])) :: (S1 ('MetaSel ('Just "owner") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Owner)) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newGetBucketAclResponse Source #

Arguments

:: Int	`$sel:httpStatus:GetBucketAclResponse'`
-> GetBucketAclResponse

Create a value of GetBucketAclResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:grants:GetBucketAclResponse', getBucketAclResponse_grants - A list of grants.

$sel:owner:GetBucketAclResponse', getBucketAclResponse_owner - Container for the bucket owner's display name and ID.

$sel:httpStatus:GetBucketAclResponse', getBucketAclResponse_httpStatus - The response's http status code.

Response Lenses

getBucketAclResponse_grants :: Lens' GetBucketAclResponse (Maybe [Grant]) Source #

A list of grants.

getBucketAclResponse_owner :: Lens' GetBucketAclResponse (Maybe Owner) Source #

Container for the bucket owner's display name and ID.

getBucketAclResponse_httpStatus :: Lens' GetBucketAclResponse Int Source #

The response's http status code.