docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/bigqueryreservation_v1beta1.projects.locations.reservations.html b/docs/dyn/bigqueryreservation_v1beta1.projects.locations.reservations.html
index ac813b1..b8177ff 100644
--- a/docs/dyn/bigqueryreservation_v1beta1.projects.locations.reservations.html
+++ b/docs/dyn/bigqueryreservation_v1beta1.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, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, pageToken=None, filter=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.
- "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.
+ "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`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "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
-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.
- "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.
+ "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`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "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="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,38 +174,23 @@
An object of the form:
{ # A reservation is a mechanism used to guarantee slots to users.
- "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.
+ "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`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "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, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, pageToken=None, filter=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)
- 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).
- pageSize: integer, The maximum number of items to return.
+ 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.
+ 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).
+ pageSize: integer, The maximum number of items to return.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -243,25 +202,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.
- "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.
+ "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`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "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
- # 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>
@@ -284,27 +232,16 @@
<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.
- "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.
+ "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`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "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.
@@ -317,21 +254,11 @@
An object of the form:
{ # A reservation is a mechanism used to guarantee slots to users.
- "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.
+ "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`.
+ "creationTime": "A String", # Output only. Creation time of the reservation.
+ "name": "A String", # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+ "updateTime": "A String", # Output only. Last update time of the reservation.
+ "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>