google-api-client 0.43.0 → 0.44.0

data/generated/google/apis/bigqueryreservation_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryreservationV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200702'
+      REVISION = '20200808'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'

data/generated/google/apis/bigqueryreservation_v1beta1/classes.rb

@@ -22,13 +22,13 @@ module Google
   module Apis
     module BigqueryreservationV1beta1
       
-      # A Assignment allows a project to submit jobs
-      # of a certain type using slots from the specified reservation.
+      # A Assignment allows a project to submit jobs of a certain type using slots
+      # from the specified reservation.
       class Assignment
         include Google::Apis::Core::Hashable
       
-        # The resource which will use the reservation. E.g.
-        # `projects/myproject`, `folders/123`, or `organizations/456`.
+        # The resource which will use the reservation. E.g. `projects/myproject`, `
+        # folders/123`, or `organizations/456`.
         # Corresponds to the JSON property `assignee`
         # @return [String]
         attr_accessor :assignee
@@ -38,8 +38,8 @@ module Google
         # @return [String]
         attr_accessor :job_type
       
-        # Output only. Name of the resource. E.g.:
-        # `projects/myproject/locations/US/reservations/team1-prod/assignments/123`.
+        # Output only. Name of the resource. E.g.: `projects/myproject/locations/US/
+        # reservations/team1-prod/assignments/123`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -66,9 +66,8 @@ module Google
       class BiReservation
         include Google::Apis::Core::Hashable
       
-        # The resource name of the singleton BI reservation.
-        # Reservation names have the form
-        # `projects/`project_id`/locations/`location_id`/bireservation`.
+        # The resource name of the singleton BI reservation. Reservation names have the
+        # form `projects/`project_id`/locations/`location_id`/bireservation`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -95,43 +94,39 @@ module Google
         end
       end
       
-      # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
-      # (in the form of slots) with some committed period of usage. Annual
-      # commitments renew by default. Commitments can be removed after their
-      # commitment end time passes.
-      # In order to remove annual commitment, its plan needs to be changed
-      # to monthly or flex first.
-      # A capacity commitment resource exists as a child resource of the admin
-      # project.
+      # Capacity commitment is a way to purchase compute capacity for BigQuery jobs (
+      # in the form of slots) with some committed period of usage. Annual commitments
+      # renew by default. Commitments can be removed after their commitment end time
+      # passes. In order to remove annual commitment, its plan needs to be changed to
+      # monthly or flex first. A capacity commitment resource exists as a child
+      # resource of the admin project.
       class CapacityCommitment
         include Google::Apis::Core::Hashable
       
         # Output only. The end of the current commitment period. It is applicable only
-        # for ACTIVE
-        # capacity commitments.
+        # for ACTIVE capacity commitments.
         # Corresponds to the JSON property `commitmentEndTime`
         # @return [String]
         attr_accessor :commitment_end_time
       
         # Output only. The start of the current commitment period. It is applicable only
-        # for
-        # ACTIVE capacity commitments.
+        # for ACTIVE capacity commitments.
         # Corresponds to the JSON property `commitmentStartTime`
         # @return [String]
         attr_accessor :commitment_start_time
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `failureStatus`
         # @return [Google::Apis::BigqueryreservationV1beta1::Status]
         attr_accessor :failure_status
       
-        # Output only. The resource name of the capacity commitment, e.g.,
-        # `projects/myproject/locations/US/capacityCommitments/123`
+        # Output only. The resource name of the capacity commitment, e.g., `projects/
+        # myproject/locations/US/capacityCommitments/123`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -175,13 +170,12 @@ module Google
         end
       end
       
-      # The metadata for operation returned from
-      # ReservationService.CreateSlotPool.
+      # The metadata for operation returned from ReservationService.CreateSlotPool.
       class CreateSlotPoolMetadata
         include Google::Apis::Core::Hashable
       
-        # Resource name of the slot pool that is being created. E.g.,
-        # projects/myproject/locations/us-central1/reservations/foo/slotPools/123
+        # Resource name of the slot pool that is being created. E.g., projects/myproject/
+        # locations/us-central1/reservations/foo/slotPools/123
         # Corresponds to the JSON property `slotPool`
         # @return [String]
         attr_accessor :slot_pool
@@ -196,13 +190,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -224,8 +216,8 @@ module Google
         # @return [Array<Google::Apis::BigqueryreservationV1beta1::Assignment>]
         attr_accessor :assignments
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -250,8 +242,8 @@ module Google
         # @return [Array<Google::Apis::BigqueryreservationV1beta1::CapacityCommitment>]
         attr_accessor :capacity_commitments
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -271,8 +263,8 @@ module Google
       class ListReservationsResponse
         include Google::Apis::Core::Hashable
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -297,11 +289,10 @@ module Google
       class MergeCapacityCommitmentsRequest
         include Google::Apis::Core::Hashable
       
-        # Ids of capacity commitments to merge.
-        # These capacity commitments must exist under admin project and location
-        # specified in the parent.
-        # ID is the last portion of capacity commitment name e.g., 'abc' for
-        # projects/myproject/locations/US/capacityCommitments/abc
+        # Ids of capacity commitments to merge. These capacity commitments must exist
+        # under admin project and location specified in the parent. ID is the last
+        # portion of capacity commitment name e.g., 'abc' for projects/myproject/
+        # locations/US/capacityCommitments/abc
         # Corresponds to the JSON property `capacityCommitmentIds`
         # @return [Array<String>]
         attr_accessor :capacity_commitment_ids
@@ -316,18 +307,15 @@ module Google
         end
       end
       
-      # The request for
-      # ReservationService.MoveAssignment.
-      # **Note**: "bigquery.reservationAssignments.create" permission is required on
-      # the destination_id.
-      # **Note**: "bigquery.reservationAssignments.create" and
-      # "bigquery.reservationAssignments.delete" permission are required on the
-      # related assignee.
+      # The request for ReservationService.MoveAssignment. **Note**: "bigquery.
+      # reservationAssignments.create" permission is required on the destination_id. **
+      # Note**: "bigquery.reservationAssignments.create" and "bigquery.
+      # reservationAssignments.delete" permission are required on the related assignee.
       class MoveAssignmentRequest
         include Google::Apis::Core::Hashable
       
-        # The new reservation ID, e.g.:
-        # `projects/myotherproject/locations/US/reservations/team2-prod`
+        # The new reservation ID, e.g.: `projects/myotherproject/locations/US/
+        # reservations/team2-prod`
         # Corresponds to the JSON property `destinationId`
         # @return [String]
         attr_accessor :destination_id
@@ -346,6 +334,11 @@ module Google
       class Reservation
         include Google::Apis::Core::Hashable
       
+        # Output only. Creation time of the reservation.
+        # Corresponds to the JSON property `creationTime`
+        # @return [String]
+        attr_accessor :creation_time
+      
         # If false, any query using this reservation will use idle slots from other
         # reservations within the same admin project. If true, a query using this
         # reservation will execute with the slot capacity specified above at most.
@@ -354,33 +347,39 @@ module Google
         attr_accessor :ignore_idle_slots
         alias_method :ignore_idle_slots?, :ignore_idle_slots
       
-        # The resource name of the reservation, e.g.,
-        # `projects/*/locations/*/reservations/team1-prod`.
+        # The resource name of the reservation, e.g., `projects/*/locations/*/
+        # reservations/team1-prod`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Minimum slots available to this reservation. A slot is a unit of
-        # computational power in BigQuery, and serves as the unit of parallelism.
-        # Queries using this reservation might use more slots during runtime if
-        # ignore_idle_slots is set to false.
-        # If the new reservation's slot capacity exceed the parent's slot capacity or
-        # if total slot capacity of the new reservation and its siblings exceeds the
-        # parent's slot capacity, the request will fail with
-        # `google.rpc.Code.RESOURCE_EXHAUSTED`.
+        # Minimum slots available to this reservation. A slot is a unit of computational
+        # power in BigQuery, and serves as the unit of parallelism. Queries using this
+        # reservation might use more slots during runtime if ignore_idle_slots is set to
+        # false. If the new reservation's slot capacity exceed the parent's slot
+        # capacity or if total slot capacity of the new reservation and its siblings
+        # exceeds the parent's slot capacity, the request will fail with `google.rpc.
+        # Code.RESOURCE_EXHAUSTED`.
         # Corresponds to the JSON property `slotCapacity`
         # @return [Fixnum]
         attr_accessor :slot_capacity
       
+        # Output only. Last update time of the reservation.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @creation_time = args[:creation_time] if args.key?(:creation_time)
           @ignore_idle_slots = args[:ignore_idle_slots] if args.key?(:ignore_idle_slots)
           @name = args[:name] if args.key?(:name)
           @slot_capacity = args[:slot_capacity] if args.key?(:slot_capacity)
+          @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
       
@@ -393,8 +392,8 @@ module Google
         # @return [Array<Google::Apis::BigqueryreservationV1beta1::Assignment>]
         attr_accessor :assignments
       
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -433,26 +432,22 @@ module Google
       class SplitCapacityCommitmentResponse
         include Google::Apis::Core::Hashable
       
-        # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
-        # (in the form of slots) with some committed period of usage. Annual
-        # commitments renew by default. Commitments can be removed after their
-        # commitment end time passes.
-        # In order to remove annual commitment, its plan needs to be changed
-        # to monthly or flex first.
-        # A capacity commitment resource exists as a child resource of the admin
-        # project.
+        # Capacity commitment is a way to purchase compute capacity for BigQuery jobs (
+        # in the form of slots) with some committed period of usage. Annual commitments
+        # renew by default. Commitments can be removed after their commitment end time
+        # passes. In order to remove annual commitment, its plan needs to be changed to
+        # monthly or flex first. A capacity commitment resource exists as a child
+        # resource of the admin project.
         # Corresponds to the JSON property `first`
         # @return [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment]
         attr_accessor :first
       
-        # Capacity commitment is a way to purchase compute capacity for BigQuery jobs
-        # (in the form of slots) with some committed period of usage. Annual
-        # commitments renew by default. Commitments can be removed after their
-        # commitment end time passes.
-        # In order to remove annual commitment, its plan needs to be changed
-        # to monthly or flex first.
-        # A capacity commitment resource exists as a child resource of the admin
-        # project.
+        # Capacity commitment is a way to purchase compute capacity for BigQuery jobs (
+        # in the form of slots) with some committed period of usage. Annual commitments
+        # renew by default. Commitments can be removed after their commitment end time
+        # passes. In order to remove annual commitment, its plan needs to be changed to
+        # monthly or flex first. A capacity commitment resource exists as a child
+        # resource of the admin project.
         # Corresponds to the JSON property `second`
         # @return [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment]
         attr_accessor :second
@@ -468,12 +463,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -482,15 +477,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

data/generated/google/apis/bigqueryreservation_v1beta1/representations.rb

@@ -203,9 +203,11 @@ module Google
       class Reservation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :creation_time, as: 'creationTime'
           property :ignore_idle_slots, as: 'ignoreIdleSlots'
           property :name, as: 'name'
           property :slot_capacity, :numeric_string => true, as: 'slotCapacity'
+          property :update_time, as: 'updateTime'
         end
       end
       

data/generated/google/apis/bigqueryreservation_v1beta1/service.rb

@@ -49,8 +49,8 @@ module Google
         
         # Retrieves a BI reservation.
         # @param [String] name
-        #   Required. Name of the requested reservation, for example:
-        #   `projects/`project_id`/locations/`location_id`/bireservation`
+        #   Required. Name of the requested reservation, for example: `projects/`
+        #   project_id`/locations/`location_id`/bireservation`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -78,38 +78,28 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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
-        # returned.
-        # 3. Assignments for different JobTypes will all be returned.
-        # The same logic applies if the request is about a folder.
-        # If the request is about an organization, then assignments created on the
-        # organization will be returned (organization doesn't have ancestors).
-        # Comparing to ListAssignments, there are some behavior
-        # differences:
-        # 1. permission on the assignee will be verified in this API.
-        # 2. Hierarchy lookup (project->folder->organization) happens in this API.
-        # 3. Parent here is `projects/*/locations/*`, instead of
-        # `projects/*/locations/*reservations/*`.
-        # **Note** "-" cannot be used for projects
-        # nor locations.
+        # 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 returned. 3. Assignments for different JobTypes will all be
+        # returned. The same logic applies if the request is about a folder. If the
+        # request is about an organization, then assignments created on the organization
+        # will be returned (organization doesn't have ancestors). Comparing to
+        # ListAssignments, there are some behavior differences: 1. permission on the
+        # assignee will be verified in this API. 2. Hierarchy lookup (project->folder->
+        # organization) happens in this API. 3. Parent here is `projects/*/locations/*`,
+        # instead of `projects/*/locations/*reservations/*`. **Note** "-" cannot be used
+        # for projects nor locations.
         # @param [String] parent
         #   Required. The resource name of the admin project(containing project and
-        #   location),
-        #   e.g.:
-        #   `projects/myproject/locations/US`.
+        #   location), e.g.: `projects/myproject/locations/US`.
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
         #   The next_page_token value returned from a previous List request, if any.
         # @param [String] query
-        #   Please specify resource name as assignee in the query.
-        #   Examples:
-        #   * `assignee=projects/myproject`
-        #   * `assignee=folders/123`
-        #   * `assignee=organizations/456`
+        #   Please specify resource name as assignee in the query. Examples: * `assignee=
+        #   projects/myproject` * `assignee=folders/123` * `assignee=organizations/456`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -140,16 +130,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a BI reservation.
-        # Only fields specified in the `field_mask` are updated.
-        # A singleton BI reservation always exists with default size 0.
-        # In order to reserve BI capacity it needs to be updated to an amount
-        # greater than 0. In order to release BI capacity reservation size
-        # must be set to 0.
+        # Updates a BI reservation. Only fields specified in the `field_mask` are
+        # updated. A singleton BI reservation always exists with default size 0. In
+        # order to reserve BI capacity it needs to be updated to an amount greater than
+        # 0. In order to release BI capacity reservation size must be set to 0.
         # @param [String] name
-        #   The resource name of the singleton BI reservation.
-        #   Reservation names have the form
-        #   `projects/`project_id`/locations/`location_id`/bireservation`.
+        #   The resource name of the singleton BI reservation. Reservation names have the
+        #   form `projects/`project_id`/locations/`location_id`/bireservation`.
         # @param [Google::Apis::BigqueryreservationV1beta1::BiReservation] bi_reservation_object
         # @param [String] update_mask
         #   A list of fields to be updated in this request.
@@ -185,8 +172,8 @@ module Google
         
         # Creates a new capacity commitment resource.
         # @param [String] parent
-        #   Required. Resource name of the parent reservation. E.g.,
-        #   `projects/myproject/locations/US`
+        #   Required. Resource name of the parent reservation. E.g., `projects/myproject/
+        #   locations/US`
         # @param [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment] capacity_commitment_object
         # @param [Boolean] enforce_single_admin_project_per_org
         #   If true, fail the request if another project in the organization has a
@@ -221,12 +208,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a capacity commitment. Attempting to delete capacity commitment
-        # before its commitment_end_time will fail with the error code
-        # `google.rpc.Code.FAILED_PRECONDITION`.
+        # Deletes a capacity commitment. Attempting to delete capacity commitment before
+        # its commitment_end_time will fail with the error code `google.rpc.Code.
+        # FAILED_PRECONDITION`.
         # @param [String] name
-        #   Required. Resource name of the capacity commitment to delete. E.g.,
-        #   `projects/myproject/locations/US/capacityCommitments/123`
+        #   Required. Resource name of the capacity commitment to delete. E.g., `projects/
+        #   myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -256,8 +243,8 @@ module Google
         
         # Returns information about the capacity commitment.
         # @param [String] name
-        #   Required. Resource name of the capacity commitment to retrieve. E.g.,
-        #   `projects/myproject/locations/US/capacityCommitments/123`
+        #   Required. Resource name of the capacity commitment to retrieve. E.g., `
+        #   projects/myproject/locations/US/capacityCommitments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -287,8 +274,8 @@ module Google
         
         # Lists all the capacity commitments for the admin project.
         # @param [String] parent
-        #   Required. Resource name of the parent reservation. E.g.,
-        #   `projects/myproject/locations/US`
+        #   Required. Resource name of the parent reservation. E.g., `projects/myproject/
+        #   locations/US`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -322,14 +309,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Merges capacity commitments of the same plan into a single commitment.
-        # The resulting capacity commitment has the greater commitment_end_time
-        # out of the to-be-merged capacity commitments.
-        # Attempting to merge capacity commitments of different plan will fail
-        # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
+        # Merges capacity commitments of the same plan into a single commitment. The
+        # resulting capacity commitment has the greater commitment_end_time out of the
+        # to-be-merged capacity commitments. Attempting to merge capacity commitments of
+        # different plan will fail with the error code `google.rpc.Code.
+        # FAILED_PRECONDITION`.
         # @param [String] parent
-        #   Parent resource that identifies admin project and location e.g.,
-        #   `projects/myproject/locations/us`
+        #   Parent resource that identifies admin project and location e.g., `projects/
+        #   myproject/locations/us`
         # @param [Google::Apis::BigqueryreservationV1beta1::MergeCapacityCommitmentsRequest] merge_capacity_commitments_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -360,14 +347,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an existing capacity commitment.
-        # Only `plan` and `renewal_plan` fields can be updated.
-        # Plan can only be changed to a plan of a longer commitment period.
-        # Attempting to change to a plan with shorter commitment period will fail
-        # with the error code `google.rpc.Code.FAILED_PRECONDITION`.
+        # Updates an existing capacity commitment. Only `plan` and `renewal_plan` fields
+        # can be updated. Plan can only be changed to a plan of a longer commitment
+        # period. Attempting to change to a plan with shorter commitment period will
+        # fail with the error code `google.rpc.Code.FAILED_PRECONDITION`.
         # @param [String] name
-        #   Output only. The resource name of the capacity commitment, e.g.,
-        #   `projects/myproject/locations/US/capacityCommitments/123`
+        #   Output only. The resource name of the capacity commitment, e.g., `projects/
+        #   myproject/locations/US/capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::CapacityCommitment] capacity_commitment_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -401,15 +387,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Splits capacity commitment to two commitments of the same plan and
-        # `commitment_end_time`.
-        # A common use case is to enable downgrading commitments.
-        # 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.
+        # Splits capacity commitment to two commitments of the same plan and `
+        # commitment_end_time`. A common use case is to enable downgrading commitments.
+        # 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.
         # @param [String] name
-        #   Required. The resource name e.g.,:
-        #   `projects/myproject/locations/US/capacityCommitments/123`
+        #   Required. The resource name e.g.,: `projects/myproject/locations/US/
+        #   capacityCommitments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::SplitCapacityCommitmentRequest] split_capacity_commitment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -442,8 +427,7 @@ module Google
         
         # Creates a new reservation resource.
         # @param [String] parent
-        #   Required. Project, location. E.g.,
-        #   `projects/myproject/locations/US`
+        #   Required. Project, location. E.g., `projects/myproject/locations/US`
         # @param [Google::Apis::BigqueryreservationV1beta1::Reservation] reservation_object
         # @param [String] reservation_id
         #   The reservation ID. This field must only contain lower case alphanumeric
@@ -478,12 +462,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a reservation.
-        # Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has
-        # assignments.
+        # Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` when
+        # reservation has assignments.
         # @param [String] name
-        #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   `projects/myproject/locations/US/reservations/team1-prod`
+        #   Required. Resource name of the reservation to retrieve. E.g., `projects/
+        #   myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -513,8 +496,8 @@ module Google
         
         # Returns information about the reservation.
         # @param [String] name
-        #   Required. Resource name of the reservation to retrieve. E.g.,
-        #   `projects/myproject/locations/US/reservations/team1-prod`
+        #   Required. Resource name of the reservation to retrieve. E.g., `projects/
+        #   myproject/locations/US/reservations/team1-prod`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -544,14 +527,13 @@ module Google
         
         # Lists all the reservations for the project in the specified location.
         # @param [String] parent
-        #   Required. The parent resource name containing project and location, e.g.:
-        #   `projects/myproject/locations/US`
+        #   Required. The parent resource name containing project and location, e.g.: `
+        #   projects/myproject/locations/US`
         # @param [String] filter
         #   Can be used to filter out reservations based on names, capacity, etc, e.g.:
-        #   filter="reservation.slot_capacity > 200"
-        #   filter="reservation.name = \"*dev/*\""
-        #   Advanced filtering syntax can be
-        #   [here](https://cloud.google.com/logging/docs/view/advanced-filters).
+        #   filter="reservation.slot_capacity > 200" filter="reservation.name = \"*dev/*\""
+        #   Advanced filtering syntax can be [here](https://cloud.google.com/logging/docs/
+        #   view/advanced-filters).
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -588,8 +570,8 @@ module Google
         
         # Updates an existing reservation resource.
         # @param [String] name
-        #   The resource name of the reservation, e.g.,
-        #   `projects/*/locations/*/reservations/team1-prod`.
+        #   The resource name of the reservation, e.g., `projects/*/locations/*/
+        #   reservations/team1-prod`.
         # @param [Google::Apis::BigqueryreservationV1beta1::Reservation] reservation_object
         # @param [String] update_mask
         #   Standard field mask for the set of fields to be updated.
@@ -623,32 +605,26 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an assignment object which allows the given project to submit jobs
-        # of a certain type using slots from the specified reservation.
-        # Currently a
-        # resource (project, folder, organization) can only have one assignment per
-        # each (job_type, location) combination, and that reservation will be used
-        # for all jobs of the matching type.
-        # Different assignments can be created on different levels of the
-        # projects, folders or organization hierarchy.  During query execution,
-        # the assignment is looked up at the project, folder and organization levels
-        # in that order. The first assignment found is applied to the query.
-        # When creating assignments, it does not matter if other assignments exist at
-        # higher levels.
-        # Example:
-        # * The organization `organizationA` contains two projects, `project1`
-        # and `project2`.
-        # * Assignments for all three entities (`organizationA`, `project1`, and
-        # `project2`) could all be created and mapped to the same or different
-        # reservations.
-        # Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have
-        # 'bigquery.admin' permissions on the project using the reservation
-        # and the project that owns this reservation.
-        # Returns `google.rpc.Code.INVALID_ARGUMENT` when location of the assignment
-        # does not match location of the reservation.
+        # Creates an assignment object which allows the given project to submit jobs of
+        # a certain type using slots from the specified reservation. Currently a
+        # resource (project, folder, organization) can only have one assignment per each
+        # (job_type, location) combination, and that reservation will be used for all
+        # jobs of the matching type. Different assignments can be created on different
+        # levels of the projects, folders or organization hierarchy. During query
+        # execution, the assignment is looked up at the project, folder and organization
+        # levels in that order. The first assignment found is applied to the query. When
+        # creating assignments, it does not matter if other assignments exist at higher
+        # levels. Example: * The organization `organizationA` contains two projects, `
+        # project1` and `project2`. * Assignments for all three entities (`organizationA`
+        # , `project1`, and `project2`) could all be created and mapped to the same or
+        # different reservations. Returns `google.rpc.Code.PERMISSION_DENIED` if user
+        # does not have 'bigquery.admin' permissions on the project using the
+        # reservation and the project that owns this reservation. Returns `google.rpc.
+        # Code.INVALID_ARGUMENT` when location of the assignment does not match location
+        # of the reservation.
         # @param [String] parent
-        #   Required. The parent resource name of the assignment
-        #   E.g. `projects/myproject/locations/US/reservations/team1-prod`
+        #   Required. The parent resource name of the assignment E.g. `projects/myproject/
+        #   locations/US/reservations/team1-prod`
         # @param [Google::Apis::BigqueryreservationV1beta1::Assignment] assignment_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -679,21 +655,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a assignment. No expansion will happen.
-        # Example:
-        # * Organization `organizationA` contains two projects, `project1` and
-        # `project2`.
-        # * Reservation `res1` exists and was created previously.
-        # * CreateAssignment was used previously to define the following
-        # associations between entities and reservations: `<organizationA, res1>`
-        # and `<project1, res1>`
-        # In this example, deletion of the `<organizationA, res1>` assignment won't
-        # affect the other assignment `<project1, res1>`. After said deletion,
-        # queries from `project1` will still use `res1` while queries from
-        # `project2` will switch to use on-demand mode.
+        # Deletes a assignment. No expansion will happen. Example: * Organization `
+        # organizationA` contains two projects, `project1` and `project2`. * Reservation
+        # `res1` exists and was created previously. * CreateAssignment was used
+        # previously to define the following associations between entities and
+        # reservations: `` and `` In this example, deletion of the `` assignment won't
+        # affect the other assignment ``. After said deletion, queries from `project1`
+        # will still use `res1` while queries from `project2` will switch to use on-
+        # demand mode.
         # @param [String] name
-        #   Required. Name of the resource, e.g.
-        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
+        #   Required. Name of the resource, e.g. `projects/myproject/locations/US/
+        #   reservations/team1-prod/assignments/123`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -721,26 +693,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists assignments.
-        # Only explicitly created assignments will be returned.
-        # Example:
-        # * Organization `organizationA` contains two projects, `project1` and
-        # `project2`.
-        # * Reservation `res1` exists and was created previously.
-        # * CreateAssignment was used previously to define the following
-        # associations between entities and reservations: `<organizationA, res1>`
-        # and `<project1, res1>`
-        # In this example, ListAssignments will just return the above two assignments
-        # for reservation `res1`, and no expansion/merge will happen.
-        # The wildcard "-" can be used for
-        # reservations in the request. In that case all assignments belongs to the
-        # specified project and location will be listed.
-        # **Note** "-" cannot be used for projects nor locations.
+        # Lists assignments. Only explicitly created assignments will be returned.
+        # Example: * Organization `organizationA` contains two projects, `project1` and `
+        # project2`. * Reservation `res1` exists and was created previously. *
+        # CreateAssignment was used previously to define the following associations
+        # between entities and reservations: `` and `` In this example, ListAssignments
+        # will just return the above two assignments for reservation `res1`, and no
+        # expansion/merge will happen. The wildcard "-" can be used for reservations in
+        # the request. In that case all assignments belongs to the specified project and
+        # location will be listed. **Note** "-" cannot be used for projects nor
+        # locations.
         # @param [String] parent
-        #   Required. The parent resource name e.g.:
-        #   `projects/myproject/locations/US/reservations/team1-prod`
-        #   Or:
-        #   `projects/myproject/locations/US/reservations/-`
+        #   Required. The parent resource name e.g.: `projects/myproject/locations/US/
+        #   reservations/team1-prod` Or: `projects/myproject/locations/US/reservations/-`
         # @param [Fixnum] page_size
         #   The maximum number of items to return.
         # @param [String] page_token
@@ -774,14 +739,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Moves an assignment under a new reservation.
-        # This differs from removing an existing assignment and recreating a new one
-        # by providing a transactional change that ensures an assignee always has an
-        # associated reservation.
+        # Moves an assignment under a new reservation. This differs from removing an
+        # existing assignment and recreating a new one by providing a transactional
+        # change that ensures an assignee always has an associated reservation.
         # @param [String] name
-        #   Required. The resource name of the assignment,
-        #   e.g.
-        #   `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
+        #   Required. The resource name of the assignment, e.g. `projects/myproject/
+        #   locations/US/reservations/team1-prod/assignments/123`
         # @param [Google::Apis::BigqueryreservationV1beta1::MoveAssignmentRequest] move_assignment_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.