terraform-provider-google/website/docs/r/google_service_account.html.markdown

58 lines
1.6 KiB
Markdown
Raw Normal View History

---
layout: "google"
page_title: "Google: google_service_account"
sidebar_current: "docs-google-service-account-x"
description: |-
Allows management of a Google Cloud Platform service account.
---
# google\_service\_account
2016-11-17 17:49:22 +00:00
Allows management of a [Google Cloud Platform service account](https://cloud.google.com/compute/docs/access/service-accounts)
## Example Usage
This snippet creates a service account, then gives it objectViewer
permission in a project.
```hcl
resource "google_service_account" "object_viewer" {
account_id = "object-viewer"
display_name = "Object viewer"
}
```
## Argument Reference
The following arguments are supported:
* `account_id` - (Required) The service account ID.
Changing this forces a new service account to be created.
* `display_name` - (Optional) The display name for the service account.
Can be updated without creating a new resource.
* `project` - (Optional) The ID of the project that the service account will be created in.
Defaults to the provider project configuration.
## Attributes Reference
In addition to the arguments listed above, the following computed attributes are
exported:
* `email` - The e-mail address of the service account. This value
should be referenced from any `google_iam_policy` data sources
that would grant the service account privileges.
* `name` - The fully-qualified name of the service account.
* `unique_id` - The unique id of the service account.
## Import
Service accounts can be imported using their URI, e.g.
```
$ terraform import google_service_account.my_sa projects/my-project/serviceAccounts/my-sa@my-project.iam.gserviceaccount.com
```