Class: Aws::DataSync::Types::CreateLocationS3Request

Inherits:

Struct

• Object
• Struct
• Aws::DataSync::Types::CreateLocationS3Request

Includes:

Structure

Defined in:

lib/aws-sdk-datasync/types.rb

Overview

CreateLocationS3Request

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #agent_arns ⇒ Array<String>

  (Amazon S3 on Outposts only) Specifies the Amazon Resource Name (ARN) of the DataSync agent on your Outpost.

• #s3_bucket_arn ⇒ String

  Specifies the ARN of the S3 bucket that you want to use as a location.

• #s3_config ⇒ Types::S3Config

  Specifies the Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.

• #s3_storage_class ⇒ String

  Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.

• #subdirectory ⇒ String

  Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).

• #tags ⇒ Array<Types::TagListEntry>

  Specifies labels that help you categorize, filter, and search for your Amazon Web Services resources.

Instance Attribute Details

#agent_arns ⇒ Array<String>

(Amazon S3 on Outposts only) Specifies the Amazon Resource Name (ARN) of the DataSync agent on your Outpost.

For more information, see [Deploy your DataSync agent on Outposts].

[1]: docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent

Returns:

• (Array<String>)

# File 'lib/aws-sdk-datasync/types.rb', line 1192

class CreateLocationS3Request < Struct.new(
  :subdirectory,
  :s3_bucket_arn,
  :s3_storage_class,
  :s3_config,
  :agent_arns,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#s3_bucket_arn ⇒ String

Specifies the ARN of the S3 bucket that you want to use as a location. (When creating your DataSync task later, you specify whether this location is a transfer source or destination.)

If your S3 bucket is located on an Outposts resource, you must specify an Amazon S3 access point. For more information, see

Managing data access with Amazon S3 access points][1

in the

*Amazon S3 User Guide*.

[1]: docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html

Returns:

• (String)

# File 'lib/aws-sdk-datasync/types.rb', line 1192

class CreateLocationS3Request < Struct.new(
  :subdirectory,
  :s3_bucket_arn,
  :s3_storage_class,
  :s3_config,
  :agent_arns,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#s3_config ⇒ Types::S3Config

Specifies the Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that DataSync uses to access your S3 bucket.

For more information, see [Providing DataSync access to S3 buckets].

[1]: docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access

Returns:

• (Types::S3Config)

# File 'lib/aws-sdk-datasync/types.rb', line 1192

class CreateLocationS3Request < Struct.new(
  :subdirectory,
  :s3_bucket_arn,
  :s3_storage_class,
  :s3_config,
  :agent_arns,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#s3_storage_class ⇒ String

Specifies the storage class that you want your objects to use when Amazon S3 is a transfer destination.

For buckets in Amazon Web Services Regions, the storage class defaults to ‘STANDARD`. For buckets on Outposts, the storage class defaults to `OUTPOSTS`.

For more information, see [Storage class considerations with Amazon S3 transfers].

[1]: docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes

Returns:

• (String)

# File 'lib/aws-sdk-datasync/types.rb', line 1192

class CreateLocationS3Request < Struct.new(
  :subdirectory,
  :s3_bucket_arn,
  :s3_storage_class,
  :s3_config,
  :agent_arns,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#subdirectory ⇒ String

Specifies a prefix in the S3 bucket that DataSync reads from or writes to (depending on whether the bucket is a source or destination location).

<note markdown=“1”> DataSync can’t transfer objects with a prefix that begins with a slash (‘/`) or includes `//`, `/./`, or `/../` patterns. For example:

* `/photos`

• ‘photos//2006/January`

• ‘photos/./2006/February`

• ‘photos/../2006/March`

</note>

Returns:

• (String)

# File 'lib/aws-sdk-datasync/types.rb', line 1192

class CreateLocationS3Request < Struct.new(
  :subdirectory,
  :s3_bucket_arn,
  :s3_storage_class,
  :s3_config,
  :agent_arns,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ Array<Types::TagListEntry>

Specifies labels that help you categorize, filter, and search for your Amazon Web Services resources. We recommend creating at least a name tag for your transfer location.

Returns:

• (Array<Types::TagListEntry>)

# File 'lib/aws-sdk-datasync/types.rb', line 1192

class CreateLocationS3Request < Struct.new(
  :subdirectory,
  :s3_bucket_arn,
  :s3_storage_class,
  :s3_config,
  :agent_arns,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end