google-cloud-redis-cluster-v1 0.4.2 → 0.6.0

data/lib/google/cloud/redis/cluster/v1/cloud_redis_cluster/operations.rb

@@ -125,14 +125,6 @@ module Google
               # Lists operations that match the specified filter in the request. If the
               # server doesn't support this method, it returns `UNIMPLEMENTED`.
               #
-              # NOTE: the `name` binding allows API services to override the binding
-              # to use different resource name schemes, such as `users/*/operations`. To
-              # override the binding, API services can add a binding such as
-              # `"/v1/{name=users/*}/operations"` to their service configuration.
-              # For backwards compatibility, the default name includes the operations
-              # collection id, however overriding users must ensure the name binding
-              # is the parent resource, without the operations collection id.
-              #
               # @overload list_operations(request, options = nil)
               #   Pass arguments to `list_operations` via a request object, either of type
               #   {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -222,7 +214,7 @@ module Google
                   wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
                   response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
                   yield response, operation if block_given?
-                  return response
+                  throw :response, response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -318,7 +310,7 @@ module Google
                 @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
                   response = ::Gapic::Operation.new response, @operations_client, options: options
                   yield response, operation if block_given?
-                  return response
+                  throw :response, response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -407,7 +399,6 @@ module Google
 
                 @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
                   yield response, operation if block_given?
-                  return response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -422,8 +413,9 @@ module Google
               # other methods to check whether the cancellation succeeded or whether the
               # operation completed despite cancellation. On successful cancellation,
               # the operation is not deleted; instead, it becomes an operation with
-              # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-              # corresponding to `Code.CANCELLED`.
+              # an {::Google::Longrunning::Operation#error Operation.error} value with a
+              # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
+              # `Code.CANCELLED`.
               #
               # @overload cancel_operation(request, options = nil)
               #   Pass arguments to `cancel_operation` via a request object, either of type
@@ -502,7 +494,6 @@ module Google
 
                 @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
                   yield response, operation if block_given?
-                  return response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -600,7 +591,7 @@ module Google
                 @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
                   response = ::Gapic::Operation.new response, @operations_client, options: options
                   yield response, operation if block_given?
-                  return response
+                  throw :response, response
                 end
               rescue ::GRPC::BadStatus => e
                 raise ::Google::Cloud::Error.from_error(e)
@@ -650,6 +641,13 @@ module Google
               #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
               #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
               #    *  (`nil`) indicating no credentials
+              #
+              #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+              #   external source for authentication to Google Cloud, you must validate it before
+              #   providing it to a Google API client library. Providing an unvalidated credential
+              #   configuration to Google APIs can compromise the security of your systems and data.
+              #   For more information, refer to [Validate credential configurations from external
+              #   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
               #   @return [::Object]
               # @!attribute [rw] scope
               #   The OAuth scopes
@@ -689,6 +687,11 @@ module Google
               #   default endpoint URL. The default value of nil uses the environment
               #   universe (usually the default "googleapis.com" universe).
               #   @return [::String,nil]
+              # @!attribute [rw] logger
+              #   A custom logger to use for request/response debug logging, or the value
+              #   `:default` (the default) to construct a default logger, or `nil` to
+              #   explicitly disable logging.
+              #   @return [::Logger,:default,nil]
               #
               class Configuration
                 extend ::Gapic::Config
@@ -713,6 +716,7 @@ module Google
                 config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
                 config_attr :quota_project, nil, ::String, nil
                 config_attr :universe_domain, nil, ::String, nil
+                config_attr :logger, :default, ::Logger, nil, :default
 
                 # @private
                 def initialize parent_config = nil

data/lib/google/cloud/redis/cluster/v1/cloud_redis_cluster/paths.rb

@@ -25,6 +25,46 @@ module Google
           module CloudRedisCluster
             # Path helper methods for the CloudRedisCluster API.
             module Paths
+              ##
+              # Create a fully-qualified Backup resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/locations/{location}/backupCollections/{backup_collection}/backups/{backup}`
+              #
+              # @param project [String]
+              # @param location [String]
+              # @param backup_collection [String]
+              # @param backup [String]
+              #
+              # @return [::String]
+              def backup_path project:, location:, backup_collection:, backup:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                raise ::ArgumentError, "backup_collection cannot contain /" if backup_collection.to_s.include? "/"
+
+                "projects/#{project}/locations/#{location}/backupCollections/#{backup_collection}/backups/#{backup}"
+              end
+
+              ##
+              # Create a fully-qualified BackupCollection resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/locations/{location}/backupCollections/{backup_collection}`
+              #
+              # @param project [String]
+              # @param location [String]
+              # @param backup_collection [String]
+              #
+              # @return [::String]
+              def backup_collection_path project:, location:, backup_collection:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                "projects/#{project}/locations/#{location}/backupCollections/#{backup_collection}"
+              end
+
               ##
               # Create a fully-qualified CertificateAuthority resource string.
               #
@@ -63,6 +103,69 @@ module Google
                 "projects/#{project}/locations/#{location}/clusters/#{cluster}"
               end
 
+              ##
+              # Create a fully-qualified CryptoKey resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`
+              #
+              # @param project [String]
+              # @param location [String]
+              # @param key_ring [String]
+              # @param crypto_key [String]
+              #
+              # @return [::String]
+              def crypto_key_path project:, location:, key_ring:, crypto_key:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                raise ::ArgumentError, "key_ring cannot contain /" if key_ring.to_s.include? "/"
+
+                "projects/#{project}/locations/#{location}/keyRings/#{key_ring}/cryptoKeys/#{crypto_key}"
+              end
+
+              ##
+              # Create a fully-qualified CryptoKeyVersion resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`
+              #
+              # @param project [String]
+              # @param location [String]
+              # @param key_ring [String]
+              # @param crypto_key [String]
+              # @param crypto_key_version [String]
+              #
+              # @return [::String]
+              def crypto_key_version_path project:, location:, key_ring:, crypto_key:, crypto_key_version:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                raise ::ArgumentError, "key_ring cannot contain /" if key_ring.to_s.include? "/"
+                raise ::ArgumentError, "crypto_key cannot contain /" if crypto_key.to_s.include? "/"
+
+                "projects/#{project}/locations/#{location}/keyRings/#{key_ring}/cryptoKeys/#{crypto_key}/cryptoKeyVersions/#{crypto_key_version}"
+              end
+
+              ##
+              # Create a fully-qualified ForwardingRule resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}`
+              #
+              # @param project [String]
+              # @param region [String]
+              # @param forwarding_rule [String]
+              #
+              # @return [::String]
+              def forwarding_rule_path project:, region:, forwarding_rule:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "region cannot contain /" if region.to_s.include? "/"
+
+                "projects/#{project}/regions/#{region}/forwardingRules/#{forwarding_rule}"
+              end
+
               ##
               # Create a fully-qualified Location resource string.
               #
@@ -80,6 +183,42 @@ module Google
                 "projects/#{project}/locations/#{location}"
               end
 
+              ##
+              # Create a fully-qualified Network resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/global/networks/{network}`
+              #
+              # @param project [String]
+              # @param network [String]
+              #
+              # @return [::String]
+              def network_path project:, network:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                "projects/#{project}/global/networks/#{network}"
+              end
+
+              ##
+              # Create a fully-qualified ServiceAttachment resource string.
+              #
+              # The resource will be in the following format:
+              #
+              # `projects/{project}/regions/{region}/serviceAttachments/{service_attachment}`
+              #
+              # @param project [String]
+              # @param region [String]
+              # @param service_attachment [String]
+              #
+              # @return [::String]
+              def service_attachment_path project:, region:, service_attachment:
+                raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                raise ::ArgumentError, "region cannot contain /" if region.to_s.include? "/"
+
+                "projects/#{project}/regions/#{region}/serviceAttachments/#{service_attachment}"
+              end
+
               extend self
             end
           end