Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.S3.GetBucketCors

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Returns the Cross-Origin Resource Sharing (CORS) configuration information set for the bucket.

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

For more information about CORS, see Enabling Cross-Origin Resource Sharing.

The following operations are related to GetBucketCors:

Creating a Request

data GetBucketCors Source #

See: newGetBucketCors smart constructor.

Constructors

GetBucketCors'
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 bucket name for which to get the cors configuration.

Instances

Instances details

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

newGetBucketCors Source #

Arguments

:: BucketName	`GetBucketCors`
-> GetBucketCors

Create a value of GetBucketCors 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:GetBucketCors', getBucketCors_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).

GetBucketCors, getBucketCors_bucket - The bucket name for which to get the cors configuration.

Request Lenses

getBucketCors_expectedBucketOwner :: Lens' GetBucketCors (Maybe Text) Source #

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

getBucketCors_bucket :: Lens' GetBucketCors BucketName Source #

The bucket name for which to get the cors configuration.

Destructuring the Response

data GetBucketCorsResponse Source #

See: newGetBucketCorsResponse smart constructor.

Constructors

GetBucketCorsResponse'
Fields cORSRules :: Maybe [CORSRule] A set of origins and methods (cross-origin access that you want to allow). You can add up to 100 rules to the configuration. httpStatus :: Int The response's http status code.

Instances

Instances details

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

newGetBucketCorsResponse Source #

Arguments

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

Create a value of GetBucketCorsResponse 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:

GetBucketCorsResponse, getBucketCorsResponse_cORSRules - A set of origins and methods (cross-origin access that you want to allow). You can add up to 100 rules to the configuration.

$sel:httpStatus:GetBucketCorsResponse', getBucketCorsResponse_httpStatus - The response's http status code.

Response Lenses

getBucketCorsResponse_cORSRules :: Lens' GetBucketCorsResponse (Maybe [CORSRule]) Source #

A set of origins and methods (cross-origin access that you want to allow). You can add up to 100 rules to the configuration.

getBucketCorsResponse_httpStatus :: Lens' GetBucketCorsResponse Int Source #

The response's http status code.