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

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