software.amazon.awscdk.services.ec2

Class InitFile

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.ec2.InitElement

software.amazon.awscdk.services.ec2.InitFile

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:06.638Z")
 @Stability(value=Experimental)
public abstract class InitFile
extends InitElement

(experimental) Create files on the EC2 instance.

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InitFile(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	InitFile(software.amazon.jsii.JsiiObjectRef objRef)
protected	InitFile(String fileName, InitFileOptions options)

Method Summary

Modifier and Type	Method and Description
static InitFile	fromAsset(String targetFileName, String path) (experimental) Create an asset from the given file.
static InitFile	fromAsset(String targetFileName, String path, InitFileAssetOptions options) (experimental) Create an asset from the given file.
static InitFile	fromExistingAsset(String targetFileName, Asset asset) (experimental) Use a file from an asset at instance startup time.
static InitFile	fromExistingAsset(String targetFileName, Asset asset, InitFileOptions options) (experimental) Use a file from an asset at instance startup time.
static InitFile	fromFileInline(String targetFileName, String sourceFileName) (experimental) Read a file from disk and use its contents.
static InitFile	fromFileInline(String targetFileName, String sourceFileName, InitFileOptions options) (experimental) Read a file from disk and use its contents.
static InitFile	fromObject(String fileName, Map<String,? extends Object> obj) (experimental) Use a JSON-compatible object as the file content, write it to a JSON file.
static InitFile	fromObject(String fileName, Map<String,? extends Object> obj, InitFileOptions options) (experimental) Use a JSON-compatible object as the file content, write it to a JSON file.
static InitFile	fromS3Object(String fileName, IBucket bucket, String key) (experimental) Download a file from an S3 bucket at instance startup time.
static InitFile	fromS3Object(String fileName, IBucket bucket, String key, InitFileOptions options) (experimental) Download a file from an S3 bucket at instance startup time.
static InitFile	fromString(String fileName, String content) (experimental) Use a literal string as the file content.
static InitFile	fromString(String fileName, String content, InitFileOptions options) (experimental) Use a literal string as the file content.
static InitFile	fromUrl(String fileName, String url) (experimental) Download from a URL at instance startup time.
static InitFile	fromUrl(String fileName, String url, InitFileOptions options) (experimental) Download from a URL at instance startup time.
String	getElementType() (experimental) Returns the init element type for this element.
static InitFile	symlink(String fileName, String target) (experimental) Write a symlink with the given symlink target.
static InitFile	symlink(String fileName, String target, InitFileOptions options) (experimental) Write a symlink with the given symlink target.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

InitFile

protected InitFile(software.amazon.jsii.JsiiObjectRef objRef)

InitFile

protected InitFile(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

InitFile

@Stability(value=Experimental)
protected InitFile(@NotNull
                                                  String fileName,
                                                  @NotNull
                                                  InitFileOptions options)

Parameters:

fileName - This parameter is required.

options - This parameter is required.

Method Detail

fromAsset

@Stability(value=Experimental)
 @NotNull
public static InitFile fromAsset(@NotNull
                                                                          String targetFileName,
                                                                          @NotNull
                                                                          String path,
                                                                          @Nullable
                                                                          InitFileAssetOptions options)

(experimental) Create an asset from the given file.

This is appropriate for files that are too large to embed into the template.

Parameters:

targetFileName - This parameter is required.

path - This parameter is required.

options -

fromAsset

@Stability(value=Experimental)
 @NotNull
public static InitFile fromAsset(@NotNull
                                                                          String targetFileName,
                                                                          @NotNull
                                                                          String path)

(experimental) Create an asset from the given file.

This is appropriate for files that are too large to embed into the template.

Parameters:

targetFileName - This parameter is required.

path - This parameter is required.

fromExistingAsset

@Stability(value=Experimental)
 @NotNull
public static InitFile fromExistingAsset(@NotNull
                                                                                  String targetFileName,
                                                                                  @NotNull
                                                                                  Asset asset,
                                                                                  @Nullable
                                                                                  InitFileOptions options)

(experimental) Use a file from an asset at instance startup time.

Parameters:

targetFileName - This parameter is required.

asset - This parameter is required.

options -

fromExistingAsset

@Stability(value=Experimental)
 @NotNull
public static InitFile fromExistingAsset(@NotNull
                                                                                  String targetFileName,
                                                                                  @NotNull
                                                                                  Asset asset)

(experimental) Use a file from an asset at instance startup time.

Parameters:

targetFileName - This parameter is required.

asset - This parameter is required.

fromFileInline

@Stability(value=Experimental)
 @NotNull
public static InitFile fromFileInline(@NotNull
                                                                               String targetFileName,
                                                                               @NotNull
                                                                               String sourceFileName,
                                                                               @Nullable
                                                                               InitFileOptions options)

(experimental) Read a file from disk and use its contents.

The file will be embedded in the template, so care should be taken to not exceed the template size.

If options.base64encoded is set to true, this will base64-encode the file's contents.

Parameters:

targetFileName - This parameter is required.

sourceFileName - This parameter is required.

options -

fromFileInline

@Stability(value=Experimental)
 @NotNull
public static InitFile fromFileInline(@NotNull
                                                                               String targetFileName,
                                                                               @NotNull
                                                                               String sourceFileName)

(experimental) Read a file from disk and use its contents.

The file will be embedded in the template, so care should be taken to not exceed the template size.

If options.base64encoded is set to true, this will base64-encode the file's contents.

Parameters:

targetFileName - This parameter is required.

sourceFileName - This parameter is required.

fromObject

@Stability(value=Experimental)
 @NotNull
public static InitFile fromObject(@NotNull
                                                                           String fileName,
                                                                           @NotNull
                                                                           Map<String,? extends Object> obj,
                                                                           @Nullable
                                                                           InitFileOptions options)

(experimental) Use a JSON-compatible object as the file content, write it to a JSON file.

May contain tokens.

Parameters:

fileName - This parameter is required.

obj - This parameter is required.

options -

fromObject

@Stability(value=Experimental)
 @NotNull
public static InitFile fromObject(@NotNull
                                                                           String fileName,
                                                                           @NotNull
                                                                           Map<String,? extends Object> obj)

(experimental) Use a JSON-compatible object as the file content, write it to a JSON file.

May contain tokens.

Parameters:

fileName - This parameter is required.

obj - This parameter is required.

fromS3Object

@Stability(value=Experimental)
 @NotNull
public static InitFile fromS3Object(@NotNull
                                                                             String fileName,
                                                                             @NotNull
                                                                             IBucket bucket,
                                                                             @NotNull
                                                                             String key,
                                                                             @Nullable
                                                                             InitFileOptions options)

(experimental) Download a file from an S3 bucket at instance startup time.

Parameters:

fileName - This parameter is required.

bucket - This parameter is required.

key - This parameter is required.

options -

fromS3Object

@Stability(value=Experimental)
 @NotNull
public static InitFile fromS3Object(@NotNull
                                                                             String fileName,
                                                                             @NotNull
                                                                             IBucket bucket,
                                                                             @NotNull
                                                                             String key)

(experimental) Download a file from an S3 bucket at instance startup time.

Parameters:

fileName - This parameter is required.

bucket - This parameter is required.

key - This parameter is required.

fromString

@Stability(value=Experimental)
 @NotNull
public static InitFile fromString(@NotNull
                                                                           String fileName,
                                                                           @NotNull
                                                                           String content,
                                                                           @Nullable
                                                                           InitFileOptions options)

(experimental) Use a literal string as the file content.

Parameters:

fileName - This parameter is required.

content - This parameter is required.

options -

fromString

@Stability(value=Experimental)
 @NotNull
public static InitFile fromString(@NotNull
                                                                           String fileName,
                                                                           @NotNull
                                                                           String content)

(experimental) Use a literal string as the file content.

Parameters:

fileName - This parameter is required.

content - This parameter is required.

fromUrl

@Stability(value=Experimental)
 @NotNull
public static InitFile fromUrl(@NotNull
                                                                        String fileName,
                                                                        @NotNull
                                                                        String url,
                                                                        @Nullable
                                                                        InitFileOptions options)

(experimental) Download from a URL at instance startup time.

Parameters:

fileName - This parameter is required.

url - This parameter is required.

options -

fromUrl

@Stability(value=Experimental)
 @NotNull
public static InitFile fromUrl(@NotNull
                                                                        String fileName,
                                                                        @NotNull
                                                                        String url)

(experimental) Download from a URL at instance startup time.

Parameters:

fileName - This parameter is required.

url - This parameter is required.

symlink

@Stability(value=Experimental)
 @NotNull
public static InitFile symlink(@NotNull
                                                                        String fileName,
                                                                        @NotNull
                                                                        String target,
                                                                        @Nullable
                                                                        InitFileOptions options)

(experimental) Write a symlink with the given symlink target.

Parameters:

fileName - This parameter is required.

target - This parameter is required.

options -

symlink

@Stability(value=Experimental)
 @NotNull
public static InitFile symlink(@NotNull
                                                                        String fileName,
                                                                        @NotNull
                                                                        String target)

(experimental) Write a symlink with the given symlink target.

Parameters:

fileName - This parameter is required.

target - This parameter is required.

getElementType

@Stability(value=Experimental)
 @NotNull
public String getElementType()

(experimental) Returns the init element type for this element.

Specified by:

getElementType in class InitElement