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

111 lines
3.1 KiB
Markdown
Raw Normal View History

2018-05-17 23:33:30 +00:00
---
# ----------------------------------------------------------------------------
#
# *** AUTO GENERATED CODE *** AUTO GENERATED CODE ***
#
# ----------------------------------------------------------------------------
#
# This file is automatically generated by Magic Modules and manual
# changes will be clobbered when the file is regenerated.
#
# Please read more about how to change this file in
# .github/CONTRIBUTING.md.
#
# ----------------------------------------------------------------------------
layout: "google"
page_title: "Google: google_resource_manager_lien"
sidebar_current: "docs-google-resource-manager-lien"
2018-05-17 23:33:30 +00:00
description: |-
A Lien represents an encumbrance on the actions that can be performed on a resource.
---
# google\_resource\_manager\_lien
2018-05-17 23:33:30 +00:00
A Lien represents an encumbrance on the actions that can be performed on a resource.
## Example Usage - Resource Manager Lien
2018-05-17 23:33:30 +00:00
```hcl
resource "google_resource_manager_lien" "lien" {
2018-05-17 23:33:30 +00:00
parent = "projects/${google_project.project.number}"
restrictions = ["resourcemanager.projects.delete"]
origin = "machine-readable-explanation"
reason = "This project is an important environment"
}
resource "google_project" "project" {
project_id = "staging-project"
name = "A very important project!"
2018-05-17 23:33:30 +00:00
}
```
## Argument Reference
The following arguments are supported:
2018-05-17 23:33:30 +00:00
* `reason` -
(Required)
Concise user-visible strings indicating why an action cannot be performed
on a resource. Maximum length of 200 characters.
2018-05-17 23:33:30 +00:00
* `origin` -
(Required)
A stable, user-visible/meaningful string identifying the origin
of the Lien, intended to be inspected programmatically. Maximum length of
200 characters.
2018-05-17 23:33:30 +00:00
* `parent` -
(Required)
A reference to the resource this Lien is attached to.
The server will validate the parent against those for which Liens are supported.
Since a variety of objects can have Liens against them, you must provide the type
prefix (e.g. "projects/my-project-name").
2018-05-17 23:33:30 +00:00
* `restrictions` -
(Required)
The types of operations which should be blocked as a result of this Lien.
Each value should correspond to an IAM permission. The server will validate
the permissions against those for which Liens are supported. An empty
list is meaningless and will be rejected.
e.g. ['resourcemanager.projects.delete']
2018-05-17 23:33:30 +00:00
- - -
## Attributes Reference
In addition to the arguments listed above, the following computed attributes are exported:
2018-05-17 23:33:30 +00:00
* `name` -
A system-generated unique identifier for this Lien.
2018-05-17 23:33:30 +00:00
* `create_time` -
Time of creation
## Timeouts
This resource provides the following
[Timeouts](/docs/configuration/resources.html#timeouts) configuration options:
- `create` - Default is 4 minutes.
- `delete` - Default is 4 minutes.
2018-05-17 23:33:30 +00:00
## Import
Lien can be imported using any of these accepted formats:
```
$ terraform import google_resource_manager_lien.default {{parent}}/{{name}}
2018-05-17 23:33:30 +00:00
```
-> If you're importing a resource with beta features, make sure to include `-provider=google-beta`
as an argument so that Terraform uses the correct provider to import your resource.