Skip to main content

liens

Creates, updates, deletes, gets or lists a liens resource.

Overview

Nameliens
TypeResource
Idgoogle.cloudresourcemanager.liens

Fields

NameDatatypeDescription
namestringA system-generated unique identifier for this Lien. Example: liens/1234abcd
createTimestringThe creation time of this Lien.
originstringA stable, user-visible/meaningful string identifying the origin of the Lien, intended to be inspected programmatically. Maximum length of 200 characters. Example: 'compute.googleapis.com'
parentstringA reference to the resource this Lien is attached to. The server will validate the parent against those for which Liens are supported. Example: projects/1234
reasonstringConcise user-visible strings indicating why an action cannot be performed on a resource. Maximum length of 200 characters. Example: 'Holds production API key'
restrictionsarrayThe 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. Example: ['resourcemanager.projects.delete']

Methods

NameAccessible byRequired ParamsDescription
getSELECTliensIdRetrieve a Lien by name. Callers of this method will require permission on the parent resource. For example, a Lien with a parent of projects/1234 requires permission resourcemanager.projects.get
listSELECTList all Liens applied to the parent resource. Callers of this method will require permission on the parent resource. For example, a Lien with a parent of projects/1234 requires permission resourcemanager.projects.get.
createINSERTCreate a Lien which applies to the resource denoted by the parent field. Callers of this method will require permission on the parent resource. For example, applying to projects/1234 requires permission resourcemanager.projects.updateLiens. NOTE: Some resources may limit the number of Liens which may be applied.
deleteDELETEliensIdDelete a Lien by name. Callers of this method will require permission on the parent resource. For example, a Lien with a parent of projects/1234 requires permission resourcemanager.projects.updateLiens.

SELECT examples

List all Liens applied to the parent resource. Callers of this method will require permission on the parent resource. For example, a Lien with a parent of projects/1234 requires permission resourcemanager.projects.get.

SELECT
name,
createTime,
origin,
parent,
reason,
restrictions
FROM google.cloudresourcemanager.liens
;

INSERT example

Use the following StackQL query and manifest file to create a new liens resource.

/*+ create */
INSERT INTO google.cloudresourcemanager.liens (
name,
parent,
restrictions,
reason,
origin
)
SELECT
'{{ name }}',
'{{ parent }}',
'{{ restrictions }}',
'{{ reason }}',
'{{ origin }}'
;

DELETE example

Deletes the specified liens resource.

/*+ delete */
DELETE FROM google.cloudresourcemanager.liens
WHERE liensId = '{{ liensId }}';