Interface Snapshot.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<Snapshot.Builder,
,Snapshot> SdkBuilder<Snapshot.Builder,
,Snapshot> SdkPojo
- Enclosing class:
Snapshot
-
Method Summary
Modifier and TypeMethodDescriptionaccountsWithRestoreAccess
(Collection<AccountWithRestoreAccess> accountsWithRestoreAccess) A list of the Amazon Web Services accounts authorized to restore the snapshot.accountsWithRestoreAccess
(Consumer<AccountWithRestoreAccess.Builder>... accountsWithRestoreAccess) A list of the Amazon Web Services accounts authorized to restore the snapshot.accountsWithRestoreAccess
(AccountWithRestoreAccess... accountsWithRestoreAccess) A list of the Amazon Web Services accounts authorized to restore the snapshot.actualIncrementalBackupSizeInMegaBytes
(Double actualIncrementalBackupSizeInMegaBytes) The size of the incremental backup.availabilityZone
(String availabilityZone) The Availability Zone in which the cluster was created.backupProgressInMegaBytes
(Double backupProgressInMegaBytes) The number of megabytes that have been transferred to the snapshot backup.clusterCreateTime
(Instant clusterCreateTime) The time (UTC) when the cluster was originally created.clusterIdentifier
(String clusterIdentifier) The identifier of the cluster for which the snapshot was taken.clusterVersion
(String clusterVersion) The version ID of the Amazon Redshift engine that is running on the cluster.currentBackupRateInMegaBytesPerSecond
(Double currentBackupRateInMegaBytesPerSecond) The number of megabytes per second being transferred to the snapshot backup.The name of the database that was created when the cluster was created.elapsedTimeInSeconds
(Long elapsedTimeInSeconds) The amount of time an in-progress snapshot backup has been running, or the amount of time it took a completed backup to finish.Iftrue
, the data in the snapshot is encrypted at rest.encryptedWithHSM
(Boolean encryptedWithHSM) A boolean that indicates whether the snapshot data is encrypted using the HSM keys of the source cluster.engineFullVersion
(String engineFullVersion) The cluster version of the cluster used to create the snapshot.enhancedVpcRouting
(Boolean enhancedVpcRouting) An option that specifies whether to create the cluster with enhanced VPC routing enabled.estimatedSecondsToCompletion
(Long estimatedSecondsToCompletion) The estimate of the time remaining before the snapshot backup will complete.The Key Management Service (KMS) key ID of the encryption key that was used to encrypt data in the cluster from which the snapshot was taken.maintenanceTrackName
(String maintenanceTrackName) The name of the maintenance track for the snapshot.manualSnapshotRemainingDays
(Integer manualSnapshotRemainingDays) The number of days until a manual snapshot will pass its retention period.manualSnapshotRetentionPeriod
(Integer manualSnapshotRetentionPeriod) The number of days that a manual snapshot is retained.masterPasswordSecretArn
(String masterPasswordSecretArn) The Amazon Resource Name (ARN) for the cluster's admin user credentials secret.masterPasswordSecretKmsKeyId
(String masterPasswordSecretKmsKeyId) The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.masterUsername
(String masterUsername) The admin user name for the cluster.The node type of the nodes in the cluster.numberOfNodes
(Integer numberOfNodes) The number of nodes in the cluster.ownerAccount
(String ownerAccount) For manual snapshots, the Amazon Web Services account used to create or copy the snapshot.The port that the cluster is listening on.restorableNodeTypes
(String... restorableNodeTypes) The list of node types that this cluster snapshot is able to restore into.restorableNodeTypes
(Collection<String> restorableNodeTypes) The list of node types that this cluster snapshot is able to restore into.snapshotArn
(String snapshotArn) The Amazon Resource Name (ARN) of the snapshot.snapshotCreateTime
(Instant snapshotCreateTime) The time (in UTC format) when Amazon Redshift began the snapshot.snapshotIdentifier
(String snapshotIdentifier) The snapshot identifier that is provided in the request.snapshotRetentionStartTime
(Instant snapshotRetentionStartTime) A timestamp representing the start of the retention period for the snapshot.snapshotType
(String snapshotType) The snapshot type.sourceRegion
(String sourceRegion) The source region from which the snapshot was copied.The snapshot status.tags
(Collection<Tag> tags) The list of tags for the cluster snapshot.tags
(Consumer<Tag.Builder>... tags) The list of tags for the cluster snapshot.The list of tags for the cluster snapshot.totalBackupSizeInMegaBytes
(Double totalBackupSizeInMegaBytes) The size of the complete set of backup data that would be used to restore the cluster.The VPC identifier of the cluster if the snapshot is from a cluster in a VPC.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
snapshotIdentifier
The snapshot identifier that is provided in the request.
- Parameters:
snapshotIdentifier
- The snapshot identifier that is provided in the request.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
clusterIdentifier
The identifier of the cluster for which the snapshot was taken.
- Parameters:
clusterIdentifier
- The identifier of the cluster for which the snapshot was taken.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
snapshotCreateTime
The time (in UTC format) when Amazon Redshift began the snapshot. A snapshot contains a copy of the cluster data as of this exact time.
- Parameters:
snapshotCreateTime
- The time (in UTC format) when Amazon Redshift began the snapshot. A snapshot contains a copy of the cluster data as of this exact time.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
The snapshot status. The value of the status depends on the API operation used:
-
CreateClusterSnapshot and CopyClusterSnapshot returns status as "creating".
-
DescribeClusterSnapshots returns status as "creating", "available", "final snapshot", or "failed".
-
DeleteClusterSnapshot returns status as "deleted".
- Parameters:
status
- The snapshot status. The value of the status depends on the API operation used:-
CreateClusterSnapshot and CopyClusterSnapshot returns status as "creating".
-
DescribeClusterSnapshots returns status as "creating", "available", "final snapshot", or "failed".
-
DeleteClusterSnapshot returns status as "deleted".
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
port
The port that the cluster is listening on.
- Parameters:
port
- The port that the cluster is listening on.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
availabilityZone
The Availability Zone in which the cluster was created.
- Parameters:
availabilityZone
- The Availability Zone in which the cluster was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
clusterCreateTime
The time (UTC) when the cluster was originally created.
- Parameters:
clusterCreateTime
- The time (UTC) when the cluster was originally created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
masterUsername
The admin user name for the cluster.
- Parameters:
masterUsername
- The admin user name for the cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
clusterVersion
The version ID of the Amazon Redshift engine that is running on the cluster.
- Parameters:
clusterVersion
- The version ID of the Amazon Redshift engine that is running on the cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
engineFullVersion
The cluster version of the cluster used to create the snapshot. For example, 1.0.15503.
- Parameters:
engineFullVersion
- The cluster version of the cluster used to create the snapshot. For example, 1.0.15503.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
snapshotType
The snapshot type. Snapshots created using CreateClusterSnapshot and CopyClusterSnapshot are of type "manual".
- Parameters:
snapshotType
- The snapshot type. Snapshots created using CreateClusterSnapshot and CopyClusterSnapshot are of type "manual".- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
nodeType
The node type of the nodes in the cluster.
- Parameters:
nodeType
- The node type of the nodes in the cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
numberOfNodes
The number of nodes in the cluster.
- Parameters:
numberOfNodes
- The number of nodes in the cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
dbName
The name of the database that was created when the cluster was created.
- Parameters:
dbName
- The name of the database that was created when the cluster was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
vpcId
The VPC identifier of the cluster if the snapshot is from a cluster in a VPC. Otherwise, this field is not in the output.
- Parameters:
vpcId
- The VPC identifier of the cluster if the snapshot is from a cluster in a VPC. Otherwise, this field is not in the output.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
encrypted
If
true
, the data in the snapshot is encrypted at rest.- Parameters:
encrypted
- Iftrue
, the data in the snapshot is encrypted at rest.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
kmsKeyId
The Key Management Service (KMS) key ID of the encryption key that was used to encrypt data in the cluster from which the snapshot was taken.
- Parameters:
kmsKeyId
- The Key Management Service (KMS) key ID of the encryption key that was used to encrypt data in the cluster from which the snapshot was taken.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
encryptedWithHSM
A boolean that indicates whether the snapshot data is encrypted using the HSM keys of the source cluster.
true
indicates that the data is encrypted using HSM keys.- Parameters:
encryptedWithHSM
- A boolean that indicates whether the snapshot data is encrypted using the HSM keys of the source cluster.true
indicates that the data is encrypted using HSM keys.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accountsWithRestoreAccess
Snapshot.Builder accountsWithRestoreAccess(Collection<AccountWithRestoreAccess> accountsWithRestoreAccess) A list of the Amazon Web Services accounts authorized to restore the snapshot. Returns
null
if no accounts are authorized. Visible only to the snapshot owner.- Parameters:
accountsWithRestoreAccess
- A list of the Amazon Web Services accounts authorized to restore the snapshot. Returnsnull
if no accounts are authorized. Visible only to the snapshot owner.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accountsWithRestoreAccess
A list of the Amazon Web Services accounts authorized to restore the snapshot. Returns
null
if no accounts are authorized. Visible only to the snapshot owner.- Parameters:
accountsWithRestoreAccess
- A list of the Amazon Web Services accounts authorized to restore the snapshot. Returnsnull
if no accounts are authorized. Visible only to the snapshot owner.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accountsWithRestoreAccess
Snapshot.Builder accountsWithRestoreAccess(Consumer<AccountWithRestoreAccess.Builder>... accountsWithRestoreAccess) A list of the Amazon Web Services accounts authorized to restore the snapshot. Returns
This is a convenience method that creates an instance of thenull
if no accounts are authorized. Visible only to the snapshot owner.AccountWithRestoreAccess.Builder
avoiding the need to create one manually viaAccountWithRestoreAccess.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toaccountsWithRestoreAccess(List<AccountWithRestoreAccess>)
.- Parameters:
accountsWithRestoreAccess
- a consumer that will call methods onAccountWithRestoreAccess.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
ownerAccount
For manual snapshots, the Amazon Web Services account used to create or copy the snapshot. For automatic snapshots, the owner of the cluster. The owner can perform all snapshot actions, such as sharing a manual snapshot.
- Parameters:
ownerAccount
- For manual snapshots, the Amazon Web Services account used to create or copy the snapshot. For automatic snapshots, the owner of the cluster. The owner can perform all snapshot actions, such as sharing a manual snapshot.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
totalBackupSizeInMegaBytes
The size of the complete set of backup data that would be used to restore the cluster.
- Parameters:
totalBackupSizeInMegaBytes
- The size of the complete set of backup data that would be used to restore the cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
actualIncrementalBackupSizeInMegaBytes
Snapshot.Builder actualIncrementalBackupSizeInMegaBytes(Double actualIncrementalBackupSizeInMegaBytes) The size of the incremental backup.
- Parameters:
actualIncrementalBackupSizeInMegaBytes
- The size of the incremental backup.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
backupProgressInMegaBytes
The number of megabytes that have been transferred to the snapshot backup.
- Parameters:
backupProgressInMegaBytes
- The number of megabytes that have been transferred to the snapshot backup.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
currentBackupRateInMegaBytesPerSecond
Snapshot.Builder currentBackupRateInMegaBytesPerSecond(Double currentBackupRateInMegaBytesPerSecond) The number of megabytes per second being transferred to the snapshot backup. Returns
0
for a completed backup.- Parameters:
currentBackupRateInMegaBytesPerSecond
- The number of megabytes per second being transferred to the snapshot backup. Returns0
for a completed backup.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
estimatedSecondsToCompletion
The estimate of the time remaining before the snapshot backup will complete. Returns
0
for a completed backup.- Parameters:
estimatedSecondsToCompletion
- The estimate of the time remaining before the snapshot backup will complete. Returns0
for a completed backup.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
elapsedTimeInSeconds
The amount of time an in-progress snapshot backup has been running, or the amount of time it took a completed backup to finish.
- Parameters:
elapsedTimeInSeconds
- The amount of time an in-progress snapshot backup has been running, or the amount of time it took a completed backup to finish.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
sourceRegion
The source region from which the snapshot was copied.
- Parameters:
sourceRegion
- The source region from which the snapshot was copied.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The list of tags for the cluster snapshot.
- Parameters:
tags
- The list of tags for the cluster snapshot.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The list of tags for the cluster snapshot.
- Parameters:
tags
- The list of tags for the cluster snapshot.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
The list of tags for the cluster snapshot.
This is a convenience method that creates an instance of theTag.Builder
avoiding the need to create one manually viaTag.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed totags(List<Tag>)
.- Parameters:
tags
- a consumer that will call methods onTag.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
restorableNodeTypes
The list of node types that this cluster snapshot is able to restore into.
- Parameters:
restorableNodeTypes
- The list of node types that this cluster snapshot is able to restore into.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
restorableNodeTypes
The list of node types that this cluster snapshot is able to restore into.
- Parameters:
restorableNodeTypes
- The list of node types that this cluster snapshot is able to restore into.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
enhancedVpcRouting
An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.
If this option is
true
, enhanced VPC routing is enabled.Default: false
- Parameters:
enhancedVpcRouting
- An option that specifies whether to create the cluster with enhanced VPC routing enabled. To create a cluster that uses enhanced VPC routing, the cluster must be in a VPC. For more information, see Enhanced VPC Routing in the Amazon Redshift Cluster Management Guide.If this option is
true
, enhanced VPC routing is enabled.Default: false
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
maintenanceTrackName
The name of the maintenance track for the snapshot.
- Parameters:
maintenanceTrackName
- The name of the maintenance track for the snapshot.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
manualSnapshotRetentionPeriod
The number of days that a manual snapshot is retained. If the value is -1, the manual snapshot is retained indefinitely.
The value must be either -1 or an integer between 1 and 3,653.
- Parameters:
manualSnapshotRetentionPeriod
- The number of days that a manual snapshot is retained. If the value is -1, the manual snapshot is retained indefinitely.The value must be either -1 or an integer between 1 and 3,653.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
manualSnapshotRemainingDays
The number of days until a manual snapshot will pass its retention period.
- Parameters:
manualSnapshotRemainingDays
- The number of days until a manual snapshot will pass its retention period.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
snapshotRetentionStartTime
A timestamp representing the start of the retention period for the snapshot.
- Parameters:
snapshotRetentionStartTime
- A timestamp representing the start of the retention period for the snapshot.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
masterPasswordSecretArn
The Amazon Resource Name (ARN) for the cluster's admin user credentials secret.
- Parameters:
masterPasswordSecretArn
- The Amazon Resource Name (ARN) for the cluster's admin user credentials secret.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
masterPasswordSecretKmsKeyId
The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.
- Parameters:
masterPasswordSecretKmsKeyId
- The ID of the Key Management Service (KMS) key used to encrypt and store the cluster's admin credentials secret.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
snapshotArn
The Amazon Resource Name (ARN) of the snapshot.
- Parameters:
snapshotArn
- The Amazon Resource Name (ARN) of the snapshot.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-