@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)", date="2023-03-14T16:25:29.419Z") public class CfnDBParameterGroup extends CfnResource implements IInspectable
AWS::Neptune::DBParameterGroup
creates a new DB parameter group. This type can be declared in a template and referenced in the DBParameterGroupName
parameter of AWS::Neptune::DBInstance
.
Applying a parameter group to a DB instance might require the instance to reboot, resulting in a database outage for the duration of the reboot.
A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup . Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance . When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.
After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon Neptune to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the
character_set_database
parameter. You can use the Parameter Groups option of the Amazon Neptune console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.
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.neptune.*; Object parameters; CfnDBParameterGroup cfnDBParameterGroup = CfnDBParameterGroup.Builder.create(this, "MyCfnDBParameterGroup") .description("description") .family("family") .parameters(parameters) // the properties below are optional .name("name") .tags(List.of(CfnTag.builder() .key("key") .value("value") .build())) .build();
Modifier and Type | Class and Description |
---|---|
static class |
CfnDBParameterGroup.Builder
A fluent builder for
CfnDBParameterGroup . |
IInspectable.Jsii$Default, IInspectable.Jsii$Proxy
IConstruct.Jsii$Default
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
|
Modifier | Constructor and Description |
---|---|
|
CfnDBParameterGroup(Construct scope,
java.lang.String id,
CfnDBParameterGroupProps props)
Create a new `AWS::Neptune::DBParameterGroup`.
|
protected |
CfnDBParameterGroup(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) |
protected |
CfnDBParameterGroup(software.amazon.jsii.JsiiObjectRef objRef) |
Modifier and Type | Method and Description |
---|---|
protected java.util.Map<java.lang.String,java.lang.Object> |
getCfnProperties() |
java.lang.String |
getDescription()
Provides the customer-specified description for this DB parameter group.
|
java.lang.String |
getFamily()
Must be `neptune1` for engine versions prior to [1.2.0.0](https://docs.aws.amazon.com/neptune/latest/userguide/engine-releases-1.2.0.0.html) , or `neptune1.2` for engine version `1.2.0.0` and higher.
|
java.lang.String |
getName()
Provides the name of the DB parameter group.
|
java.lang.Object |
getParameters()
The parameters to set for this DB parameter group.
|
TagManager |
getTags()
The tags that you want to attach to this parameter group.
|
void |
inspect(TreeInspector inspector)
Examines the CloudFormation resource and discloses attributes.
|
protected java.util.Map<java.lang.String,java.lang.Object> |
renderProperties(java.util.Map<java.lang.String,java.lang.Object> props) |
void |
setDescription(java.lang.String value)
Provides the customer-specified description for this DB parameter group.
|
void |
setFamily(java.lang.String value)
Must be `neptune1` for engine versions prior to [1.2.0.0](https://docs.aws.amazon.com/neptune/latest/userguide/engine-releases-1.2.0.0.html) , or `neptune1.2` for engine version `1.2.0.0` and higher.
|
void |
setName(java.lang.String value)
Provides the name of the DB parameter group.
|
void |
setParameters(java.lang.Object value)
The parameters to set for this DB parameter group.
|
addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validateProperties
getRef
getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId
getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate
public static final java.lang.String CFN_RESOURCE_TYPE_NAME
protected CfnDBParameterGroup(software.amazon.jsii.JsiiObjectRef objRef)
protected CfnDBParameterGroup(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
public CfnDBParameterGroup(Construct scope, java.lang.String id, CfnDBParameterGroupProps 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. This parameter is required.public void inspect(TreeInspector inspector)
inspect
in interface IInspectable
inspector
- - tree inspector to collect and process attributes. This parameter is required.protected java.util.Map<java.lang.String,java.lang.Object> renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)
renderProperties
in class CfnResource
props
- This parameter is required.protected java.util.Map<java.lang.String,java.lang.Object> getCfnProperties()
getCfnProperties
in class CfnResource
public TagManager getTags()
public java.lang.String getDescription()
public void setDescription(java.lang.String value)
public java.lang.String getFamily()
public void setFamily(java.lang.String value)
public java.lang.Object getParameters()
The parameters are expressed as a JSON object consisting of key-value pairs.
Changes to dynamic parameters are applied immediately. During an update, if you have static parameters (whether they were changed or not), it triggers AWS CloudFormation to reboot the associated DB instance without failover.
public void setParameters(java.lang.Object value)
The parameters are expressed as a JSON object consisting of key-value pairs.
Changes to dynamic parameters are applied immediately. During an update, if you have static parameters (whether they were changed or not), it triggers AWS CloudFormation to reboot the associated DB instance without failover.
public java.lang.String getName()
public void setName(java.lang.String value)