terraform/website/source/docs/providers/pagerduty/r/user.html.markdown

56 lines
1.8 KiB
Markdown
Raw Normal View History

2016-09-26 22:14:08 +02:00
---
layout: "pagerduty"
page_title: "PagerDuty: pagerduty_user"
sidebar_current: "docs-pagerduty-resource-user"
description: |-
Creates and manages a user in PagerDuty.
---
# pagerduty\_user
A [user](https://v2.developer.pagerduty.com/v2/page/api-reference#!/Users/get_users) is a member of a PagerDuty account that have the ability to interact with incidents and other data on the account.
## Example Usage
```
resource "pagerduty_team" "example" {
name = "Engineering"
description = "All engineering"
}
resource "pagerduty_user" "example" {
name = "Earline Greenholt"
email = "125.greenholt.earline@graham.name"
teams = ["${pagerduty_team.example.id}"]
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Optional) The name of the user.
* `description` - (Optional) A human-friendly description of the user.
If not set, a placeholder of "Managed by Terraform" will be set.
* `color` - (Optional) The schedule color for the user.
* `role` - (Optional) The user role. Can be `admin`, `limited_user`, `owner`, `read_only_user` or `user`
* `job_title` - (Optional) The user's title.
* `teams` - (Optional) A list of teams the user should belong to.
## Attributes Reference
The following attributes are exported:
* `id` - The ID of the user.
* `name` - The name of the user.
* `email` - The user's email address.
* `time_zone` - The preferred time zone name.
* `role` - The user role.
* `avatar_url` - The URL of the user's avatar.
* `description` - The user's bio.
* `invitation_sent` - If true, the user has an outstanding invitation.
* `job_title` - The user's title.
* `html_url` - URL at which the entity is uniquely displayed in the Web app
* `teams` - A list of teams the user belongs to