Skip to main content

db_instances_for_clusters

Creates, updates, deletes, gets or lists a db_instances_for_clusters resource.

Overview

Namedb_instances_for_clusters
TypeResource
Idaws.timestream_influxdb.db_instances_for_clusters

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe service-generated unique identifier of the DB instance. (pattern: <code>[a-zA-Z0-9]+</code>)
namestringA service-generated name for the DB instance based on the customer-supplied name for the DB cluster. (pattern: <code>[a-zA-Z][a-zA-Z0-9](-[a-zA-Z0-9]+)</code>)
allocated_storageintegerThe amount of storage allocated for your DB storage type in GiB (gibibytes).
arnstringThe Amazon Resource Name (ARN) of the DB instance. (pattern: <code>arn:aws[a-z-]*:timestream-influxdb:[a-z0-9-]+:[0-9]{12}:(db-instance|db-cluster|db-parameter-group|db-backup)/[a-zA-Z0-9]{3,64}</code>)
db_instance_typestringThe Timestream for InfluxDB instance type to run InfluxDB on. (db.influx.medium, db.influx.large, db.influx.xlarge, db.influx.2xlarge, db.influx.4xlarge, db.influx.8xlarge, db.influx.12xlarge, db.influx.16xlarge, db.influx.24xlarge)
db_storage_typestringThe storage type for your DB instance. (InfluxIOIncludedT1, InfluxIOIncludedT2, InfluxIOIncludedT3)
deployment_typestringSpecifies the deployment type if applicable. (SINGLE_AZ, WITH_MULTIAZ_STANDBY)
endpointstringThe endpoint used to connect to InfluxDB. The default InfluxDB port is 8086.
instance_modestringSpecifies the DB instance's role in the cluster. (PRIMARY, STANDBY, REPLICA, INGEST, QUERY, COMPACT, PROCESS)
instance_modesarraySpecifies the DB instance's roles in the cluster.
network_typestringSpecifies whether the network type of the Timestream for InfluxDB instance is IPv4, which can communicate over IPv4 protocol only, or DUAL, which can communicate over both IPv4 and IPv6 protocols. (IPV4, DUAL)
portintegerThe port number on which InfluxDB accepts connections.
statusstringThe status of the DB instance. (CREATING, AVAILABLE, DELETING, MODIFYING, UPDATING, DELETED, FAILED, UPDATING_DEPLOYMENT_TYPE, UPDATING_INSTANCE_TYPE, MAINTENANCE, REBOOTING, REBOOT_FAILED, RESTORING, RESTORE_FAILED)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_db_instances_for_clusterselectregionReturns a list of Timestream for InfluxDB clusters.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)

SELECT examples

Returns a list of Timestream for InfluxDB clusters.

SELECT
id,
name,
allocated_storage,
arn,
db_instance_type,
db_storage_type,
deployment_type,
endpoint,
instance_mode,
instance_modes,
network_type,
port,
status
FROM aws.timestream_influxdb.db_instances_for_clusters
WHERE region = '{{ region }}' -- required
;