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

50 lines
1.3 KiB
Markdown
Raw Normal View History

---
layout: "datadog"
page_title: "Datadog: datadog_user"
sidebar_current: "docs-datadog-resource-user"
description: |-
Provides a Datadog user resource. This can be used to create and manage users.
---
2017-04-10 18:20:16 +02:00
# datadog_user
Provides a Datadog user resource. This can be used to create and manage Datadog users.
## Example Usage
2017-04-10 18:20:16 +02:00
```hcl
# Create a new Datadog user
resource "datadog_user" "foo" {
email = "new@example.com"
handle = "new@example.com"
name = "New User"
}
```
## Argument Reference
The following arguments are supported:
* `disabled` - (Optional) Whether the user is disabled
* `email` - (Required) Email address for user
* `handle` - (Required) The user handle, must be a valid email.
* `is_admin` - (Optional) Whether the user is an administrator
* `name` - (Required) Name for user
* `role` - (Optional) Role description for user (NOTE: can only be applied on user creation)
## Attributes Reference
The following attributes are exported:
* `disabled` - Returns true if Datadog user is disabled (NOTE: Datadog does not actually delete users so this will be true for those as well)
* `id` - ID of the Datadog user
* `verified` - Returns true if Datadog user is verified
## Import
users can be imported using their handle, e.g.
```
$ terraform import datadog_user.example_user existing@example.com
```