@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)", date="2022-09-19T20:26:38.011Z") @Stability(value=Stable) public class CfnDBCluster extends CfnResource implements IInspectable
The AWS::DocDB::DBCluster Amazon DocumentDB (with MongoDB compatibility) resource describes a DBCluster. Amazon DocumentDB is a fully managed, MongoDB-compatible document database engine. For more information, see DBCluster in the Amazon DocumentDB Developer Guide .
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.docdb.*;
CfnDBCluster cfnDBCluster = CfnDBCluster.Builder.create(this, "MyCfnDBCluster")
.availabilityZones(List.of("availabilityZones"))
.backupRetentionPeriod(123)
.copyTagsToSnapshot(false)
.dbClusterIdentifier("dbClusterIdentifier")
.dbClusterParameterGroupName("dbClusterParameterGroupName")
.dbSubnetGroupName("dbSubnetGroupName")
.deletionProtection(false)
.enableCloudwatchLogsExports(List.of("enableCloudwatchLogsExports"))
.engineVersion("engineVersion")
.kmsKeyId("kmsKeyId")
.masterUsername("masterUsername")
.masterUserPassword("masterUserPassword")
.port(123)
.preferredBackupWindow("preferredBackupWindow")
.preferredMaintenanceWindow("preferredMaintenanceWindow")
.restoreToTime("restoreToTime")
.restoreType("restoreType")
.snapshotIdentifier("snapshotIdentifier")
.sourceDbClusterIdentifier("sourceDbClusterIdentifier")
.storageEncrypted(false)
.tags(List.of(CfnTag.builder()
.key("key")
.value("value")
.build()))
.useLatestRestorableTime(false)
.vpcSecurityGroupIds(List.of("vpcSecurityGroupIds"))
.build();
| Modifier and Type | Class and Description |
|---|---|
static class |
CfnDBCluster.Builder
A fluent builder for
CfnDBCluster. |
software.amazon.jsii.JsiiObject.InitializationModeIInspectable.Jsii$Default, IInspectable.Jsii$Proxy| Modifier and Type | Field and Description |
|---|---|
static String |
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
|
| Modifier | Constructor and Description |
|---|---|
|
CfnDBCluster(software.constructs.Construct scope,
String id)
Create a new `AWS::DocDB::DBCluster`.
|
|
CfnDBCluster(software.constructs.Construct scope,
String id,
CfnDBClusterProps props)
Create a new `AWS::DocDB::DBCluster`.
|
protected |
CfnDBCluster(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) |
protected |
CfnDBCluster(software.amazon.jsii.JsiiObjectRef objRef) |
| Modifier and Type | Method and Description |
|---|---|
String |
getAttrClusterResourceId()
The resource id for the cluster;
|
String |
getAttrEndpoint()
The connection endpoint for the cluster, such as `sample-cluster.cluster-cozrlsfrcjoc.us-east-1.docdb.amazonaws.com` .
|
String |
getAttrPort()
The port number on which the cluster accepts connections.
|
String |
getAttrReadEndpoint()
The reader endpoint for the cluster.
|
List<String> |
getAvailabilityZones()
A list of Amazon EC2 Availability Zones that instances in the cluster can be created in.
|
Number |
getBackupRetentionPeriod()
The number of days for which automated backups are retained.
|
protected Map<String,Object> |
getCfnProperties() |
Object |
getCopyTagsToSnapshot()
`AWS::DocDB::DBCluster.CopyTagsToSnapshot`.
|
String |
getDbClusterIdentifier()
The cluster identifier.
|
String |
getDbClusterParameterGroupName()
The name of the cluster parameter group to associate with this cluster.
|
String |
getDbSubnetGroupName()
A subnet group to associate with this cluster.
|
Object |
getDeletionProtection()
Protects clusters from being accidentally deleted.
|
List<String> |
getEnableCloudwatchLogsExports()
The list of log types that need to be enabled for exporting to Amazon CloudWatch Logs.
|
String |
getEngineVersion()
The version number of the database engine to use.
|
String |
getKmsKeyId()
The AWS KMS key identifier for an encrypted cluster.
|
String |
getMasterUsername()
The name of the master user for the cluster.
|
String |
getMasterUserPassword()
The password for the master database user.
|
Number |
getPort()
Specifies the port that the database engine is listening on.
|
String |
getPreferredBackupWindow()
The daily time range during which automated backups are created if automated backups are enabled using the `BackupRetentionPeriod` parameter.
|
String |
getPreferredMaintenanceWindow()
The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
|
String |
getRestoreToTime()
`AWS::DocDB::DBCluster.RestoreToTime`.
|
String |
getRestoreType()
`AWS::DocDB::DBCluster.RestoreType`.
|
String |
getSnapshotIdentifier()
The identifier for the snapshot or cluster snapshot to restore from.
|
String |
getSourceDbClusterIdentifier()
`AWS::DocDB::DBCluster.SourceDBClusterIdentifier`.
|
Object |
getStorageEncrypted()
Specifies whether the cluster is encrypted.
|
TagManager |
getTags()
The tags to be assigned to the cluster.
|
Object |
getUseLatestRestorableTime()
`AWS::DocDB::DBCluster.UseLatestRestorableTime`.
|
List<String> |
getVpcSecurityGroupIds()
A list of EC2 VPC security groups to associate with this cluster.
|
void |
inspect(TreeInspector inspector)
Examines the CloudFormation resource and discloses attributes.
|
protected Map<String,Object> |
renderProperties(Map<String,Object> props) |
void |
setAvailabilityZones(List<String> value)
A list of Amazon EC2 Availability Zones that instances in the cluster can be created in.
|
void |
setBackupRetentionPeriod(Number value)
The number of days for which automated backups are retained.
|
void |
setCopyTagsToSnapshot(Boolean value)
`AWS::DocDB::DBCluster.CopyTagsToSnapshot`.
|
void |
setCopyTagsToSnapshot(IResolvable value)
`AWS::DocDB::DBCluster.CopyTagsToSnapshot`.
|
void |
setDbClusterIdentifier(String value)
The cluster identifier.
|
void |
setDbClusterParameterGroupName(String value)
The name of the cluster parameter group to associate with this cluster.
|
void |
setDbSubnetGroupName(String value)
A subnet group to associate with this cluster.
|
void |
setDeletionProtection(Boolean value)
Protects clusters from being accidentally deleted.
|
void |
setDeletionProtection(IResolvable value)
Protects clusters from being accidentally deleted.
|
void |
setEnableCloudwatchLogsExports(List<String> value)
The list of log types that need to be enabled for exporting to Amazon CloudWatch Logs.
|
void |
setEngineVersion(String value)
The version number of the database engine to use.
|
void |
setKmsKeyId(String value)
The AWS KMS key identifier for an encrypted cluster.
|
void |
setMasterUsername(String value)
The name of the master user for the cluster.
|
void |
setMasterUserPassword(String value)
The password for the master database user.
|
void |
setPort(Number value)
Specifies the port that the database engine is listening on.
|
void |
setPreferredBackupWindow(String value)
The daily time range during which automated backups are created if automated backups are enabled using the `BackupRetentionPeriod` parameter.
|
void |
setPreferredMaintenanceWindow(String value)
The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
|
void |
setRestoreToTime(String value)
`AWS::DocDB::DBCluster.RestoreToTime`.
|
void |
setRestoreType(String value)
`AWS::DocDB::DBCluster.RestoreType`.
|
void |
setSnapshotIdentifier(String value)
The identifier for the snapshot or cluster snapshot to restore from.
|
void |
setSourceDbClusterIdentifier(String value)
`AWS::DocDB::DBCluster.SourceDBClusterIdentifier`.
|
void |
setStorageEncrypted(Boolean value)
Specifies whether the cluster is encrypted.
|
void |
setStorageEncrypted(IResolvable value)
Specifies whether the cluster is encrypted.
|
void |
setUseLatestRestorableTime(Boolean value)
`AWS::DocDB::DBCluster.UseLatestRestorableTime`.
|
void |
setUseLatestRestorableTime(IResolvable value)
`AWS::DocDB::DBCluster.UseLatestRestorableTime`.
|
void |
setVpcSecurityGroupIds(List<String> value)
A list of EC2 VPC security groups to associate with this cluster.
|
addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, shouldSynthesize, toString, validatePropertiesgetRefgetCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalIdjsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet@Stability(value=Stable) public static final String CFN_RESOURCE_TYPE_NAME
protected CfnDBCluster(software.amazon.jsii.JsiiObjectRef objRef)
protected CfnDBCluster(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
@Stability(value=Stable)
public CfnDBCluster(@NotNull
software.constructs.Construct scope,
@NotNull
String id,
@Nullable
CfnDBClusterProps props)
scope - - scope in which this resource is defined. This parameter is required.id - - scoped id of the resource. This parameter is required.props - - resource properties.@Stability(value=Stable)
public CfnDBCluster(@NotNull
software.constructs.Construct scope,
@NotNull
String id)
scope - - scope in which this resource is defined. This parameter is required.id - - scoped id of the resource. This parameter is required.@Stability(value=Stable)
public void inspect(@NotNull
TreeInspector inspector)
inspect in interface IInspectableinspector - - tree inspector to collect and process attributes. This parameter is required.@Stability(value=Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
renderProperties in class CfnResourceprops - This parameter is required.@Stability(value=Stable) @NotNull public String getAttrClusterResourceId()
for example: cluster-ABCD1234EFGH5678IJKL90MNOP . The cluster ID uniquely identifies the cluster and is used in things like IAM authentication policies.
@Stability(value=Stable) @NotNull public String getAttrEndpoint()
@Stability(value=Stable) @NotNull public String getAttrPort()
For example: 27017 .
@Stability(value=Stable) @NotNull public String getAttrReadEndpoint()
For example: sample-cluster.cluster-ro-cozrlsfrcjoc.us-east-1.docdb.amazonaws.com .
@Stability(value=Stable) @NotNull protected Map<String,Object> getCfnProperties()
getCfnProperties in class CfnResource@Stability(value=Stable) @NotNull public TagManager getTags()
@Stability(value=Stable) @Nullable public List<String> getAvailabilityZones()
@Stability(value=Stable)
public void setAvailabilityZones(@Nullable
List<String> value)
@Stability(value=Stable) @Nullable public Number getBackupRetentionPeriod()
Default: 1
Constraints:
@Stability(value=Stable)
public void setBackupRetentionPeriod(@Nullable
Number value)
Default: 1
Constraints:
@Stability(value=Stable) @Nullable public Object getCopyTagsToSnapshot()
@Stability(value=Stable)
public void setCopyTagsToSnapshot(@Nullable
Boolean value)
@Stability(value=Stable)
public void setCopyTagsToSnapshot(@Nullable
IResolvable value)
@Stability(value=Stable) @Nullable public String getDbClusterIdentifier()
Constraints:
Example: my-cluster
@Stability(value=Stable)
public void setDbClusterIdentifier(@Nullable
String value)
Constraints:
Example: my-cluster
@Stability(value=Stable) @Nullable public String getDbClusterParameterGroupName()
@Stability(value=Stable)
public void setDbClusterParameterGroupName(@Nullable
String value)
@Stability(value=Stable) @Nullable public String getDbSubnetGroupName()
Constraints: Must match the name of an existing DBSubnetGroup . Must not be default.
Example: mySubnetgroup
@Stability(value=Stable)
public void setDbSubnetGroupName(@Nullable
String value)
Constraints: Must match the name of an existing DBSubnetGroup . Must not be default.
Example: mySubnetgroup
@Stability(value=Stable) @Nullable public Object getDeletionProtection()
If enabled, the cluster cannot be deleted unless it is modified and DeletionProtection is disabled.
@Stability(value=Stable)
public void setDeletionProtection(@Nullable
Boolean value)
If enabled, the cluster cannot be deleted unless it is modified and DeletionProtection is disabled.
@Stability(value=Stable)
public void setDeletionProtection(@Nullable
IResolvable value)
If enabled, the cluster cannot be deleted unless it is modified and DeletionProtection is disabled.
@Stability(value=Stable) @Nullable public List<String> getEnableCloudwatchLogsExports()
You can enable audit logs or profiler logs. For more information, see Auditing Amazon DocumentDB Events and Profiling Amazon DocumentDB Operations .
@Stability(value=Stable)
public void setEnableCloudwatchLogsExports(@Nullable
List<String> value)
You can enable audit logs or profiler logs. For more information, see Auditing Amazon DocumentDB Events and Profiling Amazon DocumentDB Operations .
@Stability(value=Stable) @Nullable public String getEngineVersion()
The --engine-version will default to the latest major engine version. For production workloads, we recommend explicitly declaring this parameter with the intended major engine version.
@Stability(value=Stable)
public void setEngineVersion(@Nullable
String value)
The --engine-version will default to the latest major engine version. For production workloads, we recommend explicitly declaring this parameter with the intended major engine version.
@Stability(value=Stable) @Nullable public String getKmsKeyId()
The AWS KMS key identifier is the Amazon Resource Name (ARN) for the AWS KMS encryption key. If you are creating a cluster using the same AWS account that owns the AWS KMS encryption key that is used to encrypt the new cluster, you can use the AWS KMS key alias instead of the ARN for the AWS KMS encryption key.
If an encryption key is not specified in KmsKeyId :
StorageEncrypted parameter is true , Amazon DocumentDB uses your default encryption key.AWS KMS creates the default encryption key for your AWS account . Your AWS account has a different default encryption key for each AWS Regions .
@Stability(value=Stable)
public void setKmsKeyId(@Nullable
String value)
The AWS KMS key identifier is the Amazon Resource Name (ARN) for the AWS KMS encryption key. If you are creating a cluster using the same AWS account that owns the AWS KMS encryption key that is used to encrypt the new cluster, you can use the AWS KMS key alias instead of the ARN for the AWS KMS encryption key.
If an encryption key is not specified in KmsKeyId :
StorageEncrypted parameter is true , Amazon DocumentDB uses your default encryption key.AWS KMS creates the default encryption key for your AWS account . Your AWS account has a different default encryption key for each AWS Regions .
@Stability(value=Stable) @Nullable public String getMasterUsername()
Constraints:
@Stability(value=Stable)
public void setMasterUsername(@Nullable
String value)
Constraints:
@Stability(value=Stable) @Nullable public String getMasterUserPassword()
This password can contain any printable ASCII character except forward slash (/), double quote ("), or the "at" symbol (@).
Constraints: Must contain from 8 to 100 characters.
@Stability(value=Stable)
public void setMasterUserPassword(@Nullable
String value)
This password can contain any printable ASCII character except forward slash (/), double quote ("), or the "at" symbol (@).
Constraints: Must contain from 8 to 100 characters.
@Stability(value=Stable) @Nullable public Number getPort()
@Stability(value=Stable)
public void setPort(@Nullable
Number value)
@Stability(value=Stable) @Nullable public String getPreferredBackupWindow()
The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region .
Constraints:
hh24:mi-hh24:mi .@Stability(value=Stable)
public void setPreferredBackupWindow(@Nullable
String value)
The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region .
Constraints:
hh24:mi-hh24:mi .@Stability(value=Stable) @Nullable public String getPreferredMaintenanceWindow()
Format: ddd:hh24:mi-ddd:hh24:mi
The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
@Stability(value=Stable)
public void setPreferredMaintenanceWindow(@Nullable
String value)
Format: ddd:hh24:mi-ddd:hh24:mi
The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints: Minimum 30-minute window.
@Stability(value=Stable) @Nullable public String getRestoreToTime()
@Stability(value=Stable)
public void setRestoreToTime(@Nullable
String value)
@Stability(value=Stable) @Nullable public String getRestoreType()
@Stability(value=Stable)
public void setRestoreType(@Nullable
String value)
@Stability(value=Stable) @Nullable public String getSnapshotIdentifier()
You can use either the name or the Amazon Resource Name (ARN) to specify a cluster snapshot. However, you can use only the ARN to specify a snapshot.
Constraints:
@Stability(value=Stable)
public void setSnapshotIdentifier(@Nullable
String value)
You can use either the name or the Amazon Resource Name (ARN) to specify a cluster snapshot. However, you can use only the ARN to specify a snapshot.
Constraints:
@Stability(value=Stable) @Nullable public String getSourceDbClusterIdentifier()
@Stability(value=Stable)
public void setSourceDbClusterIdentifier(@Nullable
String value)
@Stability(value=Stable) @Nullable public Object getStorageEncrypted()
@Stability(value=Stable)
public void setStorageEncrypted(@Nullable
Boolean value)
@Stability(value=Stable)
public void setStorageEncrypted(@Nullable
IResolvable value)
@Stability(value=Stable) @Nullable public Object getUseLatestRestorableTime()
@Stability(value=Stable)
public void setUseLatestRestorableTime(@Nullable
Boolean value)
@Stability(value=Stable)
public void setUseLatestRestorableTime(@Nullable
IResolvable value)
@Stability(value=Stable) @Nullable public List<String> getVpcSecurityGroupIds()
Copyright © 2022. All rights reserved.