Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13175452.0 KB
projects

Updates the configurations of a node.

patch/v2/{+name}

Path parameters

namestring required

Output only. Immutable. The name of the TPU.

Query parameters

updateMaskstring

Required. Mask of fields from Node to update. Supported fields: [description, tags, labels, metadata, network_config.enable_external_ips].

Request body

queuedResourcestring

Output only. The qualified name of the QueuedResource that requested this Node.

apiVersion'API_VERSION_UNSPECIFIED' | 'V1_ALPHA1' | 'V1' | 'V2_ALPHA1' | 'V2'

Output only. The API version that created this Node.

healthDescriptionstring

Output only. If this field is populated, it contains a description of why the TPU Node is unhealthy.

descriptionstring

The user-supplied description of the TPU. Maximum of 512 characters.

acceleratorTypestring

Optional. The type of hardware accelerators associated with this node.

health'HEALTH_UNSPECIFIED' | 'HEALTHY' | 'TIMEOUT' | 'UNHEALTHY_TENSORFLOW' | 'UNHEALTHY_MAINTENANCE'

The health status of the TPU node.

metadataobject

Custom metadata to apply to the TPU Node. Can set startup-script and shutdown-script

idstring int64

Output only. The unique identifier for the TPU Node.

multisliceNodeboolean

Output only. Whether the Node belongs to a Multislice group.

runtimeVersionstring

Required. The runtime version running in the Node.

namestring

Output only. Immutable. The name of the TPU.

cidrBlockstring

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.

state'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'RESTARTING' | 'REIMAGING' | 'DELETING' | 'REPAIRING' | 'STOPPED' | 'STOPPING' | 'STARTING' | 'PREEMPTED' | 'TERMINATED' | 'HIDING' | 'HIDDEN' | 'UNHIDING' | 'UNKNOWN'

Output only. The current state for the TPU Node.

createTimestring google-datetime

Output only. The time when the node was created.

tagsstring[]

Tags to apply to the TPU Node. Tags are used to identify valid sources or targets for network firewalls.

labelsobject

Resource labels to represent user-provided metadata.

Response

Successful response