approval_requests

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

Overview

Name	approval_requests
Type	Resource
Id	google.accessapproval.approval_requests

Fields

Name	Datatype	Description
name	string	The resource name of the request. Format is "{projects
approve	object	A decision that has been made to approve access to a resource.
dismiss	object	A decision that has been made to dismiss an approval request.
requestTime	string	The time at which approval was requested.
requestedAugmentedInfo	object	This field contains the augmented information of the request.
requestedDuration	string	The requested access duration.
requestedExpiration	string	The original requested expiration for the approval. Calculated by adding the requested_duration to the request_time.
requestedLocations	object	Home office and physical location of the principal.
requestedReason	object
requestedResourceName	string	The resource for which approval is being requested. The format of the resource name is defined at https://cloud.google.com/apis/design/resource_names. The resource name here may either be a "full" resource name (e.g. "//library.googleapis.com/shelves/shelf1/books/book2") or a "relative" resource name (e.g. "shelves/shelf1/books/book2") as described in the resource name specification.
requestedResourceProperties	object	The properties associated with the resource of the request.

Methods

Name	Accessible by	Required Params	Description
folders_approval_requests_get	SELECT	approvalRequestsId, foldersId	Gets an approval request. Returns NOT_FOUND if the request does not exist.
folders_approval_requests_list	SELECT	foldersId	Lists approval requests associated with a project, folder, or organization. Approval requests can be filtered by state (pending, active, dismissed). The order is reverse chronological.
organizations_approval_requests_get	SELECT	approvalRequestsId, organizationsId	Gets an approval request. Returns NOT_FOUND if the request does not exist.
organizations_approval_requests_list	SELECT	organizationsId	Lists approval requests associated with a project, folder, or organization. Approval requests can be filtered by state (pending, active, dismissed). The order is reverse chronological.
projects_approval_requests_get	SELECT	approvalRequestsId, projectsId	Gets an approval request. Returns NOT_FOUND if the request does not exist.
projects_approval_requests_list	SELECT	projectsId	Lists approval requests associated with a project, folder, or organization. Approval requests can be filtered by state (pending, active, dismissed). The order is reverse chronological.
folders_approval_requests_approve	EXEC	approvalRequestsId, foldersId	Approves a request and returns the updated ApprovalRequest. Returns NOT_FOUND if the request does not exist. Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
folders_approval_requests_dismiss	EXEC	approvalRequestsId, foldersId	Dismisses a request. Returns the updated ApprovalRequest. NOTE: This does not deny access to the resource if another request has been made and approved. It is equivalent in effect to ignoring the request altogether. Returns NOT_FOUND if the request does not exist. Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
folders_approval_requests_invalidate	EXEC	approvalRequestsId, foldersId	Invalidates an existing ApprovalRequest. Returns the updated ApprovalRequest. NOTE: This does not deny access to the resource if another request has been made and approved. It only invalidates a single approval. Returns FAILED_PRECONDITION if the request exists but is not in an approved state.
organizations_approval_requests_approve	EXEC	approvalRequestsId, organizationsId	Approves a request and returns the updated ApprovalRequest. Returns NOT_FOUND if the request does not exist. Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
organizations_approval_requests_dismiss	EXEC	approvalRequestsId, organizationsId	Dismisses a request. Returns the updated ApprovalRequest. NOTE: This does not deny access to the resource if another request has been made and approved. It is equivalent in effect to ignoring the request altogether. Returns NOT_FOUND if the request does not exist. Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
organizations_approval_requests_invalidate	EXEC	approvalRequestsId, organizationsId	Invalidates an existing ApprovalRequest. Returns the updated ApprovalRequest. NOTE: This does not deny access to the resource if another request has been made and approved. It only invalidates a single approval. Returns FAILED_PRECONDITION if the request exists but is not in an approved state.
projects_approval_requests_approve	EXEC	approvalRequestsId, projectsId	Approves a request and returns the updated ApprovalRequest. Returns NOT_FOUND if the request does not exist. Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
projects_approval_requests_dismiss	EXEC	approvalRequestsId, projectsId	Dismisses a request. Returns the updated ApprovalRequest. NOTE: This does not deny access to the resource if another request has been made and approved. It is equivalent in effect to ignoring the request altogether. Returns NOT_FOUND if the request does not exist. Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
projects_approval_requests_invalidate	EXEC	approvalRequestsId, projectsId	Invalidates an existing ApprovalRequest. Returns the updated ApprovalRequest. NOTE: This does not deny access to the resource if another request has been made and approved. It only invalidates a single approval. Returns FAILED_PRECONDITION if the request exists but is not in an approved state.

SELECT examples

Lists approval requests associated with a project, folder, or organization. Approval requests can be filtered by state (pending, active, dismissed). The order is reverse chronological.

SELECT
name,
approve,
dismiss,
requestTime,
requestedAugmentedInfo,
requestedDuration,
requestedExpiration,
requestedLocations,
requestedReason,
requestedResourceName,
requestedResourceProperties
FROM google.accessapproval.approval_requests
WHERE foldersId = '{{ foldersId }}';