reservation_services_pb.rb in google-cloud-bigquery-reservation-v1-0.4.0

- old
+ new

@@ -117,10 +117,15 @@
               #   and `project2`.
               # * Assignments for all three entities (`organizationA`, `project1`, and
               #   `project2`) could all be created and mapped to the same or different
               #   reservations.
               #
+              # "None" assignments represent an absence of the assignment. Projects
+              # assigned to None use on-demand pricing. To create a "None" assignment, use
+              # "none" as a reservation_id in the parent. Example parent:
+              # `projects/myproject/locations/US/reservations/none`.
+              #
               # 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
@@ -162,11 +167,11 @@
               # 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.
               rpc :DeleteAssignment, ::Google::Cloud::Bigquery::Reservation::V1::DeleteAssignmentRequest, ::Google::Protobuf::Empty
-              # Looks up assignments for a specified resource for a particular region.
+              # 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
               #    returned.
@@ -186,9 +191,30 @@
               #    `projects/*/locations/*reservations/*`.
               #
               # **Note** "-" cannot be used for projects
               # nor locations.
               rpc :SearchAssignments, ::Google::Cloud::Bigquery::Reservation::V1::SearchAssignmentsRequest, ::Google::Cloud::Bigquery::Reservation::V1::SearchAssignmentsResponse
+              # 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/*`.
+              rpc :SearchAllAssignments, ::Google::Cloud::Bigquery::Reservation::V1::SearchAllAssignmentsRequest, ::Google::Cloud::Bigquery::Reservation::V1::SearchAllAssignmentsResponse
               # 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.