56 lines
1.8 KiB
Markdown
56 lines
1.8 KiB
Markdown
|
---
|
||
|
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
|