software.amazon.awscdk.services.ecs

Enum ExecuteCommandLogging

java.lang.Object

java.lang.Enum<ExecuteCommandLogging>

software.amazon.awscdk.services.ecs.ExecuteCommandLogging

All Implemented Interfaces:

Serializable, Comparable<ExecuteCommandLogging>

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:38.699Z")
 @Stability(value=Stable)
public enum ExecuteCommandLogging
extends Enum<ExecuteCommandLogging>

The log settings to use to for logging the execute command session.

For more information, see [Logging] https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-executecommandconfiguration.html#cfn-ecs-cluster-executecommandconfiguration-logging

Example:

 Vpc vpc;
 Key kmsKey = new Key(this, "KmsKey");
 // Pass the KMS key in the `encryptionKey` field to associate the key to the log group
 LogGroup logGroup = LogGroup.Builder.create(this, "LogGroup")
         .encryptionKey(kmsKey)
         .build();
 // Pass the KMS key in the `encryptionKey` field to associate the key to the S3 bucket
 Bucket execBucket = Bucket.Builder.create(this, "EcsExecBucket")
         .encryptionKey(kmsKey)
         .build();
 Cluster cluster = Cluster.Builder.create(this, "Cluster")
         .vpc(vpc)
         .executeCommandConfiguration(ExecuteCommandConfiguration.builder()
                 .kmsKey(kmsKey)
                 .logConfiguration(ExecuteCommandLogConfiguration.builder()
                         .cloudWatchLogGroup(logGroup)
                         .cloudWatchEncryptionEnabled(true)
                         .s3Bucket(execBucket)
                         .s3EncryptionEnabled(true)
                         .s3KeyPrefix("exec-command-output")
                         .build())
                 .logging(ExecuteCommandLogging.OVERRIDE)
                 .build())
         .build();
 

Enum Constant Summary

Enum Constants

Enum Constant and Description
DEFAULT The awslogs configuration in the task definition is used.
NONE The execute command session is not logged.
OVERRIDE Specify the logging details as a part of logConfiguration.

Method Summary

Modifier and Type	Method and Description
static ExecuteCommandLogging	valueOf(String name) Returns the enum constant of this type with the specified name.
static ExecuteCommandLogging[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

NONE

@Stability(value=Stable)
public static final ExecuteCommandLogging NONE

The execute command session is not logged.

DEFAULT

@Stability(value=Stable)
public static final ExecuteCommandLogging DEFAULT

The awslogs configuration in the task definition is used.

If no logging parameter is specified, it defaults to this value. If no awslogs log driver is configured in the task definition, the output won't be logged.

OVERRIDE

@Stability(value=Stable)
public static final ExecuteCommandLogging OVERRIDE

Specify the logging details as a part of logConfiguration.

Method Detail

values

public static ExecuteCommandLogging[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ExecuteCommandLogging c : ExecuteCommandLogging.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ExecuteCommandLogging valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null