google-cloud-gke_backup-v1 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7719f3f7f3b5cfa2ce2d2048056e3c2e0c823ae239037e8d77052e315928790f
-  data.tar.gz: 1c5b87a2bed969c8d4b476306ab26a6ab3e66e463d4785711edfdb18b484e884
+  metadata.gz: c2be2b1a312ce59f8927177ecb25dddecde1bd58cc1de8cc96aeee6adf280cbf
+  data.tar.gz: 395d2792ee9c9ed25297b74454e85e8e1431a5871abd3b3075fab521c409aef8
 SHA512:
-  metadata.gz: a57ea665b28709d0e3f06574d6fc54de1ba556c9796b074c5d9f5c950d389000bab6bda9b13acbfeaa074b55d0cc4187f766bc547d9ebb742c80dc59a9ee99da
-  data.tar.gz: fb61e9611118550eb87232d51c6b9dc697874dbc802e03bf3c6c4138191153e44147baefacaa753a57248ae50e82d585a1a345ac1420f4d354eb1392a842863a
+  metadata.gz: a490c63a12342323f865b7df6240b26603bb49eceeba7f33d77fe99e5b74c5fc6e48e0bb01f85896734285f8aa263c7415524ead93ba17c069d81600836f34e7
+  data.tar.gz: 9cb99a2f3ed7ceede75bec301bc56a2ffe8bb7cf08e908f6128b66cf2dfd611f2b2d742be10811a436b17441242fa26a5793f5166dce92dfd1c598fe5d8cfd99

data/lib/google/cloud/gke_backup/v1/backup_for_gke/client.rb

@@ -243,7 +243,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -799,11 +800,11 @@ module Google
             #     The client-provided short name for the Backup resource.
             #     This name must:
             #
-            #      - be between 1 and 63 characters long (inclusive)
-            #      - consist of only lower-case ASCII letters, numbers, and dashes
-            #      - start with a lower-case letter
-            #      - end with a lower-case letter or number
-            #      - be unique within the set of Backups in this BackupPlan
+            #     - be between 1 and 63 characters long (inclusive)
+            #     - consist of only lower-case ASCII letters, numbers, and dashes
+            #     - start with a lower-case letter
+            #     - end with a lower-case letter or number
+            #     - be unique within the set of Backups in this BackupPlan
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -1499,11 +1500,11 @@ module Google
             #     Required. The client-provided short name for the RestorePlan resource.
             #     This name must:
             #
-            #      - be between 1 and 63 characters long (inclusive)
-            #      - consist of only lower-case ASCII letters, numbers, and dashes
-            #      - start with a lower-case letter
-            #      - end with a lower-case letter or number
-            #      - be unique within the set of RestorePlans in this location
+            #     - be between 1 and 63 characters long (inclusive)
+            #     - consist of only lower-case ASCII letters, numbers, and dashes
+            #     - start with a lower-case letter
+            #     - end with a lower-case letter or number
+            #     - be unique within the set of RestorePlans in this location
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -2004,11 +2005,11 @@ module Google
             #     Required. The client-provided short name for the Restore resource.
             #     This name must:
             #
-            #      - be between 1 and 63 characters long (inclusive)
-            #      - consist of only lower-case ASCII letters, numbers, and dashes
-            #      - start with a lower-case letter
-            #      - end with a lower-case letter or number
-            #      - be unique within the set of Restores in this RestorePlan.
+            #     - be between 1 and 63 characters long (inclusive)
+            #     - consist of only lower-case ASCII letters, numbers, and dashes
+            #     - start with a lower-case letter
+            #     - end with a lower-case letter or number
+            #     - be unique within the set of Restores in this RestorePlan.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -2796,6 +2797,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the BackupForGKE API.
               #

data/lib/google/cloud/gke_backup/v1/backup_for_gke/operations.rb

@@ -93,7 +93,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
 
               # Used by an LRO wrapper for some methods of this service
@@ -701,6 +702,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Operations API.
               #

data/lib/google/cloud/gke_backup/v1/backup_for_gke/rest/client.rb

@@ -302,6 +302,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::CreateBackupPlanRequest.new
+              #
+              #   # Call the create_backup_plan method.
+              #   result = client.create_backup_plan request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_backup_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -384,6 +407,26 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::ListBackupPlansResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::ListBackupPlansRequest.new
+              #
+              #   # Call the list_backup_plans method.
+              #   result = client.list_backup_plans request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::GkeBackup::V1::BackupPlan.
+              #     p item
+              #   end
+              #
               def list_backup_plans request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -447,6 +490,22 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::BackupPlan]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::GetBackupPlanRequest.new
+              #
+              #   # Call the get_backup_plan method.
+              #   result = client.get_backup_plan request
+              #
+              #   # The returned object is of type Google::Cloud::GkeBackup::V1::BackupPlan.
+              #   p result
+              #
               def get_backup_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -520,6 +579,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::UpdateBackupPlanRequest.new
+              #
+              #   # Call the update_backup_plan method.
+              #   result = client.update_backup_plan request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def update_backup_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -588,6 +670,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::DeleteBackupPlanRequest.new
+              #
+              #   # Call the delete_backup_plan method.
+              #   result = client.delete_backup_plan request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def delete_backup_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -651,11 +756,11 @@ module Google
               #     The client-provided short name for the Backup resource.
               #     This name must:
               #
-              #      - be between 1 and 63 characters long (inclusive)
-              #      - consist of only lower-case ASCII letters, numbers, and dashes
-              #      - start with a lower-case letter
-              #      - end with a lower-case letter or number
-              #      - be unique within the set of Backups in this BackupPlan
+              #     - be between 1 and 63 characters long (inclusive)
+              #     - consist of only lower-case ASCII letters, numbers, and dashes
+              #     - start with a lower-case letter
+              #     - end with a lower-case letter or number
+              #     - be unique within the set of Backups in this BackupPlan
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -663,6 +768,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::CreateBackupRequest.new
+              #
+              #   # Call the create_backup method.
+              #   result = client.create_backup request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_backup request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -745,6 +873,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::Backup>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::ListBackupsRequest.new
+              #
+              #   # Call the list_backups method.
+              #   result = client.list_backups request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::GkeBackup::V1::Backup.
+              #     p item
+              #   end
+              #
               def list_backups request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -809,6 +957,22 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::Backup]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::GetBackupRequest.new
+              #
+              #   # Call the get_backup method.
+              #   result = client.get_backup request
+              #
+              #   # The returned object is of type Google::Cloud::GkeBackup::V1::Backup.
+              #   p result
+              #
               def get_backup request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -881,6 +1045,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::UpdateBackupRequest.new
+              #
+              #   # Call the update_backup method.
+              #   result = client.update_backup request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def update_backup request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -953,6 +1140,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::DeleteBackupRequest.new
+              #
+              #   # Call the delete_backup method.
+              #   result = client.delete_backup request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def delete_backup request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1035,6 +1245,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::VolumeBackup>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::ListVolumeBackupsRequest.new
+              #
+              #   # Call the list_volume_backups method.
+              #   result = client.list_volume_backups request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::GkeBackup::V1::VolumeBackup.
+              #     p item
+              #   end
+              #
               def list_volume_backups request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1099,6 +1329,22 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::VolumeBackup]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::GetVolumeBackupRequest.new
+              #
+              #   # Call the get_volume_backup method.
+              #   result = client.get_volume_backup request
+              #
+              #   # The returned object is of type Google::Cloud::GkeBackup::V1::VolumeBackup.
+              #   p result
+              #
               def get_volume_backup request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1161,11 +1407,11 @@ module Google
               #     Required. The client-provided short name for the RestorePlan resource.
               #     This name must:
               #
-              #      - be between 1 and 63 characters long (inclusive)
-              #      - consist of only lower-case ASCII letters, numbers, and dashes
-              #      - start with a lower-case letter
-              #      - end with a lower-case letter or number
-              #      - be unique within the set of RestorePlans in this location
+              #     - be between 1 and 63 characters long (inclusive)
+              #     - consist of only lower-case ASCII letters, numbers, and dashes
+              #     - start with a lower-case letter
+              #     - end with a lower-case letter or number
+              #     - be unique within the set of RestorePlans in this location
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1173,6 +1419,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::CreateRestorePlanRequest.new
+              #
+              #   # Call the create_restore_plan method.
+              #   result = client.create_restore_plan request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_restore_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1255,6 +1524,26 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::ListRestorePlansResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::ListRestorePlansRequest.new
+              #
+              #   # Call the list_restore_plans method.
+              #   result = client.list_restore_plans request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::GkeBackup::V1::RestorePlan.
+              #     p item
+              #   end
+              #
               def list_restore_plans request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1318,6 +1607,22 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::RestorePlan]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::GetRestorePlanRequest.new
+              #
+              #   # Call the get_restore_plan method.
+              #   result = client.get_restore_plan request
+              #
+              #   # The returned object is of type Google::Cloud::GkeBackup::V1::RestorePlan.
+              #   p result
+              #
               def get_restore_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1390,6 +1695,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::UpdateRestorePlanRequest.new
+              #
+              #   # Call the update_restore_plan method.
+              #   result = client.update_restore_plan request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def update_restore_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1462,6 +1790,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::DeleteRestorePlanRequest.new
+              #
+              #   # Call the delete_restore_plan method.
+              #   result = client.delete_restore_plan request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def delete_restore_plan request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1525,11 +1876,11 @@ module Google
               #     Required. The client-provided short name for the Restore resource.
               #     This name must:
               #
-              #      - be between 1 and 63 characters long (inclusive)
-              #      - consist of only lower-case ASCII letters, numbers, and dashes
-              #      - start with a lower-case letter
-              #      - end with a lower-case letter or number
-              #      - be unique within the set of Restores in this RestorePlan.
+              #     - be between 1 and 63 characters long (inclusive)
+              #     - consist of only lower-case ASCII letters, numbers, and dashes
+              #     - start with a lower-case letter
+              #     - end with a lower-case letter or number
+              #     - be unique within the set of Restores in this RestorePlan.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1537,6 +1888,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::CreateRestoreRequest.new
+              #
+              #   # Call the create_restore method.
+              #   result = client.create_restore request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def create_restore request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1619,6 +1993,26 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::ListRestoresResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::ListRestoresRequest.new
+              #
+              #   # Call the list_restores method.
+              #   result = client.list_restores request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::GkeBackup::V1::Restore.
+              #     p item
+              #   end
+              #
               def list_restores request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1682,6 +2076,22 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::Restore]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::GetRestoreRequest.new
+              #
+              #   # Call the get_restore method.
+              #   result = client.get_restore request
+              #
+              #   # The returned object is of type Google::Cloud::GkeBackup::V1::Restore.
+              #   p result
+              #
               def get_restore request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1754,6 +2164,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::UpdateRestoreRequest.new
+              #
+              #   # Call the update_restore method.
+              #   result = client.update_restore request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def update_restore request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1826,6 +2259,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::DeleteRestoreRequest.new
+              #
+              #   # Call the delete_restore method.
+              #   result = client.delete_restore request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def delete_restore request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1908,6 +2364,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeBackup::V1::VolumeRestore>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::ListVolumeRestoresRequest.new
+              #
+              #   # Call the list_volume_restores method.
+              #   result = client.list_volume_restores request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::GkeBackup::V1::VolumeRestore.
+              #     p item
+              #   end
+              #
               def list_volume_restores request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1972,6 +2448,22 @@ module Google
               # @return [::Google::Cloud::GkeBackup::V1::VolumeRestore]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/gke_backup/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::GkeBackup::V1::BackupForGKE::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::GkeBackup::V1::GetVolumeRestoreRequest.new
+              #
+              #   # Call the get_volume_restore method.
+              #   result = client.get_volume_restore request
+              #
+              #   # The returned object is of type Google::Cloud::GkeBackup::V1::VolumeRestore.
+              #   p result
+              #
               def get_volume_restore request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/gke_backup/v1/backup_for_gke/rest/operations.rb

@@ -136,6 +136,26 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::ListOperationsRequest.new
+              #
+              #   # Call the list_operations method.
+              #   result = client.list_operations request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Longrunning::Operation.
+              #     p item
+              #   end
+              #
               def list_operations request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -201,6 +221,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::GetOperationRequest.new
+              #
+              #   # Call the get_operation method.
+              #   result = client.get_operation request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def get_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -267,6 +310,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::DeleteOperationRequest.new
+              #
+              #   # Call the delete_operation method.
+              #   result = client.delete_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -338,6 +397,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::CancelOperationRequest.new
+              #
+              #   # Call the cancel_operation method.
+              #   result = client.cancel_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def cancel_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/gke_backup/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module GkeBackup
       module V1
-        VERSION = "0.5.0"
+        VERSION = "0.6.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

data/proto_docs/google/cloud/gkebackup/v1/gkebackup.rb

@@ -185,11 +185,11 @@ module Google
         #     The client-provided short name for the Backup resource.
         #     This name must:
         #
-        #      - be between 1 and 63 characters long (inclusive)
-        #      - consist of only lower-case ASCII letters, numbers, and dashes
-        #      - start with a lower-case letter
-        #      - end with a lower-case letter or number
-        #      - be unique within the set of Backups in this BackupPlan
+        #     - be between 1 and 63 characters long (inclusive)
+        #     - consist of only lower-case ASCII letters, numbers, and dashes
+        #     - start with a lower-case letter
+        #     - end with a lower-case letter or number
+        #     - be unique within the set of Backups in this BackupPlan
         class CreateBackupRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -363,11 +363,11 @@ module Google
         #     Required. The client-provided short name for the RestorePlan resource.
         #     This name must:
         #
-        #      - be between 1 and 63 characters long (inclusive)
-        #      - consist of only lower-case ASCII letters, numbers, and dashes
-        #      - start with a lower-case letter
-        #      - end with a lower-case letter or number
-        #      - be unique within the set of RestorePlans in this location
+        #     - be between 1 and 63 characters long (inclusive)
+        #     - consist of only lower-case ASCII letters, numbers, and dashes
+        #     - start with a lower-case letter
+        #     - end with a lower-case letter or number
+        #     - be unique within the set of RestorePlans in this location
         class CreateRestorePlanRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -487,11 +487,11 @@ module Google
         #     Required. The client-provided short name for the Restore resource.
         #     This name must:
         #
-        #      - be between 1 and 63 characters long (inclusive)
-        #      - consist of only lower-case ASCII letters, numbers, and dashes
-        #      - start with a lower-case letter
-        #      - end with a lower-case letter or number
-        #      - be unique within the set of Restores in this RestorePlan.
+        #     - be between 1 and 63 characters long (inclusive)
+        #     - consist of only lower-case ASCII letters, numbers, and dashes
+        #     - start with a lower-case letter
+        #     - end with a lower-case letter or number
+        #     - be unique within the set of Restores in this RestorePlan.
         class CreateRestoreRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-gke_backup-v1
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-27 00:00:00.000000000 Z
+date: 2023-09-12 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.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -271,7 +271,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Backup for GKE is a managed Kubernetes workload backup and restore service