Access Approval v1 API - Class AccessApprovalServiceClientImpl (2.4.0)

Version latest

• 2.4.0 (latest)
• 2.3.0
• 2.2.0
• 2.1.0
• 2.0.0
• 1.4.0
• 1.3.0
• 1.2.0
• 1.1.0
• 1.0.0

public sealed class AccessApprovalServiceClientImpl : AccessApprovalServiceClient

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

AccessApprovalService client wrapper implementation, for convenient use.

Inheritance

object > AccessApprovalServiceClient > AccessApprovalServiceClientImpl

Inherited Members

AccessApprovalServiceClient.DefaultEndpoint

AccessApprovalServiceClient.DefaultScopes

AccessApprovalServiceClient.ServiceMetadata

AccessApprovalServiceClient.CreateAsync(CancellationToken)

AccessApprovalServiceClient.Create()

AccessApprovalServiceClient.ShutdownDefaultChannelsAsync()

AccessApprovalServiceClient.ListApprovalRequests(string, string, int?, CallSettings)

AccessApprovalServiceClient.ListApprovalRequestsAsync(string, string, int?, CallSettings)

AccessApprovalServiceClient.ListApprovalRequests(ProjectName, string, int?, CallSettings)

AccessApprovalServiceClient.ListApprovalRequestsAsync(ProjectName, string, int?, CallSettings)

AccessApprovalServiceClient.ListApprovalRequests(FolderName, string, int?, CallSettings)

AccessApprovalServiceClient.ListApprovalRequestsAsync(FolderName, string, int?, CallSettings)

AccessApprovalServiceClient.ListApprovalRequests(OrganizationName, string, int?, CallSettings)

AccessApprovalServiceClient.ListApprovalRequestsAsync(OrganizationName, string, int?, CallSettings)

AccessApprovalServiceClient.GetApprovalRequestAsync(GetApprovalRequestMessage, CancellationToken)

AccessApprovalServiceClient.GetApprovalRequest(string, CallSettings)

AccessApprovalServiceClient.GetApprovalRequestAsync(string, CallSettings)

AccessApprovalServiceClient.GetApprovalRequestAsync(string, CancellationToken)

AccessApprovalServiceClient.GetApprovalRequest(ApprovalRequestName, CallSettings)

AccessApprovalServiceClient.GetApprovalRequestAsync(ApprovalRequestName, CallSettings)

AccessApprovalServiceClient.GetApprovalRequestAsync(ApprovalRequestName, CancellationToken)

AccessApprovalServiceClient.ApproveApprovalRequestAsync(ApproveApprovalRequestMessage, CancellationToken)

AccessApprovalServiceClient.DismissApprovalRequestAsync(DismissApprovalRequestMessage, CancellationToken)

AccessApprovalServiceClient.InvalidateApprovalRequestAsync(InvalidateApprovalRequestMessage, CancellationToken)

AccessApprovalServiceClient.GetAccessApprovalSettingsAsync(GetAccessApprovalSettingsMessage, CancellationToken)

AccessApprovalServiceClient.GetAccessApprovalSettings(string, CallSettings)

AccessApprovalServiceClient.GetAccessApprovalSettingsAsync(string, CallSettings)

AccessApprovalServiceClient.GetAccessApprovalSettingsAsync(string, CancellationToken)

AccessApprovalServiceClient.GetAccessApprovalSettings(AccessApprovalSettingsName, CallSettings)

AccessApprovalServiceClient.GetAccessApprovalSettingsAsync(AccessApprovalSettingsName, CallSettings)

AccessApprovalServiceClient.GetAccessApprovalSettingsAsync(AccessApprovalSettingsName, CancellationToken)

AccessApprovalServiceClient.UpdateAccessApprovalSettingsAsync(UpdateAccessApprovalSettingsMessage, CancellationToken)

AccessApprovalServiceClient.UpdateAccessApprovalSettings(AccessApprovalSettings, FieldMask, CallSettings)

AccessApprovalServiceClient.UpdateAccessApprovalSettingsAsync(AccessApprovalSettings, FieldMask, CallSettings)

AccessApprovalServiceClient.UpdateAccessApprovalSettingsAsync(AccessApprovalSettings, FieldMask, CancellationToken)

AccessApprovalServiceClient.DeleteAccessApprovalSettingsAsync(DeleteAccessApprovalSettingsMessage, CancellationToken)

AccessApprovalServiceClient.DeleteAccessApprovalSettings(string, CallSettings)

AccessApprovalServiceClient.DeleteAccessApprovalSettingsAsync(string, CallSettings)

AccessApprovalServiceClient.DeleteAccessApprovalSettingsAsync(string, CancellationToken)

AccessApprovalServiceClient.DeleteAccessApprovalSettings(AccessApprovalSettingsName, CallSettings)

AccessApprovalServiceClient.DeleteAccessApprovalSettingsAsync(AccessApprovalSettingsName, CallSettings)

AccessApprovalServiceClient.DeleteAccessApprovalSettingsAsync(AccessApprovalSettingsName, CancellationToken)

AccessApprovalServiceClient.GetAccessApprovalServiceAccountAsync(GetAccessApprovalServiceAccountMessage, CancellationToken)

AccessApprovalServiceClient.GetAccessApprovalServiceAccount(string, CallSettings)

AccessApprovalServiceClient.GetAccessApprovalServiceAccountAsync(string, CallSettings)

AccessApprovalServiceClient.GetAccessApprovalServiceAccountAsync(string, CancellationToken)

object.GetHashCode()

object.GetType()

object.ToString()

Namespace

Google.Cloud.AccessApproval.V1

Assembly

Google.Cloud.AccessApproval.V1.dll

Remarks

This API allows a customer to manage accesses to cloud resources by Google personnel. It defines the following resource model:

• The API has a collection of [ApprovalRequest][google.cloud.accessapproval.v1.ApprovalRequest] resources, named approvalRequests/{approval_request}
• The API has top-level settings per Project/Folder/Organization, named accessApprovalSettings

The service also periodically emails a list of recipients, defined at the Project/Folder/Organization level in the accessApprovalSettings, when there is a pending ApprovalRequest for them to act on. The ApprovalRequests can also optionally be published to a Pub/Sub topic owned by the customer (contact support if you would like to enable Pub/Sub notifications).

ApprovalRequests can be approved or dismissed. Google personnel can only access the indicated resource or resources if the request is approved (subject to some exclusions: https://cloud.google.com/access-approval/docs/overview#exclusions).

Note: Using Access Approval functionality will mean that Google may not be able to meet the SLAs for your chosen products, as any support response times may be dramatically increased. As such the SLAs do not apply to any service disruption to the extent impacted by Customer's use of Access Approval. Do not enable Access Approval for projects where you may require high service availability and rapid response by Google Cloud Support.

After a request is approved or dismissed, no further action may be taken on it. Requests with the requested_expiration in the past or with no activity for 14 days are considered dismissed. When an approval expires, the request is considered dismissed.

If a request is not approved or dismissed, we call it pending.

Constructors

AccessApprovalServiceClientImpl(AccessApprovalClient, AccessApprovalServiceSettings, ILogger)

public AccessApprovalServiceClientImpl(AccessApproval.AccessApprovalClient grpcClient, AccessApprovalServiceSettings settings, ILogger logger)

Constructs a client wrapper for the AccessApprovalService service, with the specified gRPC client and settings.

Parameters
Name	Description
grpcClient	AccessApprovalAccessApprovalClient The underlying gRPC client.
settings	AccessApprovalServiceSettings The base AccessApprovalServiceSettings used within this client.
logger	ILogger Optional ILogger to use within this client.

Properties

GrpcClient

public override AccessApproval.AccessApprovalClient GrpcClient { get; }

The underlying gRPC AccessApprovalService client

Property Value
Type	Description
AccessApprovalAccessApprovalClient

Overrides

AccessApprovalServiceClient.GrpcClient

Methods

ApproveApprovalRequest(ApproveApprovalRequestMessage, CallSettings)

public override ApprovalRequest ApproveApprovalRequest(ApproveApprovalRequestMessage request, CallSettings callSettings = null)

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
Name	Description
request	ApproveApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
ApprovalRequest	The RPC response.

Overrides

AccessApprovalServiceClient.ApproveApprovalRequest(ApproveApprovalRequestMessage, CallSettings)

ApproveApprovalRequestAsync(ApproveApprovalRequestMessage, CallSettings)

public override Task<ApprovalRequest> ApproveApprovalRequestAsync(ApproveApprovalRequestMessage request, CallSettings callSettings = null)

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
Name	Description
request	ApproveApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
TaskApprovalRequest	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.ApproveApprovalRequestAsync(ApproveApprovalRequestMessage, CallSettings)

DeleteAccessApprovalSettings(DeleteAccessApprovalSettingsMessage, CallSettings)

public override void DeleteAccessApprovalSettings(DeleteAccessApprovalSettingsMessage request, CallSettings callSettings = null)

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
Name	Description
request	DeleteAccessApprovalSettingsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Overrides

AccessApprovalServiceClient.DeleteAccessApprovalSettings(DeleteAccessApprovalSettingsMessage, CallSettings)

DeleteAccessApprovalSettingsAsync(DeleteAccessApprovalSettingsMessage, CallSettings)

public override Task DeleteAccessApprovalSettingsAsync(DeleteAccessApprovalSettingsMessage request, CallSettings callSettings = null)

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
Name	Description
request	DeleteAccessApprovalSettingsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
Task	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.DeleteAccessApprovalSettingsAsync(DeleteAccessApprovalSettingsMessage, CallSettings)

DismissApprovalRequest(DismissApprovalRequestMessage, CallSettings)

public override ApprovalRequest DismissApprovalRequest(DismissApprovalRequestMessage request, CallSettings callSettings = null)

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
Name	Description
request	DismissApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
ApprovalRequest	The RPC response.

Overrides

AccessApprovalServiceClient.DismissApprovalRequest(DismissApprovalRequestMessage, CallSettings)

DismissApprovalRequestAsync(DismissApprovalRequestMessage, CallSettings)

public override Task<ApprovalRequest> DismissApprovalRequestAsync(DismissApprovalRequestMessage request, CallSettings callSettings = null)

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
Name	Description
request	DismissApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
TaskApprovalRequest	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.DismissApprovalRequestAsync(DismissApprovalRequestMessage, CallSettings)

GetAccessApprovalServiceAccount(GetAccessApprovalServiceAccountMessage, CallSettings)

public override AccessApprovalServiceAccount GetAccessApprovalServiceAccount(GetAccessApprovalServiceAccountMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	GetAccessApprovalServiceAccountMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
AccessApprovalServiceAccount	The RPC response.

Overrides

AccessApprovalServiceClient.GetAccessApprovalServiceAccount(GetAccessApprovalServiceAccountMessage, CallSettings)

GetAccessApprovalServiceAccountAsync(GetAccessApprovalServiceAccountMessage, CallSettings)

public override Task<AccessApprovalServiceAccount> GetAccessApprovalServiceAccountAsync(GetAccessApprovalServiceAccountMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	GetAccessApprovalServiceAccountMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
TaskAccessApprovalServiceAccount	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.GetAccessApprovalServiceAccountAsync(GetAccessApprovalServiceAccountMessage, CallSettings)

GetAccessApprovalSettings(GetAccessApprovalSettingsMessage, CallSettings)

public override AccessApprovalSettings GetAccessApprovalSettings(GetAccessApprovalSettingsMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	GetAccessApprovalSettingsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
AccessApprovalSettings	The RPC response.

Overrides

AccessApprovalServiceClient.GetAccessApprovalSettings(GetAccessApprovalSettingsMessage, CallSettings)

GetAccessApprovalSettingsAsync(GetAccessApprovalSettingsMessage, CallSettings)

public override Task<AccessApprovalSettings> GetAccessApprovalSettingsAsync(GetAccessApprovalSettingsMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	GetAccessApprovalSettingsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
TaskAccessApprovalSettings	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.GetAccessApprovalSettingsAsync(GetAccessApprovalSettingsMessage, CallSettings)

GetApprovalRequest(GetApprovalRequestMessage, CallSettings)

public override ApprovalRequest GetApprovalRequest(GetApprovalRequestMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	GetApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
ApprovalRequest	The RPC response.

Overrides

AccessApprovalServiceClient.GetApprovalRequest(GetApprovalRequestMessage, CallSettings)

GetApprovalRequestAsync(GetApprovalRequestMessage, CallSettings)

public override Task<ApprovalRequest> GetApprovalRequestAsync(GetApprovalRequestMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	GetApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
TaskApprovalRequest	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.GetApprovalRequestAsync(GetApprovalRequestMessage, CallSettings)

InvalidateApprovalRequest(InvalidateApprovalRequestMessage, CallSettings)

public override ApprovalRequest InvalidateApprovalRequest(InvalidateApprovalRequestMessage request, CallSettings callSettings = null)

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
Name	Description
request	InvalidateApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
ApprovalRequest	The RPC response.

Overrides

AccessApprovalServiceClient.InvalidateApprovalRequest(InvalidateApprovalRequestMessage, CallSettings)

InvalidateApprovalRequestAsync(InvalidateApprovalRequestMessage, CallSettings)

public override Task<ApprovalRequest> InvalidateApprovalRequestAsync(InvalidateApprovalRequestMessage request, CallSettings callSettings = null)

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
Name	Description
request	InvalidateApprovalRequestMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
TaskApprovalRequest	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.InvalidateApprovalRequestAsync(InvalidateApprovalRequestMessage, CallSettings)

ListApprovalRequests(ListApprovalRequestsMessage, CallSettings)

public override PagedEnumerable<ListApprovalRequestsResponse, ApprovalRequest> ListApprovalRequests(ListApprovalRequestsMessage request, CallSettings callSettings = null)

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
Name	Description
request	ListApprovalRequestsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
PagedEnumerableListApprovalRequestsResponseApprovalRequest	A pageable sequence of ApprovalRequest resources.

Overrides

AccessApprovalServiceClient.ListApprovalRequests(ListApprovalRequestsMessage, CallSettings)

ListApprovalRequestsAsync(ListApprovalRequestsMessage, CallSettings)

public override PagedAsyncEnumerable<ListApprovalRequestsResponse, ApprovalRequest> ListApprovalRequestsAsync(ListApprovalRequestsMessage request, CallSettings callSettings = null)

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
Name	Description
request	ListApprovalRequestsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
PagedAsyncEnumerableListApprovalRequestsResponseApprovalRequest	A pageable asynchronous sequence of ApprovalRequest resources.

Overrides

AccessApprovalServiceClient.ListApprovalRequestsAsync(ListApprovalRequestsMessage, CallSettings)

UpdateAccessApprovalSettings(UpdateAccessApprovalSettingsMessage, CallSettings)

public override AccessApprovalSettings UpdateAccessApprovalSettings(UpdateAccessApprovalSettingsMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	UpdateAccessApprovalSettingsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
AccessApprovalSettings	The RPC response.

Overrides

AccessApprovalServiceClient.UpdateAccessApprovalSettings(UpdateAccessApprovalSettingsMessage, CallSettings)

UpdateAccessApprovalSettingsAsync(UpdateAccessApprovalSettingsMessage, CallSettings)

public override Task<AccessApprovalSettings> UpdateAccessApprovalSettingsAsync(UpdateAccessApprovalSettingsMessage request, CallSettings callSettings = null)

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

Parameters
Name	Description
request	UpdateAccessApprovalSettingsMessage The request object containing all of the parameters for the API call.
callSettings	CallSettings If not null, applies overrides to this RPC call.

Returns
Type	Description
TaskAccessApprovalSettings	A Task containing the RPC response.

Overrides

AccessApprovalServiceClient.UpdateAccessApprovalSettingsAsync(UpdateAccessApprovalSettingsMessage, CallSettings)