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

     1  ---
     2  layout: "github"
     3  page_title: "GitHub: github_issue_label"
     4  sidebar_current: "docs-github-resource-issue-label"
     5  description: |-
     6    Provides a GitHub issue label resource.
     7  ---
     8  
     9  # github_issue_label
    10  
    11  Provides a GitHub issue label resource.
    12  
    13  This resource allows you to create and manage issue labels within your
    14  Github organization.
    15  
    16  Issue labels are keyed off of their "name", so pre-existing issue labels result
    17  in a 422 HTTP error if they exist outside of Terraform. Normally this would not
    18  be an issue, except new repositories are created with a "default" set of labels,
    19  and those labels easily conflict with custom ones.
    20  
    21  This resource will first check if the label exists, and then issue an update,
    22  otherwise it will create.
    23  
    24  ## Example Usage
    25  
    26  ```hcl
    27  # Create a new, red colored label
    28  resource "github_issue_label" "test_repo" {
    29    repository = "test-repo"
    30    name       = "Urgent"
    31    color      = "FF0000"
    32  }
    33  ```
    34  
    35  ## Argument Reference
    36  
    37  The following arguments are supported:
    38  
    39  * `repository` - (Required) The GitHub repository
    40  
    41  * `name` - (Required) The name of the label.
    42  
    43  * `color` - (Required) A 6 character hex code, **without the leading #**, identifying the color of the label.