RubyGems - google-cloud-spanner-admin-database-v1 - Versions diffs - 0.7.6 → 0.10.0 - Mend

google-cloud-spanner-admin-database-v1 0.7.6 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71abcf8dd2d3be6ce66337af3ea8cce45352060da6f5a7cd503512bbcc8ecbde
-  data.tar.gz: 0d92c2b6201a29a0680875f0097b060935b2814e3505e32c7015ab9c241af10f
+  metadata.gz: 1536ce544d325f282526a4e7a4f70d77e1d073372d1bc82d0cae4d12de5d1917
+  data.tar.gz: 66ee74760e3fff07df238a2c06ad18777f77770d29eba5e3a2f84e71ea76134e
 SHA512:
-  metadata.gz: 0be9b4ac8c5e3937ab7a0481410fb196d836fe653398de0bcce8e558c3d1236a5ce8f596d741c8c86fe79cb49de9518de3bae87c6263c91c263c02da26807325
-  data.tar.gz: af453963e8a0db745601efd13473d95623028fe93b0983cb91bd8b5f056f0e55375c7058da21d6dbb6bea0a7e66a77be4cfdd6a717bc127e72f81ab57f15a11e
+  metadata.gz: 6c632de0881e5b7e06b9e90c3a031ae425771dedbb4bc451dbc380b4cb0eec0ddff0929dd96bd368b7ad3a01cfa8d0cfcce2776cc788bc304eb1bb7919f7d557
+  data.tar.gz: 07d1c5592f9f7efaa0b3c0495b5cbfd825c900e363c3be9fde0465081bf8bbb70fb7449ae16e5309e1204a2b3d7daf0f438b0a56fefc8c66009864c5296f622c

data/README.md CHANGED Viewed

@@ -69,16 +69,21 @@ module GRPC
 end
 ```
+## Google Cloud Samples
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
 ## Supported Ruby Versions
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.6+.
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.5
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
+in security maintenance, and not end of life. Older versions of Ruby _may_
+still work, but are unsupported and not recommended. See
+https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
+support schedule.
 ## Which client should I use?

data/lib/google/cloud/spanner/admin/database/v1/database_admin/client.rb CHANGED Viewed

@@ -110,6 +110,8 @@ module Google
                     default_config.rpcs.create_backup.timeout = 3600.0
+                    default_config.rpcs.copy_backup.timeout = 3600.0
                     default_config.rpcs.get_backup.timeout = 3600.0
                     default_config.rpcs.get_backup.retry_policy = {
                       initial_delay: 1.0, max_delay: 32.0, multiplier: 1.3, retry_codes: [14, 4]
@@ -857,7 +859,7 @@ module Google
                 #   @param options [::Gapic::CallOptions, ::Hash]
                 #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
                 #
-                # @overload set_iam_policy(resource: nil, policy: nil)
+                # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
                 #   Pass arguments to `set_iam_policy` 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).
@@ -870,6 +872,12 @@ module Google
                 #     the policy is limited to a few 10s of KB. An empty policy is a
                 #     valid policy but certain Cloud Platform services (such as Projects)
                 #     might reject them.
+                #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+                #     OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
+                #     the fields in the mask will be modified. If no mask is provided, the
+                #     following default mask is used:
+                #
+                #     `paths: "bindings, etag"`
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Google::Iam::V1::Policy]
@@ -965,7 +973,7 @@ module Google
                 #     See the operation documentation for the appropriate value for this field.
                 #   @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
                 #     OPTIONAL: A `GetPolicyOptions` object for specifying options to
-                #     `GetIamPolicy`. This field is only used by Cloud IAM.
+                #     `GetIamPolicy`.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Google::Iam::V1::Policy]
@@ -1252,6 +1260,134 @@ module Google
                   raise ::Google::Cloud::Error.from_error(e)
                 end
+                ##
+                # Starts copying a Cloud Spanner Backup.
+                # The returned backup {::Google::Longrunning::Operation long-running operation}
+                # will have a name of the format
+                # `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation_id>`
+                # and can be used to track copying of the backup. The operation is associated
+                # with the destination backup.
+                # The {::Google::Longrunning::Operation#metadata metadata} field type is
+                # {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata}.
+                # The {::Google::Longrunning::Operation#response response} field type is
+                # {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}, if successful. Cancelling the returned operation will stop the
+                # copying and delete the backup.
+                # Concurrent CopyBackup requests can run on the same source backup.
+                #
+                # @overload copy_backup(request, options = nil)
+                #   Pass arguments to `copy_backup` via a request object, either of type
+                #   {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupRequest} or an equivalent Hash.
+                #
+                #   @param request [::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupRequest, ::Hash]
+                #     A request object representing the call parameters. Required. To specify no
+                #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                #   @param options [::Gapic::CallOptions, ::Hash]
+                #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+                #
+                # @overload copy_backup(parent: nil, backup_id: nil, source_backup: nil, expire_time: nil, encryption_config: nil)
+                #   Pass arguments to `copy_backup` 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 name of the destination instance that will contain the backup copy.
+                #     Values are of the form: `projects/<project>/instances/<instance>`.
+                #   @param backup_id [::String]
+                #     Required. The id of the backup copy.
+                #     The `backup_id` appended to `parent` forms the full backup_uri of the form
+                #     `projects/<project>/instances/<instance>/backups/<backup>`.
+                #   @param source_backup [::String]
+                #     Required. The source backup to be copied.
+                #     The source backup needs to be in READY state for it to be copied.
+                #     Once CopyBackup is in progress, the source backup cannot be deleted or
+                #     cleaned up on expiration until CopyBackup is finished.
+                #     Values are of the form:
+                #     `projects/<project>/instances/<instance>/backups/<backup>`.
+                #   @param expire_time [::Google::Protobuf::Timestamp, ::Hash]
+                #     Required. The expiration time of the backup in microsecond granularity.
+                #     The expiration time must be at least 6 hours and at most 366 days
+                #     from the `create_time` of the source backup. Once the `expire_time` has
+                #     passed, the backup is eligible to be automatically deleted by Cloud Spanner
+                #     to free the resources used by the backup.
+                #   @param encryption_config [::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig, ::Hash]
+                #     Optional. The encryption configuration used to encrypt the backup. If this field is
+                #     not specified, the backup will use the same
+                #     encryption configuration as the source backup by default, namely
+                #     {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig#encryption_type encryption_type} =
+                #     `USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION`.
+                #
+                # @yield [response, operation] Access the result along with the RPC operation
+                # @yieldparam response [::Gapic::Operation]
+                # @yieldparam operation [::GRPC::ActiveCall::Operation]
+                #
+                # @return [::Gapic::Operation]
+                #
+                # @raise [::Google::Cloud::Error] if the RPC is aborted.
+                #
+                # @example Basic example
+                #   require "google/cloud/spanner/admin/database/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Cloud::Spanner::Admin::Database::V1::CopyBackupRequest.new
+                #
+                #   # Call the copy_backup method.
+                #   result = client.copy_backup 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:
+                #   result.wait_until_done! timeout: 60
+                #   if result.response?
+                #     p result.response
+                #   else
+                #     puts "Error!"
+                #   end
+                #
+                def copy_backup request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupRequest
+                  # Converts hash and nil to an options object
+                  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+                  # Customize the options with defaults
+                  metadata = @config.rpcs.copy_backup.metadata.to_h
+                  # Set x-goog-api-client and x-goog-user-project headers
+                  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                    lib_name: @config.lib_name, lib_version: @config.lib_version,
+                    gapic_version: ::Google::Cloud::Spanner::Admin::Database::V1::VERSION
+                  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+                  header_params = {}
+                  if request.parent
+                    header_params["parent"] = request.parent
+                  end
+                  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                  metadata[:"x-goog-request-params"] ||= request_params_header
+                  options.apply_defaults timeout:      @config.rpcs.copy_backup.timeout,
+                                         metadata:     metadata,
+                                         retry_policy: @config.rpcs.copy_backup.retry_policy
+                  options.apply_defaults timeout:      @config.timeout,
+                                         metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+                  @database_admin_stub.call_rpc :copy_backup, request, options: options do |response, operation|
+                    response = ::Gapic::Operation.new response, @operations_client, options: options
+                    yield response, operation if block_given?
+                    return response
+                  end
+                rescue ::GRPC::BadStatus => e
+                  raise ::Google::Cloud::Error.from_error(e)
+                end
                 ##
                 # Gets metadata on a pending or completed {::Google::Cloud::Spanner::Admin::Database::V1::Backup Backup}.
                 #
@@ -1833,6 +1969,8 @@ module Google
                 #          for {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata} is
                 #          `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`.
                 #       * `metadata.<field_name>` - any field in metadata.value.
+                #          `metadata.@type` must be specified first, if filtering on metadata
+                #          fields.
                 #       * `error` - Error associated with the long-running operation.
                 #       * `response.@type` - the type of response.
                 #       * `response.<field_name>` - any field in response.value.
@@ -1985,6 +2123,8 @@ module Google
                 #          for {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} is
                 #          `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`.
                 #       * `metadata.<field_name>` - any field in metadata.value.
+                #          `metadata.@type` must be specified first if filtering on metadata
+                #          fields.
                 #       * `error` - Error associated with the long-running operation.
                 #       * `response.@type` - the type of response.
                 #       * `response.<field_name>` - any field in response.value.
@@ -1996,8 +2136,11 @@ module Google
                 #     Here are a few examples:
                 #
                 #       * `done:true` - The operation is complete.
-                #       * `metadata.database:prod` - The database the backup was taken from has
-                #          a name containing the string "prod".
+                #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
+                #          `metadata.database:prod` - Returns operations where:
+                #          * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
+                #          * The database the backup was taken from has a name containing the
+                #          string "prod".
                 #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
                 #         `(metadata.name:howl) AND` \
                 #         `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
@@ -2006,6 +2149,29 @@ module Google
                 #         * The backup name contains the string "howl".
                 #         * The operation started before 2018-03-28T14:50:00Z.
                 #         * The operation resulted in an error.
+                #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \
+                #         `(metadata.source_backup:test) AND` \
+                #         `(metadata.progress.start_time < \"2022-01-18T14:50:00Z\") AND` \
+                #         `(error:*)` - Returns operations where:
+                #         * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata}.
+                #         * The source backup of the copied backup name contains the string
+                #         "test".
+                #         * The operation started before 2022-01-18T14:50:00Z.
+                #         * The operation resulted in an error.
+                #       * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
+                #         `(metadata.database:test_db)) OR` \
+                #         `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata)
+                #         AND` \
+                #         `(metadata.source_backup:test_bkp)) AND` \
+                #         `(error:*)` - Returns operations where:
+                #         * The operation's metadata matches either of criteria:
+                #           * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} AND the
+                #           database the backup was taken from has name containing string
+                #           "test_db"
+                #           * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata} AND the
+                #           backup the backup was copied from has name containing string
+                #           "test_bkp"
+                #         * The operation resulted in an error.
                 #   @param page_size [::Integer]
                 #     Number of operations to be returned in the response. If 0 or
                 #     less, defaults to the server's maximum allowed page size.
@@ -2273,6 +2439,11 @@ module Google
                     #
                     attr_reader :create_backup
                     ##
+                    # RPC-specific configuration for `copy_backup`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :copy_backup
+                    ##
                     # RPC-specific configuration for `get_backup`
                     # @return [::Gapic::Config::Method]
                     #
@@ -2330,6 +2501,8 @@ module Google
                       @test_iam_permissions = ::Gapic::Config::Method.new test_iam_permissions_config
                       create_backup_config = parent_rpcs.create_backup if parent_rpcs.respond_to? :create_backup
                       @create_backup = ::Gapic::Config::Method.new create_backup_config
+                      copy_backup_config = parent_rpcs.copy_backup if parent_rpcs.respond_to? :copy_backup
+                      @copy_backup = ::Gapic::Config::Method.new copy_backup_config
                       get_backup_config = parent_rpcs.get_backup if parent_rpcs.respond_to? :get_backup
                       @get_backup = ::Gapic::Config::Method.new get_backup_config
                       update_backup_config = parent_rpcs.update_backup if parent_rpcs.respond_to? :update_backup

data/lib/google/cloud/spanner/admin/database/v1/database_admin/operations.rb CHANGED Viewed

@@ -97,6 +97,9 @@ module Google
                     channel_args: @config.channel_args,
                     interceptors: @config.interceptors
                   )
+                  # Used by an LRO wrapper for some methods of this service
+                  @operations_client = self
                 end
                 # Service calls

data/lib/google/cloud/spanner/admin/database/v1/version.rb CHANGED Viewed

@@ -23,7 +23,7 @@ module Google
       module Admin
         module Database
           module V1
-            VERSION = "0.7.6"
+            VERSION = "0.10.0"
           end
         end
       end

data/lib/google/spanner/admin/database/v1/backup_pb.rb CHANGED Viewed

@@ -1,13 +1,14 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/admin/database/v1/backup.proto
+require 'google/protobuf'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/spanner/admin/database/v1/common_pb'
-require 'google/protobuf'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/admin/database/v1/backup.proto", :syntax => :proto3) do
@@ -22,6 +23,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :referencing_databases, :string, 7
       optional :encryption_info, :message, 8, "google.spanner.admin.database.v1.EncryptionInfo"
       optional :database_dialect, :enum, 10, "google.spanner.admin.database.v1.DatabaseDialect"
+      repeated :referencing_backups, :string, 11
+      optional :max_expire_time, :message, 12, "google.protobuf.Timestamp"
     end
     add_enum "google.spanner.admin.database.v1.Backup.State" do
       value :STATE_UNSPECIFIED, 0
@@ -40,6 +43,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :progress, :message, 3, "google.spanner.admin.database.v1.OperationProgress"
       optional :cancel_time, :message, 4, "google.protobuf.Timestamp"
     end
+    add_message "google.spanner.admin.database.v1.CopyBackupRequest" do
+      optional :parent, :string, 1
+      optional :backup_id, :string, 2
+      optional :source_backup, :string, 3
+      optional :expire_time, :message, 4, "google.protobuf.Timestamp"
+      optional :encryption_config, :message, 5, "google.spanner.admin.database.v1.CopyBackupEncryptionConfig"
+    end
+    add_message "google.spanner.admin.database.v1.CopyBackupMetadata" do
+      optional :name, :string, 1
+      optional :source_backup, :string, 2
+      optional :progress, :message, 3, "google.spanner.admin.database.v1.OperationProgress"
+      optional :cancel_time, :message, 4, "google.protobuf.Timestamp"
+    end
     add_message "google.spanner.admin.database.v1.UpdateBackupRequest" do
       optional :backup, :message, 1, "google.spanner.admin.database.v1.Backup"
       optional :update_mask, :message, 2, "google.protobuf.FieldMask"
@@ -86,6 +102,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :GOOGLE_DEFAULT_ENCRYPTION, 2
       value :CUSTOMER_MANAGED_ENCRYPTION, 3
     end
+    add_message "google.spanner.admin.database.v1.CopyBackupEncryptionConfig" do
+      optional :encryption_type, :enum, 1, "google.spanner.admin.database.v1.CopyBackupEncryptionConfig.EncryptionType"
+      optional :kms_key_name, :string, 2
+    end
+    add_enum "google.spanner.admin.database.v1.CopyBackupEncryptionConfig.EncryptionType" do
+      value :ENCRYPTION_TYPE_UNSPECIFIED, 0
+      value :USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION, 1
+      value :GOOGLE_DEFAULT_ENCRYPTION, 2
+      value :CUSTOMER_MANAGED_ENCRYPTION, 3
+    end
   end
 end
@@ -99,6 +125,8 @@ module Google
             Backup::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.Backup.State").enummodule
             CreateBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateBackupRequest").msgclass
             CreateBackupMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateBackupMetadata").msgclass
+            CopyBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CopyBackupRequest").msgclass
+            CopyBackupMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CopyBackupMetadata").msgclass
             UpdateBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.UpdateBackupRequest").msgclass
             GetBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.GetBackupRequest").msgclass
             DeleteBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.DeleteBackupRequest").msgclass
@@ -109,6 +137,8 @@ module Google
             BackupInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.BackupInfo").msgclass
             CreateBackupEncryptionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateBackupEncryptionConfig").msgclass
             CreateBackupEncryptionConfig::EncryptionType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CreateBackupEncryptionConfig.EncryptionType").enummodule
+            CopyBackupEncryptionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CopyBackupEncryptionConfig").msgclass
+            CopyBackupEncryptionConfig::EncryptionType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.admin.database.v1.CopyBackupEncryptionConfig.EncryptionType").enummodule
           end
         end
       end

data/lib/google/spanner/admin/database/v1/common_pb.rb CHANGED Viewed

@@ -1,11 +1,12 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/admin/database/v1/common.proto
+require 'google/protobuf'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
-require 'google/protobuf'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/admin/database/v1/common.proto", :syntax => :proto3) do

data/lib/google/spanner/admin/database/v1/spanner_database_admin_pb.rb CHANGED Viewed

@@ -1,6 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/spanner/admin/database/v1/spanner_database_admin.proto
+require 'google/protobuf'
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -12,7 +14,6 @@ require 'google/protobuf/empty_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/spanner/admin/database/v1/backup_pb'
 require 'google/spanner/admin/database/v1/common_pb'
-require 'google/protobuf'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/spanner/admin/database/v1/spanner_database_admin.proto", :syntax => :proto3) do

data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb CHANGED Viewed

@@ -113,6 +113,19 @@ module Google
                 # There can be only one pending backup creation per database. Backup creation
                 # of different databases can run concurrently.
                 rpc :CreateBackup, ::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupRequest, ::Google::Longrunning::Operation
+                # Starts copying a Cloud Spanner Backup.
+                # The returned backup [long-running operation][google.longrunning.Operation]
+                # will have a name of the format
+                # `projects/<project>/instances/<instance>/backups/<backup>/operations/<operation_id>`
+                # and can be used to track copying of the backup. The operation is associated
+                # with the destination backup.
+                # The [metadata][google.longrunning.Operation.metadata] field type is
+                # [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata].
+                # The [response][google.longrunning.Operation.response] field type is
+                # [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned operation will stop the
+                # copying and delete the backup.
+                # Concurrent CopyBackup requests can run on the same source backup.
+                rpc :CopyBackup, ::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupRequest, ::Google::Longrunning::Operation
                 # Gets metadata on a pending or completed [Backup][google.spanner.admin.database.v1.Backup].
                 rpc :GetBackup, ::Google::Cloud::Spanner::Admin::Database::V1::GetBackupRequest, ::Google::Cloud::Spanner::Admin::Database::V1::Backup
                 # Updates a pending or completed [Backup][google.spanner.admin.database.v1.Backup].

data/proto_docs/google/iam/v1/iam_policy.rb CHANGED Viewed

@@ -31,6 +31,13 @@ module Google
       #     the policy is limited to a few 10s of KB. An empty policy is a
       #     valid policy but certain Cloud Platform services (such as Projects)
       #     might reject them.
+      # @!attribute [rw] update_mask
+      #   @return [::Google::Protobuf::FieldMask]
+      #     OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
+      #     the fields in the mask will be modified. If no mask is provided, the
+      #     following default mask is used:
+      #
+      #     `paths: "bindings, etag"`
       class SetIamPolicyRequest
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -44,7 +51,7 @@ module Google
       # @!attribute [rw] options
       #   @return [::Google::Iam::V1::GetPolicyOptions]
       #     OPTIONAL: A `GetPolicyOptions` object for specifying options to
-      #     `GetIamPolicy`. This field is only used by Cloud IAM.
+      #     `GetIamPolicy`.
       class GetIamPolicyRequest
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/iam/v1/options.rb CHANGED Viewed

@@ -23,14 +23,24 @@ module Google
       # Encapsulates settings provided to GetIamPolicy.
       # @!attribute [rw] requested_policy_version
       #   @return [::Integer]
-      #     Optional. The policy format version to be returned.
+      #     Optional. The maximum policy version that will be used to format the
+      #     policy.
       #
       #     Valid values are 0, 1, and 3. Requests specifying an invalid value will be
       #     rejected.
       #
-      #     Requests for policies with any conditional bindings must specify version 3.
-      #     Policies without any conditional bindings may specify any valid value or
-      #     leave the field unset.
+      #     Requests for policies with any conditional role bindings must specify
+      #     version 3. Policies with no conditional role bindings may specify any valid
+      #     value or leave the field unset.
+      #
+      #     The policy in the response might use the policy version that you specified,
+      #     or it might use a lower policy version. For example, if you specify version
+      #     3, but the policy has no conditional role bindings, the response uses
+      #     version 1.
+      #
+      #     To learn which resources support conditions in their IAM policies, see the
+      #     [IAM
+      #     documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       class GetPolicyOptions
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/iam/v1/policy.rb CHANGED Viewed

@@ -20,19 +20,24 @@
 module Google
   module Iam
     module V1
-      # Defines an Identity and Access Management (IAM) policy. It is used to
-      # specify access control policies for Cloud Platform resources.
+      # An Identity and Access Management (IAM) policy, which specifies access
+      # controls for Google Cloud resources.
       #
       #
       # A `Policy` is a collection of `bindings`. A `binding` binds one or more
-      # `members` to a single `role`. Members can be user accounts, service accounts,
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
-      # permissions (defined by IAM or configured by users). A `binding` can
-      # optionally specify a `condition`, which is a logic expression that further
-      # constrains the role binding based on attributes about the request and/or
-      # target resource.
+      # `members`, or principals, to a single `role`. Principals can be user
+      # accounts, service accounts, Google groups, and domains (such as G Suite). A
+      # `role` is a named list of permissions; each `role` can be an IAM predefined
+      # role or a user-created custom role.
       #
-      # **JSON Example**
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      #
+      # **JSON example:**
       #
       #     {
       #       "bindings": [
@@ -47,18 +52,21 @@ module Google
       #         },
       #         {
       #           "role": "roles/resourcemanager.organizationViewer",
-      #           "members": ["user:eve@example.com"],
+      #           "members": [
+      #             "user:eve@example.com"
+      #           ],
       #           "condition": {
       #             "title": "expirable access",
       #             "description": "Does not grant access after Sep 2020",
-      #             "expression": "request.time <
-      #             timestamp('2020-10-01T00:00:00.000Z')",
+      #             "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",
       #           }
       #         }
-      #       ]
+      #       ],
+      #       "etag": "BwWWja0YfJA=",
+      #       "version": 3
       #     }
       #
-      # **YAML Example**
+      # **YAML example:**
       #
       #     bindings:
       #     - members:
@@ -74,30 +82,52 @@ module Google
       #         title: expirable access
       #         description: Does not grant access after Sep 2020
       #         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
+      #     etag: BwWWja0YfJA=
+      #     version: 3
       #
       # For a description of IAM and its features, see the
-      # [IAM developer's guide](https://cloud.google.com/iam/docs).
+      # [IAM documentation](https://cloud.google.com/iam/docs/).
       # @!attribute [rw] version
       #   @return [::Integer]
       #     Specifies the format of the policy.
       #
-      #     Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-      #     rejected.
+      #     Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+      #     are rejected.
+      #
+      #     Any operation that affects conditional role bindings must specify version
+      #     `3`. This requirement applies to the following operations:
       #
-      #     Operations affecting conditional bindings must specify version 3. This can
-      #     be either setting a conditional policy, modifying a conditional binding,
-      #     or removing a binding (conditional or unconditional) from the stored
-      #     conditional policy.
-      #     Operations on non-conditional policies may specify any valid value or
-      #     leave the field unset.
+      #     * Getting a policy that includes a conditional role binding
+      #     * Adding a conditional role binding to a policy
+      #     * Changing a conditional role binding in a policy
+      #     * Removing any role binding, with or without a condition, from a policy
+      #       that includes conditions
       #
-      #     If no etag is provided in the call to `setIamPolicy`, version compliance
-      #     checks against the stored policy is skipped.
+      #     **Important:** If you use IAM Conditions, you must include the `etag` field
+      #     whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+      #     you to overwrite a version `3` policy with a version `1` policy, and all of
+      #     the conditions in the version `3` policy are lost.
+      #
+      #     If a policy does not include any conditions, operations on that policy may
+      #     specify any valid version or leave the field unset.
+      #
+      #     To learn which resources support conditions in their IAM policies, see the
+      #     [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       # @!attribute [rw] bindings
       #   @return [::Array<::Google::Iam::V1::Binding>]
-      #     Associates a list of `members` to a `role`. Optionally may specify a
-      #     `condition` that determines when binding is in effect.
-      #     `bindings` with no members will result in an error.
+      #     Associates a list of `members`, or principals, with a `role`. Optionally,
+      #     may specify a `condition` that determines how and when the `bindings` are
+      #     applied. Each of the `bindings` must contain at least one principal.
+      #
+      #     The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
+      #     of these principals can be Google groups. Each occurrence of a principal
+      #     counts towards these limits. For example, if the `bindings` grant 50
+      #     different roles to `user:alice@example.com`, and not to any other
+      #     principal, then you can add another 1,450 principals to the `bindings` in
+      #     the `Policy`.
+      # @!attribute [rw] audit_configs
+      #   @return [::Array<::Google::Iam::V1::AuditConfig>]
+      #     Specifies cloud audit logging configuration for this policy.
       # @!attribute [rw] etag
       #   @return [::String]
       #     `etag` is used for optimistic concurrency control as a way to help
@@ -108,23 +138,23 @@ module Google
       #     systems are expected to put that etag in the request to `setIamPolicy` to
       #     ensure that their change will be applied to the same version of the policy.
       #
-      #     If no `etag` is provided in the call to `setIamPolicy`, then the existing
-      #     policy is overwritten. Due to blind-set semantics of an etag-less policy,
-      #     'setIamPolicy' will not fail even if the incoming policy version does not
-      #     meet the requirements for modifying the stored policy.
+      #     **Important:** If you use IAM Conditions, you must include the `etag` field
+      #     whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+      #     you to overwrite a version `3` policy with a version `1` policy, and all of
+      #     the conditions in the version `3` policy are lost.
       class Policy
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods
       end
-      # Associates `members` with a `role`.
+      # Associates `members`, or principals, with a `role`.
       # @!attribute [rw] role
       #   @return [::String]
-      #     Role that is assigned to `members`.
+      #     Role that is assigned to the list of `members`, or principals.
       #     For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
       # @!attribute [rw] members
       #   @return [::Array<::String>]
-      #     Specifies the identities requesting access for a Cloud Platform resource.
+      #     Specifies the principals requesting access for a Cloud Platform resource.
       #     `members` can have the following values:
       #
       #     * `allUsers`: A special identifier that represents anyone who is
@@ -143,20 +173,160 @@ module Google
       #     * `group:{emailid}`: An email address that represents a Google group.
       #        For example, `admins@example.com`.
       #
+      #     * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
+      #        identifier) representing a user that has been recently deleted. For
+      #        example, `alice@example.com?uid=123456789012345678901`. If the user is
+      #        recovered, this value reverts to `user:{emailid}` and the recovered user
+      #        retains the role in the binding.
+      #
+      #     * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
+      #        unique identifier) representing a service account that has been recently
+      #        deleted. For example,
+      #        `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+      #        If the service account is undeleted, this value reverts to
+      #        `serviceAccount:{emailid}` and the undeleted service account retains the
+      #        role in the binding.
+      #
+      #     * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
+      #        identifier) representing a Google group that has been recently
+      #        deleted. For example, `admins@example.com?uid=123456789012345678901`. If
+      #        the group is recovered, this value reverts to `group:{emailid}` and the
+      #        recovered group retains the role in the binding.
+      #
       #
       #     * `domain:{domain}`: The G Suite domain (primary) that represents all the
       #        users of that domain. For example, `google.com` or `example.com`.
       # @!attribute [rw] condition
       #   @return [::Google::Type::Expr]
       #     The condition that is associated with this binding.
-      #     NOTE: An unsatisfied condition will not allow user access via current
-      #     binding. Different bindings, including their conditions, are examined
-      #     independently.
+      #
+      #     If the condition evaluates to `true`, then this binding applies to the
+      #     current request.
+      #
+      #     If the condition evaluates to `false`, then this binding does not apply to
+      #     the current request. However, a different role binding might grant the same
+      #     role to one or more of the principals in this binding.
+      #
+      #     To learn which resources support conditions in their IAM policies, see the
+      #     [IAM
+      #     documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
       class Binding
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods
       end
+      # Specifies the audit configuration for a service.
+      # The configuration determines which permission types are logged, and what
+      # identities, if any, are exempted from logging.
+      # An AuditConfig must have one or more AuditLogConfigs.
+      #
+      # If there are AuditConfigs for both `allServices` and a specific service,
+      # the union of the two AuditConfigs is used for that service: the log_types
+      # specified in each AuditConfig are enabled, and the exempted_members in each
+      # AuditLogConfig are exempted.
+      #
+      # Example Policy with multiple AuditConfigs:
+      #
+      #     {
+      #       "audit_configs": [
+      #         {
+      #           "service": "allServices",
+      #           "audit_log_configs": [
+      #             {
+      #               "log_type": "DATA_READ",
+      #               "exempted_members": [
+      #                 "user:jose@example.com"
+      #               ]
+      #             },
+      #             {
+      #               "log_type": "DATA_WRITE"
+      #             },
+      #             {
+      #               "log_type": "ADMIN_READ"
+      #             }
+      #           ]
+      #         },
+      #         {
+      #           "service": "sampleservice.googleapis.com",
+      #           "audit_log_configs": [
+      #             {
+      #               "log_type": "DATA_READ"
+      #             },
+      #             {
+      #               "log_type": "DATA_WRITE",
+      #               "exempted_members": [
+      #                 "user:aliya@example.com"
+      #               ]
+      #             }
+      #           ]
+      #         }
+      #       ]
+      #     }
+      #
+      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+      # logging. It also exempts jose@example.com from DATA_READ logging, and
+      # aliya@example.com from DATA_WRITE logging.
+      # @!attribute [rw] service
+      #   @return [::String]
+      #     Specifies a service that will be enabled for audit logging.
+      #     For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+      #     `allServices` is a special value that covers all services.
+      # @!attribute [rw] audit_log_configs
+      #   @return [::Array<::Google::Iam::V1::AuditLogConfig>]
+      #     The configuration for logging of each type of permission.
+      class AuditConfig
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+      # Provides the configuration for logging a type of permissions.
+      # Example:
+      #
+      #     {
+      #       "audit_log_configs": [
+      #         {
+      #           "log_type": "DATA_READ",
+      #           "exempted_members": [
+      #             "user:jose@example.com"
+      #           ]
+      #         },
+      #         {
+      #           "log_type": "DATA_WRITE"
+      #         }
+      #       ]
+      #     }
+      #
+      # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+      # jose@example.com from DATA_READ logging.
+      # @!attribute [rw] log_type
+      #   @return [::Google::Iam::V1::AuditLogConfig::LogType]
+      #     The log type that this config enables.
+      # @!attribute [rw] exempted_members
+      #   @return [::Array<::String>]
+      #     Specifies the identities that do not cause logging for this type of
+      #     permission.
+      #     Follows the same format of {::Google::Iam::V1::Binding#members Binding.members}.
+      class AuditLogConfig
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+        # The list of valid permission types for which logging can be configured.
+        # Admin writes are always logged, and are not configurable.
+        module LogType
+          # Default case. Should never be this.
+          LOG_TYPE_UNSPECIFIED = 0
+          # Admin reads. Example: CloudIAM getIamPolicy
+          ADMIN_READ = 1
+          # Data writes. Example: CloudSQL Users create
+          DATA_WRITE = 2
+          # Data reads. Example: CloudSQL Users list
+          DATA_READ = 3
+        end
+      end
       # The difference delta between two policies.
       # @!attribute [rw] binding_deltas
       #   @return [::Array<::Google::Iam::V1::BindingDelta>]

data/proto_docs/google/protobuf/any.rb CHANGED Viewed

@@ -44,7 +44,7 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
-    #  Example 3: Pack and unpack a message in Python.
+    # Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +54,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    #  Example 4: Pack and unpack a message in Go
+    # Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
     #
     #
     # JSON
-    # ====
+    #
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/spanner/admin/database/v1/backup.rb CHANGED Viewed

@@ -86,6 +86,22 @@ module Google
             # @!attribute [r] database_dialect
             #   @return [::Google::Cloud::Spanner::Admin::Database::V1::DatabaseDialect]
             #     Output only. The database dialect information for the backup.
+            # @!attribute [r] referencing_backups
+            #   @return [::Array<::String>]
+            #     Output only. The names of the destination backups being created by copying
+            #     this source backup. The backup names are of the form
+            #     `projects/<project>/instances/<instance>/backups/<backup>`.
+            #     Referencing backups may exist in different instances. The existence of
+            #     any referencing backup prevents the backup from being deleted. When the
+            #     copy operation is done (either successfully completed or cancelled or the
+            #     destination backup is deleted), the reference to the backup is removed.
+            # @!attribute [r] max_expire_time
+            #   @return [::Google::Protobuf::Timestamp]
+            #     Output only. The max allowed expiration time of the backup, with
+            #     microseconds granularity. A backup's expiration time can be configured in
+            #     multiple APIs: CreateBackup, UpdateBackup, CopyBackup. When updating or
+            #     copying an existing backup, the expiration time specified must be
+            #     less than `Backup.max_expire_time`.
             class Backup
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -164,6 +180,78 @@ module Google
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+            # The request for {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#copy_backup CopyBackup}.
+            # @!attribute [rw] parent
+            #   @return [::String]
+            #     Required. The name of the destination instance that will contain the backup copy.
+            #     Values are of the form: `projects/<project>/instances/<instance>`.
+            # @!attribute [rw] backup_id
+            #   @return [::String]
+            #     Required. The id of the backup copy.
+            #     The `backup_id` appended to `parent` forms the full backup_uri of the form
+            #     `projects/<project>/instances/<instance>/backups/<backup>`.
+            # @!attribute [rw] source_backup
+            #   @return [::String]
+            #     Required. The source backup to be copied.
+            #     The source backup needs to be in READY state for it to be copied.
+            #     Once CopyBackup is in progress, the source backup cannot be deleted or
+            #     cleaned up on expiration until CopyBackup is finished.
+            #     Values are of the form:
+            #     `projects/<project>/instances/<instance>/backups/<backup>`.
+            # @!attribute [rw] expire_time
+            #   @return [::Google::Protobuf::Timestamp]
+            #     Required. The expiration time of the backup in microsecond granularity.
+            #     The expiration time must be at least 6 hours and at most 366 days
+            #     from the `create_time` of the source backup. Once the `expire_time` has
+            #     passed, the backup is eligible to be automatically deleted by Cloud Spanner
+            #     to free the resources used by the backup.
+            # @!attribute [rw] encryption_config
+            #   @return [::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig]
+            #     Optional. The encryption configuration used to encrypt the backup. If this field is
+            #     not specified, the backup will use the same
+            #     encryption configuration as the source backup by default, namely
+            #     {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig#encryption_type encryption_type} =
+            #     `USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION`.
+            class CopyBackupRequest
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+            # Metadata type for the google.longrunning.Operation returned by
+            # {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#copy_backup CopyBackup}.
+            # @!attribute [rw] name
+            #   @return [::String]
+            #     The name of the backup being created through the copy operation.
+            #     Values are of the form
+            #     `projects/<project>/instances/<instance>/backups/<backup>`.
+            # @!attribute [rw] source_backup
+            #   @return [::String]
+            #     The name of the source backup that is being copied.
+            #     Values are of the form
+            #     `projects/<project>/instances/<instance>/backups/<backup>`.
+            # @!attribute [rw] progress
+            #   @return [::Google::Cloud::Spanner::Admin::Database::V1::OperationProgress]
+            #     The progress of the
+            #     {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#copy_backup CopyBackup} operation.
+            # @!attribute [rw] cancel_time
+            #   @return [::Google::Protobuf::Timestamp]
+            #     The time at which cancellation of CopyBackup operation was received.
+            #     Operations.CancelOperation
+            #     starts asynchronous cancellation on a long-running operation. The server
+            #     makes a best effort to cancel the operation, but success is not guaranteed.
+            #     Clients can use
+            #     Operations.GetOperation or
+            #     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`.
+            class CopyBackupMetadata
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
             # The request for {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#update_backup UpdateBackup}.
             # @!attribute [rw] backup
             #   @return [::Google::Cloud::Spanner::Admin::Database::V1::Backup]
@@ -302,6 +390,8 @@ module Google
             #          for {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} is
             #          `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`.
             #       * `metadata.<field_name>` - any field in metadata.value.
+            #          `metadata.@type` must be specified first if filtering on metadata
+            #          fields.
             #       * `error` - Error associated with the long-running operation.
             #       * `response.@type` - the type of response.
             #       * `response.<field_name>` - any field in response.value.
@@ -313,8 +403,11 @@ module Google
             #     Here are a few examples:
             #
             #       * `done:true` - The operation is complete.
-            #       * `metadata.database:prod` - The database the backup was taken from has
-            #          a name containing the string "prod".
+            #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
+            #          `metadata.database:prod` - Returns operations where:
+            #          * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}.
+            #          * The database the backup was taken from has a name containing the
+            #          string "prod".
             #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
             #         `(metadata.name:howl) AND` \
             #         `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \
@@ -323,6 +416,29 @@ module Google
             #         * The backup name contains the string "howl".
             #         * The operation started before 2018-03-28T14:50:00Z.
             #         * The operation resulted in an error.
+            #       * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata) AND` \
+            #         `(metadata.source_backup:test) AND` \
+            #         `(metadata.progress.start_time < \"2022-01-18T14:50:00Z\") AND` \
+            #         `(error:*)` - Returns operations where:
+            #         * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata}.
+            #         * The source backup of the copied backup name contains the string
+            #         "test".
+            #         * The operation started before 2022-01-18T14:50:00Z.
+            #         * The operation resulted in an error.
+            #       * `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` \
+            #         `(metadata.database:test_db)) OR` \
+            #         `((metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CopyBackupMetadata)
+            #         AND` \
+            #         `(metadata.source_backup:test_bkp)) AND` \
+            #         `(error:*)` - Returns operations where:
+            #         * The operation's metadata matches either of criteria:
+            #           * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata} AND the
+            #           database the backup was taken from has name containing string
+            #           "test_db"
+            #           * The operation's metadata type is {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupMetadata CopyBackupMetadata} AND the
+            #           backup the backup was copied from has name containing string
+            #           "test_bkp"
+            #         * The operation resulted in an error.
             # @!attribute [rw] page_size
             #   @return [::Integer]
             #     Number of operations to be returned in the response. If 0 or
@@ -344,11 +460,11 @@ module Google
             #   @return [::Array<::Google::Longrunning::Operation>]
             #     The list of matching backup [long-running
             #     operations][google.longrunning.Operation]. Each operation's name will be
-            #     prefixed by the backup's name and the operation's
-            #     {::Google::Longrunning::Operation#metadata metadata} will be of type
-            #     {::Google::Cloud::Spanner::Admin::Database::V1::CreateBackupMetadata CreateBackupMetadata}. Operations returned include those that are
-            #     pending or have completed/failed/canceled within the last 7 days.
-            #     Operations returned are ordered by
+            #     prefixed by the backup's name. The operation's
+            #     {::Google::Longrunning::Operation#metadata metadata} field type
+            #     `metadata.type_url` describes the type of the metadata. Operations returned
+            #     include those that are pending or have completed/failed/canceled within the
+            #     last 7 days. Operations returned are ordered by
             #     `operation.metadata.value.progress.start_time` in descending order starting
             #     from the most recently started operation.
             # @!attribute [rw] next_page_token
@@ -419,6 +535,41 @@ module Google
                 CUSTOMER_MANAGED_ENCRYPTION = 3
               end
             end
+            # Encryption configuration for the copied backup.
+            # @!attribute [rw] encryption_type
+            #   @return [::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig::EncryptionType]
+            #     Required. The encryption type of the backup.
+            # @!attribute [rw] kms_key_name
+            #   @return [::String]
+            #     Optional. The Cloud KMS key that will be used to protect the backup.
+            #     This field should be set only when
+            #     {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig#encryption_type encryption_type} is
+            #     `CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form
+            #     `projects/<project>/locations/<location>/keyRings/<key_ring>/cryptoKeys/<kms_key_name>`.
+            class CopyBackupEncryptionConfig
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+              # Encryption types for the backup.
+              module EncryptionType
+                # Unspecified. Do not use.
+                ENCRYPTION_TYPE_UNSPECIFIED = 0
+                # This is the default option for {::Google::Cloud::Spanner::Admin::Database::V1::DatabaseAdmin::Client#copy_backup CopyBackup}
+                # when {::Google::Cloud::Spanner::Admin::Database::V1::CopyBackupEncryptionConfig encryption_config} is not specified.
+                # For example, if the source backup is using `Customer_Managed_Encryption`,
+                # the backup will be using the same Cloud KMS key as the source backup.
+                USE_CONFIG_DEFAULT_OR_BACKUP_ENCRYPTION = 1
+                # Use Google default encryption.
+                GOOGLE_DEFAULT_ENCRYPTION = 2
+                # Use customer managed encryption. If specified, `kms_key_name`
+                # must contain a valid Cloud KMS key.
+                CUSTOMER_MANAGED_ENCRYPTION = 3
+              end
+            end
           end
         end
       end

data/proto_docs/google/spanner/admin/database/v1/spanner_database_admin.rb CHANGED Viewed

@@ -345,6 +345,8 @@ module Google
             #          for {::Google::Cloud::Spanner::Admin::Database::V1::RestoreDatabaseMetadata RestoreDatabaseMetadata} is
             #          `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`.
             #       * `metadata.<field_name>` - any field in metadata.value.
+            #          `metadata.@type` must be specified first, if filtering on metadata
+            #          fields.
             #       * `error` - Error associated with the long-running operation.
             #       * `response.@type` - the type of response.
             #       * `response.<field_name>` - any field in response.value.

metadata CHANGED Viewed

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-admin-database-v1
 version: !ruby/object:Gem::Version
-  version: 0.7.6
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-17 00:00:00.000000000 Z
+date: 2022-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -48,50 +48,44 @@ dependencies:
   name: grpc-google-iam-v1
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.6.10
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.6.10
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
 - !ruby/object:Gem::Dependency
   name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
@@ -126,14 +120,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -230,14 +224,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.5
+rubygems_version: 3.3.14
 signing_key:
 specification_version: 4
 summary: API Client library for the Cloud Spanner Database Admin V1 API