google-cloud-logging 1.10.2 → 1.10.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3ff009393cbd979b24ec55b77e9a01ace67e83cd85fbf2515744fe17c3a2eb4
-  data.tar.gz: 94f7be31be064dfdf28606eb61fa12a14cc04d4a437cc8586860270ed2f365a9
+  metadata.gz: bcf1cecc45e21a908822e15ae13b14ee5b110e460f61c743442af832e35b3d03
+  data.tar.gz: 4328a9236c7380894d39281f14906e6a21a5623bf5f9e1a5823b9407be4891ee
 SHA512:
-  metadata.gz: b9cce3e3f7bbfe109934fa366b0115eba10669823d57141566eefeb8f0399dd87c97c69468697bfc3fe81d8f5b62f177dbdd88b40136c20be554dc89908e7a71
-  data.tar.gz: 228de2d91c3417de0680ba1ecc65e6ced7dbba967f87ef3ae01bcfd6ba0e720ef32dcb892a6703214a3f2f046c3be65d42e8dc2f3753c5b930ccca575e30ffbb
+  metadata.gz: a5cfe2ab82077f691c247e91380c12e9ac632e5ea00cf95af069e93d6d2b20c300a80218c0fe8834785180b52660f8871d0ad0840f1fd343706d903680433326
+  data.tar.gz: e6ad1dd7d86df9605d3b2fd466ae386ac9115962ad43e2dc568bbbf6c8216f37a06ea184764629baa0c9632db487058847f9c9202be2facb0b5209530df31bfa

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Release History
 
+### 1.10.7 / 2020-05-28
+
+#### Documentation
+
+* Fix a few broken links
+
+### 1.10.6 / 2020-05-19
+
+#### Bug Fixes
+
+* Adjusted some default timeout and retry settings
+
+### 1.10.5 / 2020-05-05
+
+#### Bug Fixes
+
+* Prevent error when calling stop! on unused AsyncWriter
+
+### 1.10.4 / 2020-04-20
+
+#### Documentation
+
+* Fix some broken links in the Project and Sink docs
+
+### 1.10.3 / 2020-04-06
+
+#### Documentation
+
+* Fix some broken links in the low-level interface documentation.
+
 ### 1.10.2 / 2020-04-01
 
 #### Bug Fixes

data/TROUBLESHOOTING.md

@@ -24,14 +24,8 @@ improved, *please* create a new issue on GitHub so we can talk about it.
 
   - [New issue][gh-ruby]
 
-Or, you can ask questions on the [Google Cloud Platform Slack][slack-ruby]. You
-can use the "ruby" channel for general Ruby questions, or use the
-"google-cloud-ruby" channel if you have questions about this gem in particular.
-
 [so-ruby]: http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby+logging
 
-[gh-search-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues?q=label%3A%22api%3A+logging%22
-
-[gh-ruby]: https://github.com/googlecloudplatform/google-cloud-ruby/issues/new
+[gh-search-ruby]: https://github.com/googleapis/google-cloud-ruby/issues?q=label%3A%22api%3A+logging%22
 
-[slack-ruby]: https://gcp-slack.appspot.com/
+[gh-ruby]: https://github.com/googleapis/google-cloud-ruby/issues/new

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

@@ -155,7 +155,7 @@ module Google
               max_threads: @threads, max_queue: @max_queue
             @thread ||= Thread.new { run_background }
 
-            publish_batch! if @batch.ready?
+            publish_batch! if @batch&.ready?
 
             @cond.broadcast
           end
@@ -222,6 +222,10 @@ module Google
         # writer. To stop the writer, first call {#stop} and then call {#wait!}
         # to block until the writer is stopped.
         #
+        # @param [Number, nil] timeout The maximum number of seconds to wait for
+        #   shutdown to complete. Will wait forever when the value is `nil`. The
+        #   default value is `nil`.
+        #
         # @return [AsyncWriter] returns self so calls can be chained.
         def wait! timeout = nil
           synchronize do
@@ -237,18 +241,22 @@ module Google
         ##
         # Stop this asynchronous writer and block until it has been stopped.
         #
-        # @param [Number] timeout Timeout in seconds.
+        # @param [Number, nil] timeout The maximum number of seconds to wait for
+        #   shutdown to complete. Will wait forever when the value is `nil`. The
+        #   default value is `nil`.
         # @param [Boolean] force If set to true, and the writer hasn't stopped
-        #     within the given timeout, kill it forcibly by terminating the
-        #     thread. This should be used with extreme caution, as it can
-        #     leave RPCs unfinished. Default is false.
+        #   within the given timeout, kill it forcibly by terminating the
+        #   thread. This should be used with extreme caution, as it can
+        #   leave RPCs unfinished. Default is false.
         #
-        # @return [Symbol] Returns `:stopped` if the AsyncWriter was already
-        #     stopped at the time of invocation, `:waited` if it stopped
-        #     during the timeout period, `:timeout` if it is still running
-        #     after the timeout, or `:forced` if it was forcibly killed.
+        # @return [Symbol] Returns `:new` if {#write_entries} has never been
+        #   called on the AsyncWriter, `:stopped` if it was already stopped
+        #   at the time of invocation, `:waited` if it stopped during the
+        #   timeout period, `:timeout` if it is still running after the
+        #   timeout, or `:forced` if it was forcibly killed.
         #
         def stop! timeout = nil, force: nil
+          return :new unless @thread_pool
           return :stopped if stopped?
 
           stop

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

@@ -515,7 +515,7 @@ module Google
         # Retrieves the list of monitored resource descriptors that are used by
         # Stackdriver Logging.
         #
-        # @see https://cloud.google.com/logging/docs/api/introduction_v2#monitored_resources
+        # @see https://cloud.google.com/logging/docs/api/v2/resource-list
         #   Monitored Resources
         #
         # @param [String] token A previously-returned page token representing
@@ -621,18 +621,15 @@ module Google
         # does not send previously-ingested log entries to the sink's
         # destination.
         #
-        # Before creating the sink, ensure that you have granted
-        # `cloud-logs@google.com` permission to write logs to the destination.
-        # See [Permissions for writing exported
-        # logs](https://cloud.google.com/logging/docs/export/configure_export#setting_product_name_short_permissions_for_writing_exported_logs).
-        #
-        # @see https://cloud.google.com/logging/docs/api/tasks/exporting-logs
-        #   Exporting Logs With Sinks
-        # @see https://cloud.google.com/logging/docs/api/introduction_v2#kinds_of_log_sinks
-        #   Kinds of log sinks (API V2)
-        # @see https://cloud.google.com/logging/docs/api/#sinks Sinks (API V1)
-        # @see https://cloud.google.com/logging/docs/export/configure_export#setting_product_name_short_permissions_for_writing_exported_logs
-        #   Permissions for writing exported logs
+        # Before creating the sink, ensure that you have granted the sink's
+        # _unique writer identity_ permission to write logs to the destination.
+        # See [Destination
+        # permissions](https://cloud.google.com/logging/docs/export/configure_export_v2#dest-auth).
+        #
+        # @see https://cloud.google.com/logging/docs/export
+        #   Overview of logs exports
+        # @see https://cloud.google.com/logging/docs/reference/v2/rpc/google.logging.v2#configservicev2
+        #   ConfigService API which includes sink methods
         #
         # @overload create_sink(name, destination, filter: nil, unique_writer_identity: nil)
         #   @param [String] name The client-assigned sink identifier. Sink

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

@@ -27,20 +27,17 @@ module Google
       #
       # A logs filter controls which log entries are exported.
       #
-      # Before creating the sink, ensure that you have granted
-      # `cloud-logs@google.com` permission to write logs to the destination. See
-      # [Permissions for writing exported
-      # logs](https://cloud.google.com/logging/docs/export/configure_export#setting_product_name_short_permissions_for_writing_exported_logs).
+      # Before creating the sink, ensure that you have granted the sink's
+      # _unique writer identity_ permission to write logs to the destination.
+      # See [Destination
+      # permissions](https://cloud.google.com/logging/docs/export/configure_export_v2#dest-auth).
       #
       # You can retrieve an existing sink with {Project#sink}.
       #
-      # @see https://cloud.google.com/logging/docs/api/tasks/exporting-logs
-      #   Exporting Logs With Sinks
-      # @see https://cloud.google.com/logging/docs/api/introduction_v2#kinds_of_log_sinks
-      #   Kinds of log sinks (API V2)
-      # @see https://cloud.google.com/logging/docs/api/#sinks Sinks (API V1)
-      # @see https://cloud.google.com/logging/docs/export/configure_export#setting_product_name_short_permissions_for_writing_exported_logs
-      #   Permissions for writing exported logs
+      # @see https://cloud.google.com/logging/docs/export
+      #   Overview of logs exports
+      # @see https://cloud.google.com/logging/docs/reference/v2/rpc/google.logging.v2#configservicev2
+      #   ConfigService API which includes sink methods
       #
       # @example
       #   require "google/cloud/storage"
@@ -83,22 +80,22 @@ module Google
         end
 
         ##
-        # The export destination. See [Exporting Logs With
-        # Sinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
+        # The export destination. See [Properties of
+        # Sinks](https://cloud.google.com/logging/docs/export#sink-terms).
         def destination
           @grpc.destination
         end
 
         ##
-        # Updates the export destination. See [Exporting Logs With
-        # Sinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
+        # Updates the export destination. See [Properties of
+        # Sinks](https://cloud.google.com/logging/docs/export#sink-terms).
         def destination= destination
           @grpc.destination = destination
         end
 
         ##
         # An [advanced logs
-        # filter](https://cloud.google.com/logging/docs/view/advanced_filters)
+        # filter](https://cloud.google.com/logging/docs/view/advanced-queries)
         # that defines the log entries to be exported. The filter must be
         # consistent with the log entry format designed by the `version`
         # parameter, regardless of the format of the log entry that was
@@ -109,7 +106,7 @@ module Google
 
         ##
         # Updates the [advanced logs
-        # filter](https://cloud.google.com/logging/docs/view/advanced_filters)
+        # filter](https://cloud.google.com/logging/docs/view/advanced-queries)
         # that defines the log entries to be exported. The filter must be
         # consistent with the log entry format designed by the `version`
         # parameter, regardless of the format of the log entry that was

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

@@ -388,6 +388,30 @@ module Google
               &Google::Logging::V2::ConfigServiceV2::Stub.method(:new)
             )
 
+            @delete_sink = Google::Gax.create_api_call(
+              @config_service_v2_stub.method(:delete_sink),
+              defaults["delete_sink"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'sink_name' => request.sink_name}
+              end
+            )
+            @update_sink = Google::Gax.create_api_call(
+              @config_service_v2_stub.method(:update_sink),
+              defaults["update_sink"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'sink_name' => request.sink_name}
+              end
+            )
+            @delete_exclusion = Google::Gax.create_api_call(
+              @config_service_v2_stub.method(:delete_exclusion),
+              defaults["delete_exclusion"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
             @list_buckets = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:list_buckets),
               defaults["list_buckets"],
@@ -436,22 +460,6 @@ module Google
                 {'parent' => request.parent}
               end
             )
-            @update_sink = Google::Gax.create_api_call(
-              @config_service_v2_stub.method(:update_sink),
-              defaults["update_sink"],
-              exception_transformer: exception_transformer,
-              params_extractor: proc do |request|
-                {'sink_name' => request.sink_name}
-              end
-            )
-            @delete_sink = Google::Gax.create_api_call(
-              @config_service_v2_stub.method(:delete_sink),
-              defaults["delete_sink"],
-              exception_transformer: exception_transformer,
-              params_extractor: proc do |request|
-                {'sink_name' => request.sink_name}
-              end
-            )
             @list_exclusions = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:list_exclusions),
               defaults["list_exclusions"],
@@ -484,14 +492,6 @@ module Google
                 {'name' => request.name}
               end
             )
-            @delete_exclusion = Google::Gax.create_api_call(
-              @config_service_v2_stub.method(:delete_exclusion),
-              defaults["delete_exclusion"],
-              exception_transformer: exception_transformer,
-              params_extractor: proc do |request|
-                {'name' => request.name}
-              end
-            )
             @get_cmek_settings = Google::Gax.create_api_call(
               @config_service_v2_stub.method(:get_cmek_settings),
               defaults["get_cmek_settings"],
@@ -512,6 +512,173 @@ module Google
 
           # Service calls
 
+          # Deletes a sink. If the sink has a unique `writer_identity`, then that
+          # service account is also deleted.
+          #
+          # @param sink_name [String]
+          #   Required. The full resource name of the sink to delete, including the parent
+          #   resource and the sink identifier:
+          #
+          #       "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+          #       "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+          #       "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+          #       "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+          #
+          #   Example: `"projects/my-project-id/sinks/my-sink-id"`.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result []
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2"
+          #
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #
+          #   # TODO: Initialize `sink_name`:
+          #   sink_name = ''
+          #   config_client.delete_sink(sink_name)
+
+          def delete_sink \
+              sink_name,
+              options: nil,
+              &block
+            req = {
+              sink_name: sink_name
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Logging::V2::DeleteSinkRequest)
+            @delete_sink.call(req, options, &block)
+            nil
+          end
+
+          # 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.
+          #
+          # @param sink_name [String]
+          #   Required. The full resource name of the sink to update, including the parent
+          #   resource and the sink identifier:
+          #
+          #       "projects/[PROJECT_ID]/sinks/[SINK_ID]"
+          #       "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+          #       "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+          #       "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+          #
+          #   Example: `"projects/my-project-id/sinks/my-sink-id"`.
+          # @param sink [Google::Logging::V2::LogSink | Hash]
+          #   Required. The updated sink, whose name is the same identifier that appears as part
+          #   of `sink_name`.
+          #   A hash of the same form as `Google::Logging::V2::LogSink`
+          #   can also be provided.
+          # @param unique_writer_identity [true, false]
+          #   Optional. See {Google::Logging::V2::ConfigServiceV2#create_sink}
+          #   for a description of this field. When updating a sink, the effect of this
+          #   field on the value of `writer_identity` in the updated sink depends on both
+          #   the old and new values of this field:
+          #
+          #   * If the old and new values of this field are both false or both true,
+          #     then there is no change to the sink's `writer_identity`.
+          #   * If the old value is false and the new value is true, then
+          #     `writer_identity` is changed to a unique service account.
+          #   * It is an error if the old value is true and the new value is
+          #     set to false or defaulted to false.
+          # @param update_mask [Google::Protobuf::FieldMask | Hash]
+          #   Optional. Field mask that specifies the fields in `sink` that need
+          #   an update. A sink field will be overwritten if, and only if, it is
+          #   in the update mask. `name` and output only fields cannot be updated.
+          #
+          #   An empty updateMask is temporarily treated as using the following mask
+          #   for backwards compatibility purposes:
+          #     destination,filter,includeChildren
+          #   At some point in the future, behavior will be removed and specifying an
+          #   empty updateMask will be an error.
+          #
+          #   For a detailed `FieldMask` definition, see
+          #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
+          #
+          #   Example: `updateMask=filter`.
+          #   A hash of the same form as `Google::Protobuf::FieldMask`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Logging::V2::LogSink]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Logging::V2::LogSink]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2"
+          #
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #
+          #   # TODO: Initialize `sink_name`:
+          #   sink_name = ''
+          #
+          #   # TODO: Initialize `sink`:
+          #   sink = {}
+          #   response = config_client.update_sink(sink_name, sink)
+
+          def update_sink \
+              sink_name,
+              sink,
+              unique_writer_identity: nil,
+              update_mask: nil,
+              options: nil,
+              &block
+            req = {
+              sink_name: sink_name,
+              sink: sink,
+              unique_writer_identity: unique_writer_identity,
+              update_mask: update_mask
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Logging::V2::UpdateSinkRequest)
+            @update_sink.call(req, options, &block)
+          end
+
+          # Deletes an exclusion.
+          #
+          # @param name [String]
+          #   Required. The resource name of an existing exclusion to delete:
+          #
+          #       "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
+          #       "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
+          #       "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
+          #       "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
+          #
+          #   Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result []
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2"
+          #
+          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
+          #
+          #   # TODO: Initialize `name`:
+          #   name = ''
+          #   config_client.delete_exclusion(name)
+
+          def delete_exclusion \
+              name,
+              options: nil,
+              &block
+            req = {
+              name: name
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Logging::V2::DeleteExclusionRequest)
+            @delete_exclusion.call(req, options, &block)
+            nil
+          end
+
           # Lists buckets (Beta).
           #
           # @param parent [String]
@@ -854,134 +1021,6 @@ module Google
             @create_sink.call(req, options, &block)
           end
 
-          # 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.
-          #
-          # @param sink_name [String]
-          #   Required. The full resource name of the sink to update, including the parent
-          #   resource and the sink identifier:
-          #
-          #       "projects/[PROJECT_ID]/sinks/[SINK_ID]"
-          #       "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
-          #       "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
-          #       "folders/[FOLDER_ID]/sinks/[SINK_ID]"
-          #
-          #   Example: `"projects/my-project-id/sinks/my-sink-id"`.
-          # @param sink [Google::Logging::V2::LogSink | Hash]
-          #   Required. The updated sink, whose name is the same identifier that appears as part
-          #   of `sink_name`.
-          #   A hash of the same form as `Google::Logging::V2::LogSink`
-          #   can also be provided.
-          # @param unique_writer_identity [true, false]
-          #   Optional. See {Google::Logging::V2::ConfigServiceV2#create_sink}
-          #   for a description of this field. When updating a sink, the effect of this
-          #   field on the value of `writer_identity` in the updated sink depends on both
-          #   the old and new values of this field:
-          #
-          #   * If the old and new values of this field are both false or both true,
-          #     then there is no change to the sink's `writer_identity`.
-          #   * If the old value is false and the new value is true, then
-          #     `writer_identity` is changed to a unique service account.
-          #   * It is an error if the old value is true and the new value is
-          #     set to false or defaulted to false.
-          # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Optional. Field mask that specifies the fields in `sink` that need
-          #   an update. A sink field will be overwritten if, and only if, it is
-          #   in the update mask. `name` and output only fields cannot be updated.
-          #
-          #   An empty updateMask is temporarily treated as using the following mask
-          #   for backwards compatibility purposes:
-          #     destination,filter,includeChildren
-          #   At some point in the future, behavior will be removed and specifying an
-          #   empty updateMask will be an error.
-          #
-          #   For a detailed `FieldMask` definition, see
-          #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
-          #
-          #   Example: `updateMask=filter`.
-          #   A hash of the same form as `Google::Protobuf::FieldMask`
-          #   can also be provided.
-          # @param options [Google::Gax::CallOptions]
-          #   Overrides the default settings for this call, e.g, timeout,
-          #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Logging::V2::LogSink]
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Logging::V2::LogSink]
-          # @raise [Google::Gax::GaxError] if the RPC is aborted.
-          # @example
-          #   require "google/cloud/logging/v2"
-          #
-          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #
-          #   # TODO: Initialize `sink_name`:
-          #   sink_name = ''
-          #
-          #   # TODO: Initialize `sink`:
-          #   sink = {}
-          #   response = config_client.update_sink(sink_name, sink)
-
-          def update_sink \
-              sink_name,
-              sink,
-              unique_writer_identity: nil,
-              update_mask: nil,
-              options: nil,
-              &block
-            req = {
-              sink_name: sink_name,
-              sink: sink,
-              unique_writer_identity: unique_writer_identity,
-              update_mask: update_mask
-            }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Logging::V2::UpdateSinkRequest)
-            @update_sink.call(req, options, &block)
-          end
-
-          # Deletes a sink. If the sink has a unique `writer_identity`, then that
-          # service account is also deleted.
-          #
-          # @param sink_name [String]
-          #   Required. The full resource name of the sink to delete, including the parent
-          #   resource and the sink identifier:
-          #
-          #       "projects/[PROJECT_ID]/sinks/[SINK_ID]"
-          #       "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
-          #       "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
-          #       "folders/[FOLDER_ID]/sinks/[SINK_ID]"
-          #
-          #   Example: `"projects/my-project-id/sinks/my-sink-id"`.
-          # @param options [Google::Gax::CallOptions]
-          #   Overrides the default settings for this call, e.g, timeout,
-          #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result []
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @raise [Google::Gax::GaxError] if the RPC is aborted.
-          # @example
-          #   require "google/cloud/logging/v2"
-          #
-          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #
-          #   # TODO: Initialize `sink_name`:
-          #   sink_name = ''
-          #   config_client.delete_sink(sink_name)
-
-          def delete_sink \
-              sink_name,
-              options: nil,
-              &block
-            req = {
-              sink_name: sink_name
-            }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Logging::V2::DeleteSinkRequest)
-            @delete_sink.call(req, options, &block)
-            nil
-          end
-
           # Lists all the exclusions in a parent resource.
           #
           # @param parent [String]
@@ -1193,45 +1232,6 @@ module Google
             @update_exclusion.call(req, options, &block)
           end
 
-          # Deletes an exclusion.
-          #
-          # @param name [String]
-          #   Required. The resource name of an existing exclusion to delete:
-          #
-          #       "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
-          #       "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
-          #       "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
-          #       "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
-          #
-          #   Example: `"projects/my-project-id/exclusions/my-exclusion-id"`.
-          # @param options [Google::Gax::CallOptions]
-          #   Overrides the default settings for this call, e.g, timeout,
-          #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result []
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @raise [Google::Gax::GaxError] if the RPC is aborted.
-          # @example
-          #   require "google/cloud/logging/v2"
-          #
-          #   config_client = Google::Cloud::Logging::V2::ConfigServiceV2Client.new
-          #
-          #   # TODO: Initialize `name`:
-          #   name = ''
-          #   config_client.delete_exclusion(name)
-
-          def delete_exclusion \
-              name,
-              options: nil,
-              &block
-            req = {
-              name: name
-            }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Logging::V2::DeleteExclusionRequest)
-            @delete_exclusion.call(req, options, &block)
-            nil
-          end
-
           # Gets the Logs Router CMEK settings for the given resource.
           #
           # Note: CMEK for the Logs Router can currently only be configured for GCP
@@ -1239,7 +1239,7 @@ module Google
           # the GCP organization.
           #
           # See [Enabling CMEK for Logs
-          # Router](/logging/docs/routing/managed-encryption) for more information.
+          # Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
           #
           # @param name [String]
           #   Required. The resource for which to retrieve CMEK settings.
@@ -1295,7 +1295,7 @@ module Google
           # 3) access to the key is disabled.
           #
           # See [Enabling CMEK for Logs
-          # Router](/logging/docs/routing/managed-encryption) for more information.
+          # Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
           #
           # @param name [String]
           #   Required. The resource name for the CMEK settings to update.
@@ -1314,7 +1314,7 @@ module Google
           #   Required. The CMEK settings to update.
           #
           #   See [Enabling CMEK for Logs
-          #   Router](/logging/docs/routing/managed-encryption) for more information.
+          #   Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
           #   A hash of the same form as `Google::Logging::V2::CmekSettings`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]