1. Packages
  2. AWS Native
  3. API Docs
  4. rds
  5. getDbParameterGroup

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.109.0 published on Wednesday, Jun 26, 2024 by Pulumi

aws-native.rds.getDbParameterGroup

Explore with Pulumi AI

aws-native logo

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.109.0 published on Wednesday, Jun 26, 2024 by Pulumi

    The AWS::RDS::DBParameterGroup resource creates a custom parameter group for an RDS database family. This type can be declared in a template and referenced in the DBParameterGroupName property of an AWS::RDS::DBInstance resource. For information about configuring parameters for Amazon RDS DB instances, see Working with parameter groups in the Amazon RDS User Guide. For information about configuring parameters for Amazon Aurora DB instances, see Working with parameter groups in the Amazon Aurora User Guide. Applying a parameter group to a DB instance may require the DB instance to reboot, resulting in a database outage for the duration of the reboot.

    Using getDbParameterGroup

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getDbParameterGroup(args: GetDbParameterGroupArgs, opts?: InvokeOptions): Promise<GetDbParameterGroupResult>
    function getDbParameterGroupOutput(args: GetDbParameterGroupOutputArgs, opts?: InvokeOptions): Output<GetDbParameterGroupResult>
    def get_db_parameter_group(db_parameter_group_name: Optional[str] = None,
                               opts: Optional[InvokeOptions] = None) -> GetDbParameterGroupResult
    def get_db_parameter_group_output(db_parameter_group_name: Optional[pulumi.Input[str]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetDbParameterGroupResult]
    func LookupDbParameterGroup(ctx *Context, args *LookupDbParameterGroupArgs, opts ...InvokeOption) (*LookupDbParameterGroupResult, error)
    func LookupDbParameterGroupOutput(ctx *Context, args *LookupDbParameterGroupOutputArgs, opts ...InvokeOption) LookupDbParameterGroupResultOutput

    > Note: This function is named LookupDbParameterGroup in the Go SDK.

    public static class GetDbParameterGroup 
    {
        public static Task<GetDbParameterGroupResult> InvokeAsync(GetDbParameterGroupArgs args, InvokeOptions? opts = null)
        public static Output<GetDbParameterGroupResult> Invoke(GetDbParameterGroupInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDbParameterGroupResult> getDbParameterGroup(GetDbParameterGroupArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: aws-native:rds:getDbParameterGroup
      arguments:
        # arguments dictionary

    The following arguments are supported:

    DbParameterGroupName string

    The name of the DB parameter group. Constraints:

    • Must be 1 to 255 letters, numbers, or hyphens.
    • First character must be a letter
    • Can't end with a hyphen or contain two consecutive hyphens

    If you don't specify a value for DBParameterGroupName property, a name is automatically created for the DB parameter group. This value is stored as a lowercase string.

    DbParameterGroupName string

    The name of the DB parameter group. Constraints:

    • Must be 1 to 255 letters, numbers, or hyphens.
    • First character must be a letter
    • Can't end with a hyphen or contain two consecutive hyphens

    If you don't specify a value for DBParameterGroupName property, a name is automatically created for the DB parameter group. This value is stored as a lowercase string.

    dbParameterGroupName String

    The name of the DB parameter group. Constraints:

    • Must be 1 to 255 letters, numbers, or hyphens.
    • First character must be a letter
    • Can't end with a hyphen or contain two consecutive hyphens

    If you don't specify a value for DBParameterGroupName property, a name is automatically created for the DB parameter group. This value is stored as a lowercase string.

    dbParameterGroupName string

    The name of the DB parameter group. Constraints:

    • Must be 1 to 255 letters, numbers, or hyphens.
    • First character must be a letter
    • Can't end with a hyphen or contain two consecutive hyphens

    If you don't specify a value for DBParameterGroupName property, a name is automatically created for the DB parameter group. This value is stored as a lowercase string.

    db_parameter_group_name str

    The name of the DB parameter group. Constraints:

    • Must be 1 to 255 letters, numbers, or hyphens.
    • First character must be a letter
    • Can't end with a hyphen or contain two consecutive hyphens

    If you don't specify a value for DBParameterGroupName property, a name is automatically created for the DB parameter group. This value is stored as a lowercase string.

    dbParameterGroupName String

    The name of the DB parameter group. Constraints:

    • Must be 1 to 255 letters, numbers, or hyphens.
    • First character must be a letter
    • Can't end with a hyphen or contain two consecutive hyphens

    If you don't specify a value for DBParameterGroupName property, a name is automatically created for the DB parameter group. This value is stored as a lowercase string.

    getDbParameterGroup Result

    The following output properties are available:

    Parameters object

    An array of parameter names and values for the parameter update. At least one parameter name and value must be supplied. Subsequent arguments are optional. RDS for Db2 requires you to bring your own Db2 license. You must enter your IBM customer ID (rds.ibm_customer_id) and site number (rds.ibm_site_id) before starting a Db2 instance. For more information about DB parameters and DB parameter groups for Amazon RDS DB engines, see Working with DB Parameter Groups in the Amazon RDS User Guide. For more information about DB cluster and DB instance parameters and parameter groups for Amazon Aurora DB engines, see Working with DB Parameter Groups and DB Cluster Parameter Groups in the Amazon Aurora User Guide. AWS CloudFormation doesn't support specifying an apply method for each individual parameter. The default apply method for each parameter is used.

    Search the CloudFormation User Guide for AWS::RDS::DBParameterGroup for more information about the expected schema for this property.

    Tags List<Pulumi.AwsNative.Outputs.Tag>
    An optional array of key-value pairs to apply to this DB parameter group. Currently, this is the only property that supports drift detection.
    Parameters interface{}

    An array of parameter names and values for the parameter update. At least one parameter name and value must be supplied. Subsequent arguments are optional. RDS for Db2 requires you to bring your own Db2 license. You must enter your IBM customer ID (rds.ibm_customer_id) and site number (rds.ibm_site_id) before starting a Db2 instance. For more information about DB parameters and DB parameter groups for Amazon RDS DB engines, see Working with DB Parameter Groups in the Amazon RDS User Guide. For more information about DB cluster and DB instance parameters and parameter groups for Amazon Aurora DB engines, see Working with DB Parameter Groups and DB Cluster Parameter Groups in the Amazon Aurora User Guide. AWS CloudFormation doesn't support specifying an apply method for each individual parameter. The default apply method for each parameter is used.

    Search the CloudFormation User Guide for AWS::RDS::DBParameterGroup for more information about the expected schema for this property.

    Tags Tag
    An optional array of key-value pairs to apply to this DB parameter group. Currently, this is the only property that supports drift detection.
    parameters Object

    An array of parameter names and values for the parameter update. At least one parameter name and value must be supplied. Subsequent arguments are optional. RDS for Db2 requires you to bring your own Db2 license. You must enter your IBM customer ID (rds.ibm_customer_id) and site number (rds.ibm_site_id) before starting a Db2 instance. For more information about DB parameters and DB parameter groups for Amazon RDS DB engines, see Working with DB Parameter Groups in the Amazon RDS User Guide. For more information about DB cluster and DB instance parameters and parameter groups for Amazon Aurora DB engines, see Working with DB Parameter Groups and DB Cluster Parameter Groups in the Amazon Aurora User Guide. AWS CloudFormation doesn't support specifying an apply method for each individual parameter. The default apply method for each parameter is used.

    Search the CloudFormation User Guide for AWS::RDS::DBParameterGroup for more information about the expected schema for this property.

    tags List<Tag>
    An optional array of key-value pairs to apply to this DB parameter group. Currently, this is the only property that supports drift detection.
    parameters any

    An array of parameter names and values for the parameter update. At least one parameter name and value must be supplied. Subsequent arguments are optional. RDS for Db2 requires you to bring your own Db2 license. You must enter your IBM customer ID (rds.ibm_customer_id) and site number (rds.ibm_site_id) before starting a Db2 instance. For more information about DB parameters and DB parameter groups for Amazon RDS DB engines, see Working with DB Parameter Groups in the Amazon RDS User Guide. For more information about DB cluster and DB instance parameters and parameter groups for Amazon Aurora DB engines, see Working with DB Parameter Groups and DB Cluster Parameter Groups in the Amazon Aurora User Guide. AWS CloudFormation doesn't support specifying an apply method for each individual parameter. The default apply method for each parameter is used.

    Search the CloudFormation User Guide for AWS::RDS::DBParameterGroup for more information about the expected schema for this property.

    tags Tag[]
    An optional array of key-value pairs to apply to this DB parameter group. Currently, this is the only property that supports drift detection.
    parameters Any

    An array of parameter names and values for the parameter update. At least one parameter name and value must be supplied. Subsequent arguments are optional. RDS for Db2 requires you to bring your own Db2 license. You must enter your IBM customer ID (rds.ibm_customer_id) and site number (rds.ibm_site_id) before starting a Db2 instance. For more information about DB parameters and DB parameter groups for Amazon RDS DB engines, see Working with DB Parameter Groups in the Amazon RDS User Guide. For more information about DB cluster and DB instance parameters and parameter groups for Amazon Aurora DB engines, see Working with DB Parameter Groups and DB Cluster Parameter Groups in the Amazon Aurora User Guide. AWS CloudFormation doesn't support specifying an apply method for each individual parameter. The default apply method for each parameter is used.

    Search the CloudFormation User Guide for AWS::RDS::DBParameterGroup for more information about the expected schema for this property.

    tags Sequence[root_Tag]
    An optional array of key-value pairs to apply to this DB parameter group. Currently, this is the only property that supports drift detection.
    parameters Any

    An array of parameter names and values for the parameter update. At least one parameter name and value must be supplied. Subsequent arguments are optional. RDS for Db2 requires you to bring your own Db2 license. You must enter your IBM customer ID (rds.ibm_customer_id) and site number (rds.ibm_site_id) before starting a Db2 instance. For more information about DB parameters and DB parameter groups for Amazon RDS DB engines, see Working with DB Parameter Groups in the Amazon RDS User Guide. For more information about DB cluster and DB instance parameters and parameter groups for Amazon Aurora DB engines, see Working with DB Parameter Groups and DB Cluster Parameter Groups in the Amazon Aurora User Guide. AWS CloudFormation doesn't support specifying an apply method for each individual parameter. The default apply method for each parameter is used.

    Search the CloudFormation User Guide for AWS::RDS::DBParameterGroup for more information about the expected schema for this property.

    tags List<Property Map>
    An optional array of key-value pairs to apply to this DB parameter group. Currently, this is the only property that supports drift detection.

    Supporting Types

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    AWS Native is in preview. AWS Classic is fully supported.

    AWS Native v0.109.0 published on Wednesday, Jun 26, 2024 by Pulumi