google-cloud-bigquery-reservation-v1 0.4.0 → 0.5.0

data/lib/google/cloud/bigquery/reservation/v1/reservation_service/client.rb

@@ -81,17 +81,17 @@ module Google
 
                   default_config.rpcs.create_reservation.timeout = 300.0
 
-                  default_config.rpcs.list_reservations.timeout = 60.0
+                  default_config.rpcs.list_reservations.timeout = 300.0
                   default_config.rpcs.list_reservations.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.get_reservation.timeout = 60.0
+                  default_config.rpcs.get_reservation.timeout = 300.0
                   default_config.rpcs.get_reservation.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.delete_reservation.timeout = 60.0
+                  default_config.rpcs.delete_reservation.timeout = 300.0
                   default_config.rpcs.delete_reservation.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
@@ -100,17 +100,17 @@ module Google
 
                   default_config.rpcs.create_capacity_commitment.timeout = 300.0
 
-                  default_config.rpcs.list_capacity_commitments.timeout = 60.0
+                  default_config.rpcs.list_capacity_commitments.timeout = 300.0
                   default_config.rpcs.list_capacity_commitments.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.get_capacity_commitment.timeout = 60.0
+                  default_config.rpcs.get_capacity_commitment.timeout = 300.0
                   default_config.rpcs.get_capacity_commitment.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.delete_capacity_commitment.timeout = 60.0
+                  default_config.rpcs.delete_capacity_commitment.timeout = 300.0
                   default_config.rpcs.delete_capacity_commitment.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
@@ -123,24 +123,24 @@ module Google
 
                   default_config.rpcs.create_assignment.timeout = 300.0
 
-                  default_config.rpcs.list_assignments.timeout = 60.0
+                  default_config.rpcs.list_assignments.timeout = 300.0
                   default_config.rpcs.list_assignments.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.delete_assignment.timeout = 60.0
+                  default_config.rpcs.delete_assignment.timeout = 300.0
                   default_config.rpcs.delete_assignment.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
-                  default_config.rpcs.search_assignments.timeout = 60.0
+                  default_config.rpcs.search_assignments.timeout = 300.0
                   default_config.rpcs.search_assignments.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
                   default_config.rpcs.move_assignment.timeout = 300.0
 
-                  default_config.rpcs.get_bi_reservation.timeout = 60.0
+                  default_config.rpcs.get_bi_reservation.timeout = 300.0
                   default_config.rpcs.get_bi_reservation.retry_policy = {
                     initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
@@ -249,8 +249,9 @@ module Google
               #     Required. Project, location. E.g.,
               #     `projects/myproject/locations/US`
               #   @param reservation_id [::String]
-              #     The reservation ID. This field must only contain lower case alphanumeric
-              #     characters or dash. Max length is 64 characters.
+              #     The reservation ID. It must only contain lower case alphanumeric
+              #     characters or dashes. It must start with a letter and must not end
+              #     with a dash. Its maximum length is 64 characters.
               #   @param reservation [::Google::Cloud::Bigquery::Reservation::V1::Reservation, ::Hash]
               #     Definition of the new reservation to create.
               #
@@ -262,6 +263,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::CreateReservationRequest.new
+              #
+              #   # Call the create_reservation method.
+              #   result = client.create_reservation request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Reservation.
+              #   p result
+              #
               def create_reservation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -279,9 +295,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -335,6 +353,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::ListReservationsRequest.new
+              #
+              #   # Call the list_reservations method.
+              #   result = client.list_reservations request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can
+              #   # iterate over all elements by calling #each, and the enumerable
+              #   # will lazily make API calls to fetch subsequent pages. Other
+              #   # methods are also available for managing paging directly.
+              #   result.each do |response|
+              #     # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Reservation.
+              #     p response
+              #   end
+              #
               def list_reservations request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -352,9 +391,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -405,6 +446,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::GetReservationRequest.new
+              #
+              #   # Call the get_reservation method.
+              #   result = client.get_reservation request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Reservation.
+              #   p result
+              #
               def get_reservation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -422,9 +478,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -476,6 +534,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::DeleteReservationRequest.new
+              #
+              #   # Call the delete_reservation method.
+              #   result = client.delete_reservation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_reservation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -493,9 +566,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -546,6 +621,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::UpdateReservationRequest.new
+              #
+              #   # Call the update_reservation method.
+              #   result = client.update_reservation request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Reservation.
+              #   p result
+              #
               def update_reservation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -563,9 +653,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "reservation.name" => request.reservation.name
-                }
+                header_params = {}
+                if request.reservation&.name
+                  header_params["reservation.name"] = request.reservation.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -614,8 +706,8 @@ module Google
               #   @param capacity_commitment_id [::String]
               #     The optional capacity commitment ID. Capacity commitment name will be
               #     generated automatically if this field is empty.
-              #     This field must only contain lower case alphanumeric characters or dash.
-              #     Max length is 64 characters.
+              #     This field must only contain lower case alphanumeric characters or dashes.
+              #     The first and last character cannot be a dash. Max length is 64 characters.
               #     NOTE: this ID won't be kept if the capacity commitment is split or merged.
               #
               # @yield [response, operation] Access the result along with the RPC operation
@@ -626,6 +718,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::CreateCapacityCommitmentRequest.new
+              #
+              #   # Call the create_capacity_commitment method.
+              #   result = client.create_capacity_commitment request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
+              #   p result
+              #
               def create_capacity_commitment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -643,9 +750,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -699,6 +808,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::ListCapacityCommitmentsRequest.new
+              #
+              #   # Call the list_capacity_commitments method.
+              #   result = client.list_capacity_commitments request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can
+              #   # iterate over all elements by calling #each, and the enumerable
+              #   # will lazily make API calls to fetch subsequent pages. Other
+              #   # methods are also available for managing paging directly.
+              #   result.each do |response|
+              #     # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
+              #     p response
+              #   end
+              #
               def list_capacity_commitments request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -716,9 +846,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -769,6 +901,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::GetCapacityCommitmentRequest.new
+              #
+              #   # Call the get_capacity_commitment method.
+              #   result = client.get_capacity_commitment request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
+              #   p result
+              #
               def get_capacity_commitment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -786,9 +933,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -844,6 +993,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::DeleteCapacityCommitmentRequest.new
+              #
+              #   # Call the delete_capacity_commitment method.
+              #   result = client.delete_capacity_commitment request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_capacity_commitment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -861,9 +1025,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -920,6 +1086,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::UpdateCapacityCommitmentRequest.new
+              #
+              #   # Call the update_capacity_commitment method.
+              #   result = client.update_capacity_commitment request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
+              #   p result
+              #
               def update_capacity_commitment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -937,9 +1118,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "capacity_commitment.name" => request.capacity_commitment.name
-                }
+                header_params = {}
+                if request.capacity_commitment&.name
+                  header_params["capacity_commitment.name"] = request.capacity_commitment.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -967,7 +1150,7 @@ module Google
               #
               # For example, in order to downgrade from 10000 slots to 8000, you might
               # split a 10000 capacity commitment into commitments of 2000 and 8000. Then,
-              # you would change the plan of the first one to `FLEX` and then delete it.
+              # you delete the first one after the commitment end time passes.
               #
               # @overload split_capacity_commitment(request, options = nil)
               #   Pass arguments to `split_capacity_commitment` via a request object, either of type
@@ -998,6 +1181,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentRequest.new
+              #
+              #   # Call the split_capacity_commitment method.
+              #   result = client.split_capacity_commitment request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::SplitCapacityCommitmentResponse.
+              #   p result
+              #
               def split_capacity_commitment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1015,9 +1213,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1079,6 +1279,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::MergeCapacityCommitmentsRequest.new
+              #
+              #   # Call the merge_capacity_commitments method.
+              #   result = client.merge_capacity_commitments request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::CapacityCommitment.
+              #   p result
+              #
               def merge_capacity_commitments request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1096,9 +1311,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -1178,7 +1395,7 @@ module Google
               #   @param assignment_id [::String]
               #     The optional assignment ID. Assignment name will be generated automatically
               #     if this field is empty.
-              #     This field must only contain lower case alphanumeric characters or dash.
+              #     This field must only contain lower case alphanumeric characters or dashes.
               #     Max length is 64 characters.
               #
               # @yield [response, operation] Access the result along with the RPC operation
@@ -1189,6 +1406,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::CreateAssignmentRequest.new
+              #
+              #   # Call the create_assignment method.
+              #   result = client.create_assignment request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Assignment.
+              #   p result
+              #
               def create_assignment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1206,9 +1438,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -1287,6 +1521,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::ListAssignmentsRequest.new
+              #
+              #   # Call the list_assignments method.
+              #   result = client.list_assignments request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can
+              #   # iterate over all elements by calling #each, and the enumerable
+              #   # will lazily make API calls to fetch subsequent pages. Other
+              #   # methods are also available for managing paging directly.
+              #   result.each do |response|
+              #     # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Assignment.
+              #     p response
+              #   end
+              #
               def list_assignments request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1304,9 +1559,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -1371,6 +1628,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::DeleteAssignmentRequest.new
+              #
+              #   # Call the delete_assignment method.
+              #   result = client.delete_assignment request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_assignment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1388,9 +1660,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1411,8 +1685,8 @@ module Google
               end
 
               ##
-              # Deprecated: Looks up assignments for a specified resource for a particular region.
-              # If the request is about a project:
+              # Deprecated: Looks up assignments for a specified resource for a particular
+              # region. If the request is about a project:
               #
               # 1. Assignments created on the project will be returned if they exist.
               # 2. Otherwise assignments created on the closest ancestor will be
@@ -1477,6 +1751,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::SearchAssignmentsRequest.new
+              #
+              #   # Call the search_assignments method.
+              #   result = client.search_assignments request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can
+              #   # iterate over all elements by calling #each, and the enumerable
+              #   # will lazily make API calls to fetch subsequent pages. Other
+              #   # methods are also available for managing paging directly.
+              #   result.each do |response|
+              #     # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Assignment.
+              #     p response
+              #   end
+              #
               def search_assignments request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1494,9 +1789,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -1579,6 +1876,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::SearchAllAssignmentsRequest.new
+              #
+              #   # Call the search_all_assignments method.
+              #   result = client.search_all_assignments request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can
+              #   # iterate over all elements by calling #each, and the enumerable
+              #   # will lazily make API calls to fetch subsequent pages. Other
+              #   # methods are also available for managing paging directly.
+              #   result.each do |response|
+              #     # Each element is of type ::Google::Cloud::Bigquery::Reservation::V1::Assignment.
+              #     p response
+              #   end
+              #
               def search_all_assignments request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1596,9 +1914,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                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
 
@@ -1657,6 +1977,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::MoveAssignmentRequest.new
+              #
+              #   # Call the move_assignment method.
+              #   result = client.move_assignment request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Assignment.
+              #   p result
+              #
               def move_assignment request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1674,9 +2009,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1696,6 +2033,95 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Updates an existing assignment.
+              #
+              # Only the `priority` field can be updated.
+              #
+              # @overload update_assignment(request, options = nil)
+              #   Pass arguments to `update_assignment` via a request object, either of type
+              #   {::Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest, ::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 update_assignment(assignment: nil, update_mask: nil)
+              #   Pass arguments to `update_assignment` 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 assignment [::Google::Cloud::Bigquery::Reservation::V1::Assignment, ::Hash]
+              #     Content of the assignment to update.
+              #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+              #     Standard field mask for the set of fields to be updated.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Google::Cloud::Bigquery::Reservation::V1::Assignment]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest.new
+              #
+              #   # Call the update_assignment method.
+              #   result = client.update_assignment request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::Assignment.
+              #   p result
+              #
+              def update_assignment request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Bigquery::Reservation::V1::UpdateAssignmentRequest
+
+                # 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.update_assignment.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::Bigquery::Reservation::V1::VERSION
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {}
+                if request.assignment&.name
+                  header_params["assignment.name"] = request.assignment.name
+                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.update_assignment.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.update_assignment.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @reservation_service_stub.call_rpc :update_assignment, request, options: options do |response, operation|
+                  yield response, operation if block_given?
+                  return response
+                end
+              rescue ::GRPC::BadStatus => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Retrieves a BI reservation.
               #
@@ -1726,6 +2152,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::GetBiReservationRequest.new
+              #
+              #   # Call the get_bi_reservation method.
+              #   result = client.get_bi_reservation request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::BiReservation.
+              #   p result
+              #
               def get_bi_reservation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1743,9 +2184,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -1803,6 +2246,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/bigquery/reservation/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Bigquery::Reservation::V1::ReservationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Bigquery::Reservation::V1::UpdateBiReservationRequest.new
+              #
+              #   # Call the update_bi_reservation method.
+              #   result = client.update_bi_reservation request
+              #
+              #   # The returned object is of type Google::Cloud::Bigquery::Reservation::V1::BiReservation.
+              #   p result
+              #
               def update_bi_reservation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1820,9 +2278,11 @@ module Google
                   gapic_version: ::Google::Cloud::Bigquery::Reservation::V1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "bi_reservation.name" => request.bi_reservation.name
-                }
+                header_params = {}
+                if request.bi_reservation&.name
+                  header_params["bi_reservation.name"] = request.bi_reservation.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -2068,6 +2528,11 @@ module Google
                   #
                   attr_reader :move_assignment
                   ##
+                  # RPC-specific configuration for `update_assignment`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :update_assignment
+                  ##
                   # RPC-specific configuration for `get_bi_reservation`
                   # @return [::Gapic::Config::Method]
                   #
@@ -2116,6 +2581,8 @@ module Google
                     @search_all_assignments = ::Gapic::Config::Method.new search_all_assignments_config
                     move_assignment_config = parent_rpcs.move_assignment if parent_rpcs.respond_to? :move_assignment
                     @move_assignment = ::Gapic::Config::Method.new move_assignment_config
+                    update_assignment_config = parent_rpcs.update_assignment if parent_rpcs.respond_to? :update_assignment
+                    @update_assignment = ::Gapic::Config::Method.new update_assignment_config
                     get_bi_reservation_config = parent_rpcs.get_bi_reservation if parent_rpcs.respond_to? :get_bi_reservation
                     @get_bi_reservation = ::Gapic::Config::Method.new get_bi_reservation_config
                     update_bi_reservation_config = parent_rpcs.update_bi_reservation if parent_rpcs.respond_to? :update_bi_reservation