github.com/cbroglie/terraform@v0.7.0-rc3.0.20170410193827-735dfc416d46/website/source/docs/providers/alicloud/r/security_group.html.markdown (about)

     1  ---
     2  layout: "alicloud"
     3  page_title: "Alicloud: alicloud_security_group"
     4  sidebar_current: "docs-alicloud-resource-security-group."
     5  description: |-
     6    Provides a Alicloud Security Group resource.
     7  ---
     8  
     9  # alicloud_security_group
    10  
    11  Provides a security group resource.
    12  
    13  ~> **NOTE:** `alicloud_security_group` is used to build and manage a security group, and `alicloud_security_group_rule` can define ingress or egress rules for it.
    14  
    15  ## Example Usage
    16  
    17  Basic Usage
    18  
    19  ```hcl
    20  resource "alicloud_security_group" "group" {
    21    name        = "terraform-test-group"
    22    description = "New security group"
    23  }
    24  ```
    25  
    26  Basic usage for vpc
    27  
    28  ```hcl
    29  resource "alicloud_security_group" "group" {
    30    name   = "new-group"
    31    vpc_id = "${alicloud_vpc.vpc.id}"
    32  }
    33  
    34  resource "alicloud_vpc" "vpc" {
    35    cidr_block = "10.1.0.0/21"
    36  }
    37  ```
    38  
    39  ## Argument Reference
    40  
    41  The following arguments are supported:
    42  
    43  * `name` - (Optional) The name of the security group. Defaults to null.
    44  * `description` - (Optional, Forces new resource) The security group description. Defaults to null.
    45  * `vpc_id` - (Optional, Forces new resource) The VPC ID.
    46  
    47  ## Attributes Reference
    48  
    49  The following attributes are exported:
    50  
    51  * `id` - The ID of the security group
    52  * `vpc_id` - The VPC ID.
    53  * `name` - The name of the security group
    54  * `description` - The description of the security group