Allows management of a Google Cloud Platform service account

Example Usage

This snippet creates a service account, then gives it objectViewer permission in a project.

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.

  • policy_data - (DEPRECATED, Optional) The google_iam_policy data source that represents the IAM policy that will be applied to the service account. The policy will be merged with any existing policy.

    This attribute has been deprecated. Use the google_service_account_iam_* resources instead.

    Deleting this removes the policy declared in Terraform. Any policy bindings associated with the project before Terraform was used are not deleted.

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.


Service accounts can be imported using their URI, e.g.

$ terraform import google_service_account.my_sa projects/my-project/serviceAccounts/[email protected]

© 2018 HashiCorpLicensed under the MPL 2.0 License.