google-cloud-logging-v2 0.8.1 → 0.9.0

data/lib/google/cloud/logging/v2/config_service/operations.rb

@@ -158,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil
@@ -622,9 +620,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/logging/v2/config_service/paths.rb

@@ -139,6 +139,87 @@ module Google
               "folders/#{folder}/locations/#{location}"
             end
 
+            ##
+            # Create a fully-qualified Link resource string.
+            #
+            # @overload link_path(project:, location:, bucket:, link:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/buckets/{bucket}/links/{link}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param bucket [String]
+            #   @param link [String]
+            #
+            # @overload link_path(organization:, location:, bucket:, link:)
+            #   The resource will be in the following format:
+            #
+            #   `organizations/{organization}/locations/{location}/buckets/{bucket}/links/{link}`
+            #
+            #   @param organization [String]
+            #   @param location [String]
+            #   @param bucket [String]
+            #   @param link [String]
+            #
+            # @overload link_path(folder:, location:, bucket:, link:)
+            #   The resource will be in the following format:
+            #
+            #   `folders/{folder}/locations/{location}/buckets/{bucket}/links/{link}`
+            #
+            #   @param folder [String]
+            #   @param location [String]
+            #   @param bucket [String]
+            #   @param link [String]
+            #
+            # @overload link_path(billing_account:, location:, bucket:, link:)
+            #   The resource will be in the following format:
+            #
+            #   `billingAccounts/{billing_account}/locations/{location}/buckets/{bucket}/links/{link}`
+            #
+            #   @param billing_account [String]
+            #   @param location [String]
+            #   @param bucket [String]
+            #   @param link [String]
+            #
+            # @return [::String]
+            def link_path **args
+              resources = {
+                "bucket:link:location:project" => (proc do |project:, location:, bucket:, link:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/buckets/#{bucket}/links/#{link}"
+                end),
+                "bucket:link:location:organization" => (proc do |organization:, location:, bucket:, link:|
+                  raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
+
+                  "organizations/#{organization}/locations/#{location}/buckets/#{bucket}/links/#{link}"
+                end),
+                "bucket:folder:link:location" => (proc do |folder:, location:, bucket:, link:|
+                  raise ::ArgumentError, "folder cannot contain /" if folder.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
+
+                  "folders/#{folder}/locations/#{location}/buckets/#{bucket}/links/#{link}"
+                end),
+                "billing_account:bucket:link:location" => (proc do |billing_account:, location:, bucket:, link:|
+                  raise ::ArgumentError, "billing_account cannot contain /" if billing_account.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "bucket cannot contain /" if bucket.to_s.include? "/"
+
+                  "billingAccounts/#{billing_account}/locations/#{location}/buckets/#{bucket}/links/#{link}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             ##
             # Create a fully-qualified Location resource string.
             #

data/lib/google/cloud/logging/v2/config_service.rb

@@ -34,7 +34,7 @@ module Google
         ##
         # Service for configuring sinks used to route log entries.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/logging/v2/config_service"
         #     client = ::Google::Cloud::Logging::V2::ConfigService::Client.new

data/lib/google/cloud/logging/v2/logging_service/client.rb

@@ -356,11 +356,13 @@ module Google
             #     `entries.write`, you should try to include several log entries in this
             #     list, rather than calling this method for each individual log entry.
             #   @param partial_success [::Boolean]
-            #     Optional. Whether valid entries should be written even if some other
-            #     entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
-            #     entry is not written, then the response status is the error associated
-            #     with one of the failed entries and the response includes error details
-            #     keyed by the entries' zero-based index in the `entries.write` method.
+            #     Optional. Whether a batch's valid entries should be written even if some
+            #     other entry failed due to a permanent error such as INVALID_ARGUMENT or
+            #     PERMISSION_DENIED. If any entry failed, then the response status is the
+            #     response status of one of the failed entries. The response will include
+            #     error details in `WriteLogEntriesPartialErrors.log_entry_errors` keyed by
+            #     the entries' zero-based index in the `entries`. Failed requests for which
+            #     no entries are written will not include per-entry errors.
             #   @param dry_run [::Boolean]
             #     Optional. If true, the request should expect normal response, but the
             #     entries won't be persisted nor exported. Useful for checking whether the
@@ -460,14 +462,13 @@ module Google
             #      * `folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]`
             #
             #     Projects listed in the `project_ids` field are added to this list.
+            #     A maximum of 100 resources may be specified in a single request.
             #   @param filter [::String]
-            #     Optional. A filter that chooses which log entries to return.  See [Advanced
-            #     Logs Queries](https://cloud.google.com/logging/docs/view/advanced-queries).
-            #     Only log entries that match the filter are returned.  An empty filter
-            #     matches all log entries in the resources listed in `resource_names`.
+            #     Optional. Only log entries that match the filter are returned.  An empty
+            #     filter matches all log entries in the resources listed in `resource_names`.
             #     Referencing a parent resource that is not listed in `resource_names` will
-            #     cause the filter to return no results. The maximum length of the filter is
-            #     20000 characters.
+            #     cause the filter to return no results. The maximum length of a filter is
+            #     20,000 characters.
             #   @param order_by [::String]
             #     Optional. How the results should be sorted.  Presently, the only permitted
             #     values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
@@ -476,10 +477,10 @@ module Google
             #     in order of decreasing timestamps (newest first).  Entries with equal
             #     timestamps are returned in order of their `insert_id` values.
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of results to return from this request. Default is 50.
-            #     If the value is negative or exceeds 1000, the request is rejected. The
-            #     presence of `next_page_token` in the response indicates that more results
-            #     might be available.
+            #     Optional. The maximum number of results to return from this request.
+            #     Default is 50. If the value is negative or exceeds 1000, the request is
+            #     rejected. The presence of `next_page_token` in the response indicates that
+            #     more results might be available.
             #   @param page_token [::String]
             #     Optional. If present, then retrieve the next batch of results from the
             #     preceding call to this method.  `page_token` must be the value of
@@ -506,13 +507,11 @@ module Google
             #   # Call the list_log_entries method.
             #   result = client.list_log_entries request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Logging::V2::LogEntry.
-            #     p response
+            #     p item
             #   end
             #
             def list_log_entries request, options = nil
@@ -597,13 +596,11 @@ module Google
             #   # Call the list_monitored_resource_descriptors method.
             #   result = client.list_monitored_resource_descriptors request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Api::MonitoredResourceDescriptor.
-            #     p response
+            #     p item
             #   end
             #
             def list_monitored_resource_descriptors request, options = nil
@@ -654,29 +651,20 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_logs(parent: nil, page_size: nil, page_token: nil, resource_names: nil)
+            # @overload list_logs(parent: nil, resource_names: nil, page_size: nil, page_token: nil)
             #   Pass arguments to `list_logs` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The resource name that owns the logs:
+            #     Required. The resource name to list logs for:
             #
             #     *  `projects/[PROJECT_ID]`
             #     *  `organizations/[ORGANIZATION_ID]`
             #     *  `billingAccounts/[BILLING_ACCOUNT_ID]`
             #     *  `folders/[FOLDER_ID]`
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of results to return from this request.
-            #     Non-positive values are ignored.  The presence of `nextPageToken` in the
-            #     response indicates that more results might be available.
-            #   @param page_token [::String]
-            #     Optional. If present, then retrieve the next batch of results from the
-            #     preceding call to this method.  `pageToken` must be the value of
-            #     `nextPageToken` from the previous response.  The values of other method
-            #     parameters should be identical to those in the previous call.
             #   @param resource_names [::Array<::String>]
-            #     Optional. The resource name that owns the logs:
+            #     Optional. List of resource names to list logs for:
             #
             #      * `projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]`
             #      * `organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]`
@@ -690,6 +678,17 @@ module Google
             #     *  `billingAccounts/[BILLING_ACCOUNT_ID]`
             #     *  `folders/[FOLDER_ID]`
             #
+            #     The resource name in the `parent` field is added to this list.
+            #   @param page_size [::Integer]
+            #     Optional. The maximum number of results to return from this request.
+            #     Non-positive values are ignored.  The presence of `nextPageToken` in the
+            #     response indicates that more results might be available.
+            #   @param page_token [::String]
+            #     Optional. If present, then retrieve the next batch of results from the
+            #     preceding call to this method.  `pageToken` must be the value of
+            #     `nextPageToken` from the previous response.  The values of other method
+            #     parameters should be identical to those in the previous call.
+            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Logging::V2::ListLogsResponse]
             # @yieldparam operation [::GRPC::ActiveCall::Operation]
@@ -777,22 +776,22 @@ module Google
             #   # Create a client object. The client can be reused for multiple calls.
             #   client = Google::Cloud::Logging::V2::LoggingService::Client.new
             #
-            #   # Create an input stream
+            #   # Create an input stream.
             #   input = Gapic::StreamInput.new
             #
             #   # Call the tail_log_entries method to start streaming.
             #   output = client.tail_log_entries input
             #
-            #   # Send requests on the stream. For each request, pass in keyword
-            #   # arguments to set fields. Be sure to close the stream when done.
+            #   # Send requests on the stream. For each request object, set fields by
+            #   # passing keyword arguments. Be sure to close the stream when done.
             #   input << Google::Cloud::Logging::V2::TailLogEntriesRequest.new
             #   input << Google::Cloud::Logging::V2::TailLogEntriesRequest.new
             #   input.close
             #
-            #   # Handle streamed responses. These may be interleaved with inputs.
-            #   # Each response is of type ::Google::Cloud::Logging::V2::TailLogEntriesResponse.
-            #   output.each do |response|
-            #     p response
+            #   # The returned object is a streamed enumerable yielding elements of type
+            #   # ::Google::Cloud::Logging::V2::TailLogEntriesResponse
+            #   output.each do |current_response|
+            #     p current_response
             #   end
             #
             def tail_log_entries request, options = nil
@@ -871,9 +870,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/logging/v2/logging_service.rb

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for ingesting and querying logs.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/logging/v2/logging_service"
         #     client = ::Google::Cloud::Logging::V2::LoggingService::Client.new

data/lib/google/cloud/logging/v2/metrics_service/client.rb

@@ -218,13 +218,11 @@ module Google
             #   # Call the list_log_metrics method.
             #   result = client.list_log_metrics request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Logging::V2::LogMetric.
-            #     p response
+            #     p item
             #   end
             #
             def list_log_metrics request, options = nil
@@ -666,9 +664,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials

data/lib/google/cloud/logging/v2/metrics_service.rb

@@ -33,7 +33,7 @@ module Google
         ##
         # Service for configuring logs-based metrics.
         #
-        # To load this service and instantiate a client:
+        # @example Load this service and instantiate a gRPC client
         #
         #     require "google/cloud/logging/v2/metrics_service"
         #     client = ::Google::Cloud::Logging::V2::MetricsService::Client.new

data/lib/google/cloud/logging/v2/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Logging
       module V2
-        VERSION = "0.8.1"
+        VERSION = "0.9.0"
       end
     end
   end

data/lib/google/cloud/logging/v2.rb

@@ -25,9 +25,9 @@ module Google
   module Cloud
     module Logging
       ##
-      # To load this package, including all its services, and instantiate a client:
+      # API client module.
       #
-      # @example
+      # @example Load this package, including all its services, and instantiate a gRPC client
       #
       #     require "google/cloud/logging/v2"
       #     client = ::Google::Cloud::Logging::V2::LoggingService::Client.new

data/lib/google/logging/v2/logging_config_pb.rb

@@ -14,6 +14,11 @@ require 'google/protobuf/timestamp_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/logging/v2/logging_config.proto", :syntax => :proto3) do
+    add_message "google.logging.v2.IndexConfig" do
+      optional :field_path, :string, 1
+      optional :type, :enum, 2, "google.logging.v2.IndexType"
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+    end
     add_message "google.logging.v2.LogBucket" do
       optional :name, :string, 1
       optional :description, :string, 3
@@ -22,7 +27,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :retention_days, :int32, 11
       optional :locked, :bool, 9
       optional :lifecycle_state, :enum, 12, "google.logging.v2.LifecycleState"
+      optional :analytics_enabled, :bool, 14
       repeated :restricted_fields, :string, 15
+      repeated :index_configs, :message, 17, "google.logging.v2.IndexConfig"
       optional :cmek_settings, :message, 19, "google.logging.v2.CmekSettings"
     end
     add_message "google.logging.v2.LogView" do
@@ -53,6 +60,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :V2, 1
       value :V1, 2
     end
+    add_message "google.logging.v2.BigQueryDataset" do
+      optional :dataset_id, :string, 1
+    end
+    add_message "google.logging.v2.Link" do
+      optional :name, :string, 1
+      optional :description, :string, 2
+      optional :create_time, :message, 3, "google.protobuf.Timestamp"
+      optional :lifecycle_state, :enum, 4, "google.logging.v2.LifecycleState"
+      optional :bigquery_dataset, :message, 5, "google.logging.v2.BigQueryDataset"
+    end
     add_message "google.logging.v2.BigQueryOptions" do
       optional :use_partitioned_tables, :bool, 1
       optional :uses_timestamp_column_partitioning, :bool, 3
@@ -136,6 +153,26 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.logging.v2.DeleteSinkRequest" do
       optional :sink_name, :string, 1
     end
+    add_message "google.logging.v2.CreateLinkRequest" do
+      optional :parent, :string, 1
+      optional :link, :message, 2, "google.logging.v2.Link"
+      optional :link_id, :string, 3
+    end
+    add_message "google.logging.v2.DeleteLinkRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.logging.v2.ListLinksRequest" do
+      optional :parent, :string, 1
+      optional :page_token, :string, 2
+      optional :page_size, :int32, 3
+    end
+    add_message "google.logging.v2.ListLinksResponse" do
+      repeated :links, :message, 1, "google.logging.v2.Link"
+      optional :next_page_token, :string, 2
+    end
+    add_message "google.logging.v2.GetLinkRequest" do
+      optional :name, :string, 1
+    end
     add_message "google.logging.v2.LogExclusion" do
       optional :name, :string, 1
       optional :description, :string, 2
@@ -179,6 +216,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.logging.v2.CmekSettings" do
       optional :name, :string, 1
       optional :kms_key_name, :string, 2
+      optional :kms_key_version_name, :string, 4
       optional :service_account_id, :string, 3
     end
     add_message "google.logging.v2.GetSettingsRequest" do
@@ -213,10 +251,26 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.logging.v2.CopyLogEntriesResponse" do
       optional :log_entries_copied_count, :int64, 1
     end
-    add_enum "google.logging.v2.LifecycleState" do
-      value :LIFECYCLE_STATE_UNSPECIFIED, 0
-      value :ACTIVE, 1
-      value :DELETE_REQUESTED, 2
+    add_message "google.logging.v2.BucketMetadata" do
+      optional :start_time, :message, 1, "google.protobuf.Timestamp"
+      optional :end_time, :message, 2, "google.protobuf.Timestamp"
+      optional :state, :enum, 3, "google.logging.v2.OperationState"
+      oneof :request do
+        optional :create_bucket_request, :message, 4, "google.logging.v2.CreateBucketRequest"
+        optional :update_bucket_request, :message, 5, "google.logging.v2.UpdateBucketRequest"
+      end
+    end
+    add_message "google.logging.v2.LinkMetadata" do
+      optional :start_time, :message, 1, "google.protobuf.Timestamp"
+      optional :end_time, :message, 2, "google.protobuf.Timestamp"
+      optional :state, :enum, 3, "google.logging.v2.OperationState"
+      oneof :request do
+        optional :create_link_request, :message, 4, "google.logging.v2.CreateLinkRequest"
+        optional :delete_link_request, :message, 5, "google.logging.v2.DeleteLinkRequest"
+      end
+    end
+    add_message "google.logging.v2.LocationMetadata" do
+      optional :log_analytics_enabled, :bool, 1
     end
     add_enum "google.logging.v2.OperationState" do
       value :OPERATION_STATE_UNSPECIFIED, 0
@@ -227,6 +281,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :OPERATION_STATE_FAILED, 5
       value :OPERATION_STATE_CANCELLED, 6
     end
+    add_enum "google.logging.v2.LifecycleState" do
+      value :LIFECYCLE_STATE_UNSPECIFIED, 0
+      value :ACTIVE, 1
+      value :DELETE_REQUESTED, 2
+      value :UPDATING, 3
+      value :CREATING, 4
+      value :FAILED, 5
+    end
+    add_enum "google.logging.v2.IndexType" do
+      value :INDEX_TYPE_UNSPECIFIED, 0
+      value :INDEX_TYPE_STRING, 1
+      value :INDEX_TYPE_INTEGER, 2
+    end
   end
 end
 
@@ -234,10 +301,13 @@ module Google
   module Cloud
     module Logging
       module V2
+        IndexConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.IndexConfig").msgclass
         LogBucket = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogBucket").msgclass
         LogView = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogView").msgclass
         LogSink = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink").msgclass
         LogSink::VersionFormat = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink.VersionFormat").enummodule
+        BigQueryDataset = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.BigQueryDataset").msgclass
+        Link = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.Link").msgclass
         BigQueryOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.BigQueryOptions").msgclass
         ListBucketsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListBucketsRequest").msgclass
         ListBucketsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListBucketsResponse").msgclass
@@ -258,6 +328,11 @@ module Google
         CreateSinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CreateSinkRequest").msgclass
         UpdateSinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.UpdateSinkRequest").msgclass
         DeleteSinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteSinkRequest").msgclass
+        CreateLinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CreateLinkRequest").msgclass
+        DeleteLinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.DeleteLinkRequest").msgclass
+        ListLinksRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLinksRequest").msgclass
+        ListLinksResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListLinksResponse").msgclass
+        GetLinkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetLinkRequest").msgclass
         LogExclusion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogExclusion").msgclass
         ListExclusionsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListExclusionsRequest").msgclass
         ListExclusionsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListExclusionsResponse").msgclass
@@ -274,8 +349,12 @@ module Google
         CopyLogEntriesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CopyLogEntriesRequest").msgclass
         CopyLogEntriesMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CopyLogEntriesMetadata").msgclass
         CopyLogEntriesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.CopyLogEntriesResponse").msgclass
-        LifecycleState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LifecycleState").enummodule
+        BucketMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.BucketMetadata").msgclass
+        LinkMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LinkMetadata").msgclass
+        LocationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LocationMetadata").msgclass
         OperationState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.OperationState").enummodule
+        LifecycleState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LifecycleState").enummodule
+        IndexType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.IndexType").enummodule
       end
     end
   end

data/lib/google/logging/v2/logging_config_services_pb.rb

@@ -37,14 +37,21 @@ module Google
             rpc :ListBuckets, ::Google::Cloud::Logging::V2::ListBucketsRequest, ::Google::Cloud::Logging::V2::ListBucketsResponse
             # Gets a log bucket.
             rpc :GetBucket, ::Google::Cloud::Logging::V2::GetBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
+            # 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.
+            rpc :CreateBucketAsync, ::Google::Cloud::Logging::V2::CreateBucketRequest, ::Google::Longrunning::Operation
+            # 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.
+            rpc :UpdateBucketAsync, ::Google::Cloud::Logging::V2::UpdateBucketRequest, ::Google::Longrunning::Operation
             # 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.
             rpc :CreateBucket, ::Google::Cloud::Logging::V2::CreateBucketRequest, ::Google::Cloud::Logging::V2::LogBucket
-            # Updates a log bucket. This method replaces the following fields in the
-            # existing bucket with values from the new bucket: `retention_period`
-            #
-            # If the retention period is decreased and the bucket is locked,
-            # `FAILED_PRECONDITION` will be returned.
+            # Updates a log bucket.
             #
             # If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then
             # `FAILED_PRECONDITION` will be returned.
@@ -96,6 +103,17 @@ module Google
             # Deletes a sink. If the sink has a unique `writer_identity`, then that
             # service account is also deleted.
             rpc :DeleteSink, ::Google::Cloud::Logging::V2::DeleteSinkRequest, ::Google::Protobuf::Empty
+            # 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.
+            rpc :CreateLink, ::Google::Cloud::Logging::V2::CreateLinkRequest, ::Google::Longrunning::Operation
+            # Deletes a link. This will also delete the corresponding BigQuery linked
+            # dataset.
+            rpc :DeleteLink, ::Google::Cloud::Logging::V2::DeleteLinkRequest, ::Google::Longrunning::Operation
+            # Lists links.
+            rpc :ListLinks, ::Google::Cloud::Logging::V2::ListLinksRequest, ::Google::Cloud::Logging::V2::ListLinksResponse
+            # Gets a link.
+            rpc :GetLink, ::Google::Cloud::Logging::V2::GetLinkRequest, ::Google::Cloud::Logging::V2::Link
             # Lists all the exclusions on the _Default sink in a parent resource.
             rpc :ListExclusions, ::Google::Cloud::Logging::V2::ListExclusionsRequest, ::Google::Cloud::Logging::V2::ListExclusionsResponse
             # Gets the description of an exclusion in the _Default sink.