Class: Aws::S3::Types::Destination

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-s3/types.rb

Overview

Note:

When making an API call, you may pass Destination data as a hash:

{
  bucket: "BucketName", # required
  account: "AccountId",
  storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
  access_control_translation: {
    owner: "Destination", # required, accepts Destination
  },
  encryption_configuration: {
    replica_kms_key_id: "ReplicaKmsKeyID",
  },
}

Specifies information about where to publish analysis or configuration results for an Amazon S3 bucket.

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#access_control_translation ⇒ Types::AccessControlTranslation

Specify this only in a cross-account scenario (where source and destination bucket owners are not the same), and you want to change replica ownership to the AWS account that owns the destination bucket. If this is not specified in the replication configuration, the replicas are owned by same AWS account that owns the source object.

Returns:



2346
2347
2348
2349
2350
2351
2352
2353
 
# File 'lib/aws-sdk-s3/types.rb', line 2346

class Destination < Struct.new(
  :bucket,
  :account,
  :storage_class,
  :access_control_translation,
  :encryption_configuration)
  include Aws::Structure
end

#account ⇒ String

Destination bucket owner account ID. In a cross-account scenario, if you direct Amazon S3 to change replica ownership to the AWS account that owns the destination bucket by specifying the ‘AccessControlTranslation` property, this is the account ID of the destination bucket owner. For more information, see [Cross-Region Replication Additional Configuration: Change Replica Owner] in the *Amazon Simple Storage Service Developer Guide*.

[1]: docs.aws.amazon.com/AmazonS3/latest/dev/crr-change-owner.html

Returns:

  • (String) 


2346
2347
2348
2349
2350
2351
2352
2353
 
# File 'lib/aws-sdk-s3/types.rb', line 2346

class Destination < Struct.new(
  :bucket,
  :account,
  :storage_class,
  :access_control_translation,
  :encryption_configuration)
  include Aws::Structure
end

#bucket ⇒ String

The Amazon Resource Name (ARN) of the bucket where you want Amazon S3 to store replicas of the object identified by the rule.

A replication configuration can replicate objects to only one destination bucket. If there are multiple rules in your replication configuration, all rules must specify the same destination bucket.

Returns:

  • (String) 


2346
2347
2348
2349
2350
2351
2352
2353
 
# File 'lib/aws-sdk-s3/types.rb', line 2346

class Destination < Struct.new(
  :bucket,
  :account,
  :storage_class,
  :access_control_translation,
  :encryption_configuration)
  include Aws::Structure
end

#encryption_configuration ⇒ Types::EncryptionConfiguration

A container that provides information about encryption. If ‘SourceSelectionCriteria` is specified, you must specify this element.

Returns:



2346
2347
2348
2349
2350
2351
2352
2353
 
# File 'lib/aws-sdk-s3/types.rb', line 2346

class Destination < Struct.new(
  :bucket,
  :account,
  :storage_class,
  :access_control_translation,
  :encryption_configuration)
  include Aws::Structure
end

#storage_class ⇒ String

The storage class to use when replicating objects, such as standard or reduced redundancy. By default, Amazon S3 uses the storage class of the source object to create the object replica.

For valid values, see the ‘StorageClass` element of the [PUT Bucket replication] action in the *Amazon Simple Storage Service API Reference*.

[1]: docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html

Returns:

  • (String) 


2346
2347
2348
2349
2350
2351
2352
2353
 
# File 'lib/aws-sdk-s3/types.rb', line 2346

class Destination < Struct.new(
  :bucket,
  :account,
  :storage_class,
  :access_control_translation,
  :encryption_configuration)
  include Aws::Structure
end