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

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

# AlloyDB Instance

AlloyDB Instance is a fully managed PostgreSQL-compatible database service on Google Cloud. It is designed for high performance, scalability, and availability, combining the familiarity of PostgreSQL with advanced cloud optimizations. This resource allows you to run transactional and analytical workloads efficiently, with automated backups, replication, and integrated security features.

```
gcp.alloydb_instance
```

## Fields

| Title                        | ID   | Type          | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Description |
| ---------------------------- | ---- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                         | core | string        |
| ancestors                    | core | array<string> |
| annotations                  | core | hstore        | Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| availability_type            | core | string        | Availability type of an Instance. If empty, defaults to REGIONAL for primary instances. For read pools, availability_type is always UNSPECIFIED. Instances in the read pools are evenly distributed across available zones within the region (i.e. read pools with more than one node will have a node in at least two zones).                                                                                                                                                                                                                                                                  |
| client_connection_config     | core | json          | Optional. Client connection specific configurations                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| create_time                  | core | timestamp     | Output only. Create time stamp                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| datadog_display_name         | core | string        |
| delete_time                  | core | timestamp     | Output only. Delete time stamp                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| etag                         | core | string        | For Resource freshness validation (https://google.aip.dev/154)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| gce_zone                     | core | string        | The Compute Engine zone that the instance should serve from, per https://cloud.google.com/compute/docs/regions-zones This can ONLY be specified for ZONAL instances. If present for a REGIONAL instance, an error will be thrown. If this is absent for a ZONAL instance, instance is created in a random zone with available capacity.                                                                                                                                                                                                                                                         |
| gcp_display_name             | core | string        | User-settable and human-readable display name for the Instance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| instance_type                | core | string        | Required. The type of the instance. Specified at creation time.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ip_address                   | core | string        | Output only. The IP address for the Instance. This is the connection endpoint for an end-user application.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| labels                       | core | array<string> | Labels as key value pairs                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| machine_config               | core | json          | Configurations for the machines that host the underlying database engine.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| name                         | core | string        | Output only. The name of the instance resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource: * projects/{project}/locations/{region}/clusters/{cluster_id} |
| network_config               | core | json          | Optional. Instance-level network configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| nodes                        | core | json          | Output only. List of available read-only VMs in this instance, including the standby for a PRIMARY instance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| organization_id              | core | string        |
| outbound_public_ip_addresses | core | array<string> | Output only. All outbound public IP addresses configured for the instance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| parent                       | core | string        |
| project_id                   | core | string        |
| project_number               | core | string        |
| psc_instance_config          | core | json          | Optional. The configuration for Private Service Connect (PSC) for the instance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| public_ip_address            | core | string        | Output only. The public IP addresses for the Instance. This is available ONLY when enable_public_ip is set. This is the connection endpoint for an end-user application.                                                                                                                                                                                                                                                                                                                                                                                                                        |
| query_insights_config        | core | json          | Configuration for query insights.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| read_pool_config             | core | json          | Read pool instance configuration. This is required if the value of instanceType is READ_POOL.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| reconciling                  | core | bool          | Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Instance does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.                                                                                                                                                                                                                                                                 |
| region_id                    | core | string        |
| resource_name                | core | string        |
| satisfies_pzs                | core | bool          | Output only. Reserved for future use.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| state                        | core | string        | Output only. The current serving state of the instance.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| tags                         | core | hstore_csv    |
| uid                          | core | string        | Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| update_time                  | core | timestamp     | Output only. Update time stamp                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| writable_node                | core | json          | Output only. This is set for the read-write VM of the PRIMARY instance only.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| zone_id                      | core | string        |