MDAA TS Docs
    Preparing search index...

    S3 location configuration for DataSync transfers to/from Amazon S3. Defines the S3 bucket, IAM access role, optional storage class, and subdirectory prefix.

    Use cases: S3-to-S3 data migration; Cloud storage as transfer source or destination; Storage class optimization

    AWS: DataSync LocationS3 resource (CfnLocationS3)

    Validation: s3BucketArn and bucketAccessRoleArn required; s3StorageClass must be valid S3 storage class if provided

    interface LocationS3Props {
        bucketAccessRoleArn: string;
        s3BucketArn: string;
        s3StorageClass?: S3StorageClassType;
        subdirectory?: string;
    }

    Hierarchy (View Summary)

    Index

    Properties

    bucketAccessRoleArn: string

    ARN of the IAM role DataSync assumes to read/write objects in the S3 location. MDAA custom parameter — the value is used to construct the S3Config object. Accepts a role ARN or dynamic reference.

    Use cases: S3 access permissions; Cross-account bucket access

    AWS: IAM role ARN for DataSync S3 access (maps to S3Config.bucketAccessRoleArn)

    Validation: Required; must be valid IAM role ARN or dynamic reference

    s3BucketArn: string

    ARN of the S3 bucket for this DataSync location. Can be a static ARN or a dynamic reference (e.g. SSM parameter).

    Use cases: S3 bucket identification as transfer source or destination

    AWS: S3 bucket ARN for DataSync LocationS3 configuration

    Validation: Required; must be valid S3 bucket ARN

    s3StorageClass?: S3StorageClassType

    S3 storage class for transferred files when this location is a task destination. Enables cost optimization by directing data to the appropriate storage tier.

    Use cases: Storage cost optimization; Lifecycle-aware data placement

    AWS: S3 storage class (STANDARD, INTELLIGENT_TIERING, GLACIER, etc.)

    Validation: Optional; must be valid S3StorageClassType

    STANDARD (S3 default)
    
    subdirectory?: string

    Subdirectory (object key prefix) within the S3 bucket. Must use forward slashes (e.g. /path/to/folder).

    Use cases: Scoped transfers to a specific S3 prefix; Organized data placement

    AWS: S3 object key prefix for DataSync location

    Validation: Optional; must use forward slash format if specified