Class RestoreDbClusterToPointInTimeRequest
- java.lang.Object
-
- software.amazon.awssdk.core.SdkRequest
-
- software.amazon.awssdk.awscore.AwsRequest
-
- software.amazon.awssdk.services.docdb.model.DocDbRequest
-
- software.amazon.awssdk.services.docdb.model.RestoreDbClusterToPointInTimeRequest
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<RestoreDbClusterToPointInTimeRequest.Builder,RestoreDbClusterToPointInTimeRequest>
@Generated("software.amazon.awssdk:codegen") public final class RestoreDbClusterToPointInTimeRequest extends DocDbRequest implements ToCopyableBuilder<RestoreDbClusterToPointInTimeRequest.Builder,RestoreDbClusterToPointInTimeRequest>
Represents the input to RestoreDBClusterToPointInTime.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceRestoreDbClusterToPointInTimeRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static RestoreDbClusterToPointInTimeRequest.Builderbuilder()StringdbClusterIdentifier()The name of the new cluster to be created.StringdbSubnetGroupName()The subnet group name to use for the new cluster.BooleandeletionProtection()Specifies whether this cluster can be deleted.List<String>enableCloudwatchLogsExports()A list of log types that must be enabled for exporting to Amazon CloudWatch Logs.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasEnableCloudwatchLogsExports()For responses, this returns true if the service returned a value for the EnableCloudwatchLogsExports property.inthashCode()booleanhasTags()For responses, this returns true if the service returned a value for the Tags property.booleanhasVpcSecurityGroupIds()For responses, this returns true if the service returned a value for the VpcSecurityGroupIds property.StringkmsKeyId()The KMS key identifier to use when restoring an encrypted cluster from an encrypted cluster.Integerport()The port number on which the new cluster accepts connections.InstantrestoreToTime()The date and time to restore the cluster to.StringrestoreType()The type of restore to be performed.List<SdkField<?>>sdkFields()static Class<? extends RestoreDbClusterToPointInTimeRequest.Builder>serializableBuilderClass()StringsourceDBClusterIdentifier()The identifier of the source cluster from which to restore.StringstorageType()The storage type to associate with the DB cluster.List<Tag>tags()The tags to be assigned to the restored cluster.RestoreDbClusterToPointInTimeRequest.BuildertoBuilder()StringtoString()Returns a string representation of this object.BooleanuseLatestRestorableTime()A value that is set totrueto restore the cluster to the latest restorable backup time, andfalseotherwise.List<String>vpcSecurityGroupIds()A list of VPC security groups that the new cluster belongs to.-
Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
dbClusterIdentifier
public final String dbClusterIdentifier()
The name of the new cluster to be created.
Constraints:
-
Must contain from 1 to 63 letters, numbers, or hyphens.
-
The first character must be a letter.
-
Cannot end with a hyphen or contain two consecutive hyphens.
- Returns:
- The name of the new cluster to be created.
Constraints:
-
Must contain from 1 to 63 letters, numbers, or hyphens.
-
The first character must be a letter.
-
Cannot end with a hyphen or contain two consecutive hyphens.
-
-
-
restoreType
public final String restoreType()
The type of restore to be performed. You can specify one of the following values:
-
full-copy- The new DB cluster is restored as a full copy of the source DB cluster. -
copy-on-write- The new DB cluster is restored as a clone of the source DB cluster.
Constraints: You can't specify
copy-on-writeif the engine version of the source DB cluster is earlier than 1.11.If you don't specify a
RestoreTypevalue, then the new DB cluster is restored as a full copy of the source DB cluster.- Returns:
- The type of restore to be performed. You can specify one of the following values:
-
full-copy- The new DB cluster is restored as a full copy of the source DB cluster. -
copy-on-write- The new DB cluster is restored as a clone of the source DB cluster.
Constraints: You can't specify
copy-on-writeif the engine version of the source DB cluster is earlier than 1.11.If you don't specify a
RestoreTypevalue, then the new DB cluster is restored as a full copy of the source DB cluster. -
-
-
sourceDBClusterIdentifier
public final String sourceDBClusterIdentifier()
The identifier of the source cluster from which to restore.
Constraints:
-
Must match the identifier of an existing
DBCluster.
- Returns:
- The identifier of the source cluster from which to restore.
Constraints:
-
Must match the identifier of an existing
DBCluster.
-
-
-
restoreToTime
public final Instant restoreToTime()
The date and time to restore the cluster to.
Valid values: A time in Universal Coordinated Time (UTC) format.
Constraints:
-
Must be before the latest restorable time for the instance.
-
Must be specified if the
UseLatestRestorableTimeparameter is not provided. -
Cannot be specified if the
UseLatestRestorableTimeparameter istrue. -
Cannot be specified if the
RestoreTypeparameter iscopy-on-write.
Example:
2015-03-07T23:45:00Z- Returns:
- The date and time to restore the cluster to.
Valid values: A time in Universal Coordinated Time (UTC) format.
Constraints:
-
Must be before the latest restorable time for the instance.
-
Must be specified if the
UseLatestRestorableTimeparameter is not provided. -
Cannot be specified if the
UseLatestRestorableTimeparameter istrue. -
Cannot be specified if the
RestoreTypeparameter iscopy-on-write.
Example:
2015-03-07T23:45:00Z -
-
-
useLatestRestorableTime
public final Boolean useLatestRestorableTime()
A value that is set to
trueto restore the cluster to the latest restorable backup time, andfalseotherwise.Default:
falseConstraints: Cannot be specified if the
RestoreToTimeparameter is provided.- Returns:
- A value that is set to
trueto restore the cluster to the latest restorable backup time, andfalseotherwise.Default:
falseConstraints: Cannot be specified if the
RestoreToTimeparameter is provided.
-
port
public final Integer port()
The port number on which the new cluster accepts connections.
Constraints: Must be a value from
1150to65535.Default: The default port for the engine.
- Returns:
- The port number on which the new cluster accepts connections.
Constraints: Must be a value from
1150to65535.Default: The default port for the engine.
-
dbSubnetGroupName
public final String dbSubnetGroupName()
The subnet group name to use for the new cluster.
Constraints: If provided, must match the name of an existing
DBSubnetGroup.Example:
mySubnetgroup- Returns:
- The subnet group name to use for the new cluster.
Constraints: If provided, must match the name of an existing
DBSubnetGroup.Example:
mySubnetgroup
-
hasVpcSecurityGroupIds
public final boolean hasVpcSecurityGroupIds()
For responses, this returns true if the service returned a value for the VpcSecurityGroupIds property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
vpcSecurityGroupIds
public final List<String> vpcSecurityGroupIds()
A list of VPC security groups that the new cluster belongs to.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasVpcSecurityGroupIds()method.- Returns:
- A list of VPC security groups that the new cluster belongs to.
-
hasTags
public final boolean hasTags()
For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
tags
public final List<Tag> tags()
The tags to be assigned to the restored cluster.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTags()method.- Returns:
- The tags to be assigned to the restored cluster.
-
kmsKeyId
public final String kmsKeyId()
The KMS key identifier to use when restoring an encrypted cluster from an encrypted cluster.
The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a cluster with the same Amazon Web Services account that owns the KMS encryption key used to encrypt the new cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.
You can restore to a new cluster and encrypt the new cluster with an KMS key that is different from the KMS key used to encrypt the source cluster. The new DB cluster is encrypted with the KMS key identified by the
KmsKeyIdparameter.If you do not specify a value for the
KmsKeyIdparameter, then the following occurs:-
If the cluster is encrypted, then the restored cluster is encrypted using the KMS key that was used to encrypt the source cluster.
-
If the cluster is not encrypted, then the restored cluster is not encrypted.
If
DBClusterIdentifierrefers to a cluster that is not encrypted, then the restore request is rejected.- Returns:
- The KMS key identifier to use when restoring an encrypted cluster from an encrypted cluster.
The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are restoring a cluster with the same Amazon Web Services account that owns the KMS encryption key used to encrypt the new cluster, then you can use the KMS key alias instead of the ARN for the KMS encryption key.
You can restore to a new cluster and encrypt the new cluster with an KMS key that is different from the KMS key used to encrypt the source cluster. The new DB cluster is encrypted with the KMS key identified by the
KmsKeyIdparameter.If you do not specify a value for the
KmsKeyIdparameter, then the following occurs:-
If the cluster is encrypted, then the restored cluster is encrypted using the KMS key that was used to encrypt the source cluster.
-
If the cluster is not encrypted, then the restored cluster is not encrypted.
If
DBClusterIdentifierrefers to a cluster that is not encrypted, then the restore request is rejected. -
-
-
hasEnableCloudwatchLogsExports
public final boolean hasEnableCloudwatchLogsExports()
For responses, this returns true if the service returned a value for the EnableCloudwatchLogsExports property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
enableCloudwatchLogsExports
public final List<String> enableCloudwatchLogsExports()
A list of log types that must be enabled for exporting to Amazon CloudWatch Logs.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasEnableCloudwatchLogsExports()method.- Returns:
- A list of log types that must be enabled for exporting to Amazon CloudWatch Logs.
-
deletionProtection
public final Boolean deletionProtection()
Specifies whether this cluster can be deleted. If
DeletionProtectionis enabled, the cluster cannot be deleted unless it is modified andDeletionProtectionis disabled.DeletionProtectionprotects clusters from being accidentally deleted.- Returns:
- Specifies whether this cluster can be deleted. If
DeletionProtectionis enabled, the cluster cannot be deleted unless it is modified andDeletionProtectionis disabled.DeletionProtectionprotects clusters from being accidentally deleted.
-
storageType
public final String storageType()
The storage type to associate with the DB cluster.
For information on storage types for Amazon DocumentDB clusters, see Cluster storage configurations in the Amazon DocumentDB Developer Guide.
Valid values for storage type -
standard | iopt1Default value is
standard- Returns:
- The storage type to associate with the DB cluster.
For information on storage types for Amazon DocumentDB clusters, see Cluster storage configurations in the Amazon DocumentDB Developer Guide.
Valid values for storage type -
standard | iopt1Default value is
standard
-
toBuilder
public RestoreDbClusterToPointInTimeRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<RestoreDbClusterToPointInTimeRequest.Builder,RestoreDbClusterToPointInTimeRequest>- Specified by:
toBuilderin classDocDbRequest
-
builder
public static RestoreDbClusterToPointInTimeRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends RestoreDbClusterToPointInTimeRequest.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCodein classAwsRequest
-
equals
public final boolean equals(Object obj)
- Overrides:
equalsin classAwsRequest
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
getValueForField
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForFieldin classSdkRequest
-
-