# Source: https://docs.datadoghq.com/ddsql_reference/data_directory/gcp/gcp.tpu_instance.dataset.md

---
title: Tpu Instance
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Tpu Instance
---

# Tpu Instance

This table represents the tpu_instance resource from Google Cloud Platform.

```
gcp.tpu_instance
```

## Fields

| Title                  | ID   | Type          | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Description |
| ---------------------- | ---- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                   | core | string        |
| accelerator_type       | core | string        | Required. The type of hardware accelerators associated with this node.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ancestors              | core | array<string> |
| api_version            | core | string        | Output only. The API version that created this Node. Possible values: ['API_VERSION_UNSPECIFIED', 'V1_ALPHA1', 'V1', 'V2_ALPHA1']. Values descriptions: ['API version is unknown.', 'TPU API V1Alpha1 version.', 'TPU API V1 version.', 'TPU API V2Alpha1 version.']                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| cidr_block             | core | 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| create_time            | core | timestamp     | Output only. The time when the node was created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| datadog_display_name   | core | string        |
| description            | core | string        | The user-supplied description of the TPU. Maximum of 512 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| health                 | core | string        | The health status of the TPU node. Possible values: ['HEALTH_UNSPECIFIED', 'HEALTHY', 'DEPRECATED_UNHEALTHY', 'TIMEOUT', 'UNHEALTHY_TENSORFLOW', 'UNHEALTHY_MAINTENANCE']. Values descriptions: ['Health status is unknown: not initialized or failed to retrieve.', 'The resource is healthy.', 'The resource is unhealthy.', 'The resource is unresponsive.', 'The in-guest ML stack is unhealthy.', 'The node is under maintenance/priority boost caused rescheduling and will resume running once rescheduled.']                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| health_description     | core | string        | Output only. If this field is populated, it contains a description of why the TPU Node is unhealthy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ip_address             | core | string        | Output only. DEPRECATED! Use network_endpoints instead. The network address for the TPU Node as visible to Compute Engine instances.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| labels                 | core | array<string> |
| name                   | core | string        | Output only. Immutable. The name of the TPU                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| network                | core | string        | The name of a network they wish to peer the TPU node to. It must be a preexisting Compute Engine network inside of the project on which this API has been activated. If none is provided, "default" will be used.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| network_endpoints      | core | json          | Output only. The network endpoints where TPU workers can be accessed and sent work. It is recommended that Tensorflow clients of the node reach out to the 0th entry in this map first.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| organization_id        | core | string        |
| parent                 | core | string        |
| port                   | core | string        | Output only. DEPRECATED! Use network_endpoints instead. The network port for the TPU Node as visible to Compute Engine instances.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| project_id             | core | string        |
| project_number         | core | string        |
| region_id              | core | string        |
| resource_name          | core | string        |
| scheduling_config      | core | json          | The scheduling options for this node.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| service_account        | core | string        | Output only. The service account used to run the tensor flow services within the node. To share resources, including Google Cloud Storage data, with the Tensorflow job running in the Node, this account must have permissions to that data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| state                  | core | string        | Output only. The current state for the TPU Node. Possible values: ['STATE_UNSPECIFIED', 'CREATING', 'READY', 'RESTARTING', 'REIMAGING', 'DELETING', 'REPAIRING', 'STOPPED', 'STOPPING', 'STARTING', 'PREEMPTED', 'TERMINATED', 'HIDING', 'HIDDEN', 'UNHIDING', 'UNKNOWN']. Values descriptions: ['TPU node state is not known/set.', 'TPU node is being created.', 'TPU node has been created.', 'TPU node is restarting.', 'TPU node is undergoing reimaging.', 'TPU node is being deleted.', 'TPU node is being repaired and may be unusable. Details can be found in the `help_description` field.', 'TPU node is stopped.', 'TPU node is currently stopping.', 'TPU node is currently starting.', 'TPU node has been preempted. Only applies to Preemptible TPU Nodes.', 'TPU node has been terminated due to maintenance or has reached the end of its life cycle (for preemptible nodes).', 'TPU node is currently hiding.', 'TPU node has been hidden.', 'TPU node is currently unhiding.', 'TPU node has unknown state after a failed repair.'] |
| symptoms               | core | json          | Output only. The Symptoms that have occurred to the TPU Node.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| tags                   | core | hstore_csv    |
| tensorflow_version     | core | string        | Required. The version of Tensorflow running in the Node.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| use_service_networking | core | bool          | Whether the VPC peering for the node is set up through Service Networking API. The VPC Peering should be set up before provisioning the node. If this field is set, cidr_block field should not be specified. If the network, that you want to peer the TPU Node to, is Shared VPC networks, the node must be created with this this field enabled.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| zone_id                | core | string        |