libZSservicesZSamazonka-s3ZSamazonka-s3
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.S3.GetBucketReplication

Description

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:

Synopsis

Creating a Request

data GetBucketReplication Source #

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 will fail with an HTTP 403 (Access Denied) error.

  • bucket :: BucketName

    The bucket name for which to get the replication information.

Instances

Instances details
Eq GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Read GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Show GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Generic GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Associated Types

type Rep GetBucketReplication :: Type -> Type #

NFData GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Methods

rnf :: GetBucketReplication -> () #

Hashable GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

AWSRequest GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Associated Types

type AWSResponse GetBucketReplication #

ToHeaders GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

ToPath GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

ToQuery GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

type Rep GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

type Rep GetBucketReplication = D1 ('MetaData "GetBucketReplication" "Amazonka.S3.GetBucketReplication" "libZSservicesZSamazonka-s3ZSamazonka-s3" '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)))
type AWSResponse GetBucketReplication Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

newGetBucketReplication Source #

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 will fail with an HTTP 403 (Access Denied) error.

$sel:bucket:GetBucketReplication', getBucketReplication_bucket - The bucket name for which to get the replication information.

Request Lenses

getBucketReplication_expectedBucketOwner :: Lens' GetBucketReplication (Maybe Text) Source #

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.

getBucketReplication_bucket :: Lens' GetBucketReplication BucketName Source #

The bucket name for which to get the replication information.

Destructuring the Response

data GetBucketReplicationResponse Source #

See: newGetBucketReplicationResponse smart constructor.

Instances

Instances details
Eq GetBucketReplicationResponse Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Read GetBucketReplicationResponse Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Show GetBucketReplicationResponse Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Generic GetBucketReplicationResponse Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

Associated Types

type Rep GetBucketReplicationResponse :: Type -> Type #

NFData GetBucketReplicationResponse Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

type Rep GetBucketReplicationResponse Source # 
Instance details

Defined in Amazonka.S3.GetBucketReplication

type Rep GetBucketReplicationResponse = D1 ('MetaData "GetBucketReplicationResponse" "Amazonka.S3.GetBucketReplication" "libZSservicesZSamazonka-s3ZSamazonka-s3" '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 Source #

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