github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/pagerduty/r/team.html.markdown (about)

     1  ---
     2  layout: "pagerduty"
     3  page_title: "PagerDuty: pagerduty_team"
     4  sidebar_current: "docs-pagerduty-resource-team"
     5  description: |-
     6    Creates and manages a team in PagerDuty.
     7  ---
     8  
     9  # pagerduty\_team
    10  
    11  A [team](https://v2.developer.pagerduty.com/v2/page/api-reference#!/Teams/get_teams) is a collection of users and escalation policies that represent a group of people within an organization.
    12  
    13  The account must have the `teams` ability to use the following resource.
    14  
    15  ## Example Usage
    16  
    17  ```hcl
    18  resource "pagerduty_team" "example" {
    19    name        = "Engineering"
    20    description = "All engineering"
    21  }
    22  ```
    23  
    24  ## Argument Reference
    25  
    26  The following arguments are supported:
    27  
    28    * `name` - (Required) The name of the group.
    29    * `description` - (Optional) A human-friendly description of the team.
    30      If not set, a placeholder of "Managed by Terraform" will be set.
    31  
    32  ## Attributes Reference
    33  
    34  The following attributes are exported:
    35  
    36    * `id` - The ID of the team.
    37  
    38  ## Import
    39  
    40  Teams can be imported using the `id`, e.g.
    41  
    42  ```
    43  $ terraform import pagerduty_team.main PLBP09X
    44  ```