Access Approval v1 API - Class AccessApproval.AccessApprovalBase (2.2.0)

[BindServiceMethod(typeof(AccessApproval), "BindService")]
public abstract class AccessApprovalBase

Reference documentation and code samples for the Access Approval v1 API class AccessApproval.AccessApprovalBase.

Base class for server-side implementations of AccessApproval

Inheritance

Object > AccessApproval.AccessApprovalBase

Namespace

Google.Cloud.AccessApproval.V1

Assembly

Google.Cloud.AccessApproval.V1.dll

Methods

ApproveApprovalRequest(ApproveApprovalRequestMessage, ServerCallContext)

public virtual Task<ApprovalRequest> ApproveApprovalRequest(ApproveApprovalRequestMessage request, ServerCallContext context)

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.

Parameters
NameDescription
requestApproveApprovalRequestMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<ApprovalRequest>

The response to send back to the client (wrapped by a task).

DeleteAccessApprovalSettings(DeleteAccessApprovalSettingsMessage, ServerCallContext)

public virtual Task<Empty> DeleteAccessApprovalSettings(DeleteAccessApprovalSettingsMessage request, ServerCallContext context)

Deletes the settings associated with a project, folder, or organization. This will have the effect of disabling Access Approval for the project, folder, or organization, but only if all ancestors also have Access Approval disabled. If Access Approval is enabled at a higher level of the hierarchy, then Access Approval will still be enabled at this level as the settings are inherited.

Parameters
NameDescription
requestDeleteAccessApprovalSettingsMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<Empty>

The response to send back to the client (wrapped by a task).

DismissApprovalRequest(DismissApprovalRequestMessage, ServerCallContext)

public virtual Task<ApprovalRequest> DismissApprovalRequest(DismissApprovalRequestMessage request, ServerCallContext context)

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.

Parameters
NameDescription
requestDismissApprovalRequestMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<ApprovalRequest>

The response to send back to the client (wrapped by a task).

GetAccessApprovalServiceAccount(GetAccessApprovalServiceAccountMessage, ServerCallContext)

public virtual Task<AccessApprovalServiceAccount> GetAccessApprovalServiceAccount(GetAccessApprovalServiceAccountMessage request, ServerCallContext context)

Retrieves the service account that is used by Access Approval to access KMS keys for signing approved approval requests.

Parameters
NameDescription
requestGetAccessApprovalServiceAccountMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<AccessApprovalServiceAccount>

The response to send back to the client (wrapped by a task).

GetAccessApprovalSettings(GetAccessApprovalSettingsMessage, ServerCallContext)

public virtual Task<AccessApprovalSettings> GetAccessApprovalSettings(GetAccessApprovalSettingsMessage request, ServerCallContext context)

Gets the settings associated with a project, folder, or organization.

Parameters
NameDescription
requestGetAccessApprovalSettingsMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<AccessApprovalSettings>

The response to send back to the client (wrapped by a task).

GetApprovalRequest(GetApprovalRequestMessage, ServerCallContext)

public virtual Task<ApprovalRequest> GetApprovalRequest(GetApprovalRequestMessage request, ServerCallContext context)

Gets an approval request. Returns NOT_FOUND if the request does not exist.

Parameters
NameDescription
requestGetApprovalRequestMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<ApprovalRequest>

The response to send back to the client (wrapped by a task).

InvalidateApprovalRequest(InvalidateApprovalRequestMessage, ServerCallContext)

public virtual Task<ApprovalRequest> InvalidateApprovalRequest(InvalidateApprovalRequestMessage request, ServerCallContext context)

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.

Parameters
NameDescription
requestInvalidateApprovalRequestMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<ApprovalRequest>

The response to send back to the client (wrapped by a task).

ListApprovalRequests(ListApprovalRequestsMessage, ServerCallContext)

public virtual Task<ListApprovalRequestsResponse> ListApprovalRequests(ListApprovalRequestsMessage request, ServerCallContext context)

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.

Parameters
NameDescription
requestListApprovalRequestsMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<ListApprovalRequestsResponse>

The response to send back to the client (wrapped by a task).

UpdateAccessApprovalSettings(UpdateAccessApprovalSettingsMessage, ServerCallContext)

public virtual Task<AccessApprovalSettings> UpdateAccessApprovalSettings(UpdateAccessApprovalSettingsMessage request, ServerCallContext context)

Updates the settings associated with a project, folder, or organization. Settings to update are determined by the value of field_mask.

Parameters
NameDescription
requestUpdateAccessApprovalSettingsMessage

The request received from the client.

contextServerCallContext

The context of the server-side call handler being invoked.

Returns
TypeDescription
Task<AccessApprovalSettings>

The response to send back to the client (wrapped by a task).