forked from hashicorp/terraform-provider-google
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add support for org policies at the organization level (hashicorp#523)
* Fetch latest resource manager client * Add new resource to manage Org Policy at the organization level. * Update documentation
- Loading branch information
Showing
1 changed file
with
106 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,106 @@ | ||
--- | ||
layout: "google" | ||
page_title: "Google: google_organization_policy" | ||
sidebar_current: "docs-google-organization-policy" | ||
description: |- | ||
Allows management of Organization policies for a Google Organization. | ||
--- | ||
|
||
# google\_organization\_policy | ||
|
||
Allows management of Organization policies for a Google Organization. For more information see | ||
[the official | ||
documentation](https://cloud.google.com/resource-manager/docs/organization-policy/overview) and | ||
[API](https://cloud.google.com/resource-manager/reference/rest/v1/organizations/setOrgPolicy). | ||
|
||
## Example Usage | ||
|
||
To set policy with a [boolean constraint](https://cloud.google.com/resource-manager/docs/organization-policy/quickstart-boolean-constraints): | ||
|
||
```hcl | ||
resource "google_folder_organization_policy" "serial_port_policy" { | ||
org_id = "123456789" | ||
constraint = "compute.disableSerialPortAccess" | ||
boolean_policy { | ||
enforced = true | ||
} | ||
} | ||
``` | ||
|
||
|
||
To set a policy with a [list contraint](https://cloud.google.com/resource-manager/docs/organization-policy/quickstart-list-constraints): | ||
|
||
```hcl | ||
resource "google_folder_organization_policy" "services_policy" { | ||
org_id = "123456789" | ||
constraint = "serviceuser.services" | ||
list_policy { | ||
allow { | ||
all = true | ||
} | ||
} | ||
} | ||
``` | ||
|
||
|
||
Or to deny some services, use the following instead: | ||
|
||
```hcl | ||
resource "google_folder_organization_policy" "services_policy" { | ||
org_id = "123456789" | ||
constraint = "serviceuser.services" | ||
list_policy { | ||
suggested_values = "compute.googleapis.com" | ||
deny { | ||
values = ["cloudresourcemanager.googleapis.com"] | ||
} | ||
} | ||
} | ||
``` | ||
|
||
## Argument Reference | ||
|
||
The following arguments are supported: | ||
|
||
* `org_id` - (Required) The numeric ID of the organization to set the policy for. | ||
|
||
* `constraint` - (Required) The name of the Constraint the Policy is configuring, for example, `serviceuser.services`. Check out the [complete list of available constraints](https://cloud.google.com/resource-manager/docs/organization-policy/understanding-constraints#available_constraints). | ||
|
||
- - - | ||
|
||
* `version` - (Optional) Version of the Policy. Default version is 0. | ||
|
||
* `boolean_policy` - (Optional) A boolean policy is a constraint that is either enforced or not. Structure is documented below. | ||
|
||
* `list_policy` - (Optional) A policy that can define specific values that are allowed or denied for the given constraint. It can also be used to allow or deny all values. Structure is documented below. | ||
|
||
- - - | ||
|
||
The `boolean_policy` block supports: | ||
|
||
* `enforced` - (Required) If true, then the Policy is enforced. If false, then any configuration is acceptable. | ||
|
||
The `list_policy` block supports: | ||
|
||
* `allow` or `deny` - (Optional) One or the other must be set. | ||
|
||
* `suggested_values` - (Optional) The Google Cloud Console will try to default to a configuration that matches the value specified in this field. | ||
|
||
The `allow` or `deny` blocks support: | ||
|
||
* `all` - (Optional) The policy allows or denies all values. | ||
|
||
* `values` - (Optional) The policy can define specific values that are allowed or denied. | ||
|
||
## Attributes Reference | ||
|
||
In addition to the arguments listed above, the following computed attributes are | ||
exported: | ||
|
||
* `etag` - (Computed) The etag of the organization policy. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. | ||
|
||
* `update_time` - (Computed) The timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds, representing when the variable was last updated. Example: "2016-10-09T12:33:37.578138407Z". |