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`. * *
This class provides the ability to make remote calls to the backing service through method * calls that map to API methods. Sample code to get started: @@ -183,7 +183,7 @@ public ReservationServiceStub getStub() { * * * @param name Required. Resource name of the reservation to retrieve. E.g., - * projects/myproject/locations/US/reservations/team1-prod + * `projects/myproject/locations/US/reservations/team1-prod` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteReservation(ReservationName name) { @@ -209,7 +209,7 @@ public final void deleteReservation(ReservationName name) { * * * @param name Required. Resource name of the reservation to retrieve. E.g., - * projects/myproject/locations/US/reservations/team1-prod + * `projects/myproject/locations/US/reservations/team1-prod` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteReservation(String name) { @@ -364,12 +364,18 @@ public final void deleteCapacityCommitment(DeleteCapacityCommitmentRequest reque // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * 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. + * 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. * *
Sample code: * @@ -380,8 +386,8 @@ public final void deleteCapacityCommitment(DeleteCapacityCommitmentRequest reque * } * * - * @param name Required. Name of the resource, e.g.: - * projects/myproject/locations/US/reservations/team1-prod/assignments/123 + * @param name Required. Name of the resource, e.g. + * `projects/myproject/locations/US/reservations/team1-prod/assignments/123` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteAssignment(AssignmentName name) { @@ -392,12 +398,18 @@ public final void deleteAssignment(AssignmentName name) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * 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. + * 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. * *
Sample code: * @@ -408,8 +420,8 @@ public final void deleteAssignment(AssignmentName name) { * } * * - * @param name Required. Name of the resource, e.g.: - * projects/myproject/locations/US/reservations/team1-prod/assignments/123 + * @param name Required. Name of the resource, e.g. + * `projects/myproject/locations/US/reservations/team1-prod/assignments/123` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteAssignment(String name) { @@ -419,12 +431,18 @@ public final void deleteAssignment(String name) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * 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. + * 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. * *
Sample code: * @@ -447,12 +465,18 @@ public final void deleteAssignment(DeleteAssignmentRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD /** - * 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. + * 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. * *
Sample code:
*
@@ -487,8 +511,8 @@ public final UnaryCallable 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`.
+ * 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`.
*
* Sample code:
*
@@ -1241,9 +1267,11 @@ public final CapacityCommitment updateCapacityCommitment(
/**
* 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`.
+ * 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`.
*
* Sample code:
*
@@ -1266,9 +1294,11 @@ public final CapacityCommitment updateCapacityCommitment(
/**
* 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`.
+ * 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`.
*
* Sample code:
*
@@ -1288,10 +1318,13 @@ public final CapacityCommitment updateCapacityCommitment(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
+ * 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.
*
* Sample code:
*
@@ -1320,10 +1353,13 @@ public final SplitCapacityCommitmentResponse splitCapacityCommitment(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
+ * 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.
*
* Sample code:
*
@@ -1349,10 +1385,13 @@ public final SplitCapacityCommitmentResponse splitCapacityCommitment(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
+ * 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.
*
* Sample code:
*
@@ -1376,10 +1415,13 @@ public final SplitCapacityCommitmentResponse splitCapacityCommitment(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
+ * 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.
*
* Sample code:
*
@@ -1402,9 +1444,13 @@ public final SplitCapacityCommitmentResponse splitCapacityCommitment(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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`.
*
* Sample code:
*
@@ -1434,9 +1480,13 @@ public final CapacityCommitment mergeCapacityCommitments(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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`.
*
* Sample code:
*
@@ -1466,9 +1516,13 @@ public final CapacityCommitment mergeCapacityCommitments(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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`.
*
* Sample code:
*
@@ -1489,9 +1543,13 @@ public final CapacityCommitment mergeCapacityCommitments(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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`.
*
* Sample code:
*
@@ -1511,19 +1569,31 @@ public final CapacityCommitment mergeCapacityCommitments(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates an 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 {job_type, location}, and that reservation will be used for all jobs of
- * the matching type. Within the organization, different assignments can be created on projects,
- * folders or organization level. 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. E.g: organizationA contains project1, project2. Assignments for organizationA, project1
- * and project2 could all be created, mapping 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.
*
* Sample code:
*
@@ -1535,8 +1605,8 @@ public final CapacityCommitment mergeCapacityCommitments(
* }
*
*
- * @param parent Required. The parent resource name of the assignment E.g.:
- * projects/myproject/locations/US/reservations/team1-prod
+ * @param parent Required. The parent resource name of the assignment E.g.
+ * `projects/myproject/locations/US/reservations/team1-prod`
* @param assignment Assignment resource to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -1551,19 +1621,31 @@ public final Assignment createAssignment(ReservationName parent, Assignment assi
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates an 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 {job_type, location}, and that reservation will be used for all jobs of
- * the matching type. Within the organization, different assignments can be created on projects,
- * folders or organization level. 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. E.g: organizationA contains project1, project2. Assignments for organizationA, project1
- * and project2 could all be created, mapping 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.
*
* Sample code:
*
@@ -1575,8 +1657,8 @@ public final Assignment createAssignment(ReservationName parent, Assignment assi
* }
*
*
- * @param parent Required. The parent resource name of the assignment E.g.:
- * projects/myproject/locations/US/reservations/team1-prod
+ * @param parent Required. The parent resource name of the assignment E.g.
+ * `projects/myproject/locations/US/reservations/team1-prod`
* @param assignment Assignment resource to create.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
@@ -1588,19 +1670,31 @@ public final Assignment createAssignment(String parent, Assignment assignment) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates an 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 {job_type, location}, and that reservation will be used for all jobs of
- * the matching type. Within the organization, different assignments can be created on projects,
- * folders or organization level. 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. E.g: organizationA contains project1, project2. Assignments for organizationA, project1
- * and project2 could all be created, mapping 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.
*
* Sample code:
*
@@ -1623,19 +1717,31 @@ public final Assignment createAssignment(CreateAssignmentRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Creates an 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 {job_type, location}, and that reservation will be used for all jobs of
- * the matching type. Within the organization, different assignments can be created on projects,
- * folders or organization level. 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. E.g: organizationA contains project1, project2. Assignments for organizationA, project1
- * and project2 could all be created, mapping 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.
*
* Sample code:
*
@@ -1657,13 +1763,24 @@ public final UnaryCallable 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.
*
* Sample code:
*
@@ -1677,8 +1794,9 @@ public final UnaryCallable `projects/myproject/locations/US/reservations/team1-prod`
+ * Or:
+ * `projects/myproject/locations/US/reservations/-`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListAssignmentsPagedResponse listAssignments(ReservationName parent) {
@@ -1691,13 +1809,24 @@ public final ListAssignmentsPagedResponse listAssignments(ReservationName parent
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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 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:
+ * `<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.
*
* Sample code:
*
@@ -1711,8 +1840,9 @@ public final ListAssignmentsPagedResponse listAssignments(ReservationName parent
*
*
* @param parent Required. The parent resource name e.g.:
- * projects/myproject/locations/US/reservations/team1-prod Or:
- * projects/myproject/locations/US/reservations/-
+ * `projects/myproject/locations/US/reservations/team1-prod`
+ * Or:
+ * `projects/myproject/locations/US/reservations/-`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final ListAssignmentsPagedResponse listAssignments(String parent) {
@@ -1722,13 +1852,24 @@ public final ListAssignmentsPagedResponse listAssignments(String parent) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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 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:
+ * `<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.
*
* Sample code:
*
@@ -1753,13 +1894,24 @@ public final ListAssignmentsPagedResponse listAssignments(ListAssignmentsRequest
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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 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:
+ * `<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.
*
* Sample code:
*
@@ -1784,13 +1936,24 @@ public final ListAssignmentsPagedResponse listAssignments(ListAssignmentsRequest
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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 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:
+ * `<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.
*
* Sample code:
*
@@ -1823,15 +1986,25 @@ public final ListAssignmentsPagedResponse listAssignments(ListAssignmentsRequest
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* 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. 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.
+ * 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.
*
* Sample code:
*
@@ -1847,8 +2020,10 @@ public final ListAssignmentsPagedResponse listAssignments(ListAssignmentsRequest
*
* @param parent Required. The resource name of the admin project(containing project and
* location), e.g.: "projects/myproject/locations/US".
- * @param query Please specify resource name as assignee in the query. e.g.,
- * "assignee=projects/myproject" "assignee=folders/123" "assignee=organizations/456"
+ * @param query Please specify resource name as assignee in the query.
+ * Examples:
+ * * `assignee=projects/myproject` * `assignee=folders/123` *
+ * `assignee=organizations/456`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final SearchAssignmentsPagedResponse searchAssignments(
@@ -1864,15 +2039,25 @@ public final SearchAssignmentsPagedResponse searchAssignments(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* 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. 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.
+ * 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.
*
* Sample code:
*
@@ -1888,8 +2073,10 @@ public final SearchAssignmentsPagedResponse searchAssignments(
*
* @param parent Required. The resource name of the admin project(containing project and
* location), e.g.: "projects/myproject/locations/US".
- * @param query Please specify resource name as assignee in the query. e.g.,
- * "assignee=projects/myproject" "assignee=folders/123" "assignee=organizations/456"
+ * @param query Please specify resource name as assignee in the query.
+ * Examples:
+ * * `assignee=projects/myproject` * `assignee=folders/123` *
+ * `assignee=organizations/456`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final SearchAssignmentsPagedResponse searchAssignments(String parent, String query) {
@@ -1901,15 +2088,25 @@ public final SearchAssignmentsPagedResponse searchAssignments(String parent, Str
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* 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. 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.
+ * 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.
*
* Sample code:
*
@@ -1935,15 +2132,25 @@ public final SearchAssignmentsPagedResponse searchAssignments(SearchAssignmentsR
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* 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. 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.
+ * 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.
*
* Sample code:
*
@@ -1969,15 +2176,25 @@ public final SearchAssignmentsPagedResponse searchAssignments(SearchAssignmentsR
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
* 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. 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.
+ * 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.
*
* Sample code:
*
@@ -2009,11 +2226,10 @@ public final SearchAssignmentsPagedResponse searchAssignments(SearchAssignmentsR
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
*
* Sample code:
*
@@ -2025,10 +2241,10 @@ public final SearchAssignmentsPagedResponse searchAssignments(SearchAssignmentsR
* }
*
*
- * @param name Required. The resource name of the assignment, e.g.:
- * projects/myproject/locations/US/reservations/team1-prod/assignments/123
+ * @param name Required. The resource name of the assignment, e.g.
+ * `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
* @param destinationId The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Assignment moveAssignment(AssignmentName name, String destinationId) {
@@ -2042,11 +2258,10 @@ public final Assignment moveAssignment(AssignmentName name, String destinationId
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
*
* Sample code:
*
@@ -2058,10 +2273,10 @@ public final Assignment moveAssignment(AssignmentName name, String destinationId
* }
*
*
- * @param name Required. The resource name of the assignment, e.g.:
- * projects/myproject/locations/US/reservations/team1-prod/assignments/123
+ * @param name Required. The resource name of the assignment, e.g.
+ * `projects/myproject/locations/US/reservations/team1-prod/assignments/123`
* @param destinationId The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
public final Assignment moveAssignment(String name, String destinationId) {
@@ -2072,11 +2287,10 @@ public final Assignment moveAssignment(String name, String destinationId) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
*
* Sample code:
*
@@ -2099,11 +2313,10 @@ public final Assignment moveAssignment(MoveAssignmentRequest request) {
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * 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.
*
* Sample code:
*
@@ -2215,10 +2428,13 @@ public final UnaryCallable 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.
*
* Sample code:
*
@@ -2246,10 +2462,13 @@ public final BiReservation updateBiReservation(
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Updates a BI reservation. Only fields specified in the field_mask are updated. 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.
*
* Sample code:
*
@@ -2269,10 +2488,13 @@ public final BiReservation updateBiReservation(UpdateBiReservationRequest reques
// AUTO-GENERATED DOCUMENTATION AND METHOD
/**
- * Updates a BI reservation. Only fields specified in the field_mask are updated. 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.
*
* Sample code:
*
diff --git a/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/package-info.java b/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/package-info.java
index 6845104b..d67cbd03 100644
--- a/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/package-info.java
+++ b/google-cloud-bigqueryreservation/src/main/java/com/google/cloud/bigquery/reservation/v1/package-info.java
@@ -28,12 +28,12 @@
* computational power in BigQuery, and serves as the basic unit of 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`.
*
* Sample for ReservationServiceClient:
*
diff --git a/grpc-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceGrpc.java b/grpc-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceGrpc.java
index 68110c2b..ee236f96 100644
--- a/grpc-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceGrpc.java
+++ b/grpc-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationServiceGrpc.java
@@ -33,12 +33,12 @@
* 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`.
*
*/
@javax.annotation.Generated(
@@ -1040,12 +1040,12 @@ public ReservationServiceFutureStub newStub(
* 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`.
*
*/
public abstract static class ReservationServiceImplBase implements io.grpc.BindableService {
@@ -1185,7 +1185,7 @@ public void deleteCapacityCommitment(
*
*
* Updates an existing capacity commitment.
- * Only plan and renewal_plan fields 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`.
@@ -1203,10 +1203,11 @@ public void updateCapacityCommitment(
*
*
* 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.
*
*/
public void splitCapacityCommitment(
@@ -1221,10 +1222,11 @@ public void splitCapacityCommitment(
*
*
*
- * 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`.
*
*/
public void mergeCapacityCommitments(
@@ -1238,18 +1240,24 @@ public void mergeCapacityCommitments(
*
*
*
- * Creates an object which allows the given project to submit jobs
- * of a certain type using slots from the specified reservation. Currently a
+ * 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
- * {job_type, location}, and that reservation will be used for all jobs of the
- * matching type. Within the organization, different assignments can be
- * created on projects, folders or organization level. During query execution,
+ * 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. E.g: organizationA contains project1, project2. Assignments
- * for organizationA, project1 and project2 could all be created, mapping to
- * the same or different reservations.
+ * 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.
@@ -1269,17 +1277,20 @@ public void createAssignment(
*
*
* 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.
*
*/
public void listAssignments(
@@ -1295,15 +1306,17 @@ public void listAssignments(
*
*
* 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.
*
*/
public void deleteAssignment(
@@ -1318,19 +1331,20 @@ public void deleteAssignment(
*
* 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.
*
*/
@@ -1346,12 +1360,10 @@ public void searchAssignments(
*
*
*
- * 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.
*
*/
public void moveAssignment(
@@ -1380,8 +1392,8 @@ public void getBiReservation(
*
*
* 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.
@@ -1542,12 +1554,12 @@ public final io.grpc.ServerServiceDefinition bindService() {
* 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`.
*
*/
public static final class ReservationServiceStub
@@ -1724,7 +1736,7 @@ public void deleteCapacityCommitment(
*
*
* Updates an existing capacity commitment.
- * Only plan and renewal_plan fields 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`.
@@ -1745,10 +1757,11 @@ public void updateCapacityCommitment(
*
*
* 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.
*
*/
public void splitCapacityCommitment(
@@ -1766,10 +1779,11 @@ public void splitCapacityCommitment(
*
*
*
- * 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`.
*
*/
public void mergeCapacityCommitments(
@@ -1786,18 +1800,24 @@ public void mergeCapacityCommitments(
*
*
*
- * Creates an object which allows the given project to submit jobs
- * of a certain type using slots from the specified reservation. Currently a
+ * 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
- * {job_type, location}, and that reservation will be used for all jobs of the
- * matching type. Within the organization, different assignments can be
- * created on projects, folders or organization level. During query execution,
+ * 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. E.g: organizationA contains project1, project2. Assignments
- * for organizationA, project1 and project2 could all be created, mapping to
- * the same or different reservations.
+ * 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.
@@ -1820,17 +1840,20 @@ public void createAssignment(
*
*
* 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.
*
*/
public void listAssignments(
@@ -1849,15 +1872,17 @@ public void listAssignments(
*
*
* 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.
*
*/
public void deleteAssignment(
@@ -1875,19 +1900,20 @@ public void deleteAssignment(
*
* 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.
*
*/
@@ -1906,12 +1932,10 @@ public void searchAssignments(
*
*
*
- * 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.
*
*/
public void moveAssignment(
@@ -1946,8 +1970,8 @@ public void getBiReservation(
*
*
* 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.
@@ -1975,12 +1999,12 @@ public void updateBiReservation(
* 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`.
*
*/
public static final class ReservationServiceBlockingStub
@@ -2122,7 +2146,7 @@ public com.google.protobuf.Empty deleteCapacityCommitment(
*
*
* Updates an existing capacity commitment.
- * Only plan and renewal_plan fields 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`.
@@ -2139,10 +2163,11 @@ public com.google.cloud.bigquery.reservation.v1.CapacityCommitment updateCapacit
*
*
* 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.
*
*/
public com.google.cloud.bigquery.reservation.v1.SplitCapacityCommitmentResponse
@@ -2156,10 +2181,11 @@ public com.google.cloud.bigquery.reservation.v1.CapacityCommitment updateCapacit
*
*
*
- * 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`.
*
*/
public com.google.cloud.bigquery.reservation.v1.CapacityCommitment mergeCapacityCommitments(
@@ -2172,18 +2198,24 @@ public com.google.cloud.bigquery.reservation.v1.CapacityCommitment mergeCapacity
*
*
*
- * Creates an object which allows the given project to submit jobs
- * of a certain type using slots from the specified reservation. Currently a
+ * 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
- * {job_type, location}, and that reservation will be used for all jobs of the
- * matching type. Within the organization, different assignments can be
- * created on projects, folders or organization level. During query execution,
+ * 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. E.g: organizationA contains project1, project2. Assignments
- * for organizationA, project1 and project2 could all be created, mapping to
- * the same or different reservations.
+ * 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.
@@ -2202,17 +2234,20 @@ public com.google.cloud.bigquery.reservation.v1.Assignment createAssignment(
*
*
* 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.
*
*/
public com.google.cloud.bigquery.reservation.v1.ListAssignmentsResponse listAssignments(
@@ -2225,15 +2260,17 @@ public com.google.cloud.bigquery.reservation.v1.ListAssignmentsResponse listAssi
*
*
* 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.
*
*/
public com.google.protobuf.Empty deleteAssignment(
@@ -2248,19 +2285,20 @@ public com.google.protobuf.Empty deleteAssignment(
*
* 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.
*
*/
@@ -2274,12 +2312,10 @@ public com.google.cloud.bigquery.reservation.v1.SearchAssignmentsResponse search
*
*
*
- * 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.
*
*/
public com.google.cloud.bigquery.reservation.v1.Assignment moveAssignment(
@@ -2305,8 +2341,8 @@ public com.google.cloud.bigquery.reservation.v1.BiReservation getBiReservation(
*
*
* 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.
@@ -2330,12 +2366,12 @@ public com.google.cloud.bigquery.reservation.v1.BiReservation updateBiReservatio
* 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`.
*
*/
public static final class ReservationServiceFutureStub
@@ -2490,7 +2526,7 @@ protected ReservationServiceFutureStub build(
*
*
* Updates an existing capacity commitment.
- * Only plan and renewal_plan fields 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`.
@@ -2509,10 +2545,11 @@ protected ReservationServiceFutureStub build(
*
*
* 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.
*
*/
public com.google.common.util.concurrent.ListenableFuture<
@@ -2527,10 +2564,11 @@ protected ReservationServiceFutureStub build(
*
*
*
- * 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`.
*
*/
public com.google.common.util.concurrent.ListenableFuture<
@@ -2545,18 +2583,24 @@ protected ReservationServiceFutureStub build(
*
*
*
- * Creates an object which allows the given project to submit jobs
- * of a certain type using slots from the specified reservation. Currently a
+ * 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
- * {job_type, location}, and that reservation will be used for all jobs of the
- * matching type. Within the organization, different assignments can be
- * created on projects, folders or organization level. During query execution,
+ * 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. E.g: organizationA contains project1, project2. Assignments
- * for organizationA, project1 and project2 could all be created, mapping to
- * the same or different reservations.
+ * 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.
@@ -2576,17 +2620,20 @@ protected ReservationServiceFutureStub build(
*
*
@@ -1298,7 +1328,7 @@ public Builder mergeFrom(
*
*
* 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.
*
*/
public com.google.common.util.concurrent.ListenableFuture<
@@ -2601,15 +2648,17 @@ protected ReservationServiceFutureStub build(
*
*
* 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.
*
*/
public com.google.common.util.concurrent.ListenableFuture
* 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.
*
*/
@@ -2652,12 +2702,10 @@ protected ReservationServiceFutureStub build(
*
*
*
- * 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.
*
*/
public com.google.common.util.concurrent.ListenableFuture<
@@ -2686,8 +2734,8 @@ protected ReservationServiceFutureStub build(
*
*
* 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.
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Assignment.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Assignment.java
index e0cdd348..8eded0e8 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Assignment.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Assignment.java
@@ -459,7 +459,7 @@ private State(int value) {
*
*
@@ -209,6 +210,19 @@ public enum CommitmentPlan implements com.google.protobuf.ProtocolMessageEnum {
*
* 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];
@@ -482,7 +482,7 @@ public java.lang.String getName() {
*
*
* 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];
@@ -508,7 +508,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
@@ -531,7 +531,7 @@ public java.lang.String getAssignee() {
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
@@ -1005,7 +1005,7 @@ public Builder mergeFrom(
*
*
* 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];
@@ -1028,7 +1028,7 @@ public java.lang.String getName() {
*
*
* 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];
@@ -1051,7 +1051,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* 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];
@@ -1073,7 +1073,7 @@ public Builder setName(java.lang.String value) {
*
*
* 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];
@@ -1091,7 +1091,7 @@ public Builder clearName() {
*
*
* 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];
@@ -1116,7 +1116,7 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
@@ -1139,7 +1139,7 @@ public java.lang.String getAssignee() {
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
@@ -1162,7 +1162,7 @@ public com.google.protobuf.ByteString getAssigneeBytes() {
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
@@ -1184,7 +1184,7 @@ public Builder setAssignee(java.lang.String value) {
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
@@ -1202,7 +1202,7 @@ public Builder clearAssignee() {
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/AssignmentOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/AssignmentOrBuilder.java
index ce5a355c..e3b81810 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/AssignmentOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/AssignmentOrBuilder.java
@@ -28,7 +28,7 @@ public interface AssignmentOrBuilder
*
*
* 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];
@@ -41,7 +41,7 @@ public interface AssignmentOrBuilder
*
*
* 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];
@@ -55,7 +55,7 @@ public interface AssignmentOrBuilder
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
@@ -68,7 +68,7 @@ public interface AssignmentOrBuilder
*
*
* The resource which will use the reservation. E.g.
- * projects/myproject, folders/123, organizations/456.
+ * `projects/myproject`, `folders/123`, or `organizations/456`.
*
*
* string assignee = 4;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitment.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitment.java
index 8ab5e5c8..de5e9281 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitment.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitment.java
@@ -25,8 +25,9 @@
* 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.
+ * 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.
* FLEX = 3;
*/
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;
+ */
+ TRIAL(5),
/**
*
*
@@ -259,6 +273,19 @@ public enum CommitmentPlan implements com.google.protobuf.ProtocolMessageEnum {
* FLEX = 3;
*/
public static final int FLEX_VALUE = 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;
+ */
+ public static final int TRIAL_VALUE = 5;
/**
*
*
@@ -312,6 +339,8 @@ public static CommitmentPlan forNumber(int value) {
return COMMITMENT_PLAN_UNSPECIFIED;
case 3:
return FLEX;
+ case 5:
+ return TRIAL;
case 2:
return MONTHLY;
case 4:
@@ -556,7 +585,7 @@ private State(int value) {
*
*
* 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];
@@ -579,7 +608,7 @@ public java.lang.String getName() {
*
*
* 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];
@@ -697,8 +726,8 @@ public com.google.cloud.bigquery.reservation.v1.CapacityCommitment.State getStat
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -714,8 +743,8 @@ public boolean hasCommitmentEndTime() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -733,8 +762,8 @@ public com.google.protobuf.Timestamp getCommitmentEndTime() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -799,7 +828,7 @@ public com.google.rpc.StatusOrBuilder getFailureStatusOrBuilder() {
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
* .google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan renewal_plan = 8;
@@ -816,7 +845,7 @@ public int getRenewalPlanValue() {
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
* .google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan renewal_plan = 8;
@@ -1082,8 +1111,9 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
* 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.
+ * 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.
*
* 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];
@@ -1321,7 +1351,7 @@ public java.lang.String getName() {
*
*
* 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];
@@ -1344,7 +1374,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* 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];
@@ -1366,7 +1396,7 @@ public Builder setName(java.lang.String value) {
*
*
* 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];
@@ -1384,7 +1414,7 @@ public Builder clearName() {
*
*
* 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];
@@ -1661,8 +1691,8 @@ public Builder clearState() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1678,8 +1708,8 @@ public boolean hasCommitmentEndTime() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1701,8 +1731,8 @@ public com.google.protobuf.Timestamp getCommitmentEndTime() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1726,8 +1756,8 @@ public Builder setCommitmentEndTime(com.google.protobuf.Timestamp value) {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1748,8 +1778,8 @@ public Builder setCommitmentEndTime(com.google.protobuf.Timestamp.Builder builde
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1777,8 +1807,8 @@ public Builder mergeCommitmentEndTime(com.google.protobuf.Timestamp value) {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1800,8 +1830,8 @@ public Builder clearCommitmentEndTime() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1817,8 +1847,8 @@ public com.google.protobuf.Timestamp.Builder getCommitmentEndTimeBuilder() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -1838,8 +1868,8 @@ public com.google.protobuf.TimestampOrBuilder getCommitmentEndTimeOrBuilder() {
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -2054,7 +2084,7 @@ public com.google.rpc.StatusOrBuilder getFailureStatusOrBuilder() {
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
*
@@ -2072,7 +2102,7 @@ public int getRenewalPlanValue() {
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
*
@@ -2093,7 +2123,7 @@ public Builder setRenewalPlanValue(int value) {
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
*
@@ -2118,7 +2148,7 @@ public Builder setRenewalPlanValue(int value) {
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
*
@@ -2144,7 +2174,7 @@ public Builder setRenewalPlan(
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitmentOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitmentOrBuilder.java
index 0e263ddb..f4198f42 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitmentOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CapacityCommitmentOrBuilder.java
@@ -28,7 +28,7 @@ public interface CapacityCommitmentOrBuilder
*
*
* 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];
@@ -41,7 +41,7 @@ public interface CapacityCommitmentOrBuilder
*
*
* 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];
@@ -121,8 +121,8 @@ public interface CapacityCommitmentOrBuilder
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -136,8 +136,8 @@ public interface CapacityCommitmentOrBuilder
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -151,8 +151,8 @@ public interface CapacityCommitmentOrBuilder
*
*
*
- * Output only. The end of the current commitment period. It is applicable only for ACTIVE
- * capacity commitments.
+ * Output only. The end of the current commitment period. It is applicable
+ * only for ACTIVE capacity commitments.
*
*
*
@@ -205,7 +205,7 @@ public interface CapacityCommitmentOrBuilder
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
* .google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan renewal_plan = 8;
@@ -220,7 +220,7 @@ public interface CapacityCommitmentOrBuilder
*
* 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 ANNUAL commitments.
+ * commitment plan. Only applicable for ANNUAL and TRIAL commitments.
*
*
* .google.cloud.bigquery.reservation.v1.CapacityCommitment.CommitmentPlan renewal_plan = 8;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequest.java
index ef2f791f..c14b7fa0 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.CreateAssignment][google.cloud.bigquery.reservation.v1.ReservationService.CreateAssignment].
+ * The request for
+ * [ReservationService.CreateAssignment][google.cloud.bigquery.reservation.v1.ReservationService.CreateAssignment].
* Note: "bigquery.reservationAssignments.create" permission is required on the
* related assignee.
*
@@ -137,7 +138,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* 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`
*
*
*
@@ -162,7 +163,7 @@ public java.lang.String getParent() {
*
*
* 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`
*
*
*
@@ -406,7 +407,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.CreateAssignment][google.cloud.bigquery.reservation.v1.ReservationService.CreateAssignment].
+ * The request for
+ * [ReservationService.CreateAssignment][google.cloud.bigquery.reservation.v1.ReservationService.CreateAssignment].
* Note: "bigquery.reservationAssignments.create" permission is required on the
* related assignee.
*
@@ -587,7 +589,7 @@ public Builder mergeFrom(
*
*
* 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`
*
*
*
@@ -612,7 +614,7 @@ public java.lang.String getParent() {
*
*
* 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`
*
*
*
@@ -637,7 +639,7 @@ public com.google.protobuf.ByteString getParentBytes() {
*
*
* 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`
*
*
*
@@ -661,7 +663,7 @@ public Builder setParent(java.lang.String value) {
*
*
* 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`
*
*
*
@@ -681,7 +683,7 @@ public Builder clearParent() {
*
*
* 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`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequestOrBuilder.java
index 061840a2..6515859a 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateAssignmentRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface CreateAssignmentRequestOrBuilder
*
*
* 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`
*
*
*
@@ -43,7 +43,7 @@ public interface CreateAssignmentRequestOrBuilder
*
*
* 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`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateCapacityCommitmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateCapacityCommitmentRequest.java
index dce68c04..41bda1e4 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateCapacityCommitmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateCapacityCommitmentRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.CreateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.CreateCapacityCommitment].
+ * The request for
+ * [ReservationService.CreateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.CreateCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.CreateCapacityCommitmentRequest}
@@ -445,7 +446,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.CreateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.CreateCapacityCommitment].
+ * The request for
+ * [ReservationService.CreateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.CreateCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.CreateCapacityCommitmentRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequest.java
index b4b51e0e..57fce1b8 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.CreateReservation][google.cloud.bigquery.reservation.v1.ReservationService.CreateReservation].
+ * The request for
+ * [ReservationService.CreateReservation][google.cloud.bigquery.reservation.v1.ReservationService.CreateReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.CreateReservationRequest}
@@ -143,7 +144,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -168,7 +169,7 @@ public java.lang.String getParent() {
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -244,7 +245,7 @@ public com.google.protobuf.ByteString getReservationIdBytes() {
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -258,7 +259,7 @@ public boolean hasReservation() {
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -274,7 +275,7 @@ public com.google.cloud.bigquery.reservation.v1.Reservation getReservation() {
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -471,7 +472,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.CreateReservation][google.cloud.bigquery.reservation.v1.ReservationService.CreateReservation].
+ * The request for
+ * [ReservationService.CreateReservation][google.cloud.bigquery.reservation.v1.ReservationService.CreateReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.CreateReservationRequest}
@@ -658,7 +660,7 @@ public Builder mergeFrom(
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -683,7 +685,7 @@ public java.lang.String getParent() {
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -708,7 +710,7 @@ public com.google.protobuf.ByteString getParentBytes() {
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -732,7 +734,7 @@ public Builder setParent(java.lang.String value) {
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -752,7 +754,7 @@ public Builder clearParent() {
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -894,7 +896,7 @@ public Builder setReservationIdBytes(com.google.protobuf.ByteString value) {
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -908,7 +910,7 @@ public boolean hasReservation() {
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -928,7 +930,7 @@ public com.google.cloud.bigquery.reservation.v1.Reservation getReservation() {
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -950,7 +952,7 @@ public Builder setReservation(com.google.cloud.bigquery.reservation.v1.Reservati
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -970,7 +972,7 @@ public Builder setReservation(
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -996,7 +998,7 @@ public Builder mergeReservation(com.google.cloud.bigquery.reservation.v1.Reserva
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -1016,7 +1018,7 @@ public Builder clearReservation() {
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -1030,7 +1032,7 @@ public com.google.cloud.bigquery.reservation.v1.Reservation.Builder getReservati
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -1048,7 +1050,7 @@ public com.google.cloud.bigquery.reservation.v1.ReservationOrBuilder getReservat
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequestOrBuilder.java
index 4d95c97e..956d91d0 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/CreateReservationRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface CreateReservationRequestOrBuilder
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -43,7 +43,7 @@ public interface CreateReservationRequestOrBuilder
*
*
* Required. Project, location. E.g.,
- * projects/myproject/locations/US
+ * `projects/myproject/locations/US`
*
*
*
@@ -85,7 +85,7 @@ public interface CreateReservationRequestOrBuilder
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -97,7 +97,7 @@ public interface CreateReservationRequestOrBuilder
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
@@ -109,7 +109,7 @@ public interface CreateReservationRequestOrBuilder
*
*
*
- * Content of the new reservation to create.
+ * Definition of the new reservation to create.
*
*
* .google.cloud.bigquery.reservation.v1.Reservation reservation = 3;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequest.java
index 8973b37f..bea7419e 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.DeleteAssignment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteAssignment].
+ * The request for
+ * [ReservationService.DeleteAssignment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteAssignment].
* Note: "bigquery.reservationAssignments.delete" permission is required on the
* related assignee.
*
@@ -119,8 +120,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * 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`
*
*
*
@@ -144,8 +145,8 @@ public java.lang.String getName() {
*
*
*
- * 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`
*
*
*
@@ -330,7 +331,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.DeleteAssignment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteAssignment].
+ * The request for
+ * [ReservationService.DeleteAssignment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteAssignment].
* Note: "bigquery.reservationAssignments.delete" permission is required on the
* related assignee.
*
@@ -496,8 +498,8 @@ public Builder mergeFrom(
*
*
*
- * 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`
*
*
*
@@ -521,8 +523,8 @@ public java.lang.String getName() {
*
*
*
- * 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`
*
*
*
@@ -546,8 +548,8 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
*
- * 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`
*
*
*
@@ -570,8 +572,8 @@ public Builder setName(java.lang.String value) {
*
*
*
- * 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`
*
*
*
@@ -590,8 +592,8 @@ public Builder clearName() {
*
*
*
- * 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`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequestOrBuilder.java
index 0a9347eb..d181af6b 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteAssignmentRequestOrBuilder.java
@@ -27,8 +27,8 @@ public interface DeleteAssignmentRequestOrBuilder
*
*
*
- * 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`
*
*
*
@@ -42,8 +42,8 @@ public interface DeleteAssignmentRequestOrBuilder
*
*
*
- * 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`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteCapacityCommitmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteCapacityCommitmentRequest.java
index 0e95fcd7..bcb39eff 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteCapacityCommitmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteCapacityCommitmentRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.DeleteCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteCapacityCommitment].
+ * The request for
+ * [ReservationService.DeleteCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.DeleteCapacityCommitmentRequest}
@@ -331,7 +332,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.DeleteCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteCapacityCommitment].
+ * The request for
+ * [ReservationService.DeleteCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.DeleteCapacityCommitmentRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequest.java
index 6c2116b6..e2da2672 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.DeleteReservation][google.cloud.bigquery.reservation.v1.ReservationService.DeleteReservation].
+ * The request for
+ * [ReservationService.DeleteReservation][google.cloud.bigquery.reservation.v1.ReservationService.DeleteReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.DeleteReservationRequest}
@@ -118,7 +119,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -143,7 +144,7 @@ public java.lang.String getName() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -329,7 +330,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.DeleteReservation][google.cloud.bigquery.reservation.v1.ReservationService.DeleteReservation].
+ * The request for
+ * [ReservationService.DeleteReservation][google.cloud.bigquery.reservation.v1.ReservationService.DeleteReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.DeleteReservationRequest}
@@ -495,7 +497,7 @@ public Builder mergeFrom(
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -520,7 +522,7 @@ public java.lang.String getName() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -545,7 +547,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -569,7 +571,7 @@ public Builder setName(java.lang.String value) {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -589,7 +591,7 @@ public Builder clearName() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequestOrBuilder.java
index 4d4e0ba4..83459628 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/DeleteReservationRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface DeleteReservationRequestOrBuilder
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -43,7 +43,7 @@ public interface DeleteReservationRequestOrBuilder
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetCapacityCommitmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetCapacityCommitmentRequest.java
index 36257978..79a2bef9 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetCapacityCommitmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetCapacityCommitmentRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.GetCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.GetCapacityCommitment].
+ * The request for
+ * [ReservationService.GetCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.GetCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.GetCapacityCommitmentRequest}
@@ -329,7 +330,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.GetCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.GetCapacityCommitment].
+ * The request for
+ * [ReservationService.GetCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.GetCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.GetCapacityCommitmentRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequest.java
index a7d11021..08ba6e82 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.GetReservation][google.cloud.bigquery.reservation.v1.ReservationService.GetReservation].
+ * The request for
+ * [ReservationService.GetReservation][google.cloud.bigquery.reservation.v1.ReservationService.GetReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.GetReservationRequest}
@@ -118,7 +119,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -143,7 +144,7 @@ public java.lang.String getName() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -328,7 +329,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.GetReservation][google.cloud.bigquery.reservation.v1.ReservationService.GetReservation].
+ * The request for
+ * [ReservationService.GetReservation][google.cloud.bigquery.reservation.v1.ReservationService.GetReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.GetReservationRequest}
@@ -492,7 +494,7 @@ public Builder mergeFrom(
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -517,7 +519,7 @@ public java.lang.String getName() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -542,7 +544,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -566,7 +568,7 @@ public Builder setName(java.lang.String value) {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -586,7 +588,7 @@ public Builder clearName() {
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequestOrBuilder.java
index 228d294e..7684075a 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/GetReservationRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface GetReservationRequestOrBuilder
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
@@ -43,7 +43,7 @@ public interface GetReservationRequestOrBuilder
*
*
* Required. Resource name of the reservation to retrieve. E.g.,
- * projects/myproject/locations/US/reservations/team1-prod
+ * `projects/myproject/locations/US/reservations/team1-prod`
*
*
*
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequest.java
index 147bf6f6..e7111d9a 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
+ * The request for
+ * [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListAssignmentsRequest}
@@ -131,9 +132,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* 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/-`
*
*
*
@@ -158,9 +159,9 @@ public java.lang.String getParent() {
*
*
* 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/-`
*
*
*
@@ -187,7 +188,7 @@ public com.google.protobuf.ByteString getParentBytes() {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
@@ -427,7 +428,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
+ * The request for
+ * [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListAssignmentsRequest}
@@ -605,9 +607,9 @@ public Builder mergeFrom(
*
*
* 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/-`
*
*
*
@@ -632,9 +634,9 @@ public java.lang.String getParent() {
*
*
* 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/-`
*
*
*
@@ -659,9 +661,9 @@ public com.google.protobuf.ByteString getParentBytes() {
*
*
* 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/-`
*
*
*
@@ -685,9 +687,9 @@ public Builder setParent(java.lang.String value) {
*
*
* 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/-`
*
*
*
@@ -707,9 +709,9 @@ public Builder clearParent() {
*
*
* 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/-`
*
*
*
@@ -735,7 +737,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
@@ -749,7 +751,7 @@ public int getPageSize() {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
@@ -767,7 +769,7 @@ public Builder setPageSize(int value) {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequestOrBuilder.java
index 8b3f93aa..113d2950 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsRequestOrBuilder.java
@@ -28,9 +28,9 @@ public interface ListAssignmentsRequestOrBuilder
*
*
* 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/-`
*
*
*
@@ -45,9 +45,9 @@ public interface ListAssignmentsRequestOrBuilder
*
*
* 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/-`
*
*
*
@@ -62,7 +62,7 @@ public interface ListAssignmentsRequestOrBuilder
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsResponse.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsResponse.java
index 29f77196..0b1a7937 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsResponse.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListAssignmentsResponse.java
@@ -22,7 +22,8 @@
*
*
*
- * The response for [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
+ * The response for
+ * [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListAssignmentsResponse}
@@ -418,7 +419,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The response for [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
+ * The response for
+ * [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListAssignmentsResponse}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsRequest.java
index dd1dd512..ef166842 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
+ * The request for
+ * [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListCapacityCommitmentsRequest}
@@ -425,7 +426,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
+ * The request for
+ * [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListCapacityCommitmentsRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsResponse.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsResponse.java
index 8536593d..75a92d3f 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsResponse.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListCapacityCommitmentsResponse.java
@@ -22,7 +22,8 @@
*
*
*
- * The response for [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
+ * The response for
+ * [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListCapacityCommitmentsResponse}
@@ -437,7 +438,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The response for [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
+ * The response for
+ * [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListCapacityCommitmentsResponse}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequest.java
index f37b4694..1c85b789 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
+ * The request for
+ * [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListReservationsRequest}
@@ -183,7 +184,7 @@ public com.google.protobuf.ByteString getParentBytes() {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
@@ -423,7 +424,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
+ * The request for
+ * [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListReservationsRequest}
@@ -721,7 +723,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
@@ -735,7 +737,7 @@ public int getPageSize() {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
@@ -753,7 +755,7 @@ public Builder setPageSize(int value) {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequestOrBuilder.java
index 293d51a4..5c2b3995 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsRequestOrBuilder.java
@@ -58,7 +58,7 @@ public interface ListReservationsRequestOrBuilder
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 2;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsResponse.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsResponse.java
index 7d13a0c8..3c07f2b8 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsResponse.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ListReservationsResponse.java
@@ -22,7 +22,8 @@
*
*
*
- * The response for [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
+ * The response for
+ * [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListReservationsResponse}
@@ -420,7 +421,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The response for [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
+ * The response for
+ * [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.ListReservationsResponse}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MergeCapacityCommitmentsRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MergeCapacityCommitmentsRequest.java
index 676caf82..698a84b3 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MergeCapacityCommitmentsRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MergeCapacityCommitmentsRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.MergeCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.MergeCapacityCommitments].
+ * The request for
+ * [ReservationService.MergeCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.MergeCapacityCommitments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.MergeCapacityCommitmentsRequest}
@@ -428,7 +429,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.MergeCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.MergeCapacityCommitments].
+ * The request for
+ * [ReservationService.MergeCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.MergeCapacityCommitments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.MergeCapacityCommitmentsRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequest.java
index d3b827c3..359bfdb9 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequest.java
@@ -24,9 +24,10 @@
*
* The request for
* [ReservationService.MoveAssignment][google.cloud.bigquery.reservation.v1.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.
*
*
@@ -131,8 +132,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* 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`
*
*
*
@@ -157,8 +158,8 @@ public java.lang.String getName() {
*
*
* 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`
*
*
*
@@ -186,7 +187,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
@@ -209,7 +210,7 @@ public java.lang.String getDestinationId() {
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
@@ -403,9 +404,10 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
* The request for
* [ReservationService.MoveAssignment][google.cloud.bigquery.reservation.v1.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.
*
*
@@ -577,8 +579,8 @@ public Builder mergeFrom(
*
*
* 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`
*
*
*
@@ -603,8 +605,8 @@ public java.lang.String getName() {
*
*
* 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`
*
*
*
@@ -629,8 +631,8 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* 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`
*
*
*
@@ -654,8 +656,8 @@ public Builder setName(java.lang.String value) {
*
*
* 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`
*
*
*
@@ -675,8 +677,8 @@ public Builder clearName() {
*
*
* 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`
*
*
*
@@ -703,7 +705,7 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
@@ -726,7 +728,7 @@ public java.lang.String getDestinationId() {
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
@@ -749,7 +751,7 @@ public com.google.protobuf.ByteString getDestinationIdBytes() {
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
@@ -771,7 +773,7 @@ public Builder setDestinationId(java.lang.String value) {
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
@@ -789,7 +791,7 @@ public Builder clearDestinationId() {
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequestOrBuilder.java
index 2c1eb9f5..eb805d5e 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/MoveAssignmentRequestOrBuilder.java
@@ -28,8 +28,8 @@ public interface MoveAssignmentRequestOrBuilder
*
*
* 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`
*
*
*
@@ -44,8 +44,8 @@ public interface MoveAssignmentRequestOrBuilder
*
*
* 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`
*
*
*
@@ -61,7 +61,7 @@ public interface MoveAssignmentRequestOrBuilder
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
@@ -74,7 +74,7 @@ public interface MoveAssignmentRequestOrBuilder
*
*
* The new reservation ID, e.g.:
- * projects/myotherproject/locations/US/reservations/team2-prod
+ * `projects/myotherproject/locations/US/reservations/team2-prod`
*
*
* string destination_id = 3;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Reservation.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Reservation.java
index 1b67e6dd..8a231fb5 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Reservation.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/Reservation.java
@@ -128,7 +128,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
@@ -151,7 +151,7 @@ public java.lang.String getName() {
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
@@ -567,7 +567,7 @@ public Builder mergeFrom(
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
@@ -590,7 +590,7 @@ public java.lang.String getName() {
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
@@ -613,7 +613,7 @@ public com.google.protobuf.ByteString getNameBytes() {
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
@@ -635,7 +635,7 @@ public Builder setName(java.lang.String value) {
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
@@ -653,7 +653,7 @@ public Builder clearName() {
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationOrBuilder.java
index fec82c83..af84f3fb 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationOrBuilder.java
@@ -28,7 +28,7 @@ public interface ReservationOrBuilder
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
@@ -41,7 +41,7 @@ public interface ReservationOrBuilder
*
*
* The resource name of the reservation, e.g.,
- * "projects/*/locations/*/reservations/team1-prod".
+ * `projects/*/locations/*/reservations/team1-prod`.
*
*
* string name = 1;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationProto.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationProto.java
index 7826cc8d..07e72b6a 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationProto.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/ReservationProto.java
@@ -161,7 +161,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
+ "lots\030\004 \001(\010:w\352At\n.bigqueryreservation.goo"
+ "gleapis.com/Reservation\022Bprojects/{proje"
+ "ct}/locations/{location}/reservations/{r"
- + "eservation}\"\340\005\n\022CapacityCommitment\022\021\n\004na"
+ + "eservation}\"\353\005\n\022CapacityCommitment\022\021\n\004na"
+ "me\030\001 \001(\tB\003\340A\003\022\022\n\nslot_count\030\002 \001(\003\022U\n\004pla"
+ "n\030\003 \001(\0162G.google.cloud.bigquery.reservat"
+ "ion.v1.CapacityCommitment.CommitmentPlan"
@@ -172,234 +172,234 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
+ "atus\030\007 \001(\0132\022.google.rpc.StatusB\003\340A\003\022]\n\014r"
+ "enewal_plan\030\010 \001(\0162G.google.cloud.bigquer"
+ "y.reservation.v1.CapacityCommitment.Comm"
- + "itmentPlan\"T\n\016CommitmentPlan\022\037\n\033COMMITME"
- + "NT_PLAN_UNSPECIFIED\020\000\022\010\n\004FLEX\020\003\022\013\n\007MONTH"
- + "LY\020\002\022\n\n\006ANNUAL\020\004\"C\n\005State\022\025\n\021STATE_UNSPE"
- + "CIFIED\020\000\022\013\n\007PENDING\020\001\022\n\n\006ACTIVE\020\002\022\n\n\006FAI"
- + "LED\020\003:\216\001\352A\212\001\n5bigqueryreservation.google"
- + "apis.com/CapacityCommitment\022Qprojects/{p"
- + "roject}/locations/{location}/capacityCom"
- + "mitments/{capacity_commitment}\"\302\001\n\030Creat"
- + "eReservationRequest\022F\n\006parent\030\001 \001(\tB6\340A\002"
- + "\372A0\022.bigqueryreservation.googleapis.com/"
- + "Reservation\022\026\n\016reservation_id\030\002 \001(\t\022F\n\013r"
- + "eservation\030\003 \001(\01321.google.cloud.bigquery"
- + ".reservation.v1.Reservation\"\210\001\n\027ListRese"
- + "rvationsRequest\022F\n\006parent\030\001 \001(\tB6\340A\002\372A0\022"
- + ".bigqueryreservation.googleapis.com/Rese"
- + "rvation\022\021\n\tpage_size\030\002 \001(\005\022\022\n\npage_token"
- + "\030\003 \001(\t\"|\n\030ListReservationsResponse\022G\n\014re"
- + "servations\030\001 \003(\01321.google.cloud.bigquery"
- + ".reservation.v1.Reservation\022\027\n\017next_page"
- + "_token\030\002 \001(\t\"]\n\025GetReservationRequest\022D\n"
- + "\004name\030\001 \001(\tB6\340A\002\372A0\n.bigqueryreservation"
- + ".googleapis.com/Reservation\"`\n\030DeleteRes"
- + "ervationRequest\022D\n\004name\030\001 \001(\tB6\340A\002\372A0\n.b"
- + "igqueryreservation.googleapis.com/Reserv"
- + "ation\"\223\001\n\030UpdateReservationRequest\022F\n\013re"
- + "servation\030\001 \001(\01321.google.cloud.bigquery."
- + "reservation.v1.Reservation\022/\n\013update_mas"
- + "k\030\002 \001(\0132\032.google.protobuf.FieldMask\"\365\001\n\037"
- + "CreateCapacityCommitmentRequest\022M\n\006paren"
- + "t\030\001 \001(\tB=\340A\002\372A7\0225bigqueryreservation.goo"
- + "gleapis.com/CapacityCommitment\022U\n\023capaci"
- + "ty_commitment\030\002 \001(\01328.google.cloud.bigqu"
- + "ery.reservation.v1.CapacityCommitment\022,\n"
- + "$enforce_single_admin_project_per_org\030\004 "
- + "\001(\010\"\226\001\n\036ListCapacityCommitmentsRequest\022M"
- + "\n\006parent\030\001 \001(\tB=\340A\002\372A7\0225bigqueryreservat"
- + "ion.googleapis.com/CapacityCommitment\022\021\n"
- + "\tpage_size\030\002 \001(\005\022\022\n\npage_token\030\003 \001(\t\"\222\001\n"
- + "\037ListCapacityCommitmentsResponse\022V\n\024capa"
- + "city_commitments\030\001 \003(\01328.google.cloud.bi"
- + "gquery.reservation.v1.CapacityCommitment"
- + "\022\027\n\017next_page_token\030\002 \001(\t\"k\n\034GetCapacity"
- + "CommitmentRequest\022K\n\004name\030\001 \001(\tB=\340A\002\372A7\n"
- + "5bigqueryreservation.googleapis.com/Capa"
- + "cityCommitment\"n\n\037DeleteCapacityCommitme"
- + "ntRequest\022K\n\004name\030\001 \001(\tB=\340A\002\372A7\n5bigquer"
- + "yreservation.googleapis.com/CapacityComm"
- + "itment\"\251\001\n\037UpdateCapacityCommitmentReque"
- + "st\022U\n\023capacity_commitment\030\001 \001(\01328.google"
- + ".cloud.bigquery.reservation.v1.CapacityC"
- + "ommitment\022/\n\013update_mask\030\002 \001(\0132\032.google."
- + "protobuf.FieldMask\"\201\001\n\036SplitCapacityComm"
- + "itmentRequest\022K\n\004name\030\001 \001(\tB=\340A\002\372A7\n5big"
- + "queryreservation.googleapis.com/Capacity"
- + "Commitment\022\022\n\nslot_count\030\002 \001(\003\"\264\001\n\037Split"
- + "CapacityCommitmentResponse\022G\n\005first\030\001 \001("
- + "\01328.google.cloud.bigquery.reservation.v1"
- + ".CapacityCommitment\022H\n\006second\030\002 \001(\01328.go"
- + "ogle.cloud.bigquery.reservation.v1.Capac"
- + "ityCommitment\"\216\001\n\037MergeCapacityCommitmen"
- + "tsRequest\022J\n\006parent\030\001 \001(\tB:\372A7\0225bigquery"
- + "reservation.googleapis.com/CapacityCommi"
- + "tment\022\037\n\027capacity_commitment_ids\030\002 \003(\t\"\323"
- + "\003\n\nAssignment\022\021\n\004name\030\001 \001(\tB\003\340A\003\022\020\n\010assi"
- + "gnee\030\004 \001(\t\022J\n\010job_type\030\003 \001(\01628.google.cl"
- + "oud.bigquery.reservation.v1.Assignment.J"
- + "obType\022J\n\005state\030\006 \001(\01626.google.cloud.big"
- + "query.reservation.v1.Assignment.StateB\003\340"
- + "A\003\"<\n\007JobType\022\030\n\024JOB_TYPE_UNSPECIFIED\020\000\022"
- + "\014\n\010PIPELINE\020\001\022\t\n\005QUERY\020\002\"7\n\005State\022\025\n\021STA"
- + "TE_UNSPECIFIED\020\000\022\013\n\007PENDING\020\001\022\n\n\006ACTIVE\020"
- + "\002:\220\001\352A\214\001\n-bigqueryreservation.googleapis"
- + ".com/Assignment\022[projects/{project}/loca"
- + "tions/{location}/reservations/{reservati"
- + "on}/assignments/{assignment}\"\246\001\n\027CreateA"
- + "ssignmentRequest\022E\n\006parent\030\001 \001(\tB5\340A\002\372A/"
- + "\022-bigqueryreservation.googleapis.com/Ass"
- + "ignment\022D\n\nassignment\030\002 \001(\01320.google.clo"
- + "ud.bigquery.reservation.v1.Assignment\"\207\001"
- + "\n\026ListAssignmentsRequest\022F\n\006parent\030\001 \001(\t"
+ + "itmentPlan\"_\n\016CommitmentPlan\022\037\n\033COMMITME"
+ + "NT_PLAN_UNSPECIFIED\020\000\022\010\n\004FLEX\020\003\022\t\n\005TRIAL"
+ + "\020\005\022\013\n\007MONTHLY\020\002\022\n\n\006ANNUAL\020\004\"C\n\005State\022\025\n\021"
+ + "STATE_UNSPECIFIED\020\000\022\013\n\007PENDING\020\001\022\n\n\006ACTI"
+ + "VE\020\002\022\n\n\006FAILED\020\003:\216\001\352A\212\001\n5bigqueryreserva"
+ + "tion.googleapis.com/CapacityCommitment\022Q"
+ + "projects/{project}/locations/{location}/"
+ + "capacityCommitments/{capacity_commitment"
+ + "}\"\302\001\n\030CreateReservationRequest\022F\n\006parent"
+ + "\030\001 \001(\tB6\340A\002\372A0\022.bigqueryreservation.goog"
+ + "leapis.com/Reservation\022\026\n\016reservation_id"
+ + "\030\002 \001(\t\022F\n\013reservation\030\003 \001(\01321.google.clo"
+ + "ud.bigquery.reservation.v1.Reservation\"\210"
+ + "\001\n\027ListReservationsRequest\022F\n\006parent\030\001 \001"
+ + "(\tB6\340A\002\372A0\022.bigqueryreservation.googleap"
+ + "is.com/Reservation\022\021\n\tpage_size\030\002 \001(\005\022\022\n"
+ + "\npage_token\030\003 \001(\t\"|\n\030ListReservationsRes"
+ + "ponse\022G\n\014reservations\030\001 \003(\01321.google.clo"
+ + "ud.bigquery.reservation.v1.Reservation\022\027"
+ + "\n\017next_page_token\030\002 \001(\t\"]\n\025GetReservatio"
+ + "nRequest\022D\n\004name\030\001 \001(\tB6\340A\002\372A0\n.bigquery"
+ + "reservation.googleapis.com/Reservation\"`"
+ + "\n\030DeleteReservationRequest\022D\n\004name\030\001 \001(\t"
+ "B6\340A\002\372A0\n.bigqueryreservation.googleapis"
- + ".com/Reservation\022\021\n\tpage_size\030\002 \001(\005\022\022\n\np"
- + "age_token\030\003 \001(\t\"y\n\027ListAssignmentsRespon"
- + "se\022E\n\013assignments\030\001 \003(\01320.google.cloud.b"
- + "igquery.reservation.v1.Assignment\022\027\n\017nex"
- + "t_page_token\030\002 \001(\t\"^\n\027DeleteAssignmentRe"
- + "quest\022C\n\004name\030\001 \001(\tB5\340A\002\372A/\n-bigqueryres"
- + "ervation.googleapis.com/Assignment\"\227\001\n\030S"
- + "earchAssignmentsRequest\022E\n\006parent\030\001 \001(\tB"
- + "5\340A\002\372A/\022-bigqueryreservation.googleapis."
- + "com/Assignment\022\r\n\005query\030\002 \001(\t\022\021\n\tpage_si"
- + "ze\030\003 \001(\005\022\022\n\npage_token\030\004 \001(\t\"{\n\031SearchAs"
- + "signmentsResponse\022E\n\013assignments\030\001 \003(\01320"
+ + ".com/Reservation\"\223\001\n\030UpdateReservationRe"
+ + "quest\022F\n\013reservation\030\001 \001(\01321.google.clou"
+ + "d.bigquery.reservation.v1.Reservation\022/\n"
+ + "\013update_mask\030\002 \001(\0132\032.google.protobuf.Fie"
+ + "ldMask\"\365\001\n\037CreateCapacityCommitmentReque"
+ + "st\022M\n\006parent\030\001 \001(\tB=\340A\002\372A7\0225bigqueryrese"
+ + "rvation.googleapis.com/CapacityCommitmen"
+ + "t\022U\n\023capacity_commitment\030\002 \001(\01328.google."
+ + "cloud.bigquery.reservation.v1.CapacityCo"
+ + "mmitment\022,\n$enforce_single_admin_project"
+ + "_per_org\030\004 \001(\010\"\226\001\n\036ListCapacityCommitmen"
+ + "tsRequest\022M\n\006parent\030\001 \001(\tB=\340A\002\372A7\0225bigqu"
+ + "eryreservation.googleapis.com/CapacityCo"
+ + "mmitment\022\021\n\tpage_size\030\002 \001(\005\022\022\n\npage_toke"
+ + "n\030\003 \001(\t\"\222\001\n\037ListCapacityCommitmentsRespo"
+ + "nse\022V\n\024capacity_commitments\030\001 \003(\01328.goog"
+ + "le.cloud.bigquery.reservation.v1.Capacit"
+ + "yCommitment\022\027\n\017next_page_token\030\002 \001(\t\"k\n\034"
+ + "GetCapacityCommitmentRequest\022K\n\004name\030\001 \001"
+ + "(\tB=\340A\002\372A7\n5bigqueryreservation.googleap"
+ + "is.com/CapacityCommitment\"n\n\037DeleteCapac"
+ + "ityCommitmentRequest\022K\n\004name\030\001 \001(\tB=\340A\002\372"
+ + "A7\n5bigqueryreservation.googleapis.com/C"
+ + "apacityCommitment\"\251\001\n\037UpdateCapacityComm"
+ + "itmentRequest\022U\n\023capacity_commitment\030\001 \001"
+ + "(\01328.google.cloud.bigquery.reservation.v"
+ + "1.CapacityCommitment\022/\n\013update_mask\030\002 \001("
+ + "\0132\032.google.protobuf.FieldMask\"\201\001\n\036SplitC"
+ + "apacityCommitmentRequest\022K\n\004name\030\001 \001(\tB="
+ + "\340A\002\372A7\n5bigqueryreservation.googleapis.c"
+ + "om/CapacityCommitment\022\022\n\nslot_count\030\002 \001("
+ + "\003\"\264\001\n\037SplitCapacityCommitmentResponse\022G\n"
+ + "\005first\030\001 \001(\01328.google.cloud.bigquery.res"
+ + "ervation.v1.CapacityCommitment\022H\n\006second"
+ + "\030\002 \001(\01328.google.cloud.bigquery.reservati"
+ + "on.v1.CapacityCommitment\"\216\001\n\037MergeCapaci"
+ + "tyCommitmentsRequest\022J\n\006parent\030\001 \001(\tB:\372A"
+ + "7\0225bigqueryreservation.googleapis.com/Ca"
+ + "pacityCommitment\022\037\n\027capacity_commitment_"
+ + "ids\030\002 \003(\t\"\323\003\n\nAssignment\022\021\n\004name\030\001 \001(\tB\003"
+ + "\340A\003\022\020\n\010assignee\030\004 \001(\t\022J\n\010job_type\030\003 \001(\0162"
+ + "8.google.cloud.bigquery.reservation.v1.A"
+ + "ssignment.JobType\022J\n\005state\030\006 \001(\01626.googl"
+ + "e.cloud.bigquery.reservation.v1.Assignme"
+ + "nt.StateB\003\340A\003\"<\n\007JobType\022\030\n\024JOB_TYPE_UNS"
+ + "PECIFIED\020\000\022\014\n\010PIPELINE\020\001\022\t\n\005QUERY\020\002\"7\n\005S"
+ + "tate\022\025\n\021STATE_UNSPECIFIED\020\000\022\013\n\007PENDING\020\001"
+ + "\022\n\n\006ACTIVE\020\002:\220\001\352A\214\001\n-bigqueryreservation"
+ + ".googleapis.com/Assignment\022[projects/{pr"
+ + "oject}/locations/{location}/reservations"
+ + "/{reservation}/assignments/{assignment}\""
+ + "\246\001\n\027CreateAssignmentRequest\022E\n\006parent\030\001 "
+ + "\001(\tB5\340A\002\372A/\022-bigqueryreservation.googlea"
+ + "pis.com/Assignment\022D\n\nassignment\030\002 \001(\01320"
+ ".google.cloud.bigquery.reservation.v1.As"
- + "signment\022\027\n\017next_page_token\030\002 \001(\t\"t\n\025Mov"
- + "eAssignmentRequest\022C\n\004name\030\001 \001(\tB5\340A\002\372A/"
- + "\n-bigqueryreservation.googleapis.com/Ass"
- + "ignment\022\026\n\016destination_id\030\003 \001(\t\"\317\001\n\rBiRe"
- + "servation\022\014\n\004name\030\001 \001(\t\0224\n\013update_time\030\003"
- + " \001(\0132\032.google.protobuf.TimestampB\003\340A\003\022\014\n"
- + "\004size\030\004 \001(\003:l\352Ai\n0bigqueryreservation.go"
- + "ogleapis.com/BiReservation\0225projects/{pr"
- + "oject}/locations/{location}/bireservatio"
- + "n\"a\n\027GetBiReservationRequest\022F\n\004name\030\001 \001"
- + "(\tB8\340A\002\372A2\n0bigqueryreservation.googleap"
- + "is.com/BiReservation\"\232\001\n\032UpdateBiReserva"
- + "tionRequest\022K\n\016bi_reservation\030\001 \001(\01323.go"
- + "ogle.cloud.bigquery.reservation.v1.BiRes"
- + "ervation\022/\n\013update_mask\030\002 \001(\0132\032.google.p"
- + "rotobuf.FieldMask2\317#\n\022ReservationService"
- + "\022\361\001\n\021CreateReservation\022>.google.cloud.bi"
- + "gquery.reservation.v1.CreateReservationR"
- + "equest\0321.google.cloud.bigquery.reservati"
- + "on.v1.Reservation\"i\202\323\344\223\002?\"0/v1/{parent=p"
- + "rojects/*/locations/*}/reservations:\013res"
- + "ervation\332A!parent,reservation,reservatio"
- + "n_id\022\324\001\n\020ListReservations\022=.google.cloud"
- + ".bigquery.reservation.v1.ListReservation"
- + "sRequest\032>.google.cloud.bigquery.reserva"
- + "tion.v1.ListReservationsResponse\"A\202\323\344\223\0022"
- + "\0220/v1/{parent=projects/*/locations/*}/re"
- + "servations\332A\006parent\022\301\001\n\016GetReservation\022;"
- + ".google.cloud.bigquery.reservation.v1.Ge"
- + "tReservationRequest\0321.google.cloud.bigqu"
- + "ery.reservation.v1.Reservation\"?\202\323\344\223\0022\0220"
- + "/v1/{name=projects/*/locations/*/reserva"
- + "tions/*}\332A\004name\022\254\001\n\021DeleteReservation\022>."
- + "google.cloud.bigquery.reservation.v1.Del"
- + "eteReservationRequest\032\026.google.protobuf."
- + "Empty\"?\202\323\344\223\0022*0/v1/{name=projects/*/loca"
- + "tions/*/reservations/*}\332A\004name\022\363\001\n\021Updat"
- + "eReservation\022>.google.cloud.bigquery.res"
- + "ervation.v1.UpdateReservationRequest\0321.g"
- + "oogle.cloud.bigquery.reservation.v1.Rese"
- + "rvation\"k\202\323\344\223\002K2/v1/{parent=project"
- + "s/*/locations/*/reservations/*}/assignme"
- + "nts:\nassignment\332A\021parent,assignment\022\337\001\n\017"
- + "ListAssignments\022<.google.cloud.bigquery."
- + "reservation.v1.ListAssignmentsRequest\032=."
- + "google.cloud.bigquery.reservation.v1.Lis"
- + "tAssignmentsResponse\"O\202\323\344\223\002@\022>/v1/{paren"
- + "t=projects/*/locations/*/reservations/*}"
- + "/assignments\332A\006parent\022\270\001\n\020DeleteAssignme"
- + "nt\022=.google.cloud.bigquery.reservation.v"
- + "1.DeleteAssignmentRequest\032\026.google.proto"
- + "buf.Empty\"M\202\323\344\223\002@*>/v1/{name=projects/*/"
- + "locations/*/reservations/*/assignments/*"
- + "}\332A\004name\022\342\001\n\021SearchAssignments\022>.google."
- + "cloud.bigquery.reservation.v1.SearchAssi"
- + "gnmentsRequest\032?.google.cloud.bigquery.r"
- + "eservation.v1.SearchAssignmentsResponse\""
- + "L\202\323\344\223\0027\0225/v1/{parent=projects/*/location"
- + "s/*}:searchAssignments\332A\014parent,query\022\345\001"
- + "\n\016MoveAssignment\022;.google.cloud.bigquery"
- + ".reservation.v1.MoveAssignmentRequest\0320."
- + "google.cloud.bigquery.reservation.v1.Ass"
- + "ignment\"d\202\323\344\223\002H\"C/v1/{name=projects/*/lo"
- + "cations/*/reservations/*/assignments/*}:"
- + "move:\001*\332A\023name,destination_id\022\306\001\n\020GetBiR"
- + "eservation\022=.google.cloud.bigquery.reser"
- + "vation.v1.GetBiReservationRequest\0323.goog"
- + "le.cloud.bigquery.reservation.v1.BiReser"
- + "vation\">\202\323\344\223\0021\022//v1/{name=projects/*/loc"
- + "ations/*/biReservation}\332A\004name\022\201\002\n\023Updat"
- + "eBiReservation\022@.google.cloud.bigquery.r"
- + "eservation.v1.UpdateBiReservationRequest"
- + "\0323.google.cloud.bigquery.reservation.v1."
- + "BiReservation\"s\202\323\344\223\002P2>/v1/{bi_reservati"
- + "on.name=projects/*/locations/*/biReserva"
- + "tion}:\016bi_reservation\332A\032bi_reservation,u"
- + "pdate_mask\032\177\312A\"bigqueryreservation.googl"
- + "eapis.com\322AWhttps://www.googleapis.com/a"
- + "uth/bigquery,https://www.googleapis.com/"
- + "auth/cloud-platformB\217\001\n(com.google.cloud"
- + ".bigquery.reservation.v1B\020ReservationPro"
- + "toP\001ZOgoogle.golang.org/genproto/googlea"
- + "pis/cloud/bigquery/reservation/v1;reserv"
- + "ationb\006proto3"
+ + "signment\"\207\001\n\026ListAssignmentsRequest\022F\n\006p"
+ + "arent\030\001 \001(\tB6\340A\002\372A0\n.bigqueryreservation"
+ + ".googleapis.com/Reservation\022\021\n\tpage_size"
+ + "\030\002 \001(\005\022\022\n\npage_token\030\003 \001(\t\"y\n\027ListAssign"
+ + "mentsResponse\022E\n\013assignments\030\001 \003(\01320.goo"
+ + "gle.cloud.bigquery.reservation.v1.Assign"
+ + "ment\022\027\n\017next_page_token\030\002 \001(\t\"^\n\027DeleteA"
+ + "ssignmentRequest\022C\n\004name\030\001 \001(\tB5\340A\002\372A/\n-"
+ + "bigqueryreservation.googleapis.com/Assig"
+ + "nment\"\227\001\n\030SearchAssignmentsRequest\022E\n\006pa"
+ + "rent\030\001 \001(\tB5\340A\002\372A/\022-bigqueryreservation."
+ + "googleapis.com/Assignment\022\r\n\005query\030\002 \001(\t"
+ + "\022\021\n\tpage_size\030\003 \001(\005\022\022\n\npage_token\030\004 \001(\t\""
+ + "{\n\031SearchAssignmentsResponse\022E\n\013assignme"
+ + "nts\030\001 \003(\01320.google.cloud.bigquery.reserv"
+ + "ation.v1.Assignment\022\027\n\017next_page_token\030\002"
+ + " \001(\t\"t\n\025MoveAssignmentRequest\022C\n\004name\030\001 "
+ + "\001(\tB5\340A\002\372A/\n-bigqueryreservation.googlea"
+ + "pis.com/Assignment\022\026\n\016destination_id\030\003 \001"
+ + "(\t\"\317\001\n\rBiReservation\022\014\n\004name\030\001 \001(\t\0224\n\013up"
+ + "date_time\030\003 \001(\0132\032.google.protobuf.Timest"
+ + "ampB\003\340A\003\022\014\n\004size\030\004 \001(\003:l\352Ai\n0bigqueryres"
+ + "ervation.googleapis.com/BiReservation\0225p"
+ + "rojects/{project}/locations/{location}/b"
+ + "ireservation\"a\n\027GetBiReservationRequest\022"
+ + "F\n\004name\030\001 \001(\tB8\340A\002\372A2\n0bigqueryreservati"
+ + "on.googleapis.com/BiReservation\"\232\001\n\032Upda"
+ + "teBiReservationRequest\022K\n\016bi_reservation"
+ + "\030\001 \001(\01323.google.cloud.bigquery.reservati"
+ + "on.v1.BiReservation\022/\n\013update_mask\030\002 \001(\013"
+ + "2\032.google.protobuf.FieldMask2\317#\n\022Reserva"
+ + "tionService\022\361\001\n\021CreateReservation\022>.goog"
+ + "le.cloud.bigquery.reservation.v1.CreateR"
+ + "eservationRequest\0321.google.cloud.bigquer"
+ + "y.reservation.v1.Reservation\"i\202\323\344\223\002?\"0/v"
+ + "1/{parent=projects/*/locations/*}/reserv"
+ + "ations:\013reservation\332A!parent,reservation"
+ + ",reservation_id\022\324\001\n\020ListReservations\022=.g"
+ + "oogle.cloud.bigquery.reservation.v1.List"
+ + "ReservationsRequest\032>.google.cloud.bigqu"
+ + "ery.reservation.v1.ListReservationsRespo"
+ + "nse\"A\202\323\344\223\0022\0220/v1/{parent=projects/*/loca"
+ + "tions/*}/reservations\332A\006parent\022\301\001\n\016GetRe"
+ + "servation\022;.google.cloud.bigquery.reserv"
+ + "ation.v1.GetReservationRequest\0321.google."
+ + "cloud.bigquery.reservation.v1.Reservatio"
+ + "n\"?\202\323\344\223\0022\0220/v1/{name=projects/*/location"
+ + "s/*/reservations/*}\332A\004name\022\254\001\n\021DeleteRes"
+ + "ervation\022>.google.cloud.bigquery.reserva"
+ + "tion.v1.DeleteReservationRequest\032\026.googl"
+ + "e.protobuf.Empty\"?\202\323\344\223\0022*0/v1/{name=proj"
+ + "ects/*/locations/*/reservations/*}\332A\004nam"
+ + "e\022\363\001\n\021UpdateReservation\022>.google.cloud.b"
+ + "igquery.reservation.v1.UpdateReservation"
+ + "Request\0321.google.cloud.bigquery.reservat"
+ + "ion.v1.Reservation\"k\202\323\344\223\002K2/v1/{par"
+ + "ent=projects/*/locations/*/reservations/"
+ + "*}/assignments:\nassignment\332A\021parent,assi"
+ + "gnment\022\337\001\n\017ListAssignments\022<.google.clou"
+ + "d.bigquery.reservation.v1.ListAssignment"
+ + "sRequest\032=.google.cloud.bigquery.reserva"
+ + "tion.v1.ListAssignmentsResponse\"O\202\323\344\223\002@\022"
+ + ">/v1/{parent=projects/*/locations/*/rese"
+ + "rvations/*}/assignments\332A\006parent\022\270\001\n\020Del"
+ + "eteAssignment\022=.google.cloud.bigquery.re"
+ + "servation.v1.DeleteAssignmentRequest\032\026.g"
+ + "oogle.protobuf.Empty\"M\202\323\344\223\002@*>/v1/{name="
+ + "projects/*/locations/*/reservations/*/as"
+ + "signments/*}\332A\004name\022\342\001\n\021SearchAssignment"
+ + "s\022>.google.cloud.bigquery.reservation.v1"
+ + ".SearchAssignmentsRequest\032?.google.cloud"
+ + ".bigquery.reservation.v1.SearchAssignmen"
+ + "tsResponse\"L\202\323\344\223\0027\0225/v1/{parent=projects"
+ + "/*/locations/*}:searchAssignments\332A\014pare"
+ + "nt,query\022\345\001\n\016MoveAssignment\022;.google.clo"
+ + "ud.bigquery.reservation.v1.MoveAssignmen"
+ + "tRequest\0320.google.cloud.bigquery.reserva"
+ + "tion.v1.Assignment\"d\202\323\344\223\002H\"C/v1/{name=pr"
+ + "ojects/*/locations/*/reservations/*/assi"
+ + "gnments/*}:move:\001*\332A\023name,destination_id"
+ + "\022\306\001\n\020GetBiReservation\022=.google.cloud.big"
+ + "query.reservation.v1.GetBiReservationReq"
+ + "uest\0323.google.cloud.bigquery.reservation"
+ + ".v1.BiReservation\">\202\323\344\223\0021\022//v1/{name=pro"
+ + "jects/*/locations/*/biReservation}\332A\004nam"
+ + "e\022\201\002\n\023UpdateBiReservation\022@.google.cloud"
+ + ".bigquery.reservation.v1.UpdateBiReserva"
+ + "tionRequest\0323.google.cloud.bigquery.rese"
+ + "rvation.v1.BiReservation\"s\202\323\344\223\002P2>/v1/{b"
+ + "i_reservation.name=projects/*/locations/"
+ + "*/biReservation}:\016bi_reservation\332A\032bi_re"
+ + "servation,update_mask\032\177\312A\"bigqueryreserv"
+ + "ation.googleapis.com\322AWhttps://www.googl"
+ + "eapis.com/auth/bigquery,https://www.goog"
+ + "leapis.com/auth/cloud-platformB\217\001\n(com.g"
+ + "oogle.cloud.bigquery.reservation.v1B\020Res"
+ + "ervationProtoP\001ZOgoogle.golang.org/genpr"
+ + "oto/googleapis/cloud/bigquery/reservatio"
+ + "n/v1;reservationb\006proto3"
};
descriptor =
com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequest.java
index 5e29dc0d..0696b89b 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequest.java
@@ -141,8 +141,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -167,8 +167,8 @@ public java.lang.String getParent() {
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -197,9 +197,10 @@ public com.google.protobuf.ByteString getParentBytes() {
*
*
* 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;
@@ -222,9 +223,10 @@ public java.lang.String getQuery() {
*
*
* 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;
@@ -249,7 +251,7 @@ public com.google.protobuf.ByteString getQueryBytes() {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 3;
@@ -687,8 +689,8 @@ public Builder mergeFrom(
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -713,8 +715,8 @@ public java.lang.String getParent() {
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -739,8 +741,8 @@ public com.google.protobuf.ByteString getParentBytes() {
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -764,8 +766,8 @@ public Builder setParent(java.lang.String value) {
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -785,8 +787,8 @@ public Builder clearParent() {
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -814,9 +816,10 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
*
*
* 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;
@@ -839,9 +842,10 @@ public java.lang.String getQuery() {
*
*
* 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;
@@ -864,9 +868,10 @@ public com.google.protobuf.ByteString getQueryBytes() {
*
*
* 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;
@@ -888,9 +893,10 @@ public Builder setQuery(java.lang.String value) {
*
*
* 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;
@@ -908,9 +914,10 @@ public Builder clearQuery() {
*
*
* 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;
@@ -934,7 +941,7 @@ public Builder setQueryBytes(com.google.protobuf.ByteString value) {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 3;
@@ -948,7 +955,7 @@ public int getPageSize() {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 3;
@@ -966,7 +973,7 @@ public Builder setPageSize(int value) {
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 3;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequestOrBuilder.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequestOrBuilder.java
index 24289c4d..e3b87b84 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequestOrBuilder.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsRequestOrBuilder.java
@@ -27,8 +27,8 @@ public interface SearchAssignmentsRequestOrBuilder
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -43,8 +43,8 @@ public interface SearchAssignmentsRequestOrBuilder
*
*
*
- * Required. The resource name of the admin project(containing project and location),
- * e.g.:
+ * Required. The resource name of the admin project(containing project and
+ * location), e.g.:
* "projects/myproject/locations/US".
*
*
@@ -61,9 +61,10 @@ public interface SearchAssignmentsRequestOrBuilder
*
*
* 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;
@@ -76,9 +77,10 @@ public interface SearchAssignmentsRequestOrBuilder
*
*
* 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;
@@ -91,7 +93,7 @@ public interface SearchAssignmentsRequestOrBuilder
*
*
*
- * The maximum number of items to return.
+ * The maximum number of items to return per page.
*
*
* int32 page_size = 3;
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsResponse.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsResponse.java
index 4ec34f28..277e8704 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsResponse.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SearchAssignmentsResponse.java
@@ -22,7 +22,8 @@
*
*
*
- * The response for [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1.ReservationService.SearchAssignments].
+ * The response for
+ * [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1.ReservationService.SearchAssignments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.SearchAssignmentsResponse}
@@ -419,7 +420,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The response for [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1.ReservationService.SearchAssignments].
+ * The response for
+ * [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1.ReservationService.SearchAssignments].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.SearchAssignmentsResponse}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentRequest.java
index 82d93170..00167986 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
+ * The request for
+ * [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.SplitCapacityCommitmentRequest}
@@ -361,7 +362,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
+ * The request for
+ * [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.SplitCapacityCommitmentRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentResponse.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentResponse.java
index 8aae8a2b..606a7b87 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentResponse.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/SplitCapacityCommitmentResponse.java
@@ -22,7 +22,8 @@
*
*
*
- * The response for [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
+ * The response for
+ * [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.SplitCapacityCommitmentResponse}
@@ -412,7 +413,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The response for [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
+ * The response for
+ * [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.SplitCapacityCommitmentResponse}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateCapacityCommitmentRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateCapacityCommitmentRequest.java
index d9cfab15..50f67737 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateCapacityCommitmentRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateCapacityCommitmentRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.UpdateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.UpdateCapacityCommitment].
+ * The request for
+ * [ReservationService.UpdateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.UpdateCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.UpdateCapacityCommitmentRequest}
@@ -409,7 +410,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.UpdateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.UpdateCapacityCommitment].
+ * The request for
+ * [ReservationService.UpdateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.UpdateCapacityCommitment].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.UpdateCapacityCommitmentRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateReservationRequest.java b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateReservationRequest.java
index 5a69b104..0e7cbd92 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateReservationRequest.java
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/java/com/google/cloud/bigquery/reservation/v1/UpdateReservationRequest.java
@@ -22,7 +22,8 @@
*
*
*
- * The request for [ReservationService.UpdateReservation][google.cloud.bigquery.reservation.v1.ReservationService.UpdateReservation].
+ * The request for
+ * [ReservationService.UpdateReservation][google.cloud.bigquery.reservation.v1.ReservationService.UpdateReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.UpdateReservationRequest}
@@ -406,7 +407,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
*
*
*
- * The request for [ReservationService.UpdateReservation][google.cloud.bigquery.reservation.v1.ReservationService.UpdateReservation].
+ * The request for
+ * [ReservationService.UpdateReservation][google.cloud.bigquery.reservation.v1.ReservationService.UpdateReservation].
*
*
* Protobuf type {@code google.cloud.bigquery.reservation.v1.UpdateReservationRequest}
diff --git a/proto-google-cloud-bigqueryreservation-v1/src/main/proto/google/cloud/bigquery/reservation/v1/reservation.proto b/proto-google-cloud-bigqueryreservation-v1/src/main/proto/google/cloud/bigquery/reservation/v1/reservation.proto
index caa296bc..e3c24d42 100644
--- a/proto-google-cloud-bigqueryreservation-v1/src/main/proto/google/cloud/bigquery/reservation/v1/reservation.proto
+++ b/proto-google-cloud-bigqueryreservation-v1/src/main/proto/google/cloud/bigquery/reservation/v1/reservation.proto
@@ -38,13 +38,13 @@ option java_package = "com.google.cloud.bigquery.reservation.v1";
// 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) =
@@ -61,7 +61,8 @@ service ReservationService {
}
// Lists all the reservations for the project in the specified location.
- rpc ListReservations(ListReservationsRequest) returns (ListReservationsResponse) {
+ rpc ListReservations(ListReservationsRequest)
+ returns (ListReservationsResponse) {
option (google.api.http) = {
get: "/v1/{parent=projects/*/locations/*}/reservations"
};
@@ -79,7 +80,8 @@ service ReservationService {
// Deletes a reservation.
// Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has
// assignments.
- rpc DeleteReservation(DeleteReservationRequest) returns (google.protobuf.Empty) {
+ rpc DeleteReservation(DeleteReservationRequest)
+ returns (google.protobuf.Empty) {
option (google.api.http) = {
delete: "/v1/{name=projects/*/locations/*/reservations/*}"
};
@@ -96,7 +98,8 @@ service ReservationService {
}
// Creates a new capacity commitment resource.
- rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest) returns (CapacityCommitment) {
+ rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest)
+ returns (CapacityCommitment) {
option (google.api.http) = {
post: "/v1/{parent=projects/*/locations/*}/capacityCommitments"
body: "capacity_commitment"
@@ -105,7 +108,8 @@ service ReservationService {
}
// Lists all the capacity commitments for the admin project.
- rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) returns (ListCapacityCommitmentsResponse) {
+ rpc ListCapacityCommitments(ListCapacityCommitmentsRequest)
+ returns (ListCapacityCommitmentsResponse) {
option (google.api.http) = {
get: "/v1/{parent=projects/*/locations/*}/capacityCommitments"
};
@@ -113,7 +117,8 @@ service ReservationService {
}
// Returns information about the capacity commitment.
- rpc GetCapacityCommitment(GetCapacityCommitmentRequest) returns (CapacityCommitment) {
+ rpc GetCapacityCommitment(GetCapacityCommitmentRequest)
+ returns (CapacityCommitment) {
option (google.api.http) = {
get: "/v1/{name=projects/*/locations/*/capacityCommitments/*}"
};
@@ -123,7 +128,8 @@ service ReservationService {
// 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`.
- rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) returns (google.protobuf.Empty) {
+ rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest)
+ returns (google.protobuf.Empty) {
option (google.api.http) = {
delete: "/v1/{name=projects/*/locations/*/capacityCommitments/*}"
};
@@ -132,11 +138,13 @@ service ReservationService {
// Updates an existing capacity commitment.
//
- // Only plan and renewal_plan fields 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) {
+ rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest)
+ returns (CapacityCommitment) {
option (google.api.http) = {
patch: "/v1/{capacity_commitment.name=projects/*/locations/*/capacityCommitments/*}"
body: "capacity_commitment"
@@ -145,11 +153,15 @@ 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.
- rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) returns (SplitCapacityCommitmentResponse) {
+ // `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) = {
post: "/v1/{name=projects/*/locations/*/capacityCommitments/*}:split"
body: "*"
@@ -157,11 +169,15 @@ 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`.
- rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) returns (CapacityCommitment) {
+ // 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) = {
post: "/v1/{parent=projects/*/locations/*}/capacityCommitments:merge"
body: "*"
@@ -169,21 +185,34 @@ service ReservationService {
option (google.api.method_signature) = "parent,capacity_commitment_ids";
}
- // Creates an object which allows the given project to submit jobs
- // of a certain type using slots from the specified reservation. Currently a
+ // 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
- // {job_type, location}, and that reservation will be used for all jobs of the
- // matching type. Within the organization, different assignments can be
- // created on projects, folders or organization level. During query execution,
+ // 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. E.g: organizationA contains project1, project2. Assignments
- // for organizationA, project1 and project2 could all be created, mapping to
- // the same or different reservations.
+ // 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) {
@@ -195,18 +224,28 @@ 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:
- //