Package software.amazon.awscdk.services.athena

Interface CfnWorkGroupProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnWorkGroupProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)",
           date="2025-10-24T13:34:31.634Z")
@Stability(Stable)
public interface CfnWorkGroupProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnWorkGroup.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.athena.*;
 CfnWorkGroupProps cfnWorkGroupProps = CfnWorkGroupProps.builder()
         .name("name")
         // the properties below are optional
         .description("description")
         .recursiveDeleteOption(false)
         .state("state")
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .workGroupConfiguration(WorkGroupConfigurationProperty.builder()
                 .additionalConfiguration("additionalConfiguration")
                 .bytesScannedCutoffPerQuery(123)
                 .customerContentEncryptionConfiguration(CustomerContentEncryptionConfigurationProperty.builder()
                         .kmsKey("kmsKey")
                         .build())
                 .enforceWorkGroupConfiguration(false)
                 .engineVersion(EngineVersionProperty.builder()
                         .effectiveEngineVersion("effectiveEngineVersion")
                         .selectedEngineVersion("selectedEngineVersion")
                         .build())
                 .executionRole("executionRole")
                 .managedQueryResultsConfiguration(ManagedQueryResultsConfigurationProperty.builder()
                         .enabled(false)
                         .encryptionConfiguration(ManagedStorageEncryptionConfigurationProperty.builder()
                                 .kmsKey("kmsKey")
                                 .build())
                         .build())
                 .publishCloudWatchMetricsEnabled(false)
                 .requesterPaysEnabled(false)
                 .resultConfiguration(ResultConfigurationProperty.builder()
                         .aclConfiguration(AclConfigurationProperty.builder()
                                 .s3AclOption("s3AclOption")
                                 .build())
                         .encryptionConfiguration(EncryptionConfigurationProperty.builder()
                                 .encryptionOption("encryptionOption")
                                 // the properties below are optional
                                 .kmsKey("kmsKey")
                                 .build())
                         .expectedBucketOwner("expectedBucketOwner")
                         .outputLocation("outputLocation")
                         .build())
                 .build())
         .workGroupConfigurationUpdates(WorkGroupConfigurationUpdatesProperty.builder()
                 .additionalConfiguration("additionalConfiguration")
                 .bytesScannedCutoffPerQuery(123)
                 .customerContentEncryptionConfiguration(CustomerContentEncryptionConfigurationProperty.builder()
                         .kmsKey("kmsKey")
                         .build())
                 .enforceWorkGroupConfiguration(false)
                 .engineVersion(EngineVersionProperty.builder()
                         .effectiveEngineVersion("effectiveEngineVersion")
                         .selectedEngineVersion("selectedEngineVersion")
                         .build())
                 .executionRole("executionRole")
                 .managedQueryResultsConfiguration(ManagedQueryResultsConfigurationProperty.builder()
                         .enabled(false)
                         .encryptionConfiguration(ManagedStorageEncryptionConfigurationProperty.builder()
                                 .kmsKey("kmsKey")
                                 .build())
                         .build())
                 .publishCloudWatchMetricsEnabled(false)
                 .removeBytesScannedCutoffPerQuery(false)
                 .removeCustomerContentEncryptionConfiguration(false)
                 .requesterPaysEnabled(false)
                 .resultConfigurationUpdates(ResultConfigurationUpdatesProperty.builder()
                         .aclConfiguration(AclConfigurationProperty.builder()
                                 .s3AclOption("s3AclOption")
                                 .build())
                         .encryptionConfiguration(EncryptionConfigurationProperty.builder()
                                 .encryptionOption("encryptionOption")
                                 // the properties below are optional
                                 .kmsKey("kmsKey")
                                 .build())
                         .expectedBucketOwner("expectedBucketOwner")
                         .outputLocation("outputLocation")
                         .removeAclConfiguration(false)
                         .removeEncryptionConfiguration(false)
                         .removeExpectedBucketOwner(false)
                         .removeOutputLocation(false)
                         .build())
                 .build())
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static CfnWorkGroupProps.Builder	builder()
default String	getDescription()	The workgroup description.
String	getName()	The workgroup name.
default Object	getRecursiveDeleteOption()	The option to delete a workgroup and its contents even if the workgroup contains any named queries.
default String	getState()	The state of the workgroup: ENABLED or DISABLED.
default List<CfnTag>	getTags()	The tags (key-value pairs) to associate with this resource.
default Object	getWorkGroupConfiguration()	The configuration of the workgroup, which includes the location in Amazon S3 where query results are stored, the encryption option, if any, used for query results, whether Amazon CloudWatch Metrics are enabled for the workgroup, and the limit for the amount of bytes scanned (cutoff) per query, if it is specified.
default Object	getWorkGroupConfigurationUpdates()	Deprecated. this property has been deprecated

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getName

@Stability(Stable)
@NotNull
String getName()

The workgroup name.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html#cfn-athena-workgroup-name

getDescription

@Stability(Stable)
@Nullable
default String getDescription()

The workgroup description.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html#cfn-athena-workgroup-description

getRecursiveDeleteOption

@Stability(Stable)
@Nullable
default Object getRecursiveDeleteOption()

The option to delete a workgroup and its contents even if the workgroup contains any named queries.

The default is false.

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html#cfn-athena-workgroup-recursivedeleteoption

getState

@Stability(Stable)
@Nullable
default String getState()

The state of the workgroup: ENABLED or DISABLED.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html#cfn-athena-workgroup-state

getTags

@Stability(Stable)
@Nullable
default List<CfnTag> getTags()

The tags (key-value pairs) to associate with this resource.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html#cfn-athena-workgroup-tags

getWorkGroupConfiguration

@Stability(Stable)
@Nullable
default Object getWorkGroupConfiguration()

The configuration of the workgroup, which includes the location in Amazon S3 where query results are stored, the encryption option, if any, used for query results, whether Amazon CloudWatch Metrics are enabled for the workgroup, and the limit for the amount of bytes scanned (cutoff) per query, if it is specified.

The EnforceWorkGroupConfiguration option determines whether workgroup settings override client-side query settings.

Returns union: either IResolvable or CfnWorkGroup.WorkGroupConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html#cfn-athena-workgroup-workgroupconfiguration

getWorkGroupConfigurationUpdates

@Stability(Deprecated)
@Deprecated
@Nullable
default Object getWorkGroupConfigurationUpdates()

Deprecated.

this property has been deprecated

(deprecated) The configuration information that will be updated for this workgroup, which includes the location in Amazon S3 where query results are stored, the encryption option, if any, used for query results, whether the Amazon CloudWatch Metrics are enabled for the workgroup, whether the workgroup settings override the client-side settings, and the data usage limit for the amount of bytes scanned per query, if it is specified.

Returns union: either IResolvable or CfnWorkGroup.WorkGroupConfigurationUpdatesProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-athena-workgroup.html#cfn-athena-workgroup-workgroupconfigurationupdates

builder

@Stability(Stable)
static CfnWorkGroupProps.Builder builder()

Returns:

a CfnWorkGroupProps.Builder of CfnWorkGroupProps