We recommend new projects start with resources from the AWS provider.
aws-native.rds.DbClusterParameterGroup
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
The AWS::RDS::DBClusterParameterGroup
resource creates a new Amazon RDS DB cluster parameter group.
For information about configuring parameters for Amazon Aurora DB clusters, see Working with parameter groups in the Amazon Aurora User Guide.
If you apply a parameter group to a DB cluster, then its DB instances might need to reboot. This can result in an outage while the DB instances are rebooting.
If you apply a change to parameter group associated with a stopped DB cluster, then the updated stack waits until the DB cluster is started.
Create DbClusterParameterGroup Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DbClusterParameterGroup(name: string, args: DbClusterParameterGroupArgs, opts?: CustomResourceOptions);
@overload
def DbClusterParameterGroup(resource_name: str,
args: DbClusterParameterGroupArgs,
opts: Optional[ResourceOptions] = None)
@overload
def DbClusterParameterGroup(resource_name: str,
opts: Optional[ResourceOptions] = None,
description: Optional[str] = None,
family: Optional[str] = None,
parameters: Optional[Any] = None,
db_cluster_parameter_group_name: Optional[str] = None,
tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
func NewDbClusterParameterGroup(ctx *Context, name string, args DbClusterParameterGroupArgs, opts ...ResourceOption) (*DbClusterParameterGroup, error)
public DbClusterParameterGroup(string name, DbClusterParameterGroupArgs args, CustomResourceOptions? opts = null)
public DbClusterParameterGroup(String name, DbClusterParameterGroupArgs args)
public DbClusterParameterGroup(String name, DbClusterParameterGroupArgs args, CustomResourceOptions options)
type: aws-native:rds:DbClusterParameterGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DbClusterParameterGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DbClusterParameterGroupArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DbClusterParameterGroupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DbClusterParameterGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DbClusterParameterGroupArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
DbClusterParameterGroup Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The DbClusterParameterGroup resource accepts the following input properties:
- Description string
- The description for the DB cluster parameter group.
- Family string
- The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.
Aurora MySQL
Example:
aurora-mysql5.7
,aurora-mysql8.0
Aurora PostgreSQL Example:aurora-postgresql14
RDS for MySQL Example:mysql8.0
RDS for PostgreSQL Example:postgres13
To list all of the available parameter group families for a DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine <engine>
For example, to list all of the available parameter group families for the Aurora PostgreSQL DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine aurora-postgresql
The output contains duplicates. The following are the valid DB engine values:aurora-mysql
aurora-postgresql
mysql
postgres
- Parameters object
Provides a list of parameters for the DB cluster parameter group.
Search the CloudFormation User Guide for
AWS::RDS::DBClusterParameterGroup
for more information about the expected schema for this property.- Db
Cluster stringParameter Group Name The name of the DB cluster parameter group. Constraints:
- Must not match the name of an existing DB cluster parameter group.
This value is stored as a lowercase string.
- List<Pulumi.
Aws Native. Inputs. Tag> - Tags to assign to the DB cluster parameter group.
- Description string
- The description for the DB cluster parameter group.
- Family string
- The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.
Aurora MySQL
Example:
aurora-mysql5.7
,aurora-mysql8.0
Aurora PostgreSQL Example:aurora-postgresql14
RDS for MySQL Example:mysql8.0
RDS for PostgreSQL Example:postgres13
To list all of the available parameter group families for a DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine <engine>
For example, to list all of the available parameter group families for the Aurora PostgreSQL DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine aurora-postgresql
The output contains duplicates. The following are the valid DB engine values:aurora-mysql
aurora-postgresql
mysql
postgres
- Parameters interface{}
Provides a list of parameters for the DB cluster parameter group.
Search the CloudFormation User Guide for
AWS::RDS::DBClusterParameterGroup
for more information about the expected schema for this property.- Db
Cluster stringParameter Group Name The name of the DB cluster parameter group. Constraints:
- Must not match the name of an existing DB cluster parameter group.
This value is stored as a lowercase string.
- Tag
Args - Tags to assign to the DB cluster parameter group.
- description String
- The description for the DB cluster parameter group.
- family String
- The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.
Aurora MySQL
Example:
aurora-mysql5.7
,aurora-mysql8.0
Aurora PostgreSQL Example:aurora-postgresql14
RDS for MySQL Example:mysql8.0
RDS for PostgreSQL Example:postgres13
To list all of the available parameter group families for a DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine <engine>
For example, to list all of the available parameter group families for the Aurora PostgreSQL DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine aurora-postgresql
The output contains duplicates. The following are the valid DB engine values:aurora-mysql
aurora-postgresql
mysql
postgres
- parameters Object
Provides a list of parameters for the DB cluster parameter group.
Search the CloudFormation User Guide for
AWS::RDS::DBClusterParameterGroup
for more information about the expected schema for this property.- db
Cluster StringParameter Group Name The name of the DB cluster parameter group. Constraints:
- Must not match the name of an existing DB cluster parameter group.
This value is stored as a lowercase string.
- List<Tag>
- Tags to assign to the DB cluster parameter group.
- description string
- The description for the DB cluster parameter group.
- family string
- The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.
Aurora MySQL
Example:
aurora-mysql5.7
,aurora-mysql8.0
Aurora PostgreSQL Example:aurora-postgresql14
RDS for MySQL Example:mysql8.0
RDS for PostgreSQL Example:postgres13
To list all of the available parameter group families for a DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine <engine>
For example, to list all of the available parameter group families for the Aurora PostgreSQL DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine aurora-postgresql
The output contains duplicates. The following are the valid DB engine values:aurora-mysql
aurora-postgresql
mysql
postgres
- parameters any
Provides a list of parameters for the DB cluster parameter group.
Search the CloudFormation User Guide for
AWS::RDS::DBClusterParameterGroup
for more information about the expected schema for this property.- db
Cluster stringParameter Group Name The name of the DB cluster parameter group. Constraints:
- Must not match the name of an existing DB cluster parameter group.
This value is stored as a lowercase string.
- Tag[]
- Tags to assign to the DB cluster parameter group.
- description str
- The description for the DB cluster parameter group.
- family str
- The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.
Aurora MySQL
Example:
aurora-mysql5.7
,aurora-mysql8.0
Aurora PostgreSQL Example:aurora-postgresql14
RDS for MySQL Example:mysql8.0
RDS for PostgreSQL Example:postgres13
To list all of the available parameter group families for a DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine <engine>
For example, to list all of the available parameter group families for the Aurora PostgreSQL DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine aurora-postgresql
The output contains duplicates. The following are the valid DB engine values:aurora-mysql
aurora-postgresql
mysql
postgres
- parameters Any
Provides a list of parameters for the DB cluster parameter group.
Search the CloudFormation User Guide for
AWS::RDS::DBClusterParameterGroup
for more information about the expected schema for this property.- db_
cluster_ strparameter_ group_ name The name of the DB cluster parameter group. Constraints:
- Must not match the name of an existing DB cluster parameter group.
This value is stored as a lowercase string.
- Sequence[Tag
Args] - Tags to assign to the DB cluster parameter group.
- description String
- The description for the DB cluster parameter group.
- family String
- The DB cluster parameter group family name. A DB cluster parameter group can be associated with one and only one DB cluster parameter group family, and can be applied only to a DB cluster running a database engine and engine version compatible with that DB cluster parameter group family.
Aurora MySQL
Example:
aurora-mysql5.7
,aurora-mysql8.0
Aurora PostgreSQL Example:aurora-postgresql14
RDS for MySQL Example:mysql8.0
RDS for PostgreSQL Example:postgres13
To list all of the available parameter group families for a DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine <engine>
For example, to list all of the available parameter group families for the Aurora PostgreSQL DB engine, use the following command:aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily" --engine aurora-postgresql
The output contains duplicates. The following are the valid DB engine values:aurora-mysql
aurora-postgresql
mysql
postgres
- parameters Any
Provides a list of parameters for the DB cluster parameter group.
Search the CloudFormation User Guide for
AWS::RDS::DBClusterParameterGroup
for more information about the expected schema for this property.- db
Cluster StringParameter Group Name The name of the DB cluster parameter group. Constraints:
- Must not match the name of an existing DB cluster parameter group.
This value is stored as a lowercase string.
- List<Property Map>
- Tags to assign to the DB cluster parameter group.
Outputs
All input properties are implicitly available as output properties. Additionally, the DbClusterParameterGroup resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Supporting Types
Tag, TagArgs
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.