docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
index e58dfc0..a2b3dab 100644
--- a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
+++ b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
@@ -80,16 +80,19 @@
<p class="firstline">Returns the assignments Resource.</p>
<p class="toc_element">
+ <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
<code><a href="#create">create(parent, body=None, reservationId=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a new reservation resource.</p>
<p class="toc_element">
<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes a reservation.</p>
+<p class="firstline">Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has assignments.</p>
<p class="toc_element">
<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, pageToken=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, 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>
@@ -99,35 +102,28 @@
<p class="firstline">Updates an existing reservation resource.</p>
<h3>Method Details</h3>
<div class="method">
+ <code class="details" id="close">close()</code>
+ <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
<code class="details" id="create">create(parent, body=None, reservationId=None, x__xgafv=None)</code>
<pre>Creates a new reservation resource.
Args:
- parent: string, Required. Project, location. E.g.,
-`projects/myproject/locations/US` (required)
+ parent: string, Required. Project, location. E.g., `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`.
- "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`.
- "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`.
+ "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.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ }
- reservationId: string, The reservation ID. This field must only contain lower case alphanumeric
-characters or dash. Max length is 64 characters.
+ reservationId: string, The reservation ID. This field must only contain lower case alphanumeric characters or dash. Max length is 64 characters.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -137,33 +133,20 @@
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`.
- "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`.
- "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>
+ "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`.
+ "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.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ }</pre>
</div>
<div class="method">
<code class="details" id="delete">delete(name, x__xgafv=None)</code>
- <pre>Deletes a reservation.
-Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has
-assignments.
+ <pre>Deletes a reservation. Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has assignments.
Args:
- name: string, Required. Resource name of the reservation to retrieve. E.g.,
- `projects/myproject/locations/US/reservations/team1-prod` (required)
+ name: string, Required. Resource name of the reservation to retrieve. E.g., `projects/myproject/locations/US/reservations/team1-prod` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -172,15 +155,7 @@
Returns:
An object of the form:
- { # A generic empty message that you can re-use to avoid defining duplicated
- # empty messages in your APIs. A typical example is to use it as the request
- # or the response type of an API method. For instance:
- #
- # service Foo {
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
- # }
- #
- # The JSON representation for `Empty` is empty JSON object `{}`.
+ { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
}</pre>
</div>
@@ -189,8 +164,7 @@
<pre>Returns information about the reservation.
Args:
- name: string, Required. Resource name of the reservation to retrieve. E.g.,
- `projects/myproject/locations/US/reservations/team1-prod` (required)
+ name: string, Required. Resource name of the reservation to retrieve. E.g., `projects/myproject/locations/US/reservations/team1-prod` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -200,33 +174,22 @@
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`.
- "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`.
- "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>
+ "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`.
+ "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.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ }</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, 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 per page.
+ parent: string, Required. The parent resource name containing project and location, e.g.: `projects/myproject/locations/US` (required)
pageToken: string, The next_page_token value returned from a previous List request, if any.
+ pageSize: integer, The maximum number of items to return per page.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -238,25 +201,14 @@
{ # 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`.
- "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`.
- "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`.
+ "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.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ },
],
- "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
- # more results in the list.
+ "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
}</pre>
</div>
@@ -279,28 +231,17 @@
<pre>Updates an existing reservation resource.
Args:
- name: string, The resource name of the reservation, e.g.,
-`projects/*/locations/*/reservations/team1-prod`. (required)
+ name: string, The resource name of the reservation, e.g., `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`.
- "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`.
- "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`.
+ "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.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ }
updateMask: string, Standard field mask for the set of fields to be updated.
x__xgafv: string, V1 error format.
@@ -312,22 +253,12 @@
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`.
- "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`.
- "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>
+ "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`.
+ "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.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ }</pre>
</div>
</body></html>
\ No newline at end of file