github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/aws/r/db_parameter_group.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_db_parameter_group"
     4  sidebar_current: "docs-aws-resource-db-parameter-group"
     5  ---
     6  
     7  # aws\_db\_parameter\_group
     8  
     9  Provides an RDS DB parameter group resource.
    10  
    11  ## Example Usage
    12  
    13  ```hcl
    14  resource "aws_db_parameter_group" "default" {
    15    name   = "rds-pg"
    16    family = "mysql5.6"
    17  
    18    parameter {
    19      name  = "character_set_server"
    20      value = "utf8"
    21    }
    22  
    23    parameter {
    24      name  = "character_set_client"
    25      value = "utf8"
    26    }
    27  }
    28  ```
    29  
    30  ## Argument Reference
    31  
    32  The following arguments are supported:
    33  
    34  * `name` - (Optional, Forces new resource) The name of the DB parameter group. If omitted, Terraform will assign a random, unique name.
    35  * `name_prefix` - (Optional, Forces new resource) Creates a unique name beginning with the specified prefix. Conflicts with `name`.
    36  * `family` - (Required) The family of the DB parameter group.
    37  * `description` - (Optional) The description of the DB parameter group. Defaults to "Managed by Terraform".
    38  * `parameter` - (Optional) A list of DB parameters to apply.
    39  * `tags` - (Optional) A mapping of tags to assign to the resource.
    40  
    41  Parameter blocks support the following:
    42  
    43  * `name` - (Required) The name of the DB parameter.
    44  * `value` - (Required) The value of the DB parameter.
    45  * `apply_method` - (Optional) "immediate" (default), or "pending-reboot". Some
    46      engines can't apply some parameters without a reboot, and you will need to
    47      specify "pending-reboot" here.
    48  
    49  ## Attributes Reference
    50  
    51  The following attributes are exported:
    52  
    53  * `id` - The db parameter group name.
    54  * `arn` - The ARN of the db parameter group.
    55  
    56  ## Import
    57  
    58  DB Parameter groups can be imported using the `name`, e.g.
    59  
    60  ```
    61  $ terraform import aws_db_parameter_group.rds_pg rds-pg
    62  ```