Amazonka.S3.GetBucketReplication

Returns the replication configuration of a bucket.

It can take a while to propagate the put or delete a replication configuration to all Amazon S3 systems. Therefore, a get request soon after put or delete can return a wrong result.

For information about replication configuration, see Replication in the Amazon S3 User Guide.

This action requires permissions for the s3:GetReplicationConfiguration action. For more information about permissions, see Using Bucket Policies and User Policies.

If you include the Filter element in a replication configuration, you must also include the DeleteMarkerReplication and Priority elements. The response also returns those elements.

For information about GetBucketReplication errors, see List of replication-related error codes

The following operations are related to GetBucketReplication:

• PutBucketReplication
• DeleteBucketReplication

Creating a Request

data GetBucketReplication

See: newGetBucketReplication smart constructor.

Constructors

GetBucketReplication'

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 replication information.

Instances

ToHeaders GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

toHeaders :: GetBucketReplication -> [Header]

ToPath GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

toPath :: GetBucketReplication -> ByteString

ToQuery GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

toQuery :: GetBucketReplication -> QueryString

AWSRequest GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Associated Types

type AWSResponse GetBucketReplication

Methods

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

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

Generic GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Associated Types

type Rep GetBucketReplication :: Type -> Type

Methods

from :: GetBucketReplication -> Rep GetBucketReplication x

to :: Rep GetBucketReplication x -> GetBucketReplication

Read GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

readsPrec :: Int -> ReadS GetBucketReplication

readList :: ReadS [GetBucketReplication]

readPrec :: ReadPrec GetBucketReplication

readListPrec :: ReadPrec [GetBucketReplication]

Show GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

showsPrec :: Int -> GetBucketReplication -> ShowS

show :: GetBucketReplication -> String

showList :: [GetBucketReplication] -> ShowS

NFData GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

rnf :: GetBucketReplication -> ()

Eq GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

(==) :: GetBucketReplication -> GetBucketReplication -> Bool

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

Hashable GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

Methods

hashWithSalt :: Int -> GetBucketReplication -> Int

hash :: GetBucketReplication -> Int

type AWSResponse GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

type AWSResponse GetBucketReplication = GetBucketReplicationResponse

type Rep GetBucketReplication

Defined in Amazonka.S3.GetBucketReplication

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

newGetBucketReplication

Arguments

:: BucketName

GetBucketReplication

-> GetBucketReplication

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

GetBucketReplication, getBucketReplication_bucket - The bucket name for which to get the replication information.

Request Lenses

getBucketReplication_expectedBucketOwner :: Lens' GetBucketReplication (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).

getBucketReplication_bucket :: Lens' GetBucketReplication BucketName

The bucket name for which to get the replication information.

Destructuring the Response

data GetBucketReplicationResponse

See: newGetBucketReplicationResponse smart constructor.

Constructors

GetBucketReplicationResponse'

Fields

• replicationConfiguration :: Maybe ReplicationConfiguration
• httpStatus :: Int

  The response's http status code.

Instances

Generic GetBucketReplicationResponse

Defined in Amazonka.S3.GetBucketReplication

Associated Types

type Rep GetBucketReplicationResponse :: Type -> Type

Methods

from :: GetBucketReplicationResponse -> Rep GetBucketReplicationResponse x

to :: Rep GetBucketReplicationResponse x -> GetBucketReplicationResponse

Read GetBucketReplicationResponse

Defined in Amazonka.S3.GetBucketReplication

Methods

readsPrec :: Int -> ReadS GetBucketReplicationResponse

readList :: ReadS [GetBucketReplicationResponse]

readPrec :: ReadPrec GetBucketReplicationResponse

readListPrec :: ReadPrec [GetBucketReplicationResponse]

Show GetBucketReplicationResponse

Defined in Amazonka.S3.GetBucketReplication

Methods

showsPrec :: Int -> GetBucketReplicationResponse -> ShowS

show :: GetBucketReplicationResponse -> String

showList :: [GetBucketReplicationResponse] -> ShowS

NFData GetBucketReplicationResponse

Defined in Amazonka.S3.GetBucketReplication

Methods

rnf :: GetBucketReplicationResponse -> ()

Eq GetBucketReplicationResponse

Defined in Amazonka.S3.GetBucketReplication

Methods

(==) :: GetBucketReplicationResponse -> GetBucketReplicationResponse -> Bool

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

type Rep GetBucketReplicationResponse

Defined in Amazonka.S3.GetBucketReplication

type Rep GetBucketReplicationResponse = D1 ('MetaData "GetBucketReplicationResponse" "Amazonka.S3.GetBucketReplication" "amazonka-s3-2.0-CNZtv1UmVzj28JXsFvwNoj" 'False) (C1 ('MetaCons "GetBucketReplicationResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "replicationConfiguration") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ReplicationConfiguration)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newGetBucketReplicationResponse

Arguments

:: Int

$sel:httpStatus:GetBucketReplicationResponse'

-> GetBucketReplicationResponse

Create a value of GetBucketReplicationResponse 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:replicationConfiguration:GetBucketReplicationResponse', getBucketReplicationResponse_replicationConfiguration - Undocumented member.

$sel:httpStatus:GetBucketReplicationResponse', getBucketReplicationResponse_httpStatus - The response's http status code.

Response Lenses

getBucketReplicationResponse_replicationConfiguration :: Lens' GetBucketReplicationResponse (Maybe ReplicationConfiguration)

Undocumented member.

getBucketReplicationResponse_httpStatus :: Lens' GetBucketReplicationResponse Int

The response's http status code.