google-cloud-spanner-admin-instance-v1 2.2.0 → 2.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18489c4194fcfa2273d6353c35bf0eebca1d2937cba2e2a7b0da0a5365bb9a3e
-  data.tar.gz: b72a05fc7fe949f68359467040494d51383b9c17a6c134f298085884ebedced5
+  metadata.gz: ef292935a88b699b97eacbceff0f7b4c563e24c917b59da0de9fcd9568c5bf0a
+  data.tar.gz: 59b317d338d1071b284ead4a1de20ccee5c011851ecec550b6bb0fa8fdc6ab1b
 SHA512:
-  metadata.gz: 57dc1c15f07d95573a40f7a8227091ec4e87c9ff5eb213662fc774b755fe6c2419576b1baf98b7da3d1ba63054345c5a9452d84d8ebbbe32761f208f9fea9197
-  data.tar.gz: 44db536abd0c174371b663cd5b0adcd4664ce3b7b950a7b92da981fd13bea0d561a1be20963cfe7371356a8c666dee99547026d7bc3fa8b828f28a30a105ec00
+  metadata.gz: 5ebab0e2585b4e0d0d445c5c04adf92ecd6a65318beb8bd1394feb380ee25852f6dd0ed8cea1a2b9832f4d7a49c57d74b4ac55cd0c77f695db82ab0ee75d727b
+  data.tar.gz: e4743e21407b77fc4efb69417a650275c918dd942434133794ea7213cfc1551fae1902a2bcf3c09999785979a6edea98cb22a06ff8590dc053b57f5891eadd63

data/lib/google/cloud/spanner/admin/instance/v1/instance_admin/client.rb

@@ -2827,8 +2827,6 @@ module Google
                 #   @return [::String,nil]
                 # @!attribute [rw] credentials
                 #   Credentials to send with calls. You may provide any of the following types:
-                #    *  (`String`) The path to a service account key file in JSON format
-                #    *  (`Hash`) A service account key as a Hash
                 #    *  (`Google::Auth::Credentials`) A googleauth credentials object
                 #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
                 #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -2837,7 +2835,26 @@ module Google
                 #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
                 #    *  (`nil`) indicating no credentials
                 #
-                #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+                #   @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
+                #     is deprecated. Providing an unvalidated credential configuration to
+                #     Google APIs can compromise the security of your systems and data.
+                #
+                #   @example
+                #
+                #     # The recommended way to provide credentials is to use the `make_creds` method
+                #     # on the appropriate credentials class for your environment.
+                #
+                #     require "googleauth"
+                #
+                #     credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+                #       json_key_io: ::File.open("/path/to/keyfile.json")
+                #     )
+                #
+                #     client = ::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client.new do |config|
+                #       config.credentials = credentials
+                #     end
+                #
+                #   @note 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.

data/lib/google/cloud/spanner/admin/instance/v1/instance_admin/operations.rb

@@ -136,7 +136,7 @@ module Google
                 #   @param options [::Gapic::CallOptions, ::Hash]
                 #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
                 #
-                # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+                # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
                 #   Pass arguments to `list_operations` 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).
@@ -149,6 +149,17 @@ module Google
                 #     The standard list page size.
                 #   @param page_token [::String]
                 #     The standard list page token.
+                #   @param return_partial_success [::Boolean]
+                #     When set to `true`, operations that are reachable are returned as normal,
+                #     and those that are unreachable are returned in the
+                #     [ListOperationsResponse.unreachable] field.
+                #
+                #     This can only be `true` when reading across collections e.g. when `parent`
+                #     is set to `"projects/example/locations/-"`.
+                #
+                #     This field is not by default supported and will result in an
+                #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+                #     service or product specific documentation.
                 #
                 # @yield [response, operation] Access the result along with the RPC operation
                 # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -633,8 +644,6 @@ module Google
                 #   @return [::String,nil]
                 # @!attribute [rw] credentials
                 #   Credentials to send with calls. You may provide any of the following types:
-                #    *  (`String`) The path to a service account key file in JSON format
-                #    *  (`Hash`) A service account key as a Hash
                 #    *  (`Google::Auth::Credentials`) A googleauth credentials object
                 #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
                 #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -643,7 +652,26 @@ module Google
                 #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
                 #    *  (`nil`) indicating no credentials
                 #
-                #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+                #   @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
+                #     is deprecated. Providing an unvalidated credential configuration to
+                #     Google APIs can compromise the security of your systems and data.
+                #
+                #   @example
+                #
+                #     # The recommended way to provide credentials is to use the `make_creds` method
+                #     # on the appropriate credentials class for your environment.
+                #
+                #     require "googleauth"
+                #
+                #     credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+                #       json_key_io: ::File.open("/path/to/keyfile.json")
+                #     )
+                #
+                #     client = ::Google::Longrunning::Operations::Client.new do |config|
+                #       config.credentials = credentials
+                #     end
+                #
+                #   @note 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.

data/lib/google/cloud/spanner/admin/instance/v1/instance_admin/rest/operations.rb

@@ -127,7 +127,7 @@ module Google
                   #   @param options [::Gapic::CallOptions, ::Hash]
                   #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
                   #
-                  # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+                  # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
                   #   Pass arguments to `list_operations` 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).
@@ -140,6 +140,17 @@ module Google
                   #     The standard list page size.
                   #   @param page_token [::String]
                   #     The standard list page token.
+                  #   @param return_partial_success [::Boolean]
+                  #     When set to `true`, operations that are reachable are returned as normal,
+                  #     and those that are unreachable are returned in the
+                  #     [ListOperationsResponse.unreachable] field.
+                  #
+                  #     This can only be `true` when reading across collections e.g. when `parent`
+                  #     is set to `"projects/example/locations/-"`.
+                  #
+                  #     This field is not by default supported and will result in an
+                  #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+                  #     service or product specific documentation.
                   # @yield [result, operation] Access the result along with the TransportOperation object
                   # @yieldparam result [::Gapic::Operation]
                   # @yieldparam operation [::Gapic::Rest::TransportOperation]

data/lib/google/cloud/spanner/admin/instance/v1/version.rb

@@ -23,7 +23,7 @@ module Google
       module Admin
         module Instance
           module V1
-            VERSION = "2.2.0"
+            VERSION = "2.3.1"
           end
         end
       end

data/proto_docs/google/longrunning/operations.rb

@@ -83,6 +83,18 @@ module Google
     # @!attribute [rw] page_token
     #   @return [::String]
     #     The standard list page token.
+    # @!attribute [rw] return_partial_success
+    #   @return [::Boolean]
+    #     When set to `true`, operations that are reachable are returned as normal,
+    #     and those that are unreachable are returned in the
+    #     [ListOperationsResponse.unreachable] field.
+    #
+    #     This can only be `true` when reading across collections e.g. when `parent`
+    #     is set to `"projects/example/locations/-"`.
+    #
+    #     This field is not by default supported and will result in an
+    #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+    #     service or product specific documentation.
     class ListOperationsRequest
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -96,6 +108,12 @@ module Google
     # @!attribute [rw] next_page_token
     #   @return [::String]
     #     The standard List next-page token.
+    # @!attribute [rw] unreachable
+    #   @return [::Array<::String>]
+    #     Unordered list. Unreachable resources. Populated when the request sets
+    #     `ListOperationsRequest.return_partial_success` and reads across
+    #     collections e.g. when attempting to list all resources across all supported
+    #     locations.
     class ListOperationsResponse
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner-admin-instance-v1
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.3.1
 platform: ruby
 authors:
 - Google LLC