Overview of control APIs

Updated at:
Copy as MD

This document lists all control Application Programming Interfaces (APIs) and their enumeration parameters.

Enumeration parameterEnumeration valueDescription
InstanceClasstsdb.1x.basicThe instance type.
InstanceStatus
  • CREATING (0): Creating
  • ACTIVATION (1): Running
  • DELETED (8): Deleted
The status of the instance.
ChargeType
  • PREPAY: Prepayment
  • POSTPAY: Post-payment
Payment method
AggregatorType
  • count
  • sum
  • avg
  • min
  • max
The aggregation type.
DownSampleTime
  • 1m
  • 5m
  • 15m
  • 30m
  • 1h
  • 12h
  • 24h
The time range for downsampling.
DeletionJobStatus
  • Submitted
  • STARTED: Running
  • FINISHED
  • Execution failed
The status of the data deletion job.
DeletionJobType
  • Data
  • META: Timeline
The type of the data deletion job.

Control APIs

APIDescription
CreateHiTSDBInstanceCreates an instance.
DeleteHiTSDBInstanceDeletes an instance.
ModifyHiTSDBInstanceClassUpgrades or downgrades a TSDB instance. Only scale-out operations for shared instances are supported.
DescribeRegionsLists the deployment regions.
DescribeHiTSDBInstanceListQueries the database to obtain a list of instances.
DescribeHiTSDBInstanceObtains the details of an instance.
ModifyHiTSDBInstanceSecurityIpListConfigures the IP address whitelist for an instance.
RestartHiTSDBInstanceRestarts an instance.
RenameHiTSDBInstanceAliasModifies the alias of an instance.
DeleteHiTSDBInstanceDataDeletes data from an instance.
DescribeHiTSDBInstanceDataTtlQueries the TTL of data in an instance.
ExploreHiTSDBInstanceDataMetricListObtains the list of metrics for an instance.
ExploreHiTSDBInstanceDataTagKeyListObtains the list of tag keys for an instance.
ExploreHiTSDBInstanceDataTagValueListObtains the list of tag values for an instance.
ExploreHiTSDBInstanceDataObtains the time series data within an instance.
ExploreHiTSDBInstanceDeletionJobListObtains a list of deletion job records. Jobs are identified as data deletion or timeline deletion based on the JobType parameter.
UpdateHiTSDBInstanceDataTtlUpdates the data TTL.