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.GetBucketOwnershipControls

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Retrieves OwnershipControls for an Amazon S3 bucket. To use this operation, you must have the s3:GetBucketOwnershipControls permission. For more information about Amazon S3 permissions, see Specifying Permissions in a Policy.

For information about Amazon S3 Object Ownership, see Using Object Ownership.

The following operations are related to GetBucketOwnershipControls:

PutBucketOwnershipControls
DeleteBucketOwnershipControls

Creating a Request

data GetBucketOwnershipControls Source #

See: newGetBucketOwnershipControls smart constructor.

Constructors

GetBucketOwnershipControls'
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 The name of the Amazon S3 bucket whose `OwnershipControls` you want to retrieve.

Instances

Instances details

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

newGetBucketOwnershipControls Source #

Arguments

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

Create a value of GetBucketOwnershipControls 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:GetBucketOwnershipControls', getBucketOwnershipControls_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:GetBucketOwnershipControls', getBucketOwnershipControls_bucket - The name of the Amazon S3 bucket whose OwnershipControls you want to retrieve.

Request Lenses

getBucketOwnershipControls_expectedBucketOwner :: Lens' GetBucketOwnershipControls (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.

getBucketOwnershipControls_bucket :: Lens' GetBucketOwnershipControls BucketName Source #

The name of the Amazon S3 bucket whose OwnershipControls you want to retrieve.

Destructuring the Response

data GetBucketOwnershipControlsResponse Source #

See: newGetBucketOwnershipControlsResponse smart constructor.

Constructors

GetBucketOwnershipControlsResponse'
Fields ownershipControls :: Maybe OwnershipControls The `OwnershipControls` (BucketOwnerPreferred or ObjectWriter) currently in effect for this Amazon S3 bucket. httpStatus :: Int The response's http status code.

Instances

Instances details

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

newGetBucketOwnershipControlsResponse Source #

Arguments

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

Create a value of GetBucketOwnershipControlsResponse 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:ownershipControls:GetBucketOwnershipControlsResponse', getBucketOwnershipControlsResponse_ownershipControls - The OwnershipControls (BucketOwnerPreferred or ObjectWriter) currently in effect for this Amazon S3 bucket.

$sel:httpStatus:GetBucketOwnershipControlsResponse', getBucketOwnershipControlsResponse_httpStatus - The response's http status code.

Response Lenses

getBucketOwnershipControlsResponse_ownershipControls :: Lens' GetBucketOwnershipControlsResponse (Maybe OwnershipControls) Source #

The OwnershipControls (BucketOwnerPreferred or ObjectWriter) currently in effect for this Amazon S3 bucket.

getBucketOwnershipControlsResponse_httpStatus :: Lens' GetBucketOwnershipControlsResponse Int Source #

The response's http status code.