History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
Account information
Used by actions: DescribeAccounts.
| Name | Type | Description |
|---|---|---|
| DBInstanceId | String | Instance ID in the format of postgres-lnp6j617 |
| UserName | String | Account |
| Remark | String | Account remarks |
| Status | Integer | Account status. 1: creating, 2: normal, 3: modifying, 4: resetting password, -1: deleting |
| CreateTime | Timestamp | Account creation time |
| UpdateTime | Timestamp | Account last modified time |
Detailed analysis of a slow query statement with abstract parameter values, which is returned by the DescribeSlowQueryAnalysis API
Used by actions: DescribeSlowQueryAnalysis.
| Name | Type | Description |
|---|---|---|
| DatabaseName | String | The name of the database queried by the slow query statement |
| UserName | String | The name of the user who executes the slow query statement |
| NormalQuery | String | The slow query statement whose parameter values are abstracted |
| ClientAddr | String | The address of the client that executes the slow query statement |
| CallNum | Integer | The number of executions of the slow query statement during the specified period of time |
| CallPercent | Float | The ratio (in decimal form) of the number of executions of the slow query statement to that of all slow query statements during the specified period of time |
| CostTime | Float | The total execution time of the slow query statement during the specified period of time |
| CostPercent | Float | The ratio (in decimal form) of the total execution time of the slow query statement to that of all slow query statements during the specified period of time |
| MinCostTime | Float | The shortest execution time (in ms) of the slow query statement during the specified period of time |
| MaxCostTime | Float | The longest execution time (in ms) of the slow query statement during the specified period of time |
| AvgCostTime | Float | The average execution time (in ms) of the slow query statement during the specified period of time |
| FirstTime | String | The timestamp when the slow query statement starts to execute for the first time during the specified period of time |
| LastTime | String | The timestamp when the slow query statement starts to execute for the last time during the specified period of time |
Restriction information for downloading a backup
Used by actions: DescribeBackupDownloadURL.
| Name | Type | Required | Description |
|---|---|---|---|
| RestrictionType | String | No | Type of the network restrictions for downloading backup files. Valid values: NONE (backups can be downloaded over both private and public networks), INTRANET (backups can only be downloaded over the private network), CUSTOMIZE (backups can be downloaded over specified VPCs or at specified IPs). |
| VpcRestrictionEffect | String | No | Whether VPC is allowed. Valid values: ALLOW (allow), DENY (deny). |
| VpcIdSet | Array of String | No | Whether it is allowed to download the VPC ID list of the backup files. |
| IpRestrictionEffect | String | No | Whether IP is allowed. Valid values: ALLOW (allow), DENY (deny). |
| IpSet | Array of String | No | Whether it is allowed to download IP list of the backup files. |
Backup plan
Used by actions: DescribeBackupPlans.
| Name | Type | Description |
|---|---|---|
| BackupPeriod | String | Backup cycle |
| BaseBackupRetentionPeriod | Integer | Data backup retention duration |
| MinBackupStartTime | String | The earliest time to start a backup |
| MaxBackupStartTime | String | The latest time to start a backup |
Instance backup statistics
Used by actions: DescribeBackupSummaries.
| Name | Type | Description |
|---|---|---|
| DBInstanceId | String | Instance ID |
| LogBackupCount | Integer | Number of log backups of an instance |
| LogBackupSize | Integer | Size of log backups of an instance |
| ManualBaseBackupCount | Integer | Number of manually created instance data backups. |
| ManualBaseBackupSize | Integer | Size of manually created instance data backups. |
| AutoBaseBackupCount | Integer | Number of automatically created instance data backups. |
| AutoBaseBackupSize | Integer | Size of automatically created instance data backups. |
| TotalBackupCount | Integer | Total number of backups |
| TotalBackupSize | Integer | Total backup size |
Database data backup information
Used by actions: DescribeBaseBackups.
| Name | Type | Description |
|---|---|---|
| DBInstanceId | String | Instance ID |
| Id | String | Unique ID of a backup file |
| Name | String | Backup file name. |
| BackupMethod | String | Backup method, including physical and logical. |
| BackupMode | String | Backup mode, including automatic and manual. |
| State | String | Backup task status |
| Size | Integer | Backup set size in bytes |
| StartTime | String | Backup start time |
| FinishTime | String | Backup end time |
| ExpireTime | String | Backup expiration time |
Database instance specification
Used by actions: DescribeClasses.
| Name | Type | Description |
|---|---|---|
| SpecCode | String | Specification ID |
| CPU | Integer | Number of CPU cores |
| Memory | Integer | Memory size in MB |
| MaxStorage | Integer | Maximum storage capacity in GB supported by this specification |
| MinStorage | Integer | Minimum storage capacity in GB supported by this specification |
| QPS | Integer | Estimated QPS for this specification |
Database backup information
Used by actions: DescribeDBBackups.
| Name | Type | Description |
|---|---|---|
| Id | Integer | Unique backup file ID |
| StartTime | String | File generation start time |
| EndTime | String | File generation end time |
| Size | Integer | File size in KB |
| Strategy | Integer | Policy (0: instance backup, 1: multi-database backup) |
| Way | Integer | Type (0: scheduled) |
| Type | Integer | Backup mode (1: full) |
| Status | Integer | Status (1: creating, 2: success, 3: failure) |
| DbList | Array of String | DB list |
| InternalAddr | String | Download address on private network |
| ExternalAddr | String | Download address on public network |
| SetId | String | Backup set ID Note: this field may return null, indicating that no valid values can be obtained. |
Instance details
Used by actions: DescribeDBInstanceAttribute, DescribeDBInstances, DescribeReadOnlyGroups.
| Name | Type | Description |
|---|---|---|
| Region | String | Region of the instance, for example: ap-guangzhou, corresponds to the region field in RegionSet. |
| Zone | String | Availability zone to which the instance belongs, for example: ap-guangzhou-3, corresponds to the Zone field in ZoneSet. |
| VpcId | String | VPC ID, such as vpc-e6w23k31. A valid VPC ID can be obtained by logging in to the console to query or by calling the API DescribeVpcs and acquiring the unVpcId field in API return. |
| SubnetId | String | VPC subnet ID, such as subnet-51lcif9y. An effective VPC subnet ID can be obtained by logging in to the console to query. You can also call API DescribeSubnets and get it from the unSubnetId field in API return. |
| DBInstanceId | String | Instance ID. |
| DBInstanceName | String | Instance name. |
| DBInstanceStatus | String | Instance status, including: |
| DBInstanceMemory | Integer | Memory size allocated to the instance, measurement unit: GB |
| DBInstanceStorage | Integer | Storage space size allocated to the instance, measurement unit: GB |
| DBInstanceCpu | Integer | Number of CPUs allocated to the instance, unit: piece |
| DBInstanceClass | String | Purchasable specification ID. |
| DBMajorVersion | String | PostgreSQL major version number. Version information can be obtained from DescribeDBVersions. Currently supports major versions 10, 11, 12, 13, 14, and 15. |
| DBVersion | String | PostgreSQL community major version + minor version number, such as 12.4. Version information can be obtained from DescribeDBVersions. |
| DBKernelVersion | String | PostgreSQL Kernel Version, for example v12.7_r1.8. Version information can be obtained from DescribeDBVersions. |
| DBInstanceType | String | Instance types: |
| DBInstanceVersion | String | Instance version currently only supports standard (dual-server high-availability edition, one master and one slave). |
| DBCharset | String | Instance character set, which currently supports only: |
| CreateTime | Timestamp | Instance creation time. |
| UpdateTime | Timestamp | The time when the instance executed the last update. |
| ExpireTime | Timestamp | Instance expiration time. |
| IsolatedTime | Timestamp | Instance isolation time. |
| PayType | String | Billing mode: |
| AutoRenew | Integer | Auto-renewal or not: |
| DBInstanceNetInfo | Array of DBInstanceNetInfo | Instance network connection information. |
| Type | String | Machine type. |
| AppId | Integer | User's app id. |
| Uid | Integer | Uid of the instance. |
| ProjectId | Integer | Project ID. |
| TagList | Array of Tag | Tag information associated with the instance. |
| MasterDBInstanceId | String | Primary instance information. Returned only when the instance is a read-only instance. |
| ReadOnlyInstanceNum | Integer | Number of read-only instances. |
| StatusInReadonlyGroup | String | State of the read-only instance in the read-only group. |
| OfflineTime | String | Offline time. |
| DBNodeSet | Array of DBNode | Instance node information. Note: This field may return null, indicating that no valid values can be obtained. |
| IsSupportTDE | Integer | Whether the instance supports TDE data encryption: |
| DBEngine | String | Database engine, support: postgresql: TencentDB for PostgreSQLmssql_compatible: MSSQL compatible - TencentDB for PostgreSQL |
| DBEngineConfig | String | Configuration information for the database engine. The configuration format is as follows: |
| NetworkAccessList | Array of NetworkAccess | Instance network information list (deprecated) Note: This field may return null, indicating that no valid values can be obtained. |
| SupportIpv6 | Integer | Whether the instance supports Ipv6: |
| ExpandedCpu | Integer | Number of cpu cores that have been elastically scaled out for the instance |
| DeletionProtection | Boolean | Whether to enable deletion protection for the instance, values as follows:
|
| DBInstanceStorageType | String | Instance storage type. Available values: PHYSICAL_LOCAL_SSD: LOCAL SSD hard disk of PHYSICAL machine; CLOUD_PREMIUM: high-performance CLOUD block storage; CLOUD_SSD: SSD CLOUD disk; CLOUD_HSSD: enhanced SSD CLOUD disk. |
Instance network connection information
Used by actions: DescribeDBInstanceAttribute, DescribeDBInstances, DescribeReadOnlyGroups.
| Name | Type | Description |
|---|---|---|
| Address | String | DNS domain name |
| Ip | String | Ip |
| Port | Integer | Connection port address |
| NetType | String | Network type. 1: inner (private network address), 2: public (public network address) |
| Status | String | Network connection status. Valid values: initing (never enabled before), opened (enabled), closed (disabled), opening (enabling), closing (disabling) |
| VpcId | String | VPC ID. specifies the ID of the virtual private cloud. |
| SubnetId | String | Subnet ID. |
| ProtocolType | String | Specifies the protocol type to connect to the database. currently supported: postgresql, mssql (mssql compatible syntax). |
Describes the instance node information, including the node type, availability zone where the node is located, and dedicated cluster where the node resides.
Used by actions: CloneDBInstance, CreateInstances, DescribeDBInstanceAttribute, DescribeDBInstances, DescribeReadOnlyGroups, ModifyDBInstanceDeployment.
| Name | Type | Required | Description |
|---|---|---|---|
| Role | String | Yes | Node type. Valid values:Primary;Standby. |
| Zone | String | Yes | AZ where the node resides, such as ap-guangzhou-1. |
| DedicatedClusterId | String | No | CDC ID. |
Details returned by the DescribeSlowQueryAnalysis API
Used by actions: DescribeSlowQueryAnalysis.
| Name | Type | Description |
|---|---|---|
| TotalTime | Float | The total execution time (in ms) of all slow query statements during the specified period of time |
| TotalCallNum | Integer | The total number of all slow query statements during the specified period of time |
| AnalysisItems | Array of AnalysisItems | The statistical analysis list of slow queries Note: this field may return null, indicating that no valid values can be obtained. |
Analyze the execution time of slow query statements by classifying them to different time ranges
Used by actions: DescribeSlowQueryList.
| Name | Type | Description |
|---|---|---|
| TimeSegment | String | Time range |
| Count | Integer | The number of slow query statements whose execution time falls within the time range |
KMS key information
Used by actions: DescribeEncryptionKeys.
| Name | Type | Description |
|---|---|---|
| KeyId | String | Encrypted KeyId of KMS instance Note: This field may return null, indicating that no valid value can be obtained. |
| KeyAlias | String | Encryption key alias of KMS instance Note: This field may return null, indicating that no valid value can be obtained. |
| DEKCipherTextBlob | String | Instance DEK ciphertext Note: This field may return null, indicating that no valid value can be obtained. |
| IsEnabled | Integer | Whether the key is enabled. Valid values: 1 (yes), 0 (no)Note: This field may return null, indicating that no valid value can be obtained. |
| KeyRegion | String | Region where KMS key resides Note: This field may return null, indicating that no valid value can be obtained. |
| CreateTime | String | DEK key creation time Note: This field may return null, indicating that no valid value can be obtained. |
Error log details
Used by actions: DescribeDBErrlogs.
| Name | Type | Description |
|---|---|---|
| UserName | String | Username |
| Database | String | Database name |
| ErrTime | String | Error occurrence time |
| ErrMsg | String | Error message |
Parameter modification event information
Used by actions: DescribeParamsEvent.
| Name | Type | Description |
|---|---|---|
| ParamName | String | Parameter name Note: this field may return null, indicating that no valid values can be obtained. |
| OldValue | String | Original parameter value Note: this field may return null, indicating that no valid values can be obtained. |
| NewValue | String | New parameter value in this modification event Note: this field may return null, indicating that no valid values can be obtained. |
| ModifyTime | String | Start time of parameter modification Note: this field may return null, indicating that no valid values can be obtained. |
| EffectiveTime | String | Start time when the modified parameter takes effect Note: this field may return null, indicating that no valid values can be obtained. |
| State | String | Modification status Note: this field may return null, indicating that no valid values can be obtained. |
| Operator | String | Operator (generally, the value is the UIN of a sub-user) Note: this field may return null, indicating that no valid values can be obtained. |
| EventLog | String | Event log Note: this field may return null, indicating that no valid values can be obtained. |
Modification details of one parameter
Used by actions: DescribeParamsEvent.
| Name | Type | Description |
|---|---|---|
| ParamName | String | Parameter name Note: this field may return null, indicating that no valid values can be obtained. |
| EventCount | Integer | The number of modification events Note: this field may return null, indicating that no valid values can be obtained. |
| EventDetail | Array of EventInfo | Modification event details Note: this field may return null, indicating that no valid values can be obtained. |
Key-value pair filter for conditional filtering queries, such as filter ID and name
AND.OR.Used by actions: DescribeBackupSummaries, DescribeBaseBackups, DescribeDBInstances, DescribeDatabases, DescribeLogBackups, DescribeParameterTemplates, DescribeReadOnlyGroups, DescribeServerlessDBInstances.
| Name | Type | Required | Description |
|---|---|---|---|
| Name | String | No | Filter name. |
| Values | Array of String | No | One or more filter values. |
Log backup information of a database
Used by actions: DescribeLogBackups.
| Name | Type | Description |
|---|---|---|
| DBInstanceId | String | Instance ID |
| Id | String | Unique ID of a backup file |
| Name | String | Backup file name |
| BackupMethod | String | Backup method, including physical and logical. |
| BackupMode | String | Backup mode, including automatic and manual. |
| State | String | Backup task status |
| Size | Integer | Backup set size in bytes |
| StartTime | String | Backup start time |
| FinishTime | String | Backup end time |
| ExpireTime | String | Backup expiration time |
Network information. (This parameter structure has been deprecated. Please use DBInstanceNetInfo to query network information.)
Used by actions: DescribeDBInstanceAttribute, DescribeDBInstances, DescribeReadOnlyGroups.
| Name | Type | Description |
|---|---|---|
| ResourceId | String | Network resource id, instance id, or RO group id. |
| ResourceType | Integer | Resource type. valid values: 1 (instance), 2 (RO group). |
| VpcId | String | VPC ID. specifies the ID of the virtual private cloud. |
| Vip | String | IPv4 Address |
| Vip6 | String | IPv6 Address |
| Vport | Integer | Specifies the access port. |
| SubnetId | String | Subnet ID. |
| VpcStatus | Integer | Network status. valid values: 1-applying, 2-active, 3-deleting, 4-deleted. |
Information of one SlowQuery
Used by actions: DescribeDBSlowlogs.
| Name | Type | Description |
|---|---|---|
| UserName | String | Username |
| Calls | Integer | Number of calls |
| CallsGrids | Array of Integer | Granularity |
| CostTime | Float | Total time consumed |
| Rows | Integer | Number of affected rows |
| MinCostTime | Float | Minimum time consumed |
| MaxCostTime | Float | Maximum time consumed |
| FirstTime | String | Time of the earliest slow SQL statement |
| LastTime | String | Time of the latest slow SQL statement |
| SharedReadBlks | Integer | Shared memory blocks for reads |
| SharedWriteBlks | Integer | Shared memory blocks for writes |
| ReadCostTime | Integer | Total IO read time |
| WriteCostTime | Integer | Total IO write time |
| DatabaseName | String | Database name |
| NormalQuery | String | Slow SQL statement after desensitization |
Parameters to be modified in batches
Used by actions: ModifyDBInstanceParameters, ModifyParameterTemplate.
| Name | Type | Required | Description |
|---|---|---|---|
| Name | String | Yes | Parameter name |
| ExpectedValue | String | Yes | The new value to which the parameter will be modified. When this parameter is used as an input parameter, its value must be a string, such as 0.1 (decimal), 1000 (integer), and replica (enum). |
Parameter details
Used by actions: DescribeDBInstanceParameters, DescribeDefaultParameters, DescribeParameterTemplateAttributes.
| Name | Type | Description |
|---|---|---|
| ID | Integer | Parameter ID Note: this field may return null, indicating that no valid values can be obtained. |
| Name | String | Parameter name Note: this field may return null, indicating that no valid values can be obtained. |
| ParamValueType | String | Value type of the parameter. Valid values: integer, real (floating-point), bool, enum, mutil_enum (this type of parameter can be set to multiple enumerated values).For an integer or real parameter, the Min field represents the minimum value and the Max field the maximum value. For a bool parameter, the valid values include true and false; For an enum or mutil_enum parameter, the EnumValue field represents the valid values.Note: this field may return null, indicating that no valid values can be obtained. |
| Unit | String | Unit of the parameter value. If the parameter has no unit, this field will return null. Note: This field may return null, indicating that no valid values can be obtained. |
| DefaultValue | String | Default value of the parameter, which is returned as a string Note: this field may return null, indicating that no valid values can be obtained. |
| CurrentValue | String | Current value of the parameter, which is returned as a string Note: this field may return null, indicating that no valid values can be obtained. |
| Max | Float | The maximum value of the integer or real parameterNote: this field may return null, indicating that no valid values can be obtained. |
| EnumValue | Array of String | Value range of the enum parameter Note: this field may return null, indicating that no valid values can be obtained. |
| Min | Float | The minimum value of the integer or real parameterNote: this field may return null, indicating that no valid values can be obtained. |
| ParamDescriptionCH | String | Parameter description in Chinese Note: this field may return null, indicating that no valid values can be obtained. |
| ParamDescriptionEN | String | Parameter description in English Note: this field may return null, indicating that no valid values can be obtained. |
| NeedReboot | Boolean | Whether to restart the instance for the modified parameter to take effect. Valid values: true (yes), false (no)Note: this field may return null, indicating that no valid values can be obtained. |
| ClassificationCN | String | Parameter category in Chinese Note: this field may return null, indicating that no valid values can be obtained. |
| ClassificationEN | String | Parameter category in English Note: this field may return null, indicating that no valid values can be obtained. |
| SpecRelated | Boolean | Whether the parameter is related to specifications. Valid values: true (yes), false (no)Note: this field may return null, indicating that no valid values can be obtained. |
| Advanced | Boolean | Whether it is a key parameter. Valid values: true (yes, and modifying it may affect instance performance), false (no)Note: this field may return null, indicating that no valid values can be obtained. |
| LastModifyTime | String | The last modified time of the parameter Note: this field may return null, indicating that no valid values can be obtained. |
| StandbyRelated | Integer | Parameter primary-secondary constraints, 0: No constraint, 1: Standby parameter value must be greater than that of the primary machine, 2: Primary parameter value must be greater than that of the standby machine.Note: This field may return null, indicating that no valid values can be obtained. |
| VersionRelationSet | Array of ParamVersionRelation | Parameter version association information, containing detailed parameter information for the respective kernel version Note: This field may return null, indicating that no valid values can be obtained. |
| SpecRelationSet | Array of ParamSpecRelation | Parameter specification association information, containing detailed parameter information for the respective specification Note: This field may return null, indicating that no valid values can be obtained. |
Parameter information for each specification
Used by actions: DescribeDBInstanceParameters, DescribeDefaultParameters, DescribeParameterTemplateAttributes.
| Name | Type | Description |
|---|---|---|
| Name | String | Parameter name Note: This field may return null, indicating that no valid values can be obtained. |
| Memory | String | The specification that corresponds to the parameter information Note: This field may return null, indicating that no valid values can be obtained. |
| Value | String | The default parameter value under this specification Note: This field may return null, indicating that no valid values can be obtained. |
| Unit | String | Unit of the parameter value. If the parameter has no unit, this field will return null. Note: This field may return null, indicating that no valid values can be obtained. |
| Max | Float | The maximum value of the integer or real parameterNote: This field may return null, indicating that no valid values can be obtained. |
| Min | Float | The minimum value of the integer or real parameterNote: This field may return null, indicating that no valid values can be obtained. |
| EnumValue | Array of String | Value range of the enum parameter Note: This field may return null, indicating that no valid values can be obtained. |
Parameter information for each version
Used by actions: DescribeDBInstanceParameters, DescribeDefaultParameters, DescribeParameterTemplateAttributes.
| Name | Type | Description |
|---|---|---|
| Name | String | Parameter name Note: This field may return null, indicating that no valid values can be obtained. |
| DBKernelVersion | String | The kernel version that corresponds to the parameter information Note: This field may return null, indicating that no valid values can be obtained. |
| Value | String | Default parameter value under the kernel version and specification of the instance Note: This field may return null, indicating that no valid values can be obtained. |
| Unit | String | Unit of the parameter value. If the parameter has no unit, this field will return null. Note: This field may return null, indicating that no valid values can be obtained. |
| Max | Float | The maximum value of the integer or real parameterNote: This field may return null, indicating that no valid values can be obtained. |
| Min | Float | The minimum value of the integer or real parameterNote: This field may return null, indicating that no valid values can be obtained. |
| EnumValue | Array of String | Value range of the enum parameter Note: This field may return null, indicating that no valid values can be obtained. |
Basic information of a parameter template
Used by actions: DescribeParameterTemplates.
| Name | Type | Description |
|---|---|---|
| TemplateId | String | Parameter template ID |
| TemplateName | String | Parameter template name |
| DBMajorVersion | String | Database version applicable to a parameter template |
| DBEngine | String | Database engine applicable to a parameter template |
| TemplateDescription | String | Parameter template description |
Order details
Used by actions: DescribeOrders.
| Name | Type | Description |
|---|---|---|
| DealName | String | Order name |
| OwnerUin | String | User |
| Count | Integer | Number of instances involved in order |
| PayMode | Integer | Billing mode. 0: pay-as-you-go |
| FlowId | Integer | Async task flow ID |
| DBInstanceIdSet | Array of String | Instance ID array |
Rule information for security group
Used by actions: DescribeDBInstanceSecurityGroups.
| Name | Type | Description |
|---|---|---|
| Action | String | Policy, Valid values: ACCEPT, DROP. |
| CidrIp | String | Source or destination IP or IP range, such as 172.16.0.0/12. |
| PortRange | String | Port |
| IpProtocol | String | Network protocol. UDP and TCP are supported. |
| Description | String | The rule description |
The list of slow query details returned by the DescribeSlowQueryList API
Used by actions: DescribeSlowQueryList.
| Name | Type | Description |
|---|---|---|
| RawQuery | String | Slow query statement |
| DatabaseName | String | The database queried by the slow query statement |
| Duration | Float | The execution time of the slow query statement |
| ClientAddr | String | The client that executes the slow query statement |
| UserName | String | The name of the user who executes the slow query statement |
| SessionStartTime | String | The time when the slow query statement starts to execute |
RO group information
Used by actions: DescribeReadOnlyGroups.
| Name | Type | Description |
|---|---|---|
| ReadOnlyGroupId | String | RO group identifier Note: this field may return null, indicating that no valid values can be obtained. |
| ReadOnlyGroupName | String | RO group name Note: this field may return null, indicating that no valid values can be obtained. |
| ProjectId | Integer | Project ID Note: this field may return null, indicating that no valid values can be obtained. |
| MasterDBInstanceId | String | Primary instance ID Note: this field may return null, indicating that no valid values can be obtained. |
| MinDelayEliminateReserve | Integer | The minimum number of read-only replicas that must be retained in an RO group Note: this field may return null, indicating that no valid values can be obtained. |
| MaxReplayLatency | Integer | Delayed log size threshold |
| ReplayLatencyEliminate | Integer | Whether to remove a read-only replica from an RO group if the sync log size difference between the read-only replica and the primary instance exceeds the threshold. Valid values: 0 (no), 1 (yes). |
| MaxReplayLag | Float | Delay threshold |
| ReplayLagEliminate | Integer | Whether to remove a read-only replica from an RO group if the delay between the read-only replica and the primary instance exceeds the threshold. Valid values: 0 (no), 1 (yes). |
| VpcId | String | VPC ID |
| SubnetId | String | Subnet ID Note: this field may return null, indicating that no valid values can be obtained. |
| Region | String | Region ID |
| Zone | String | Availability zone ID |
| Status | String | Status |
| ReadOnlyDBInstanceList | Array of DBInstance | Instance details |
| Rebalance | Integer | Whether to enable automatic load balancing |
| DBInstanceNetInfo | Array of DBInstanceNetInfo | Network information |
| NetworkAccessList | Array of NetworkAccess | Network access list of the RO group (this field has been deprecated) Note: this field may return null, indicating that no valid values can be obtained. |
Region information such as number and status
Used by actions: DescribeRegions.
| Name | Type | Description |
|---|---|---|
| Region | String | Region abbreviation |
| RegionName | String | Region name |
| RegionId | Integer | Region number |
| RegionState | String | Availability status. UNAVAILABLE: unavailable, AVAILABLE: available |
| SupportInternational | Integer | Whether the resource can be purchased in this region. Valid values: 0 (no), 1 (yes).Note: this field may return null, indicating that no valid values can be obtained. |
Security group information
Used by actions: DescribeDBInstanceSecurityGroups.
| Name | Type | Description |
|---|---|---|
| ProjectId | Integer | Project ID |
| CreateTime | String | Creation time |
| Inbound | Array of PolicyRule | Inbound rule |
| Outbound | Array of PolicyRule | Outbound rule |
| SecurityGroupId | String | Security group ID |
| SecurityGroupName | String | Security group name |
| SecurityGroupDescription | String | Security group remarks |
PostgreSQL for Serverless instance account description
Used by actions: DescribeServerlessDBInstances.
| Name | Type | Description |
|---|---|---|
| DBUser | String | Username Note: this field may return null, indicating that no valid values can be obtained. |
| DBPassword | String | Password Note: this field may return null, indicating that no valid values can be obtained. |
| DBConnLimit | Integer | The maximum number of connections Note: this field may return null, indicating that no valid values can be obtained. |
PostgreSQL for Serverless instance description
Used by actions: DescribeServerlessDBInstances.
| Name | Type | Required | Description |
|---|---|---|---|
| DBInstanceId | String | No | Instance ID, which is the unique identifier Note: this field may return null, indicating that no valid values can be obtained. |
| DBInstanceName | String | No | Instance name Note: this field may return null, indicating that no valid values can be obtained. |
| DBInstanceStatus | String | No | Instance status Note: this field may return null, indicating that no valid values can be obtained. |
| Region | String | No | Region Note: this field may return null, indicating that no valid values can be obtained. |
| Zone | String | No | Availability zone Note: this field may return null, indicating that no valid values can be obtained. |
| ProjectId | Integer | No | Project ID Note: this field may return null, indicating that no valid values can be obtained. |
| VpcId | String | No | VPC ID Note: this field may return null, indicating that no valid values can be obtained. |
| SubnetId | String | No | Subnet ID Note: this field may return null, indicating that no valid values can be obtained. |
| DBCharset | String | No | Character set Note: this field may return null, indicating that no valid values can be obtained. |
| DBVersion | String | No | Database version Note: this field may return null, indicating that no valid values can be obtained. |
| CreateTime | String | No | Creation time Note: this field may return null, indicating that no valid values can be obtained. |
| DBInstanceNetInfo | Array of ServerlessDBInstanceNetInfo | No | Instance network information Note: this field may return null, indicating that no valid values can be obtained. |
| DBAccountSet | Array of ServerlessDBAccount | No | Instance account information Note: this field may return null, indicating that no valid values can be obtained. |
| DBDatabaseList | Array of String | No | Information of the databases in an instance Note: this field may return null, indicating that no valid values can be obtained. |
| TagList | Array of Tag | No | The array of tags bound to an instance Note: this field may return null, indicating that no valid values can be obtained. |
| DBKernelVersion | String | No | Database kernel version Note: this field may return null, indicating that no valid values can be obtained. |
| DBMajorVersion | String | No | Database major version number Note: this field may return null, indicating that no valid values can be obtained. |
PostgreSQL for Serverless instance network description
Used by actions: DescribeServerlessDBInstances.
| Name | Type | Description |
|---|---|---|
| Address | String | Address Note: this field may return null, indicating that no valid values can be obtained. |
| Ip | String | IP address Note: this field may return null, indicating that no valid values can be obtained. |
| Port | Integer | Port number Note: this field may return null, indicating that no valid values can be obtained. |
| Status | String | Status Note: this field may return null, indicating that no valid values can be obtained. |
| NetType | String | Network type Note: this field may return null, indicating that no valid values can be obtained. |
Slow query details
Used by actions: DescribeDBSlowlogs.
| Name | Type | Description |
|---|---|---|
| TotalTime | Float | Total time consumed |
| TotalCalls | Integer | Total number of calls |
| NormalQueries | Array of NormalQueryItem | List of slow SQL statements after desensitization |
Purchasable specification details in an AZ in a region.
Used by actions: DescribeProductConfig.
| Name | Type | Description |
|---|---|---|
| Region | String | Region abbreviation, which corresponds to the Region field of RegionSet |
| Zone | String | AZ abbreviate, which corresponds to the Zone field of ZoneSet |
| SpecItemInfoList | Array of SpecItemInfo | Specification details list |
| SupportKMSRegions | Array of String | Regions where KMS is supported Note: This field may return null, indicating that no valid value was found. |
Specification description
Used by actions: DescribeProductConfig.
| Name | Type | Description |
|---|---|---|
| SpecCode | String | Specification ID |
| Version | String | PostgerSQL version number |
| VersionName | String | Full version name corresponding to kernel number |
| Cpu | Integer | Number of CPU cores |
| Memory | Integer | Memory size in MB |
| MaxStorage | Integer | Maximum storage capacity in GB supported by this specification |
| MinStorage | Integer | Minimum storage capacity in GB supported by this specification |
| Qps | Integer | Estimated QPS for this specification |
| Pid | Integer | (Disused) |
| Type | String | Machine type |
| MajorVersion | String | PostgreSQL major version number Note: this field may return null, indicating that no valid values can be obtained. |
| KernelVersion | String | PostgreSQL kernel version number Note: this field may return null, indicating that no valid values can be obtained. |
| IsSupportTDE | Integer | Whether TDE data encryption is supported. Valid values: 0 (no), 1 (yes) Note: This field may return null, indicating that no valid value was found. |
The information of tags associated with instances, including TagKey and TagValue
Used by actions: CloneDBInstance, CreateDBInstances, CreateInstances, CreateReadOnlyDBInstance, CreateServerlessDBInstance, DescribeDBInstanceAttribute, DescribeDBInstances, DescribeReadOnlyGroups, DescribeServerlessDBInstances.
| Name | Type | Required | Description |
|---|---|---|---|
| TagKey | String | Yes | Tag key |
| TagValue | String | Yes | Tag value |
Database version information
Used by actions: DescribeDBVersions.
| Name | Type | Description |
|---|---|---|
| DBEngine | String | Database engines. Valid values: 1. postgresql (TencentDB for PostgreSQL)2. mssql_compatible (MSSQL compatible-TencentDB for PostgreSQL) |
| DBVersion | String | Database version, such as 12.4. |
| DBMajorVersion | String | Database major version, such as 12. |
| DBKernelVersion | String | Database kernel version, such as v12.4_r1.3. |
| SupportedFeatureNames | Array of String | List of features supported by the database kernel, such as: TDE: Supports data encryption. |
| Status | String | Database version status. Valid values:AVAILABLE.DEPRECATED. |
| AvailableUpgradeTarget | Array of String | List of versions to which this database version (DBKernelVersion) can be upgraded, including minor and major version numbers available for upgrade (complete kernel version format example: v15.1_v1.6). |
Database Xlog information
Used by actions: DescribeDBXlogs.
| Name | Type | Description |
|---|---|---|
| Id | Integer | Unique backup file ID |
| StartTime | Timestamp | File generation start time |
| EndTime | Timestamp | File generation end time |
| InternalAddr | String | Download address on private network |
| ExternalAddr | String | Download address on public network |
| Size | Integer | Backup file size |
AZ information such as number and status
Used by actions: DescribeZones.
| Name | Type | Description |
|---|---|---|
| Zone | String | AZ abbreviation |
| ZoneName | String | AZ name |
| ZoneId | Integer | AZ number |
| ZoneState | String | Availability status. Valid values:UNAVAILABLE.AVAILABLE.SELLOUT.SUPPORTMODIFYONLY (supports configuration adjustment). |
| ZoneSupportIpv6 | Integer | Whether the AZ supports IPv6 address access |
| StandbyZoneSet | Array of String | AZs that can be used as standby when this AZ is primary Note: this field may return null, indicating that no valid values can be obtained. |
文档反馈