Amazonka.S3.GetBucketWebsite

Returns the website configuration for a bucket. To host website on Amazon S3, you can configure a bucket as website by adding a website configuration. For more information about hosting websites, see Hosting Websites on Amazon S3.

This GET action requires the S3:GetBucketWebsite permission. By default, only the bucket owner can read the bucket website configuration. However, bucket owners can allow other users to read the website configuration by writing a bucket policy granting them the S3:GetBucketWebsite permission.

The following operations are related to DeleteBucketWebsite:

• DeleteBucketWebsite
• PutBucketWebsite

Creating a Request

data GetBucketWebsite

See: newGetBucketWebsite smart constructor.

Constructors

GetBucketWebsite'

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 website configuration.

Instances

ToHeaders GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

toHeaders :: GetBucketWebsite -> [Header]

ToPath GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

toPath :: GetBucketWebsite -> ByteString

ToQuery GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

toQuery :: GetBucketWebsite -> QueryString

AWSRequest GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Associated Types

type AWSResponse GetBucketWebsite

Methods

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

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

Generic GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Associated Types

type Rep GetBucketWebsite :: Type -> Type

Methods

from :: GetBucketWebsite -> Rep GetBucketWebsite x

to :: Rep GetBucketWebsite x -> GetBucketWebsite

Read GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

readsPrec :: Int -> ReadS GetBucketWebsite

readList :: ReadS [GetBucketWebsite]

readPrec :: ReadPrec GetBucketWebsite

readListPrec :: ReadPrec [GetBucketWebsite]

Show GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

showsPrec :: Int -> GetBucketWebsite -> ShowS

show :: GetBucketWebsite -> String

showList :: [GetBucketWebsite] -> ShowS

NFData GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

rnf :: GetBucketWebsite -> ()

Eq GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

(==) :: GetBucketWebsite -> GetBucketWebsite -> Bool

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

Hashable GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

Methods

hashWithSalt :: Int -> GetBucketWebsite -> Int

hash :: GetBucketWebsite -> Int

type AWSResponse GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

type AWSResponse GetBucketWebsite = GetBucketWebsiteResponse

type Rep GetBucketWebsite

Defined in Amazonka.S3.GetBucketWebsite

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

newGetBucketWebsite

Arguments

:: BucketName

GetBucketWebsite

-> GetBucketWebsite

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

GetBucketWebsite, getBucketWebsite_bucket - The bucket name for which to get the website configuration.

Request Lenses

getBucketWebsite_expectedBucketOwner :: Lens' GetBucketWebsite (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).

getBucketWebsite_bucket :: Lens' GetBucketWebsite BucketName

The bucket name for which to get the website configuration.

Destructuring the Response

data GetBucketWebsiteResponse

See: newGetBucketWebsiteResponse smart constructor.

Constructors

GetBucketWebsiteResponse'

Fields

• errorDocument :: Maybe ErrorDocument

  The object key name of the website error document to use for 4XX class errors.

• indexDocument :: Maybe IndexDocument

  The name of the index document for the website (for example index.html).

• redirectAllRequestsTo :: Maybe RedirectAllRequestsTo

  Specifies the redirect behavior of all requests to a website endpoint of an Amazon S3 bucket.

• routingRules :: Maybe [RoutingRule]

  Rules that define when a redirect is applied and the redirect behavior.

• httpStatus :: Int

  The response's http status code.

Instances

Generic GetBucketWebsiteResponse

Defined in Amazonka.S3.GetBucketWebsite

Associated Types

type Rep GetBucketWebsiteResponse :: Type -> Type

Methods

from :: GetBucketWebsiteResponse -> Rep GetBucketWebsiteResponse x

to :: Rep GetBucketWebsiteResponse x -> GetBucketWebsiteResponse

Read GetBucketWebsiteResponse

Defined in Amazonka.S3.GetBucketWebsite

Methods

readsPrec :: Int -> ReadS GetBucketWebsiteResponse

readList :: ReadS [GetBucketWebsiteResponse]

readPrec :: ReadPrec GetBucketWebsiteResponse

readListPrec :: ReadPrec [GetBucketWebsiteResponse]

Show GetBucketWebsiteResponse

Defined in Amazonka.S3.GetBucketWebsite

Methods

showsPrec :: Int -> GetBucketWebsiteResponse -> ShowS

show :: GetBucketWebsiteResponse -> String

showList :: [GetBucketWebsiteResponse] -> ShowS

NFData GetBucketWebsiteResponse

Defined in Amazonka.S3.GetBucketWebsite

Methods

rnf :: GetBucketWebsiteResponse -> ()

Eq GetBucketWebsiteResponse

Defined in Amazonka.S3.GetBucketWebsite

Methods

(==) :: GetBucketWebsiteResponse -> GetBucketWebsiteResponse -> Bool

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

type Rep GetBucketWebsiteResponse

Defined in Amazonka.S3.GetBucketWebsite

type Rep GetBucketWebsiteResponse = D1 ('MetaData "GetBucketWebsiteResponse" "Amazonka.S3.GetBucketWebsite" "amazonka-s3-2.0-CNZtv1UmVzj28JXsFvwNoj" 'False) (C1 ('MetaCons "GetBucketWebsiteResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "errorDocument") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ErrorDocument)) :*: S1 ('MetaSel ('Just "indexDocument") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe IndexDocument))) :*: (S1 ('MetaSel ('Just "redirectAllRequestsTo") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RedirectAllRequestsTo)) :*: (S1 ('MetaSel ('Just "routingRules") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [RoutingRule])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))))

newGetBucketWebsiteResponse

Arguments

:: Int

$sel:httpStatus:GetBucketWebsiteResponse'

-> GetBucketWebsiteResponse

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

GetBucketWebsiteResponse, getBucketWebsiteResponse_errorDocument - The object key name of the website error document to use for 4XX class errors.

GetBucketWebsiteResponse, getBucketWebsiteResponse_indexDocument - The name of the index document for the website (for example index.html).

GetBucketWebsiteResponse, getBucketWebsiteResponse_redirectAllRequestsTo - Specifies the redirect behavior of all requests to a website endpoint of an Amazon S3 bucket.

GetBucketWebsiteResponse, getBucketWebsiteResponse_routingRules - Rules that define when a redirect is applied and the redirect behavior.

$sel:httpStatus:GetBucketWebsiteResponse', getBucketWebsiteResponse_httpStatus - The response's http status code.

Response Lenses

getBucketWebsiteResponse_errorDocument :: Lens' GetBucketWebsiteResponse (Maybe ErrorDocument)

The object key name of the website error document to use for 4XX class errors.

getBucketWebsiteResponse_indexDocument :: Lens' GetBucketWebsiteResponse (Maybe IndexDocument)

The name of the index document for the website (for example index.html).

getBucketWebsiteResponse_redirectAllRequestsTo :: Lens' GetBucketWebsiteResponse (Maybe RedirectAllRequestsTo)

Specifies the redirect behavior of all requests to a website endpoint of an Amazon S3 bucket.

getBucketWebsiteResponse_routingRules :: Lens' GetBucketWebsiteResponse (Maybe [RoutingRule])

Rules that define when a redirect is applied and the redirect behavior.

getBucketWebsiteResponse_httpStatus :: Lens' GetBucketWebsiteResponse Int

The response's http status code.