com.google.logging.v2

Interface ConfigServiceV2Grpc.AsyncService

All Known Implementing Classes:

ConfigServiceV2Grpc.ConfigServiceV2ImplBase

Enclosing class:

ConfigServiceV2Grpc

public static interface ConfigServiceV2Grpc.AsyncService

 Service for configuring sinks used to route log entries.
 

Method Summary

Modifier and Type	Method and Description
default void	copyLogEntries(CopyLogEntriesRequest request, StreamObserver<com.google.longrunning.Operation> responseObserver) Copies a set of log entries from a log bucket to a Cloud Storage bucket.
default void	createBucket(CreateBucketRequest request, StreamObserver<LogBucket> responseObserver) Creates a log bucket that can be used to store log entries.
default void	createBucketAsync(CreateBucketRequest request, StreamObserver<com.google.longrunning.Operation> responseObserver) Creates a log bucket asynchronously that can be used to store log entries.
default void	createExclusion(CreateExclusionRequest request, StreamObserver<LogExclusion> responseObserver) Creates a new exclusion in the _Default sink in a specified parent resource.
default void	createLink(CreateLinkRequest request, StreamObserver<com.google.longrunning.Operation> responseObserver) Asynchronously creates a linked dataset in BigQuery which makes it possible to use BigQuery to read the logs stored in the log bucket.
default void	createSink(CreateSinkRequest request, StreamObserver<LogSink> responseObserver) Creates a sink that exports specified log entries to a destination.
default void	createView(CreateViewRequest request, StreamObserver<LogView> responseObserver) Creates a view over log entries in a log bucket.
default void	deleteBucket(DeleteBucketRequest request, StreamObserver<com.google.protobuf.Empty> responseObserver) Deletes a log bucket.
default void	deleteExclusion(DeleteExclusionRequest request, StreamObserver<com.google.protobuf.Empty> responseObserver) Deletes an exclusion in the _Default sink.
default void	deleteLink(DeleteLinkRequest request, StreamObserver<com.google.longrunning.Operation> responseObserver) Deletes a link.
default void	deleteSink(DeleteSinkRequest request, StreamObserver<com.google.protobuf.Empty> responseObserver) Deletes a sink.
default void	deleteView(DeleteViewRequest request, StreamObserver<com.google.protobuf.Empty> responseObserver) Deletes a view on a log bucket.
default void	getBucket(GetBucketRequest request, StreamObserver<LogBucket> responseObserver) Gets a log bucket.
default void	getCmekSettings(GetCmekSettingsRequest request, StreamObserver<CmekSettings> responseObserver) Gets the Logging CMEK settings for the given resource.
default void	getExclusion(GetExclusionRequest request, StreamObserver<LogExclusion> responseObserver) Gets the description of an exclusion in the _Default sink.
default void	getLink(GetLinkRequest request, StreamObserver<Link> responseObserver) Gets a link.
default void	getSettings(GetSettingsRequest request, StreamObserver<Settings> responseObserver) Gets the Log Router settings for the given resource.
default void	getSink(GetSinkRequest request, StreamObserver<LogSink> responseObserver) Gets a sink.
default void	getView(GetViewRequest request, StreamObserver<LogView> responseObserver) Gets a view on a log bucket..
default void	listBuckets(ListBucketsRequest request, StreamObserver<ListBucketsResponse> responseObserver) Lists log buckets.
default void	listExclusions(ListExclusionsRequest request, StreamObserver<ListExclusionsResponse> responseObserver) Lists all the exclusions on the _Default sink in a parent resource.
default void	listLinks(ListLinksRequest request, StreamObserver<ListLinksResponse> responseObserver) Lists links.
default void	listSinks(ListSinksRequest request, StreamObserver<ListSinksResponse> responseObserver) Lists sinks.
default void	listViews(ListViewsRequest request, StreamObserver<ListViewsResponse> responseObserver) Lists views on a log bucket.
default void	undeleteBucket(UndeleteBucketRequest request, StreamObserver<com.google.protobuf.Empty> responseObserver) Undeletes a log bucket.
default void	updateBucket(UpdateBucketRequest request, StreamObserver<LogBucket> responseObserver) Updates a log bucket.
default void	updateBucketAsync(UpdateBucketRequest request, StreamObserver<com.google.longrunning.Operation> responseObserver) Updates a log bucket asynchronously.
default void	updateCmekSettings(UpdateCmekSettingsRequest request, StreamObserver<CmekSettings> responseObserver) Updates the Log Router CMEK settings for the given resource.
default void	updateExclusion(UpdateExclusionRequest request, StreamObserver<LogExclusion> responseObserver) Changes one or more properties of an existing exclusion in the _Default sink.
default void	updateSettings(UpdateSettingsRequest request, StreamObserver<Settings> responseObserver) Updates the Log Router settings for the given resource.
default void	updateSink(UpdateSinkRequest request, StreamObserver<LogSink> responseObserver) Updates a sink.
default void	updateView(UpdateViewRequest request, StreamObserver<LogView> responseObserver) Updates a view on a log bucket.

Method Detail

listBuckets

default void listBuckets(ListBucketsRequest request,
                         StreamObserver<ListBucketsResponse> responseObserver)

 Lists log buckets.
 

getBucket

default void getBucket(GetBucketRequest request,
                       StreamObserver<LogBucket> responseObserver)

 Gets a log bucket.
 

createBucketAsync

default void createBucketAsync(CreateBucketRequest request,
                               StreamObserver<com.google.longrunning.Operation> responseObserver)

 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.
 

updateBucketAsync

default void updateBucketAsync(UpdateBucketRequest request,
                               StreamObserver<com.google.longrunning.Operation> responseObserver)

 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.
 

createBucket

default void createBucket(CreateBucketRequest request,
                          StreamObserver<LogBucket> responseObserver)

 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.
 

updateBucket

default void updateBucket(UpdateBucketRequest request,
                          StreamObserver<LogBucket> responseObserver)

 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.
 

deleteBucket

default void deleteBucket(DeleteBucketRequest request,
                          StreamObserver<com.google.protobuf.Empty> responseObserver)

 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.
 

undeleteBucket

default void undeleteBucket(UndeleteBucketRequest request,
                            StreamObserver<com.google.protobuf.Empty> responseObserver)

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

listViews

default void listViews(ListViewsRequest request,
                       StreamObserver<ListViewsResponse> responseObserver)

 Lists views on a log bucket.
 

getView

default void getView(GetViewRequest request,
                     StreamObserver<LogView> responseObserver)

 Gets a view on a log bucket..
 

createView

default void createView(CreateViewRequest request,
                        StreamObserver<LogView> responseObserver)

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

updateView

default void updateView(UpdateViewRequest request,
                        StreamObserver<LogView> responseObserver)

 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.
 

deleteView

default void deleteView(DeleteViewRequest request,
                        StreamObserver<com.google.protobuf.Empty> responseObserver)

 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.
 

listSinks

default void listSinks(ListSinksRequest request,
                       StreamObserver<ListSinksResponse> responseObserver)

 Lists sinks.
 

getSink

default void getSink(GetSinkRequest request,
                     StreamObserver<LogSink> responseObserver)

 Gets a sink.
 

createSink

default void createSink(CreateSinkRequest request,
                        StreamObserver<LogSink> responseObserver)

 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.
 

updateSink

default void updateSink(UpdateSinkRequest request,
                        StreamObserver<LogSink> responseObserver)

 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.
 

deleteSink

default void deleteSink(DeleteSinkRequest request,
                        StreamObserver<com.google.protobuf.Empty> responseObserver)

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

createLink

default void createLink(CreateLinkRequest request,
                        StreamObserver<com.google.longrunning.Operation> responseObserver)

 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.
 

deleteLink

default void deleteLink(DeleteLinkRequest request,
                        StreamObserver<com.google.longrunning.Operation> responseObserver)

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

listLinks

default void listLinks(ListLinksRequest request,
                       StreamObserver<ListLinksResponse> responseObserver)

 Lists links.
 

getLink

default void getLink(GetLinkRequest request,
                     StreamObserver<Link> responseObserver)

 Gets a link.
 

listExclusions

default void listExclusions(ListExclusionsRequest request,
                            StreamObserver<ListExclusionsResponse> responseObserver)

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

getExclusion

default void getExclusion(GetExclusionRequest request,
                          StreamObserver<LogExclusion> responseObserver)

 Gets the description of an exclusion in the _Default sink.
 

createExclusion

default void createExclusion(CreateExclusionRequest request,
                             StreamObserver<LogExclusion> responseObserver)

 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.
 

updateExclusion

default void updateExclusion(UpdateExclusionRequest request,
                             StreamObserver<LogExclusion> responseObserver)

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

deleteExclusion

default void deleteExclusion(DeleteExclusionRequest request,
                             StreamObserver<com.google.protobuf.Empty> responseObserver)

 Deletes an exclusion in the _Default sink.
 

getCmekSettings

default void getCmekSettings(GetCmekSettingsRequest request,
                             StreamObserver<CmekSettings> responseObserver)

 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](https://cloud.google.com/logging/docs/routing/managed-encryption)
 for more information.
 

updateCmekSettings

default void updateCmekSettings(UpdateCmekSettingsRequest request,
                                StreamObserver<CmekSettings> responseObserver)

 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][google.logging.v2.ConfigServiceV2.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](https://cloud.google.com/logging/docs/routing/managed-encryption)
 for more information.
 

getSettings

default void getSettings(GetSettingsRequest request,
                         StreamObserver<Settings> responseObserver)

 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](https://cloud.google.com/logging/docs/routing/managed-encryption)
 for more information.
 

updateSettings

default void updateSettings(UpdateSettingsRequest request,
                            StreamObserver<Settings> responseObserver)

 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][google.logging.v2.ConfigServiceV2.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](https://cloud.google.com/logging/docs/routing/managed-encryption)
 for more information.
 

copyLogEntries

default void copyLogEntries(CopyLogEntriesRequest request,
                            StreamObserver<com.google.longrunning.Operation> responseObserver)

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