Class ConfigServiceV2Grpc.ConfigServiceV2FutureStub (3.16.2)

public static final class ConfigServiceV2Grpc.ConfigServiceV2FutureStub extends AbstractFutureStub<ConfigServiceV2Grpc.ConfigServiceV2FutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service ConfigServiceV2.

Service for configuring sinks used to route log entries.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > ConfigServiceV2Grpc.ConfigServiceV2FutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected ConfigServiceV2Grpc.ConfigServiceV2FutureStub build(Channel channel, CallOptions callOptions)
Parameters
NameDescription
channelio.grpc.Channel
callOptionsio.grpc.CallOptions
Returns
TypeDescription
ConfigServiceV2Grpc.ConfigServiceV2FutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

copyLogEntries(CopyLogEntriesRequest request)

public ListenableFuture<Operation> copyLogEntries(CopyLogEntriesRequest request)

Copies a set of log entries from a log bucket to a Cloud Storage bucket.

Parameter
NameDescription
requestCopyLogEntriesRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

createBucket(CreateBucketRequest request)

public ListenableFuture<LogBucket> createBucket(CreateBucketRequest request)

Creates a log bucket that can be used to store log entries. After a bucket has been created, the bucket's location cannot be changed.

Parameter
NameDescription
requestCreateBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogBucket>

createBucketAsync(CreateBucketRequest request)

public ListenableFuture<Operation> createBucketAsync(CreateBucketRequest request)

Creates a log bucket asynchronously that can be used to store log entries. After a bucket has been created, the bucket's location cannot be changed.

Parameter
NameDescription
requestCreateBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

createExclusion(CreateExclusionRequest request)

public ListenableFuture<LogExclusion> createExclusion(CreateExclusionRequest request)

Creates a new exclusion in the _Default sink in a specified parent resource. Only log entries belonging to that resource can be excluded. You can have up to 10 exclusions in a resource.

Parameter
NameDescription
requestCreateExclusionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogExclusion>
public ListenableFuture<Operation> createLink(CreateLinkRequest request)

Asynchronously creates a linked dataset in BigQuery which makes it possible to use BigQuery to read the logs stored in the log bucket. A log bucket may currently only contain one link.

Parameter
NameDescription
requestCreateLinkRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

createSink(CreateSinkRequest request)

public ListenableFuture<LogSink> createSink(CreateSinkRequest request)

Creates a sink that exports specified log entries to a destination. The export of newly-ingested log entries begins immediately, unless the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.

Parameter
NameDescription
requestCreateSinkRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogSink>

createView(CreateViewRequest request)

public ListenableFuture<LogView> createView(CreateViewRequest request)

Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.

Parameter
NameDescription
requestCreateViewRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogView>

deleteBucket(DeleteBucketRequest request)

public ListenableFuture<Empty> deleteBucket(DeleteBucketRequest request)

Deletes a log bucket. Changes the bucket's lifecycle_state to the DELETE_REQUESTED state. After 7 days, the bucket will be purged and all log entries in the bucket will be permanently deleted.

Parameter
NameDescription
requestDeleteBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteExclusion(DeleteExclusionRequest request)

public ListenableFuture<Empty> deleteExclusion(DeleteExclusionRequest request)

Deletes an exclusion in the _Default sink.

Parameter
NameDescription
requestDeleteExclusionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>
public ListenableFuture<Operation> deleteLink(DeleteLinkRequest request)

Deletes a link. This will also delete the corresponding BigQuery linked dataset.

Parameter
NameDescription
requestDeleteLinkRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

deleteSink(DeleteSinkRequest request)

public ListenableFuture<Empty> deleteSink(DeleteSinkRequest request)

Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.

Parameter
NameDescription
requestDeleteSinkRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

deleteView(DeleteViewRequest request)

public ListenableFuture<Empty> deleteView(DeleteViewRequest request)

Deletes a view on a log bucket. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can delete the view. If this occurs, please try again in a few minutes.

Parameter
NameDescription
requestDeleteViewRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

getBucket(GetBucketRequest request)

public ListenableFuture<LogBucket> getBucket(GetBucketRequest request)

Gets a log bucket.

Parameter
NameDescription
requestGetBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogBucket>

getCmekSettings(GetCmekSettingsRequest request)

public ListenableFuture<CmekSettings> getCmekSettings(GetCmekSettingsRequest request)

Gets the Logging CMEK settings for the given resource. Note: CMEK for the Log Router can be configured for Google Cloud projects, folders, organizations and billing accounts. Once configured for an organization, it applies to all projects and folders in the Google Cloud organization. See Enabling CMEK for Log Router for more information.

Parameter
NameDescription
requestGetCmekSettingsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CmekSettings>

getExclusion(GetExclusionRequest request)

public ListenableFuture<LogExclusion> getExclusion(GetExclusionRequest request)

Gets the description of an exclusion in the _Default sink.

Parameter
NameDescription
requestGetExclusionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogExclusion>
public ListenableFuture<Link> getLink(GetLinkRequest request)

Gets a link.

Parameter
NameDescription
requestGetLinkRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Link>

getSettings(GetSettingsRequest request)

public ListenableFuture<Settings> getSettings(GetSettingsRequest request)

Gets the Log Router settings for the given resource. Note: Settings for the Log Router can be get for Google Cloud projects, folders, organizations and billing accounts. Currently it can only be configured for organizations. Once configured for an organization, it applies to all projects and folders in the Google Cloud organization. See Enabling CMEK for Log Router for more information.

Parameter
NameDescription
requestGetSettingsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Settings>

getSink(GetSinkRequest request)

public ListenableFuture<LogSink> getSink(GetSinkRequest request)

Gets a sink.

Parameter
NameDescription
requestGetSinkRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogSink>

getView(GetViewRequest request)

public ListenableFuture<LogView> getView(GetViewRequest request)

Gets a view on a log bucket..

Parameter
NameDescription
requestGetViewRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogView>

listBuckets(ListBucketsRequest request)

public ListenableFuture<ListBucketsResponse> listBuckets(ListBucketsRequest request)

Lists log buckets.

Parameter
NameDescription
requestListBucketsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListBucketsResponse>

listExclusions(ListExclusionsRequest request)

public ListenableFuture<ListExclusionsResponse> listExclusions(ListExclusionsRequest request)

Lists all the exclusions on the _Default sink in a parent resource.

Parameter
NameDescription
requestListExclusionsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListExclusionsResponse>
public ListenableFuture<ListLinksResponse> listLinks(ListLinksRequest request)

Lists links.

Parameter
NameDescription
requestListLinksRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListLinksResponse>

listSinks(ListSinksRequest request)

public ListenableFuture<ListSinksResponse> listSinks(ListSinksRequest request)

Lists sinks.

Parameter
NameDescription
requestListSinksRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListSinksResponse>

listViews(ListViewsRequest request)

public ListenableFuture<ListViewsResponse> listViews(ListViewsRequest request)

Lists views on a log bucket.

Parameter
NameDescription
requestListViewsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListViewsResponse>

undeleteBucket(UndeleteBucketRequest request)

public ListenableFuture<Empty> undeleteBucket(UndeleteBucketRequest request)

Undeletes a log bucket. A bucket that has been deleted can be undeleted within the grace period of 7 days.

Parameter
NameDescription
requestUndeleteBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

updateBucket(UpdateBucketRequest request)

public ListenableFuture<LogBucket> updateBucket(UpdateBucketRequest request)

Updates a log bucket. If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned. After a bucket has been created, the bucket's location cannot be changed.

Parameter
NameDescription
requestUpdateBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogBucket>

updateBucketAsync(UpdateBucketRequest request)

public ListenableFuture<Operation> updateBucketAsync(UpdateBucketRequest request)

Updates a log bucket asynchronously. If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned. After a bucket has been created, the bucket's location cannot be changed.

Parameter
NameDescription
requestUpdateBucketRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

updateCmekSettings(UpdateCmekSettingsRequest request)

public ListenableFuture<CmekSettings> updateCmekSettings(UpdateCmekSettingsRequest request)

Updates the Log Router CMEK settings for the given resource. Note: CMEK for the Log Router can currently only be configured for Google Cloud organizations. Once configured, it applies to all projects and folders in the Google Cloud organization. UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the associated service account does not have the required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key is disabled. See Enabling CMEK for Log Router for more information.

Parameter
NameDescription
requestUpdateCmekSettingsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CmekSettings>

updateExclusion(UpdateExclusionRequest request)

public ListenableFuture<LogExclusion> updateExclusion(UpdateExclusionRequest request)

Changes one or more properties of an existing exclusion in the _Default sink.

Parameter
NameDescription
requestUpdateExclusionRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogExclusion>

updateSettings(UpdateSettingsRequest request)

public ListenableFuture<Settings> updateSettings(UpdateSettingsRequest request)

Updates the Log Router settings for the given resource. Note: Settings for the Log Router can currently only be configured for Google Cloud organizations. Once configured, it applies to all projects and folders in the Google Cloud organization. UpdateSettings will fail if 1) kms_key_name is invalid, or 2) the associated service account does not have the required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key is disabled. 4) location_id is not supported by Logging. 5) location_id violate OrgPolicy. See Enabling CMEK for Log Router for more information.

Parameter
NameDescription
requestUpdateSettingsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Settings>

updateSink(UpdateSinkRequest request)

public ListenableFuture<LogSink> updateSink(UpdateSinkRequest request)

Updates a sink. This method replaces the following fields in the existing sink with values from the new sink: destination, and filter. The updated sink might also have a new writer_identity; see the unique_writer_identity field.

Parameter
NameDescription
requestUpdateSinkRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogSink>

updateView(UpdateViewRequest request)

public ListenableFuture<LogView> updateView(UpdateViewRequest request)

Updates a view on a log bucket. This method replaces the following fields in the existing view with values from the new view: filter. If an UNAVAILABLE error is returned, this indicates that system is not in a state where it can update the view. If this occurs, please try again in a few minutes.

Parameter
NameDescription
requestUpdateViewRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<LogView>