docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/bigqueryreservation_v1beta1.projects.locations.reservations.html b/docs/dyn/bigqueryreservation_v1beta1.projects.locations.reservations.html
index 6a44804..3832b9b 100644
--- a/docs/dyn/bigqueryreservation_v1beta1.projects.locations.reservations.html
+++ b/docs/dyn/bigqueryreservation_v1beta1.projects.locations.reservations.html
@@ -89,7 +89,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Returns information about the reservation.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, filter=None, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all the reservations for the project in the specified location.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -104,24 +104,26 @@
Args:
parent: string, Required. Project, location. E.g.,
- projects/myproject/locations/US (required)
+`projects/myproject/locations/US` (required)
body: object, The request body.
The object takes the form of:
{ # A reservation is a mechanism used to guarantee slots to users.
+ "name": "A String", # The resource name of the reservation, e.g.,
+ # `projects/*/locations/*/reservations/team1-prod`.
+ "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
+ # reservations within the same admin project. If true, a query using this
+ # reservation will execute with the slot capacity specified above at most.
"slotCapacity": "A String", # Minimum slots available to this reservation. A slot is a unit of
# computational power in BigQuery, and serves as the unit of parallelism.
+ #
# Queries using this reservation might use more slots during runtime if
# ignore_idle_slots is set to false.
+ #
# If the new reservation's slot capacity exceed the parent's slot capacity or
# if total slot capacity of the new reservation and its siblings exceeds the
# parent's slot capacity, the request will fail with
# `google.rpc.Code.RESOURCE_EXHAUSTED`.
- "name": "A String", # The resource name of the reservation, e.g.,
- # "projects/*/locations/*/reservations/team1-prod".
- "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
- # reservations within the same admin project. If true, a query using this
- # reservation will execute with the slot capacity specified above at most.
}
reservationId: string, The reservation ID. This field must only contain lower case alphanumeric
@@ -135,19 +137,21 @@
An object of the form:
{ # A reservation is a mechanism used to guarantee slots to users.
+ "name": "A String", # The resource name of the reservation, e.g.,
+ # `projects/*/locations/*/reservations/team1-prod`.
+ "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
+ # reservations within the same admin project. If true, a query using this
+ # reservation will execute with the slot capacity specified above at most.
"slotCapacity": "A String", # Minimum slots available to this reservation. A slot is a unit of
# computational power in BigQuery, and serves as the unit of parallelism.
+ #
# Queries using this reservation might use more slots during runtime if
# ignore_idle_slots is set to false.
+ #
# If the new reservation's slot capacity exceed the parent's slot capacity or
# if total slot capacity of the new reservation and its siblings exceeds the
# parent's slot capacity, the request will fail with
# `google.rpc.Code.RESOURCE_EXHAUSTED`.
- "name": "A String", # The resource name of the reservation, e.g.,
- # "projects/*/locations/*/reservations/team1-prod".
- "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
- # reservations within the same admin project. If true, a query using this
- # reservation will execute with the slot capacity specified above at most.
}</pre>
</div>
@@ -159,7 +163,7 @@
Args:
name: string, Required. Resource name of the reservation to retrieve. E.g.,
- projects/myproject/locations/US/reservations/team1-prod (required)
+ `projects/myproject/locations/US/reservations/team1-prod` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -186,7 +190,7 @@
Args:
name: string, Required. Resource name of the reservation to retrieve. E.g.,
- projects/myproject/locations/US/reservations/team1-prod (required)
+ `projects/myproject/locations/US/reservations/team1-prod` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -196,36 +200,38 @@
An object of the form:
{ # A reservation is a mechanism used to guarantee slots to users.
+ "name": "A String", # The resource name of the reservation, e.g.,
+ # `projects/*/locations/*/reservations/team1-prod`.
+ "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
+ # reservations within the same admin project. If true, a query using this
+ # reservation will execute with the slot capacity specified above at most.
"slotCapacity": "A String", # Minimum slots available to this reservation. A slot is a unit of
# computational power in BigQuery, and serves as the unit of parallelism.
+ #
# Queries using this reservation might use more slots during runtime if
# ignore_idle_slots is set to false.
+ #
# If the new reservation's slot capacity exceed the parent's slot capacity or
# if total slot capacity of the new reservation and its siblings exceeds the
# parent's slot capacity, the request will fail with
# `google.rpc.Code.RESOURCE_EXHAUSTED`.
- "name": "A String", # The resource name of the reservation, e.g.,
- # "projects/*/locations/*/reservations/team1-prod".
- "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
- # reservations within the same admin project. If true, a query using this
- # reservation will execute with the slot capacity specified above at most.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, filter=None, pageToken=None, pageSize=None, x__xgafv=None)</code>
<pre>Lists all the reservations for the project in the specified location.
Args:
parent: string, Required. The parent resource name containing project and location, e.g.:
- "projects/myproject/locations/US" (required)
- pageSize: integer, The maximum number of items to return.
+ `projects/myproject/locations/US` (required)
filter: string, Can be used to filter out reservations based on names, capacity, etc, e.g.:
filter="reservation.slot_capacity > 200"
filter="reservation.name = \"*dev/*\""
Advanced filtering syntax can be
[here](https://cloud.google.com/logging/docs/view/advanced-filters).
pageToken: string, The next_page_token value returned from a previous List request, if any.
+ pageSize: integer, The maximum number of items to return.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -237,19 +243,21 @@
{ # The response for ReservationService.ListReservations.
"reservations": [ # List of reservations visible to the user.
{ # A reservation is a mechanism used to guarantee slots to users.
+ "name": "A String", # The resource name of the reservation, e.g.,
+ # `projects/*/locations/*/reservations/team1-prod`.
+ "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
+ # reservations within the same admin project. If true, a query using this
+ # reservation will execute with the slot capacity specified above at most.
"slotCapacity": "A String", # Minimum slots available to this reservation. A slot is a unit of
# computational power in BigQuery, and serves as the unit of parallelism.
+ #
# Queries using this reservation might use more slots during runtime if
# ignore_idle_slots is set to false.
+ #
# If the new reservation's slot capacity exceed the parent's slot capacity or
# if total slot capacity of the new reservation and its siblings exceeds the
# parent's slot capacity, the request will fail with
# `google.rpc.Code.RESOURCE_EXHAUSTED`.
- "name": "A String", # The resource name of the reservation, e.g.,
- # "projects/*/locations/*/reservations/team1-prod".
- "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
- # reservations within the same admin project. If true, a query using this
- # reservation will execute with the slot capacity specified above at most.
},
],
"nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
@@ -277,24 +285,26 @@
Args:
name: string, The resource name of the reservation, e.g.,
-"projects/*/locations/*/reservations/team1-prod". (required)
+`projects/*/locations/*/reservations/team1-prod`. (required)
body: object, The request body.
The object takes the form of:
{ # A reservation is a mechanism used to guarantee slots to users.
+ "name": "A String", # The resource name of the reservation, e.g.,
+ # `projects/*/locations/*/reservations/team1-prod`.
+ "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
+ # reservations within the same admin project. If true, a query using this
+ # reservation will execute with the slot capacity specified above at most.
"slotCapacity": "A String", # Minimum slots available to this reservation. A slot is a unit of
# computational power in BigQuery, and serves as the unit of parallelism.
+ #
# Queries using this reservation might use more slots during runtime if
# ignore_idle_slots is set to false.
+ #
# If the new reservation's slot capacity exceed the parent's slot capacity or
# if total slot capacity of the new reservation and its siblings exceeds the
# parent's slot capacity, the request will fail with
# `google.rpc.Code.RESOURCE_EXHAUSTED`.
- "name": "A String", # The resource name of the reservation, e.g.,
- # "projects/*/locations/*/reservations/team1-prod".
- "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
- # reservations within the same admin project. If true, a query using this
- # reservation will execute with the slot capacity specified above at most.
}
updateMask: string, Standard field mask for the set of fields to be updated.
@@ -307,19 +317,21 @@
An object of the form:
{ # A reservation is a mechanism used to guarantee slots to users.
+ "name": "A String", # The resource name of the reservation, e.g.,
+ # `projects/*/locations/*/reservations/team1-prod`.
+ "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
+ # reservations within the same admin project. If true, a query using this
+ # reservation will execute with the slot capacity specified above at most.
"slotCapacity": "A String", # Minimum slots available to this reservation. A slot is a unit of
# computational power in BigQuery, and serves as the unit of parallelism.
+ #
# Queries using this reservation might use more slots during runtime if
# ignore_idle_slots is set to false.
+ #
# If the new reservation's slot capacity exceed the parent's slot capacity or
# if total slot capacity of the new reservation and its siblings exceeds the
# parent's slot capacity, the request will fail with
# `google.rpc.Code.RESOURCE_EXHAUSTED`.
- "name": "A String", # The resource name of the reservation, e.g.,
- # "projects/*/locations/*/reservations/team1-prod".
- "ignoreIdleSlots": True or False, # If false, any query using this reservation will use idle slots from other
- # reservations within the same admin project. If true, a query using this
- # reservation will execute with the slot capacity specified above at most.
}</pre>
</div>