software.amazon.awscdk.services.ec2

Interface S3DownloadOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

S3DownloadOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.70.0 (build 03c2f6f)",
           date="2022-11-01T13:16:47.056Z")
 @Stability(value=Experimental)
public interface S3DownloadOptions
extends software.amazon.jsii.JsiiSerializable

(experimental) Options when downloading files from S3.

Example:

 import software.amazon.awscdk.services.s3.assets.Asset;
 Instance instance;
 Asset asset = Asset.Builder.create(this, "Asset")
         .path("./configure.sh")
         .build();
 String localPath = instance.userData.addS3DownloadCommand(S3DownloadOptions.builder()
         .bucket(asset.getBucket())
         .bucketKey(asset.getS3ObjectKey())
         .region("us-east-1")
         .build());
 instance.userData.addExecuteFileCommand(ExecuteFileOptions.builder()
         .filePath(localPath)
         .arguments("--verbose -y")
         .build());
 asset.grantRead(instance.getRole());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	S3DownloadOptions.Builder A builder for S3DownloadOptions
static class	S3DownloadOptions.Jsii$Proxy An implementation for S3DownloadOptions

Method Summary

Modifier and Type	Method and Description
static S3DownloadOptions.Builder	builder()
IBucket	getBucket() (experimental) Name of the S3 bucket to download from.
String	getBucketKey() (experimental) The key of the file to download.
default String	getLocalFile() (experimental) The name of the local file.
default String	getRegion() (experimental) The region of the S3 Bucket (needed for access via VPC Gateway).

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getBucket

@Stability(value=Experimental)
 @NotNull
IBucket getBucket()

(experimental) Name of the S3 bucket to download from.

getBucketKey

@Stability(value=Experimental)
 @NotNull
String getBucketKey()

(experimental) The key of the file to download.

getLocalFile

@Stability(value=Experimental)
 @Nullable
default String getLocalFile()

(experimental) The name of the local file.

Default: Linux - /tmp/bucketKey Windows - %TEMP%/bucketKey

getRegion

@Stability(value=Experimental)
 @Nullable
default String getRegion()

(experimental) The region of the S3 Bucket (needed for access via VPC Gateway).

Default: none

builder

@Stability(value=Experimental)
static S3DownloadOptions.Builder builder()

Returns:

a S3DownloadOptions.Builder of S3DownloadOptions