suguo
/
googleapis
0
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

- Add CreateCapacityCommitment method to BigQuery Reservation v1beta1. 

- Update missing child_type annotations for v1 and v1beta1 proto annotations.
- Revert name of bi_reservation back to reservation for v1beta1 service.

PiperOrigin-RevId: 314217336
This commit is contained in:
Google APIs 2020-06-01 15:38:28 -07:00 committed by Copybara-Service
parent ded05197da
commit 907754d70e
5 changed files with 229 additions and 98 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
google/cloud/bigquery/reservation/v1/reservation.proto
View File

@ -759,7 +759,7 @@ message ListAssignmentsRequest {
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
type: "bigqueryreservation.googleapis.com/Reservation"
child_type: "bigqueryreservation.googleapis.com/Assignment"
}
];
@ -807,7 +807,7 @@ message SearchAssignmentsRequest {
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
child_type: "bigqueryreservation.googleapis.com/Assignment"
type: "locations.googleapis.com/Location"
}
];
@ -860,7 +860,9 @@ message MoveAssignmentRequest {
// The new reservation ID, e.g.:
// `projects/myotherproject/locations/US/reservations/team2-prod`
string destination_id = 3;
string destination_id = 3 [(google.api.resource_reference) = {
child_type: "bigqueryreservation.googleapis.com/Assignment"
}];
}
// Represents a BI Reservation.

14
google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_gapic.legacy.yaml
View File

@ -202,6 +202,20 @@ interfaces:
field_name_patterns:
reservation.name: reservation
timeout_millis: 60000
- name: CreateCapacityCommitment
flattening:
groups:
- parameters:
- parent
- capacity_commitment
required_fields:
- parent
- capacity_commitment
retry_codes_name: non_idempotent
retry_params_name: default
field_name_patterns:
parent: location
timeout_millis: 60000
- name: ListCapacityCommitments
flattening:
groups:

4
google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_grpc_service_config.json
View File

@ -10,6 +10,10 @@
"service": "google.cloud.bigquery.reservation.v1beta1.ReservationService",
"method": "UpdateReservation"
},
{
"service": "google.cloud.bigquery.reservation.v1beta1.ReservationService",
"method": "CreateCapacityCommitment"
},
{
"service": "google.cloud.bigquery.reservation.v1beta1.ReservationService",
"method": "UpdateCapacityCommitment"

7
google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_v1beta1.yaml
View File

@ -9,6 +9,13 @@ apis:
documentation:
summary: 'A service to modify your BigQuery flat-rate reservations.'
backend:
rules:
- selector: 'google.cloud.bigquery.reservation.v1beta1.ReservationService.*'
deadline: 30.0
- selector: 'google.longrunning.Operations.*'
deadline: 30.0
authentication:
rules:
- selector: 'google.cloud.bigquery.reservation.v1beta1.ReservationService.*'

294
google/cloud/bigquery/reservation/v1beta1/reservation.proto
View File

@ -37,13 +37,13 @@ option java_package = "com.google.cloud.bigquery.reservation.v1beta1";
// parallelism. In a scan of a multi-partitioned table, a single slot operates
// on a single partition of the table. A reservation resource exists as a child
// resource of the admin project and location, e.g.:
// projects/myproject/locations/US/reservations/reservationName.
// `projects/myproject/locations/US/reservations/reservationName`.
//
// A capacity commitment is a way to purchase compute capacity for BigQuery jobs
// (in the form of slots) with some committed period of usage. A capacity
// commitment resource exists as a child resource of the admin project and
// location, e.g.:
// projects/myproject/locations/US/capacityCommitments/id.
// `projects/myproject/locations/US/capacityCommitments/id`.
service ReservationService {
option (google.api.default_host) = "bigqueryreservation.googleapis.com";
option (google.api.oauth_scopes) =
@ -96,13 +96,22 @@ service ReservationService {
option (google.api.method_signature) = "reservation,update_mask";
}
// Creates a new capacity commitment resource.
rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest)
returns (CapacityCommitment) {
option (google.api.http) = {
post: "/v1beta1/{parent=projects/*/locations/*}/capacityCommitments"
body: "capacity_commitment"
};
option (google.api.method_signature) = "parent,capacity_commitment";
}
// Lists all the capacity commitments for the admin project.
rpc ListCapacityCommitments(ListCapacityCommitmentsRequest)
returns (ListCapacityCommitmentsResponse) {
option (google.api.http) = {
get: "/v1beta1/{parent=projects/*/locations/*}/capacityCommitments"
};
option (google.api.method_signature) = "parent";
}
// Returns information about the capacity commitment.
@ -127,7 +136,11 @@ service ReservationService {
// Updates an existing capacity commitment.
//
// Only renewal_plan field can be updated.
// 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`.
rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest)
returns (CapacityCommitment) {
option (google.api.http) = {
@ -138,10 +151,13 @@ service ReservationService {
}
// Splits capacity commitment to two commitments of the same plan and
// commitment_end_time. A common use case to do that is to perform a downgrade
// e.g., in order to downgrade from 10000 slots to 8000, one might split 10000
// capacity commitment to 2000 and 8000, change the plan of the first one to
// flex and then delete it.
// `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.
rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest)
returns (SplitCapacityCommitmentResponse) {
option (google.api.http) = {
@ -151,10 +167,13 @@ service ReservationService {
option (google.api.method_signature) = "name,slot_count";
}
// Merges capacity commitments of the same plan into one. Resulting capacity
// commitment has the longer commitment_end_time out of the two. 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`.
rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest)
returns (CapacityCommitment) {
option (google.api.http) = {
@ -164,9 +183,34 @@ service ReservationService {
option (google.api.method_signature) = "parent,capacity_commitment_ids";
}
// 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.
rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment) {
@ -178,17 +222,26 @@ service ReservationService {
}
// Lists assignments.
// Only explicitly created assignments will be returned. E.g:
// organizationA contains project1 and project2. Reservation res1 exists.
// CreateAssignment was invoked previously and following assignments were
// created explicitly:
// <organizationA, res1>
// <project1, res1>
// Then this API will just return the above two assignments for reservation
// res1, and no expansion/merge will happen. Wildcard "-" can be used for
//
// 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.
// specified project and location will be listed.
//
// **Note** "-" cannot be used for projects nor locations.
rpc ListAssignments(ListAssignmentsRequest)
returns (ListAssignmentsResponse) {
option (google.api.http) = {
@ -198,15 +251,20 @@ service ReservationService {
}
// Deletes a assignment. No expansion will happen.
// E.g:
// organizationA contains project1 and project2. Reservation res1 exists.
// CreateAssignment was invoked previously and following assignments were
// created explicitly:
// <organizationA, res1>
// <project1, res1>
// Then deletion of <organizationA, res1> won't affect <project1, res1>. After
// deletion of <organizationA, res1>, queries from project1 will still use
// res1, while queries from project2 will use on-demand mode.
//
// 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.
rpc DeleteAssignment(DeleteAssignmentRequest)
returns (google.protobuf.Empty) {
option (google.api.http) = {
@ -217,19 +275,26 @@ service ReservationService {
// 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.
// Same logic applies if the request is about a folder.
//
// 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
//
// 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.
rpc SearchAssignments(SearchAssignmentsRequest)
returns (SearchAssignmentsResponse) {
@ -239,12 +304,11 @@ service ReservationService {
option (google.api.method_signature) = "parent,query";
}
// Moves a assignment under a new reservation. Customers can do this by
// deleting the existing assignment followed by creating another assignment
// under the new reservation, but this method provides a transactional way to
// do so, to make sure the assignee always has an associated reservation.
// Without the method customers might see some queries run on-demand which
// might be unexpected.
// 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.
rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment) {
option (google.api.http) = {
post: "/v1beta1/{name=projects/*/locations/*/reservations/*/assignments/*}:move"
@ -262,17 +326,19 @@ service ReservationService {
}
// Updates a BI reservation.
// Only fields specified in the field_mask are updated.
// Singleton BI reservation always exists with default size 0.
//
// 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.
rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation) {
option (google.api.http) = {
patch: "/v1beta1/{bi_reservation.name=projects/*/locations/*/biReservation}"
body: "bi_reservation"
patch: "/v1beta1/{reservation.name=projects/*/locations/*/biReservation}"
body: "reservation"
};
option (google.api.method_signature) = "bi_reservation,update_mask";
option (google.api.method_signature) = "reservation,update_mask";
}
}
@ -284,13 +350,15 @@ message Reservation {
};
// The resource name of the reservation, e.g.,
// "projects/*/locations/*/reservations/team1-prod".
// `projects/*/locations/*/reservations/team1-prod`.
string name = 1;
// 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
@ -304,10 +372,12 @@ message Reservation {
}
// Capacity commitment is a way to purchase compute capacity for BigQuery jobs
// (in the form of slots) with some committed period of usage. Monthly and
// annual commitments renew by default. Only flex commitments can be removed. In
// order to remove monthly or annual commitments, their plan needs to be changed
// to flex first.
// (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.
@ -329,12 +399,20 @@ message CapacityCommitment {
// any time.
FLEX = 3;
// Trial commitments have a committed period of 182 days after becoming
// ACTIVE. After that, they are converted to a new commitment based on the
// `renewal_plan`. Default `renewal_plan` for Trial commitment is Flex so
// that it can be deleted right after committed period ends.
TRIAL = 5;
// Monthly commitments have a committed period of 30 days after becoming
// ACTIVE.
// ACTIVE. After that, they are not in a committed period anymore and can be
// removed any time.
MONTHLY = 2;
// Annual commitments have a committed period of 365 days after becoming
// ACTIVE.
// ACTIVE. After that they are converted to a new commitment based on the
// renewal_plan.
ANNUAL = 4;
}
@ -357,7 +435,7 @@ message CapacityCommitment {
}
// Output only. The resource name of the capacity commitment, e.g.,
// projects/myproject/locations/US/capacityCommitments/123
// `projects/myproject/locations/US/capacityCommitments/123`
string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Number of slots in this commitment.
@ -380,7 +458,7 @@ message CapacityCommitment {
// The plan this capacity commitment is converted to after commitment_end_time
// passes. Once the plan is changed, committed period is extended according to
// commitment plan. Only applicable for MONTHLY and ANNUAL commitments.
// commitment plan. Only applicable for ANNUAL commitments.
CommitmentPlan renewal_plan = 8;
}
@ -388,7 +466,7 @@ message CapacityCommitment {
// [ReservationService.CreateReservation][google.cloud.bigquery.reservation.v1beta1.ReservationService.CreateReservation].
message CreateReservationRequest {
// Required. Project, location. E.g.,
// projects/myproject/locations/US
// `projects/myproject/locations/US`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -408,7 +486,7 @@ message CreateReservationRequest {
// [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListReservations].
message ListReservationsRequest {
// Required. The parent resource name containing project and location, e.g.:
// "projects/myproject/locations/US"
// `projects/myproject/locations/US`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -445,7 +523,7 @@ message ListReservationsResponse {
// [ReservationService.GetReservation][google.cloud.bigquery.reservation.v1beta1.ReservationService.GetReservation].
message GetReservationRequest {
// Required. Resource name of the reservation to retrieve. E.g.,
// projects/myproject/locations/US/reservations/team1-prod
// `projects/myproject/locations/US/reservations/team1-prod`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -458,7 +536,7 @@ message GetReservationRequest {
// [ReservationService.DeleteReservation][google.cloud.bigquery.reservation.v1beta1.ReservationService.DeleteReservation].
message DeleteReservationRequest {
// Required. Resource name of the reservation to retrieve. E.g.,
// projects/myproject/locations/US/reservations/team1-prod
// `projects/myproject/locations/US/reservations/team1-prod`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -477,11 +555,31 @@ message UpdateReservationRequest {
google.protobuf.FieldMask update_mask = 2;
}
// The request for
// [ReservationService.CreateCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.CreateCapacityCommitment].
message CreateCapacityCommitmentRequest {
// Required. Resource name of the parent reservation. E.g.,
// `projects/myproject/locations/US`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
child_type: "bigqueryreservation.googleapis.com/CapacityCommitment"
}
];
// Content of the capacity commitment to create.
CapacityCommitment capacity_commitment = 2;
// If true, fail the request if another project in the organization has a
// capacity commitment.
bool enforce_single_admin_project_per_org = 4;
}
// The request for
// [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListCapacityCommitments].
message ListCapacityCommitmentsRequest {
// Required. Resource name of the parent reservation. E.g.,
// projects/myproject/locations/US
// `projects/myproject/locations/US`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -511,7 +609,7 @@ message ListCapacityCommitmentsResponse {
// [ReservationService.GetCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.GetCapacityCommitment].
message GetCapacityCommitmentRequest {
// Required. Resource name of the capacity commitment to retrieve. E.g.,
// projects/myproject/locations/US/capacityCommitments/123
// `projects/myproject/locations/US/capacityCommitments/123`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -524,7 +622,7 @@ message GetCapacityCommitmentRequest {
// [ReservationService.DeleteCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.DeleteCapacityCommitment].
message DeleteCapacityCommitmentRequest {
// Required. Resource name of the capacity commitment to delete. E.g.,
// projects/myproject/locations/US/capacityCommitments/123
// `projects/myproject/locations/US/capacityCommitments/123`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -547,7 +645,7 @@ message UpdateCapacityCommitmentRequest {
// [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.SplitCapacityCommitment].
message SplitCapacityCommitmentRequest {
// Required. The resource name e.g.,:
// projects/myproject/locations/US/capacityCommitments/123
// `projects/myproject/locations/US/capacityCommitments/123`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -573,13 +671,10 @@ message SplitCapacityCommitmentResponse {
// [ReservationService.MergeCapacityCommitments][google.cloud.bigquery.reservation.v1beta1.ReservationService.MergeCapacityCommitments].
message MergeCapacityCommitmentsRequest {
// Parent resource that identifies admin project and location e.g.,
// projects/myproject/locations/us
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
child_type: "bigqueryreservation.googleapis.com/CapacityCommitment"
}
];
// `projects/myproject/locations/us`
string parent = 1 [(google.api.resource_reference) = {
child_type: "bigqueryreservation.googleapis.com/CapacityCommitment"
}];
// Ids of capacity commitments to merge.
// These capacity commitments must exist under admin project and location
@ -624,12 +719,12 @@ message Assignment {
}
// Output only. Name of the resource. E.g.:
// projects/myproject/locations/US/reservations/team1-prod/assignments/123.
// `projects/myproject/locations/US/reservations/team1-prod/assignments/123`.
string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// The resource which will use the reservation. E.g.
// projects/myproject, folders/123, organizations/456.
string assignee = 4 [(google.api.resource_reference) = { type: "*" }];
// `projects/myproject`, `folders/123`, or `organizations/456`.
string assignee = 4;
// Which type of jobs will use the reservation.
JobType job_type = 3;
@ -644,7 +739,7 @@ message Assignment {
// related assignee.
message CreateAssignmentRequest {
// Required. The parent resource name of the assignment
// E.g.: projects/myproject/locations/US/reservations/team1-prod
// E.g. `projects/myproject/locations/US/reservations/team1-prod`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -660,9 +755,12 @@ message CreateAssignmentRequest {
// [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListAssignments].
message ListAssignmentsRequest {
// Required. The parent resource name e.g.:
// projects/myproject/locations/US/reservations/team1-prod
//
// `projects/myproject/locations/US/reservations/team1-prod`
//
// Or:
// projects/myproject/locations/US/reservations/-
//
// `projects/myproject/locations/US/reservations/-`
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -693,8 +791,8 @@ message ListAssignmentsResponse {
// Note: "bigquery.reservationAssignments.delete" permission is required on the
// related assignee.
message DeleteAssignmentRequest {
// 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`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -710,7 +808,7 @@ message DeleteAssignmentRequest {
message SearchAssignmentsRequest {
// Required. The resource name of the admin project(containing project and
// location), e.g.:
// "projects/myproject/locations/US".
// `projects/myproject/locations/US`.
string parent = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -719,9 +817,12 @@ message SearchAssignmentsRequest {
];
// Please specify resource name as assignee in the query.
// e.g., "assignee=projects/myproject"
// "assignee=folders/123"
// "assignee=organizations/456"
//
// Examples:
//
// * `assignee=projects/myproject`
// * `assignee=folders/123`
// * `assignee=organizations/456`
string query = 2;
// The maximum number of items to return.
@ -744,14 +845,17 @@ message SearchAssignmentsResponse {
// The request for
// [ReservationService.MoveAssignment][google.cloud.bigquery.reservation.v1beta1.ReservationService.MoveAssignment].
// Note: "bigquery.reservationAssignments.create" permission is required on the
// destination_id. Note: "bigquery.reservationAssignments.create" and
// "bigquery.reservationAssignments.delete" permission is required on the
//
// **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.
message MoveAssignmentRequest {
// Required. The resource name of the assignment,
// e.g.:
// projects/myproject/locations/US/reservations/team1-prod/assignments/123
// e.g.
// `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference) = {
@ -760,7 +864,7 @@ message MoveAssignmentRequest {
];
// The new reservation ID, e.g.:
// projects/myotherproject/locations/US/reservations/team2-prod
// `projects/myotherproject/locations/US/reservations/team2-prod`
string destination_id = 3 [(google.api.resource_reference) = {
child_type: "bigqueryreservation.googleapis.com/Assignment"
}];
@ -770,7 +874,7 @@ message MoveAssignmentRequest {
message BiReservation {
option (google.api.resource) = {
type: "bigqueryreservation.googleapis.com/BiReservation"
pattern: "projects/{project}/locations/{location}/bireservation"
pattern: "projects/{project}/locations/{location}/bireservation/{bireservation}"
};
// The resource name of the singleton BI reservation.
@ -801,7 +905,7 @@ message GetBiReservationRequest {
// A request to update a BI reservation.
message UpdateBiReservationRequest {
// A reservation to update.
BiReservation bi_reservation = 1;
BiReservation reservation = 1;
// A list of fields to be updated in this request.
google.protobuf.FieldMask update_mask = 2;