chore: Update discovery artifacts (#1582)
## Deleted keys were detected in the following stable discovery artifacts:
artifactregistry v1 https://github.com/googleapis/google-api-python-client/commit/421f4d14a998f3da97fd979647b5e05287027679
osconfig v1 https://github.com/googleapis/google-api-python-client/commit/ff7bf38f27e52634ef2b9c661d84c9118675944c
vmmigration v1 https://github.com/googleapis/google-api-python-client/commit/e29809a6548a53233925e410d2126d6e0b1600fa
## Deleted keys were detected in the following pre-stable discovery artifacts:
analyticsadmin v1alpha https://github.com/googleapis/google-api-python-client/commit/8666e3e7a134d27f832c00ef8fff2e8a5b601774
containeranalysis v1alpha1 https://github.com/googleapis/google-api-python-client/commit/15898963782a0649d6cb3a0a0c7ba1566b86b853
containeranalysis v1beta1 https://github.com/googleapis/google-api-python-client/commit/15898963782a0649d6cb3a0a0c7ba1566b86b853
osconfig v1alpha https://github.com/googleapis/google-api-python-client/commit/ff7bf38f27e52634ef2b9c661d84c9118675944c
## Discovery Artifact Change Summary:
feat(admin): update the api https://github.com/googleapis/google-api-python-client/commit/34eef11ba78a6e8eda0ec4dd8348e240ac637122
feat(analyticsadmin): update the api https://github.com/googleapis/google-api-python-client/commit/8666e3e7a134d27f832c00ef8fff2e8a5b601774
feat(analyticsdata): update the api https://github.com/googleapis/google-api-python-client/commit/a362e49252915c7da2fe88bfaec9eb7f9c217b11
feat(analyticsreporting): update the api https://github.com/googleapis/google-api-python-client/commit/ec6bf30c38ccf0f258c9f0267c6477b233483702
feat(androidpublisher): update the api https://github.com/googleapis/google-api-python-client/commit/1a6d12e5a619d753e17041696fdfa84626e952d3
feat(apigee): update the api https://github.com/googleapis/google-api-python-client/commit/afc34eebbe98c284718489b94df8bc2293ee31f5
feat(artifactregistry): update the api https://github.com/googleapis/google-api-python-client/commit/421f4d14a998f3da97fd979647b5e05287027679
feat(chat): update the api https://github.com/googleapis/google-api-python-client/commit/ba90d3f0889eac4fb061bbbe913c31eea57c94bb
feat(cloudkms): update the api https://github.com/googleapis/google-api-python-client/commit/f06247e899ba2de5d2c1f0a8d6e8cbb0569143aa
feat(containeranalysis): update the api https://github.com/googleapis/google-api-python-client/commit/15898963782a0649d6cb3a0a0c7ba1566b86b853
feat(content): update the api https://github.com/googleapis/google-api-python-client/commit/8f976a93038ee562d5ed0c9937d52e4b5e2cb8d6
feat(datacatalog): update the api https://github.com/googleapis/google-api-python-client/commit/b7876fdb21b0eeab9c07a73bbf0ca43f5f509906
feat(dataproc): update the api https://github.com/googleapis/google-api-python-client/commit/742a2f738031268771d7146b64ff0e743df79596
feat(dialogflow): update the api https://github.com/googleapis/google-api-python-client/commit/117de7bdb601d11ce48c4ad64225d6d207f0597a
feat(displayvideo): update the api https://github.com/googleapis/google-api-python-client/commit/6abb35b4ba36bfa81516994b9f95a426fa5bbaff
feat(eventarc): update the api https://github.com/googleapis/google-api-python-client/commit/59646721f76e0c02a2185111f9adf38d5c134fde
feat(file): update the api https://github.com/googleapis/google-api-python-client/commit/3508025ee9545033bc424396f2776916cbe1a3e3
feat(firestore): update the api https://github.com/googleapis/google-api-python-client/commit/851dba5e0f09a3dad06f3c8476d1c19da1a5cf93
feat(gkehub): update the api https://github.com/googleapis/google-api-python-client/commit/b62aef0cc1bd0f5f10e1828d941616163136b2f7
feat(iam): update the api https://github.com/googleapis/google-api-python-client/commit/50c48dfe6b63c9b7ff9deacc140d510cb0c50b50
feat(monitoring): update the api https://github.com/googleapis/google-api-python-client/commit/eafbb600bf57440c024be19160c275074c6da03a
feat(notebooks): update the api https://github.com/googleapis/google-api-python-client/commit/c6c8169a866814c2f4cbd622ad005d37442204d5
feat(osconfig): update the api https://github.com/googleapis/google-api-python-client/commit/ff7bf38f27e52634ef2b9c661d84c9118675944c
feat(oslogin): update the api https://github.com/googleapis/google-api-python-client/commit/c26d08f8dc0507a366afa20e899cdbe90af9e82c
feat(playcustomapp): update the api https://github.com/googleapis/google-api-python-client/commit/1898032f15649aaa4bb8469fbd05743e39fc2a28
feat(privateca): update the api https://github.com/googleapis/google-api-python-client/commit/8eca373bb25b2dc23dfd6c9fdd09420b3c415521
feat(securitycenter): update the api https://github.com/googleapis/google-api-python-client/commit/7e832748505a52c0b0d2f94163cbedcffe09fcf7
feat(speech): update the api https://github.com/googleapis/google-api-python-client/commit/1a3763caea5a3b4d50d0981ee4f52cc234fc1223
feat(storage): update the api https://github.com/googleapis/google-api-python-client/commit/07237cd66afac512e9962069312cf0bb796b0f39
feat(storagetransfer): update the api https://github.com/googleapis/google-api-python-client/commit/0901d055b0b30eeb9312881cbacde771d647ee56
feat(texttospeech): update the api https://github.com/googleapis/google-api-python-client/commit/6622bd866cc45f42b37a57737872af0f90631e5f
feat(vmmigration): update the api https://github.com/googleapis/google-api-python-client/commit/e29809a6548a53233925e410d2126d6e0b1600fa
diff --git a/docs/dyn/tpu_v2alpha1.projects.locations.nodes.html b/docs/dyn/tpu_v2alpha1.projects.locations.nodes.html
new file mode 100644
index 0000000..01c80d3
--- /dev/null
+++ b/docs/dyn/tpu_v2alpha1.projects.locations.nodes.html
@@ -0,0 +1,648 @@
+<html><body>
+<style>
+
+body, h1, h2, h3, div, span, p, pre, a {
+ margin: 0;
+ padding: 0;
+ border: 0;
+ font-weight: inherit;
+ font-style: inherit;
+ font-size: 100%;
+ font-family: inherit;
+ vertical-align: baseline;
+}
+
+body {
+ font-size: 13px;
+ padding: 1em;
+}
+
+h1 {
+ font-size: 26px;
+ margin-bottom: 1em;
+}
+
+h2 {
+ font-size: 24px;
+ margin-bottom: 1em;
+}
+
+h3 {
+ font-size: 20px;
+ margin-bottom: 1em;
+ margin-top: 1em;
+}
+
+pre, code {
+ line-height: 1.5;
+ font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
+}
+
+pre {
+ margin-top: 0.5em;
+}
+
+h1, h2, h3, p {
+ font-family: Arial, sans serif;
+}
+
+h1, h2, h3 {
+ border-bottom: solid #CCC 1px;
+}
+
+.toc_element {
+ margin-top: 0.5em;
+}
+
+.firstline {
+ margin-left: 2 em;
+}
+
+.method {
+ margin-top: 1em;
+ border: solid 1px #CCC;
+ padding: 1em;
+ background: #EEE;
+}
+
+.details {
+ font-weight: bold;
+ font-size: 14px;
+}
+
+</style>
+
+<h1><a href="tpu_v2alpha1.html">Cloud TPU API</a> . <a href="tpu_v2alpha1.projects.html">projects</a> . <a href="tpu_v2alpha1.projects.locations.html">locations</a> . <a href="tpu_v2alpha1.projects.locations.nodes.html">nodes</a></h1>
+<h2>Instance Methods</h2>
+<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, nodeId=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Creates a node.</p>
+<p class="toc_element">
+ <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
+<p class="firstline">Deletes a node.</p>
+<p class="toc_element">
+ <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the details of a node.</p>
+<p class="toc_element">
+ <code><a href="#getGuestAttributes">getGuestAttributes(name, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Retrieves the guest attributes for the node.</p>
+<p class="toc_element">
+ <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists nodes.</p>
+<p class="toc_element">
+ <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
+<p class="firstline">Retrieves the next page of results.</p>
+<p class="toc_element">
+ <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates the configurations of a node.</p>
+<p class="toc_element">
+ <code><a href="#start">start(name, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Starts a node.</p>
+<p class="toc_element">
+ <code><a href="#stop">stop(name, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Stops a node. This operation is only available with single TPU nodes.</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, nodeId=None, x__xgafv=None)</code>
+ <pre>Creates a node.
+
+Args:
+ parent: string, Required. The parent resource name. (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # A TPU instance.
+ "acceleratorType": "A String", # Required. The type of hardware accelerators associated with this node.
+ "apiVersion": "A String", # Output only. The API version that created this Node.
+ "cidrBlock": "A String", # The CIDR block that the TPU node will use when selecting an IP address. This CIDR block must be a /29 block; the Compute Engine networks API forbids a smaller block, and using a larger block would be wasteful (a node can only consume one IP address). Errors will occur if the CIDR block has already been used for a currently existing TPU node, the CIDR block conflicts with any subnetworks in the user's provided network, or the provided network is peered with another network that is using that CIDR block.
+ "createTime": "A String", # Output only. The time when the node was created.
+ "dataDisks": [ # The additional data disks for the Node.
+ { # A node-attached disk resource. Next ID: 8;
+ "mode": "A String", # The mode in which to attach this disk. If not specified, the default is READ_WRITE mode. Only applicable to data_disks.
+ "sourceDisk": "A String", # Specifies the full path to an existing disk. For example: "projects/my-project/zones/us-central1-c/disks/my-disk".
+ },
+ ],
+ "description": "A String", # The user-supplied description of the TPU. Maximum of 512 characters.
+ "health": "A String", # The health status of the TPU node.
+ "healthDescription": "A String", # Output only. If this field is populated, it contains a description of why the TPU Node is unhealthy.
+ "id": "A String", # Output only. The unique identifier for the TPU Node.
+ "labels": { # Resource labels to represent user-provided metadata.
+ "a_key": "A String",
+ },
+ "metadata": { # Custom metadata to apply to the TPU Node. Can set startup-script and shutdown-script
+ "a_key": "A String",
+ },
+ "name": "A String", # Output only. Immutable. The name of the TPU.
+ "networkConfig": { # Network related configurations. # Network configurations for the TPU node.
+ "enableExternalIps": True or False, # Indicates that external IP addresses would be associated with the TPU workers. If set to false, the specified subnetwork or network should have Private Google Access enabled.
+ "network": "A String", # The name of the network for the TPU node. It must be a preexisting Google Compute Engine network. If none is provided, "default" will be used.
+ "subnetwork": "A String", # The name of the subnetwork for the TPU node. It must be a preexisting Google Compute Engine subnetwork. If none is provided, "default" will be used.
+ },
+ "networkEndpoints": [ # Output only. The network endpoints where TPU workers can be accessed and sent work. It is recommended that runtime clients of the node reach out to the 0th entry in this map first.
+ { # A network endpoint over which a TPU worker can be reached.
+ "accessConfig": { # An access config attached to the TPU worker. # The access config for the TPU worker.
+ "externalIp": "A String", # Output only. An external IP address associated with the TPU worker.
+ },
+ "ipAddress": "A String", # The internal IP address of this network endpoint.
+ "port": 42, # The port of this network endpoint.
+ },
+ ],
+ "runtimeVersion": "A String", # Required. The runtime version running in the Node.
+ "schedulingConfig": { # Sets the scheduling options for this node. # The scheduling options for this node.
+ "preemptible": True or False, # Defines whether the node is preemptible.
+ "reserved": True or False, # Whether the node is created under a reservation.
+ },
+ "serviceAccount": { # A service account. # The Google Cloud Platform Service Account to be used by the TPU node VMs. If None is specified, the default compute service account will be used.
+ "email": "A String", # Email address of the service account. If empty, default Compute service account will be used.
+ "scope": [ # The list of scopes to be made available for this service account. If empty, access to all Cloud APIs will be allowed.
+ "A String",
+ ],
+ },
+ "state": "A String", # Output only. The current state for the TPU Node.
+ "symptoms": [ # Output only. The Symptoms that have occurred to the TPU Node.
+ { # A Symptom instance.
+ "createTime": "A String", # Timestamp when the Symptom is created.
+ "details": "A String", # Detailed information of the current Symptom.
+ "symptomType": "A String", # Type of the Symptom.
+ "workerId": "A String", # A string used to uniquely distinguish a worker within a TPU node.
+ },
+ ],
+ "tags": [ # Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls.
+ "A String",
+ ],
+}
+
+ nodeId: string, The unqualified resource name.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a network API call.
+ "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+ "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+ "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+}</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="delete">delete(name, x__xgafv=None)</code>
+ <pre>Deletes a node.
+
+Args:
+ name: string, Required. The resource name. (required)
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a network API call.
+ "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+ "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+ "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+}</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="get">get(name, x__xgafv=None)</code>
+ <pre>Gets the details of a node.
+
+Args:
+ name: string, Required. The resource name. (required)
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # A TPU instance.
+ "acceleratorType": "A String", # Required. The type of hardware accelerators associated with this node.
+ "apiVersion": "A String", # Output only. The API version that created this Node.
+ "cidrBlock": "A String", # The CIDR block that the TPU node will use when selecting an IP address. This CIDR block must be a /29 block; the Compute Engine networks API forbids a smaller block, and using a larger block would be wasteful (a node can only consume one IP address). Errors will occur if the CIDR block has already been used for a currently existing TPU node, the CIDR block conflicts with any subnetworks in the user's provided network, or the provided network is peered with another network that is using that CIDR block.
+ "createTime": "A String", # Output only. The time when the node was created.
+ "dataDisks": [ # The additional data disks for the Node.
+ { # A node-attached disk resource. Next ID: 8;
+ "mode": "A String", # The mode in which to attach this disk. If not specified, the default is READ_WRITE mode. Only applicable to data_disks.
+ "sourceDisk": "A String", # Specifies the full path to an existing disk. For example: "projects/my-project/zones/us-central1-c/disks/my-disk".
+ },
+ ],
+ "description": "A String", # The user-supplied description of the TPU. Maximum of 512 characters.
+ "health": "A String", # The health status of the TPU node.
+ "healthDescription": "A String", # Output only. If this field is populated, it contains a description of why the TPU Node is unhealthy.
+ "id": "A String", # Output only. The unique identifier for the TPU Node.
+ "labels": { # Resource labels to represent user-provided metadata.
+ "a_key": "A String",
+ },
+ "metadata": { # Custom metadata to apply to the TPU Node. Can set startup-script and shutdown-script
+ "a_key": "A String",
+ },
+ "name": "A String", # Output only. Immutable. The name of the TPU.
+ "networkConfig": { # Network related configurations. # Network configurations for the TPU node.
+ "enableExternalIps": True or False, # Indicates that external IP addresses would be associated with the TPU workers. If set to false, the specified subnetwork or network should have Private Google Access enabled.
+ "network": "A String", # The name of the network for the TPU node. It must be a preexisting Google Compute Engine network. If none is provided, "default" will be used.
+ "subnetwork": "A String", # The name of the subnetwork for the TPU node. It must be a preexisting Google Compute Engine subnetwork. If none is provided, "default" will be used.
+ },
+ "networkEndpoints": [ # Output only. The network endpoints where TPU workers can be accessed and sent work. It is recommended that runtime clients of the node reach out to the 0th entry in this map first.
+ { # A network endpoint over which a TPU worker can be reached.
+ "accessConfig": { # An access config attached to the TPU worker. # The access config for the TPU worker.
+ "externalIp": "A String", # Output only. An external IP address associated with the TPU worker.
+ },
+ "ipAddress": "A String", # The internal IP address of this network endpoint.
+ "port": 42, # The port of this network endpoint.
+ },
+ ],
+ "runtimeVersion": "A String", # Required. The runtime version running in the Node.
+ "schedulingConfig": { # Sets the scheduling options for this node. # The scheduling options for this node.
+ "preemptible": True or False, # Defines whether the node is preemptible.
+ "reserved": True or False, # Whether the node is created under a reservation.
+ },
+ "serviceAccount": { # A service account. # The Google Cloud Platform Service Account to be used by the TPU node VMs. If None is specified, the default compute service account will be used.
+ "email": "A String", # Email address of the service account. If empty, default Compute service account will be used.
+ "scope": [ # The list of scopes to be made available for this service account. If empty, access to all Cloud APIs will be allowed.
+ "A String",
+ ],
+ },
+ "state": "A String", # Output only. The current state for the TPU Node.
+ "symptoms": [ # Output only. The Symptoms that have occurred to the TPU Node.
+ { # A Symptom instance.
+ "createTime": "A String", # Timestamp when the Symptom is created.
+ "details": "A String", # Detailed information of the current Symptom.
+ "symptomType": "A String", # Type of the Symptom.
+ "workerId": "A String", # A string used to uniquely distinguish a worker within a TPU node.
+ },
+ ],
+ "tags": [ # Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls.
+ "A String",
+ ],
+}</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="getGuestAttributes">getGuestAttributes(name, body=None, x__xgafv=None)</code>
+ <pre>Retrieves the guest attributes for the node.
+
+Args:
+ name: string, Required. The resource name. (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # Request for GetGuestAttributes.
+ "queryPath": "A String", # The guest attributes path to be queried.
+ "workerIds": [ # The 0-based worker ID. If it is empty, all workers' GuestAttributes will be returned.
+ "A String",
+ ],
+}
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # Response for GetGuestAttributes.
+ "guestAttributes": [ # The guest attributes for the TPU workers.
+ { # A guest attributes.
+ "queryPath": "A String", # The path to be queried. This can be the default namespace ('/') or a nested namespace ('/\/') or a specified key ('/\/\')
+ "queryValue": { # Array of guest attribute namespace/key/value tuples. # The value of the requested queried path.
+ "items": [ # The list of guest attributes entries.
+ { # A guest attributes namespace/key/value entry.
+ "key": "A String", # Key for the guest attribute entry.
+ "namespace": "A String", # Namespace for the guest attribute entry.
+ "value": "A String", # Value for the guest attribute entry.
+ },
+ ],
+ },
+ },
+ ],
+}</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
+ <pre>Lists nodes.
+
+Args:
+ parent: string, Required. The parent resource name. (required)
+ pageSize: integer, The maximum number of items to return.
+ pageToken: string, The next_page_token value returned from a previous List request, if any.
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # Response for ListNodes.
+ "nextPageToken": "A String", # The next page token or empty if none.
+ "nodes": [ # The listed nodes.
+ { # A TPU instance.
+ "acceleratorType": "A String", # Required. The type of hardware accelerators associated with this node.
+ "apiVersion": "A String", # Output only. The API version that created this Node.
+ "cidrBlock": "A String", # The CIDR block that the TPU node will use when selecting an IP address. This CIDR block must be a /29 block; the Compute Engine networks API forbids a smaller block, and using a larger block would be wasteful (a node can only consume one IP address). Errors will occur if the CIDR block has already been used for a currently existing TPU node, the CIDR block conflicts with any subnetworks in the user's provided network, or the provided network is peered with another network that is using that CIDR block.
+ "createTime": "A String", # Output only. The time when the node was created.
+ "dataDisks": [ # The additional data disks for the Node.
+ { # A node-attached disk resource. Next ID: 8;
+ "mode": "A String", # The mode in which to attach this disk. If not specified, the default is READ_WRITE mode. Only applicable to data_disks.
+ "sourceDisk": "A String", # Specifies the full path to an existing disk. For example: "projects/my-project/zones/us-central1-c/disks/my-disk".
+ },
+ ],
+ "description": "A String", # The user-supplied description of the TPU. Maximum of 512 characters.
+ "health": "A String", # The health status of the TPU node.
+ "healthDescription": "A String", # Output only. If this field is populated, it contains a description of why the TPU Node is unhealthy.
+ "id": "A String", # Output only. The unique identifier for the TPU Node.
+ "labels": { # Resource labels to represent user-provided metadata.
+ "a_key": "A String",
+ },
+ "metadata": { # Custom metadata to apply to the TPU Node. Can set startup-script and shutdown-script
+ "a_key": "A String",
+ },
+ "name": "A String", # Output only. Immutable. The name of the TPU.
+ "networkConfig": { # Network related configurations. # Network configurations for the TPU node.
+ "enableExternalIps": True or False, # Indicates that external IP addresses would be associated with the TPU workers. If set to false, the specified subnetwork or network should have Private Google Access enabled.
+ "network": "A String", # The name of the network for the TPU node. It must be a preexisting Google Compute Engine network. If none is provided, "default" will be used.
+ "subnetwork": "A String", # The name of the subnetwork for the TPU node. It must be a preexisting Google Compute Engine subnetwork. If none is provided, "default" will be used.
+ },
+ "networkEndpoints": [ # Output only. The network endpoints where TPU workers can be accessed and sent work. It is recommended that runtime clients of the node reach out to the 0th entry in this map first.
+ { # A network endpoint over which a TPU worker can be reached.
+ "accessConfig": { # An access config attached to the TPU worker. # The access config for the TPU worker.
+ "externalIp": "A String", # Output only. An external IP address associated with the TPU worker.
+ },
+ "ipAddress": "A String", # The internal IP address of this network endpoint.
+ "port": 42, # The port of this network endpoint.
+ },
+ ],
+ "runtimeVersion": "A String", # Required. The runtime version running in the Node.
+ "schedulingConfig": { # Sets the scheduling options for this node. # The scheduling options for this node.
+ "preemptible": True or False, # Defines whether the node is preemptible.
+ "reserved": True or False, # Whether the node is created under a reservation.
+ },
+ "serviceAccount": { # A service account. # The Google Cloud Platform Service Account to be used by the TPU node VMs. If None is specified, the default compute service account will be used.
+ "email": "A String", # Email address of the service account. If empty, default Compute service account will be used.
+ "scope": [ # The list of scopes to be made available for this service account. If empty, access to all Cloud APIs will be allowed.
+ "A String",
+ ],
+ },
+ "state": "A String", # Output only. The current state for the TPU Node.
+ "symptoms": [ # Output only. The Symptoms that have occurred to the TPU Node.
+ { # A Symptom instance.
+ "createTime": "A String", # Timestamp when the Symptom is created.
+ "details": "A String", # Detailed information of the current Symptom.
+ "symptomType": "A String", # Type of the Symptom.
+ "workerId": "A String", # A string used to uniquely distinguish a worker within a TPU node.
+ },
+ ],
+ "tags": [ # Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls.
+ "A String",
+ ],
+ },
+ ],
+ "unreachable": [ # Locations that could not be reached.
+ "A String",
+ ],
+}</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
+ <pre>Retrieves the next page of results.
+
+Args:
+ previous_request: The request for the previous page. (required)
+ previous_response: The response from the request for the previous page. (required)
+
+Returns:
+ A request object that you can call 'execute()' on to request the next
+ page. Returns None if there are no more items in the collection.
+ </pre>
+</div>
+
+<div class="method">
+ <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
+ <pre>Updates the configurations of a node.
+
+Args:
+ name: string, Output only. Immutable. The name of the TPU. (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # A TPU instance.
+ "acceleratorType": "A String", # Required. The type of hardware accelerators associated with this node.
+ "apiVersion": "A String", # Output only. The API version that created this Node.
+ "cidrBlock": "A String", # The CIDR block that the TPU node will use when selecting an IP address. This CIDR block must be a /29 block; the Compute Engine networks API forbids a smaller block, and using a larger block would be wasteful (a node can only consume one IP address). Errors will occur if the CIDR block has already been used for a currently existing TPU node, the CIDR block conflicts with any subnetworks in the user's provided network, or the provided network is peered with another network that is using that CIDR block.
+ "createTime": "A String", # Output only. The time when the node was created.
+ "dataDisks": [ # The additional data disks for the Node.
+ { # A node-attached disk resource. Next ID: 8;
+ "mode": "A String", # The mode in which to attach this disk. If not specified, the default is READ_WRITE mode. Only applicable to data_disks.
+ "sourceDisk": "A String", # Specifies the full path to an existing disk. For example: "projects/my-project/zones/us-central1-c/disks/my-disk".
+ },
+ ],
+ "description": "A String", # The user-supplied description of the TPU. Maximum of 512 characters.
+ "health": "A String", # The health status of the TPU node.
+ "healthDescription": "A String", # Output only. If this field is populated, it contains a description of why the TPU Node is unhealthy.
+ "id": "A String", # Output only. The unique identifier for the TPU Node.
+ "labels": { # Resource labels to represent user-provided metadata.
+ "a_key": "A String",
+ },
+ "metadata": { # Custom metadata to apply to the TPU Node. Can set startup-script and shutdown-script
+ "a_key": "A String",
+ },
+ "name": "A String", # Output only. Immutable. The name of the TPU.
+ "networkConfig": { # Network related configurations. # Network configurations for the TPU node.
+ "enableExternalIps": True or False, # Indicates that external IP addresses would be associated with the TPU workers. If set to false, the specified subnetwork or network should have Private Google Access enabled.
+ "network": "A String", # The name of the network for the TPU node. It must be a preexisting Google Compute Engine network. If none is provided, "default" will be used.
+ "subnetwork": "A String", # The name of the subnetwork for the TPU node. It must be a preexisting Google Compute Engine subnetwork. If none is provided, "default" will be used.
+ },
+ "networkEndpoints": [ # Output only. The network endpoints where TPU workers can be accessed and sent work. It is recommended that runtime clients of the node reach out to the 0th entry in this map first.
+ { # A network endpoint over which a TPU worker can be reached.
+ "accessConfig": { # An access config attached to the TPU worker. # The access config for the TPU worker.
+ "externalIp": "A String", # Output only. An external IP address associated with the TPU worker.
+ },
+ "ipAddress": "A String", # The internal IP address of this network endpoint.
+ "port": 42, # The port of this network endpoint.
+ },
+ ],
+ "runtimeVersion": "A String", # Required. The runtime version running in the Node.
+ "schedulingConfig": { # Sets the scheduling options for this node. # The scheduling options for this node.
+ "preemptible": True or False, # Defines whether the node is preemptible.
+ "reserved": True or False, # Whether the node is created under a reservation.
+ },
+ "serviceAccount": { # A service account. # The Google Cloud Platform Service Account to be used by the TPU node VMs. If None is specified, the default compute service account will be used.
+ "email": "A String", # Email address of the service account. If empty, default Compute service account will be used.
+ "scope": [ # The list of scopes to be made available for this service account. If empty, access to all Cloud APIs will be allowed.
+ "A String",
+ ],
+ },
+ "state": "A String", # Output only. The current state for the TPU Node.
+ "symptoms": [ # Output only. The Symptoms that have occurred to the TPU Node.
+ { # A Symptom instance.
+ "createTime": "A String", # Timestamp when the Symptom is created.
+ "details": "A String", # Detailed information of the current Symptom.
+ "symptomType": "A String", # Type of the Symptom.
+ "workerId": "A String", # A string used to uniquely distinguish a worker within a TPU node.
+ },
+ ],
+ "tags": [ # Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls.
+ "A String",
+ ],
+}
+
+ updateMask: string, Required. Mask of fields from Node to update. Supported fields: [description, tags, labels, metadata, network_config.enable_external_ips].
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a network API call.
+ "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+ "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+ "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+}</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="start">start(name, body=None, x__xgafv=None)</code>
+ <pre>Starts a node.
+
+Args:
+ name: string, The resource name. (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # Request for StartNode.
+}
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a network API call.
+ "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+ "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+ "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+}</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="stop">stop(name, body=None, x__xgafv=None)</code>
+ <pre>Stops a node. This operation is only available with single TPU nodes.
+
+Args:
+ name: string, The resource name. (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # Request for StopNode.
+}
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a network API call.
+ "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+ "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+ "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+}</pre>
+</div>
+
+</body></html>
\ No newline at end of file