Amazonka.S3.GetBucketTagging

Returns the tag set associated with the bucket.

To use this operation, you must have permission to perform the s3:GetBucketTagging action. By default, the bucket owner has this permission and can grant this permission to others.

GetBucketTagging has the following special error:

• Error code: NoSuchTagSet

  • Description: There is no tag set associated with the bucket.

The following operations are related to GetBucketTagging:

• PutBucketTagging
• DeleteBucketTagging

Creating a Request

data GetBucketTagging

See: newGetBucketTagging smart constructor.

Constructors

GetBucketTagging'

Fields

• expectedBucketOwner :: Maybe Text

  The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

• bucket :: BucketName

  The name of the bucket for which to get the tagging information.

Instances

ToHeaders GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

toHeaders :: GetBucketTagging -> [Header]

ToPath GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

toPath :: GetBucketTagging -> ByteString

ToQuery GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

toQuery :: GetBucketTagging -> QueryString

AWSRequest GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Associated Types

type AWSResponse GetBucketTagging

Methods

request :: (Service -> Service) -> GetBucketTagging -> Request GetBucketTagging

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy GetBucketTagging -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse GetBucketTagging)))

Generic GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Associated Types

type Rep GetBucketTagging :: Type -> Type

Methods

from :: GetBucketTagging -> Rep GetBucketTagging x

to :: Rep GetBucketTagging x -> GetBucketTagging

Read GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

readsPrec :: Int -> ReadS GetBucketTagging

readList :: ReadS [GetBucketTagging]

readPrec :: ReadPrec GetBucketTagging

readListPrec :: ReadPrec [GetBucketTagging]

Show GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

showsPrec :: Int -> GetBucketTagging -> ShowS

show :: GetBucketTagging -> String

showList :: [GetBucketTagging] -> ShowS

NFData GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

rnf :: GetBucketTagging -> ()

Eq GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

(==) :: GetBucketTagging -> GetBucketTagging -> Bool

(/=) :: GetBucketTagging -> GetBucketTagging -> Bool

Hashable GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

Methods

hashWithSalt :: Int -> GetBucketTagging -> Int

hash :: GetBucketTagging -> Int

type AWSResponse GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

type AWSResponse GetBucketTagging = GetBucketTaggingResponse

type Rep GetBucketTagging

Defined in Amazonka.S3.GetBucketTagging

type Rep GetBucketTagging = D1 ('MetaData "GetBucketTagging" "Amazonka.S3.GetBucketTagging" "amazonka-s3-2.0-CNZtv1UmVzj28JXsFvwNoj" 'False) (C1 ('MetaCons "GetBucketTagging'" 'PrefixI 'True) (S1 ('MetaSel ('Just "expectedBucketOwner") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "bucket") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 BucketName)))

newGetBucketTagging

Arguments

:: BucketName

GetBucketTagging

-> GetBucketTagging

Create a value of GetBucketTagging 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:GetBucketTagging', getBucketTagging_expectedBucketOwner - The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

GetBucketTagging, getBucketTagging_bucket - The name of the bucket for which to get the tagging information.

Request Lenses

getBucketTagging_expectedBucketOwner :: Lens' GetBucketTagging (Maybe Text)

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code 403 Forbidden (access denied).

getBucketTagging_bucket :: Lens' GetBucketTagging BucketName

The name of the bucket for which to get the tagging information.

Destructuring the Response

data GetBucketTaggingResponse

See: newGetBucketTaggingResponse smart constructor.

Constructors

GetBucketTaggingResponse'

Fields

• httpStatus :: Int

  The response's http status code.

• tagSet :: [Tag]

  Contains the tag set.

Instances

Generic GetBucketTaggingResponse

Defined in Amazonka.S3.GetBucketTagging

Associated Types

type Rep GetBucketTaggingResponse :: Type -> Type

Methods

from :: GetBucketTaggingResponse -> Rep GetBucketTaggingResponse x

to :: Rep GetBucketTaggingResponse x -> GetBucketTaggingResponse

Read GetBucketTaggingResponse

Defined in Amazonka.S3.GetBucketTagging

Methods

readsPrec :: Int -> ReadS GetBucketTaggingResponse

readList :: ReadS [GetBucketTaggingResponse]

readPrec :: ReadPrec GetBucketTaggingResponse

readListPrec :: ReadPrec [GetBucketTaggingResponse]

Show GetBucketTaggingResponse

Defined in Amazonka.S3.GetBucketTagging

Methods

showsPrec :: Int -> GetBucketTaggingResponse -> ShowS

show :: GetBucketTaggingResponse -> String

showList :: [GetBucketTaggingResponse] -> ShowS

NFData GetBucketTaggingResponse

Defined in Amazonka.S3.GetBucketTagging

Methods

rnf :: GetBucketTaggingResponse -> ()

Eq GetBucketTaggingResponse

Defined in Amazonka.S3.GetBucketTagging

Methods

(==) :: GetBucketTaggingResponse -> GetBucketTaggingResponse -> Bool

(/=) :: GetBucketTaggingResponse -> GetBucketTaggingResponse -> Bool

type Rep GetBucketTaggingResponse

Defined in Amazonka.S3.GetBucketTagging

type Rep GetBucketTaggingResponse = D1 ('MetaData "GetBucketTaggingResponse" "Amazonka.S3.GetBucketTagging" "amazonka-s3-2.0-CNZtv1UmVzj28JXsFvwNoj" 'False) (C1 ('MetaCons "GetBucketTaggingResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "tagSet") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Tag])))

newGetBucketTaggingResponse

Arguments

:: Int

$sel:httpStatus:GetBucketTaggingResponse'

-> GetBucketTaggingResponse

Create a value of GetBucketTaggingResponse 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:httpStatus:GetBucketTaggingResponse', getBucketTaggingResponse_httpStatus - The response's http status code.

GetBucketTaggingResponse, getBucketTaggingResponse_tagSet - Contains the tag set.

Response Lenses

getBucketTaggingResponse_httpStatus :: Lens' GetBucketTaggingResponse Int

The response's http status code.

getBucketTaggingResponse_tagSet :: Lens' GetBucketTaggingResponse [Tag]

Contains the tag set.