s3_get_bucket_website: Returns the website configuration for a bucket

Description Usage Arguments Value Request syntax Examples

View source: R/s3_operations.R

Description

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 operation 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 delete_bucket_website:

Usage

1
s3_get_bucket_website(Bucket, ExpectedBucketOwner)

Arguments

Bucket

[required] The bucket name for which to get the website configuration.

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.

Value

A list with the following syntax:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
list(
  RedirectAllRequestsTo = list(
    HostName = "string",
    Protocol = "http"|"https"
  ),
  IndexDocument = list(
    Suffix = "string"
  ),
  ErrorDocument = list(
    Key = "string"
  ),
  RoutingRules = list(
    list(
      Condition = list(
        HttpErrorCodeReturnedEquals = "string",
        KeyPrefixEquals = "string"
      ),
      Redirect = list(
        HostName = "string",
        HttpRedirectCode = "string",
        Protocol = "http"|"https",
        ReplaceKeyPrefixWith = "string",
        ReplaceKeyWith = "string"
      )
    )
  )
)

Request syntax

1
2
3
4
svc$get_bucket_website(
  Bucket = "string",
  ExpectedBucketOwner = "string"
)

Examples

1
2
3
4
5
6
7
## Not run: 
# The following example retrieves website configuration of a bucket.
svc$get_bucket_website(
  Bucket = "examplebucket"
)

## End(Not run)

paws.storage documentation built on Aug. 23, 2021, 1:06 a.m.