Interface ResultConfigurationUpdates.Builder
- All Superinterfaces:
Buildable,CopyableBuilder<ResultConfigurationUpdates.Builder,,ResultConfigurationUpdates> SdkBuilder<ResultConfigurationUpdates.Builder,,ResultConfigurationUpdates> SdkPojo
- Enclosing class:
ResultConfigurationUpdates
-
Method Summary
Modifier and TypeMethodDescriptionaclConfiguration(Consumer<AclConfiguration.Builder> aclConfiguration) The ACL configuration for the query results.aclConfiguration(AclConfiguration aclConfiguration) The ACL configuration for the query results.encryptionConfiguration(Consumer<EncryptionConfiguration.Builder> encryptionConfiguration) The encryption configuration for query and calculation results.encryptionConfiguration(EncryptionConfiguration encryptionConfiguration) The encryption configuration for query and calculation results.expectedBucketOwner(String expectedBucketOwner) The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by ResultConfiguration$OutputLocation.outputLocation(String outputLocation) The location in Amazon S3 where your query and calculation results are stored, such ass3://path/to/query/bucket/.removeAclConfiguration(Boolean removeAclConfiguration) If set totrue, indicates that the previously-specified ACL configuration for queries in this workgroup should be ignored and set to null.removeEncryptionConfiguration(Boolean removeEncryptionConfiguration) If set to "true", indicates that the previously-specified encryption configuration (also known as the client-side setting) for queries in this workgroup should be ignored and set to null.removeExpectedBucketOwner(Boolean removeExpectedBucketOwner) If set to "true", removes the Amazon Web Services account ID previously specified for ResultConfiguration$ExpectedBucketOwner.removeOutputLocation(Boolean removeOutputLocation) If set to "true", indicates that the previously-specified query results location (also known as a client-side setting) for queries in this workgroup should be ignored and set to null.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copyMethods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, buildMethods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
Method Details
-
outputLocation
The location in Amazon S3 where your query and calculation results are stored, such as
s3://path/to/query/bucket/. If workgroup settings override client-side settings, then the query uses the location for the query results and the encryption configuration that are specified for the workgroup. The "workgroup settings override" is specified inEnforceWorkGroupConfiguration(true/false) in theWorkGroupConfiguration. See WorkGroupConfiguration$EnforceWorkGroupConfiguration.- Parameters:
outputLocation- The location in Amazon S3 where your query and calculation results are stored, such ass3://path/to/query/bucket/. If workgroup settings override client-side settings, then the query uses the location for the query results and the encryption configuration that are specified for the workgroup. The "workgroup settings override" is specified inEnforceWorkGroupConfiguration(true/false) in theWorkGroupConfiguration. See WorkGroupConfiguration$EnforceWorkGroupConfiguration.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
removeOutputLocation
If set to "true", indicates that the previously-specified query results location (also known as a client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in the
OutputLocationinResultConfigurationUpdates(the client-side setting), theOutputLocationin the workgroup'sResultConfigurationwill be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Parameters:
removeOutputLocation- If set to "true", indicates that the previously-specified query results location (also known as a client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in theOutputLocationinResultConfigurationUpdates(the client-side setting), theOutputLocationin the workgroup'sResultConfigurationwill be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
encryptionConfiguration
ResultConfigurationUpdates.Builder encryptionConfiguration(EncryptionConfiguration encryptionConfiguration) The encryption configuration for query and calculation results.
- Parameters:
encryptionConfiguration- The encryption configuration for query and calculation results.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
encryptionConfiguration
default ResultConfigurationUpdates.Builder encryptionConfiguration(Consumer<EncryptionConfiguration.Builder> encryptionConfiguration) The encryption configuration for query and calculation results.
This is a convenience method that creates an instance of theEncryptionConfiguration.Builderavoiding the need to create one manually viaEncryptionConfiguration.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toencryptionConfiguration(EncryptionConfiguration).- Parameters:
encryptionConfiguration- a consumer that will call methods onEncryptionConfiguration.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
removeEncryptionConfiguration
ResultConfigurationUpdates.Builder removeEncryptionConfiguration(Boolean removeEncryptionConfiguration) If set to "true", indicates that the previously-specified encryption configuration (also known as the client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in the
EncryptionConfigurationinResultConfigurationUpdates(the client-side setting), theEncryptionConfigurationin the workgroup'sResultConfigurationwill be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Parameters:
removeEncryptionConfiguration- If set to "true", indicates that the previously-specified encryption configuration (also known as the client-side setting) for queries in this workgroup should be ignored and set to null. If set to "false" or not set, and a value is present in theEncryptionConfigurationinResultConfigurationUpdates(the client-side setting), theEncryptionConfigurationin the workgroup'sResultConfigurationwill be updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
expectedBucketOwner
The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by ResultConfiguration$OutputLocation. If set, Athena uses the value for
ExpectedBucketOwnerwhen it makes Amazon S3 calls to your specified output location. If theExpectedBucketOwnerAmazon Web Services account ID does not match the actual owner of the Amazon S3 bucket, the call fails with a permissions error.If workgroup settings override client-side settings, then the query uses the
ExpectedBucketOwnersetting that is specified for the workgroup, and also uses the location for storing query results specified in the workgroup. See WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings Override Client-Side Settings.- Parameters:
expectedBucketOwner- The Amazon Web Services account ID that you expect to be the owner of the Amazon S3 bucket specified by ResultConfiguration$OutputLocation. If set, Athena uses the value forExpectedBucketOwnerwhen it makes Amazon S3 calls to your specified output location. If theExpectedBucketOwnerAmazon Web Services account ID does not match the actual owner of the Amazon S3 bucket, the call fails with a permissions error.If workgroup settings override client-side settings, then the query uses the
ExpectedBucketOwnersetting that is specified for the workgroup, and also uses the location for storing query results specified in the workgroup. See WorkGroupConfiguration$EnforceWorkGroupConfiguration and Workgroup Settings Override Client-Side Settings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
removeExpectedBucketOwner
If set to "true", removes the Amazon Web Services account ID previously specified for ResultConfiguration$ExpectedBucketOwner. If set to "false" or not set, and a value is present in the
ExpectedBucketOwnerinResultConfigurationUpdates(the client-side setting), theExpectedBucketOwnerin the workgroup'sResultConfigurationis updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Parameters:
removeExpectedBucketOwner- If set to "true", removes the Amazon Web Services account ID previously specified for ResultConfiguration$ExpectedBucketOwner. If set to "false" or not set, and a value is present in theExpectedBucketOwnerinResultConfigurationUpdates(the client-side setting), theExpectedBucketOwnerin the workgroup'sResultConfigurationis updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
aclConfiguration
The ACL configuration for the query results.
- Parameters:
aclConfiguration- The ACL configuration for the query results.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
aclConfiguration
default ResultConfigurationUpdates.Builder aclConfiguration(Consumer<AclConfiguration.Builder> aclConfiguration) The ACL configuration for the query results.
This is a convenience method that creates an instance of theAclConfiguration.Builderavoiding the need to create one manually viaAclConfiguration.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed toaclConfiguration(AclConfiguration).- Parameters:
aclConfiguration- a consumer that will call methods onAclConfiguration.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
removeAclConfiguration
If set to
true, indicates that the previously-specified ACL configuration for queries in this workgroup should be ignored and set to null. If set tofalseor not set, and a value is present in theAclConfigurationofResultConfigurationUpdates, theAclConfigurationin the workgroup'sResultConfigurationis updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Parameters:
removeAclConfiguration- If set totrue, indicates that the previously-specified ACL configuration for queries in this workgroup should be ignored and set to null. If set tofalseor not set, and a value is present in theAclConfigurationofResultConfigurationUpdates, theAclConfigurationin the workgroup'sResultConfigurationis updated with the new value. For more information, see Workgroup Settings Override Client-Side Settings.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-