projects

Changed on

Creates a node.

post/v2/{+parent}/nodes

Request

  • Base URL: https://tpu.googleapis.com
  • URL: https://tpu.googleapis.com/v2/{+parent}/nodes
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/cloud-platform) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/cloud-platform)

Path parameters

parentstring required

Required. The parent resource name.

Query parameters

nodeIdstring

The unqualified resource name.

Request body

acceleratorTypestring

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

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

Output only. The API version that created this Node.

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.

createTimestring google-datetime

Output only. The time when the node was created.

descriptionstring

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

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

The health status of the TPU node.

healthDescriptionstring

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

idstring int64

Output only. The unique identifier for the TPU Node.

labelsobject

Resource labels to represent user-provided metadata.

metadataobject

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

multisliceNodeboolean

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

namestring

Output only. Immutable. The name of the TPU.

queuedResourcestring

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

runtimeVersionstring

Required. The runtime version running in the Node.

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.

tagsstring[]

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

Response

Successful response

Changes

  • 5fd8f30c1988Revision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status