TimestreamInfluxDB / Client / get_db_instance

get_db_instance#

TimestreamInfluxDB.Client.get_db_instance(**kwargs)#

Returns a Timestream for InfluxDB DB instance.

See also: AWS API Documentation

Request Syntax

response = client.get_db_instance(
    identifier='string'
)
Parameters:

identifier (string) –

[REQUIRED]

The id of the DB instance.

Return type:

dict

Returns:

Response Syntax

{
    'id': 'string',
    'name': 'string',
    'arn': 'string',
    'status': 'CREATING'|'AVAILABLE'|'DELETING'|'MODIFYING'|'UPDATING'|'DELETED'|'FAILED'|'UPDATING_DEPLOYMENT_TYPE'|'UPDATING_INSTANCE_TYPE',
    'endpoint': 'string',
    'port': 123,
    'networkType': 'IPV4'|'DUAL',
    'dbInstanceType': 'db.influx.medium'|'db.influx.large'|'db.influx.xlarge'|'db.influx.2xlarge'|'db.influx.4xlarge'|'db.influx.8xlarge'|'db.influx.12xlarge'|'db.influx.16xlarge',
    'dbStorageType': 'InfluxIOIncludedT1'|'InfluxIOIncludedT2'|'InfluxIOIncludedT3',
    'allocatedStorage': 123,
    'deploymentType': 'SINGLE_AZ'|'WITH_MULTIAZ_STANDBY',
    'vpcSubnetIds': [
        'string',
    ],
    'publiclyAccessible': True|False,
    'vpcSecurityGroupIds': [
        'string',
    ],
    'dbParameterGroupIdentifier': 'string',
    'availabilityZone': 'string',
    'secondaryAvailabilityZone': 'string',
    'logDeliveryConfiguration': {
        's3Configuration': {
            'bucketName': 'string',
            'enabled': True|False
        }
    },
    'influxAuthParametersSecretArn': 'string'
}

Response Structure

  • (dict) –

    • id (string) –

      A service-generated unique identifier.

    • name (string) –

      The customer-supplied name that uniquely identifies the DB instance when interacting with the Amazon Timestream for InfluxDB API and CLI commands.

    • arn (string) –

      The Amazon Resource Name (ARN) of the DB instance.

    • status (string) –

      The status of the DB instance.

    • endpoint (string) –

      The endpoint used to connect to InfluxDB. The default InfluxDB port is 8086.

    • port (integer) –

      The port number on which InfluxDB accepts connections.

    • networkType (string) –

      Specifies whether the networkType 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.

    • dbInstanceType (string) –

      The Timestream for InfluxDB instance type that InfluxDB runs on.

    • dbStorageType (string) –

      The Timestream for InfluxDB DB storage type that InfluxDB stores data on.

    • allocatedStorage (integer) –

      The amount of storage allocated for your DB storage type (in gibibytes).

    • deploymentType (string) –

      Specifies whether the Timestream for InfluxDB is deployed as Single-AZ or with a MultiAZ Standby for High availability.

    • vpcSubnetIds (list) –

      A list of VPC subnet IDs associated with the DB instance.

      • (string) –

    • publiclyAccessible (boolean) –

      Indicates if the DB instance has a public IP to facilitate access.

    • vpcSecurityGroupIds (list) –

      A list of VPC security group IDs associated with the DB instance.

      • (string) –

    • dbParameterGroupIdentifier (string) –

      The id of the DB parameter group assigned to your DB instance.

    • availabilityZone (string) –

      The Availability Zone in which the DB instance resides.

    • secondaryAvailabilityZone (string) –

      The Availability Zone in which the standby instance is located when deploying with a MultiAZ standby instance.

    • logDeliveryConfiguration (dict) –

      Configuration for sending InfluxDB engine logs to send to specified S3 bucket.

      • s3Configuration (dict) –

        Configuration for S3 bucket log delivery.

        • bucketName (string) –

          The name of the S3 bucket to deliver logs to.

        • enabled (boolean) –

          Indicates whether log delivery to the S3 bucket is enabled.

    • influxAuthParametersSecretArn (string) –

      The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret containing the initial InfluxDB authorization parameters. The secret value is a JSON formatted key-value pair holding InfluxDB authorization values: organization, bucket, username, and password.

Exceptions