Features supported by the cluster
Used by actions: DescribeClusterDetail, DescribeClusters.
Name | Type | Required | Description |
---|---|---|---|
IsSupportSlaveZone | String | Yes | Whether secondary AZ is supported |
NonsupportSlaveZoneReason | String | Yes | The reason why secondary AZ is not supported Note: This field may return null, indicating that no valid values can be obtained. |
IsSupportRo | String | Yes | Whether read-only instance is supported |
NonsupportRoReason | String | Yes | The reason why read-only instance is not supported Note: This field may return null, indicating that no valid values can be obtained. |
Database account information
Used by actions: DescribeAccounts.
Name | Type | Description |
---|---|---|
AccountName | String | Database account name |
Description | String | Database account description |
CreateTime | Timestamp | Creation time |
UpdateTime | Timestamp | Update time |
Host | String | Host |
MaxUserConnections | Integer | The max connections |
Database address
Used by actions: DescribeClusterDetail.
Name | Type | Description |
---|---|---|
IP | String | IP address |
Port | Integer | Port |
Filter of rule audit
Used by actions: DescribeAuditRuleWithInstanceIds, ModifyAuditService, OpenAuditService.
Name | Type | Required | Description |
---|---|---|---|
RuleFilters | Array of RuleFilters | Yes | Audit rule |
Details of an audit rule template
Used by actions: DescribeAuditRuleTemplates.
Name | Type | Description |
---|---|---|
RuleTemplateId | String | Rule template ID |
RuleTemplateName | String | Rule template name |
RuleFilters | Array of RuleFilters | Filter of the rule template |
Description | String | Description of a rule template Note: This field may return null, indicating that no valid values can be obtained. |
CreateAt | String | Creation time of a rule template |
Backup file information
Used by actions: DescribeBackupList.
Name | Type | Description |
---|---|---|
SnapshotId | Integer | Snapshot file ID, which is deprecated. You need to use BackupId . |
FileName | String | Backup file name |
FileSize | Integer | Backup file size |
StartTime | String | Backup start time |
FinishTime | String | Backup end time |
BackupType | String | Backup type. Valid values: snapshot (snapshot backup), logic (logic backup). |
BackupMethod | String | Back mode. auto: auto backup; manual: manual backup |
BackupStatus | String | Backup file status. success: backup succeeded; fail: backup failed; creating: creating backup file; deleting: deleting backup file |
SnapshotTime | String | Backup file time |
BackupId | Integer | Backup ID Note: This field may return null, indicating that no valid values can be obtained. |
SnapShotType | String | |
BackupName | String | Backup file alias Note: This field may return null, indicating that no valid values can be obtained. |
Billable resource information
Used by actions: DescribeResourcesByDealName.
Name | Type | Description |
---|---|---|
ClusterId | String | Cluster ID |
InstanceIds | Array of String | Instance ID list |
DealName | String | Order ID |
Information of the instance bound to the resource pack
Used by actions: DescribeResourcePackageList.
Name | Type | Description |
---|---|---|
InstanceId | String | ID of the bound cluster Note: This field may return null, indicating that no valid values can be obtained. |
InstanceRegion | String | Region of the instance bound Note: This field may return null, indicating that no valid values can be obtained. |
InstanceType | String | Type of the instance bound Note: This field may return null, indicating that no valid values can be obtained. |
ExtendIds | Array of String | ID of the instance in the bound cluster Note: This field may return null, indicating that no valid values can be obtained. |
Binlog description
Used by actions: DescribeBinlogs.
Name | Type | Description |
---|---|---|
FileName | String | Binlog filename |
FileSize | Integer | File size in bytes |
StartTime | String | Transaction start time |
FinishTime | String | Transaction end time |
BinlogId | Integer | Binlog file ID |
Cluster instance information
Used by actions: DescribeClusterDetail.
Name | Type | Description |
---|---|---|
InstanceId | String | Instance ID |
InstanceName | String | Instance name |
InstanceType | String | Engine type |
InstanceStatus | String | Instance status |
InstanceStatusDesc | String | Instance status description |
InstanceCpu | Integer | Number of CPU cores |
InstanceMemory | Integer | Memory |
InstanceStorage | Integer | Disk |
InstanceRole | String | Instance role |
MaintainStartTime | Integer | Execution start time in seconds from 0:00 Note: This field may return null, indicating that no valid values can be obtained. |
MaintainDuration | Integer | Duration in seconds Note: This field may return null, indicating that no valid values can be obtained. |
MaintainWeekDays | Array of String | Execution time. Valid values: Mon , Tue , Wed , Thu , Fri , Sat, Sun`.Note: This field may return null, indicating that no valid values can be obtained. |
ServerlessStatus | String | Serverless instance enablement status Note: This field may return null, indicating that no valid values can be obtained. |
InstanceTasks | Array of ObjectTask | |
InstanceDeviceType | String |
Cluster information
Used by actions: DescribeClusters.
Name | Type | Required | Description |
---|---|---|---|
Status | String | Yes | Cluster status. Valid values are as follows: creating running isolating isolated activating (removing isolation) offlining (deactivating) offlined (deactivated) deleting deleted |
UpdateTime | String | Yes | Update time |
Zone | String | Yes | AZ |
ClusterName | String | Yes | Cluster name |
Region | String | Yes | Region |
DbVersion | String | Yes | Database version |
ClusterId | String | Yes | Cluster ID |
InstanceNum | Integer | Yes | Number of instances |
Uin | String | Yes | User UIN Note: This field may return null, indicating that no valid values can be obtained. |
DbType | String | Yes | Engine type Note: This field may return null, indicating that no valid values can be obtained. |
AppId | Integer | Yes | User appid Note: This field may return null, indicating that no valid values can be obtained. |
StatusDesc | String | Yes | Cluster status description Note: This field may return null, indicating that no valid values can be obtained. |
CreateTime | String | Yes | Cluster creation time Note: This field may return null, indicating that no valid values can be obtained. |
PayMode | Integer | Yes | Billing mode. 0 : Pay-as-you-go; 1 : Monthly subscription.Note: This field may return null, indicating that no valid values can be obtained. |
PeriodEndTime | String | Yes | End time Note: This field may return null, indicating that no valid values can be obtained. |
Vip | String | Yes | Cluster read-write VIP Note: This field may return null, indicating that no valid values can be obtained. |
Vport | Integer | Yes | Cluster read-write vport Note: This field may return null, indicating that no valid values can be obtained. |
ProjectID | Integer | Yes | 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. |
CynosVersion | String | No | TDSQL-C kernel version Note: This field may return null, indicating that no valid values can be obtained. |
StorageLimit | Integer | No | Storage capacity Note: This field may return null, indicating that no valid values can be obtained. |
RenewFlag | Integer | No | Renewal flag Note: This field may return null, indicating that no valid values can be obtained. |
ProcessingTask | String | No | Task in progress Note: This field may return null, indicating that no valid values can be obtained. |
Tasks | Array of ObjectTask | No | Array of tasks in the cluster Note: This field may return null, indicating that no valid values can be obtained. |
ResourceTags | Array of Tag | No | Array of tags bound to the cluster Note: This field may return null, indicating that no valid values can be obtained. |
DbMode | String | No | Database type. Valid values: NORMAL , SERVERLESS .Note: This field may return null, indicating that no valid values can be obtained. |
ServerlessStatus | String | No | Serverless cluster status when the database type is SERVERLESS . Valid values:resume pause Note: This field may return null, indicating that no valid values can be obtained. |
Storage | Integer | No | Prepaid cluster storage capacity Note: This field may return null, indicating that no valid values can be obtained. |
StorageId | String | No | Cluster storage ID used in prepaid storage modification Note: This field may return null, indicating that no valid values can be obtained. |
StoragePayMode | Integer | No | Billing mode of cluster storage. Valid values: 0 (pay-as-you-go), 1 (monthly subscription).Note: This field may return null, indicating that no valid values can be obtained. |
MinStorageSize | Integer | No | The minimum storage corresponding to the compute specification of the cluster Note: This field may return null, indicating that no valid values can be obtained. |
MaxStorageSize | Integer | No | The maximum storage corresponding to the compute specification of the cluster Note: This field may return null, indicating that no valid values can be obtained. |
NetAddrs | Array of NetAddr | No | Network information of the cluster Note: This field may return null, indicating that no valid values can be obtained. |
PhysicalZone | String | No | Physical AZ Note: This field may return null, indicating that no valid values can be obtained. |
MasterZone | String | No | Primary AZ Note: This field may return null, indicating that no valid values can be obtained. |
HasSlaveZone | String | No | Whether there is a secondary AZ Note: This field may return null, indicating that no valid values can be obtained. |
SlaveZones | Array of String | No | Secondary AZ Note: This field may return null, indicating that no valid values can be obtained. |
BusinessType | String | No | Business type Note: This field may return null, indicating that no valid values can be obtained. |
IsFreeze | String | No | Whether to freeze Note: This field may return null, indicating that no valid values can be obtained. |
OrderSource | String | No | Order source Note: This field may return null, indicating that no valid values can be obtained. |
Ability | Ability | No | Capability Note: This field may return null, indicating that no valid values can be obtained. |
ResourcePackages | Array of ResourcePackage | No | Information of the resource pack bound to an instance when packageType is DISK . Note: This field may return null, indicating that no valid values can be obtained. |
Cluster details
Used by actions: DescribeClusterDetail.
Name | Type | Description |
---|---|---|
ClusterId | String | Cluster ID |
ClusterName | String | Cluster name |
Region | String | Region |
Zone | String | AZ |
PhysicalZone | String | Physical AZ Note: This field may return null, indicating that no valid values can be obtained. |
Status | String | Status |
StatusDesc | String | Status description |
ServerlessStatus | String | Serverless cluster status when the database type is SERVERLESS . Valid values:resume resuming pause pausing |
StorageId | String | Storage ID Note: This field may return null, indicating that no valid values can be obtained. |
Storage | Integer | Storage capacity in GB Note: This field may return null, indicating that no valid values can be obtained. |
MaxStorageSize | Integer | Maximum storage specification in GB Note: This field may return null, indicating that no valid values can be obtained. |
MinStorageSize | Integer | Minimum storage specification in GB Note: This field may return null, indicating that no valid values can be obtained. |
StoragePayMode | Integer | Storage billing mode. Valid values: 1 (monthly subscription), 0 (pay-as-you-go).Note: This field may return null, indicating that no valid values can be obtained. |
VpcName | String | VPC name |
VpcId | String | Unique VPC ID |
SubnetName | String | Subnet name |
SubnetId | String | Subnet ID |
Charset | String | Character set |
CreateTime | String | Creation time |
DbType | String | Database type |
DbMode | String | Database type. Valid values: normal , serverless .Note: This field may return null, indicating that no valid values can be obtained. |
DbVersion | String | Database version |
StorageLimit | Integer | Maximum storage space Note: This field may return null, indicating that no valid values can be obtained. |
UsedStorage | Integer | Used capacity |
Vip | String | VIP |
Vport | Integer | vport |
RoAddr | Array of Addr | VIP and vport of the read-only instance in a cluster |
Ability | Ability | Features supported by the cluster Note: This field may return null, indicating that no valid values can be obtained. |
CynosVersion | String | TDSQL-C version Note: This field may return null, indicating that no valid values can be obtained. |
BusinessType | String | Business type Note: This field may return null, indicating that no valid values can be obtained. |
HasSlaveZone | String | Whether there is a secondary AZ Note: This field may return null, indicating that no valid values can be obtained. |
IsFreeze | String | Whether to freeze Note: This field may return null, indicating that no valid values can be obtained. |
Tasks | Array of ObjectTask | Task list Note: This field may return null, indicating that no valid values can be obtained. |
MasterZone | String | Primary AZ Note: This field may return null, indicating that no valid values can be obtained. |
SlaveZones | Array of String | Secondary AZ list Note: This field may return null, indicating that no valid values can be obtained. |
InstanceSet | Array of ClusterInstanceDetail | Instance information |
PayMode | Integer | Billing mode |
PeriodEndTime | String | Expiration time |
ProjectID | Integer | Project ID |
ResourceTags | Array of Tag | Array of tags bound to instance |
ProxyStatus | String | Proxy status Note: This field may return null, indicating that no valid values can be obtained. |
LogBin | String | Binlog switch. Valid values: ON , OFF .Note: This field may return null, indicating that no valid values can be obtained. |
IsSkipTrade | String | Whether to skip the transaction Note: This field may return null, indicating that no valid values can be obtained. |
PitrType | String | PITR type. Valid values: normal , redo_pitr .Note: This field may return null, indicating that no valid values can be obtained. |
IsOpenPasswordComplexity | String | Whether to enable password complexity Note: This field may return null, indicating that no valid values can be obtained. |
NetworkStatus | String | Network type Note: This field may return null, indicating that no valid values can be obtained. |
ResourcePackages | Array of ResourcePackage | Information of the resource pack bound to a cluster Note: This field may return null, indicating that no valid values can be obtained. |
RenewFlag | Integer | The auto-renewal flag. Valid values: 0 : (manual renewal, default), 1 (auto-renewal). Note: This field may return null, indicating that no valid values can be obtained. |
NetworkType | String | |
SlaveZoneAttr | Array of SlaveZoneAttrItem |
Types of the returned error logs for an instance
Used by actions: DescribeInstanceErrorLogs.
Name | Type | Description |
---|---|---|
Timestamp | Integer | Log timestamp Note: This field may return null, indicating that no valid values can be obtained. |
Level | String | Log level Note: This field may return null, indicating that no valid values can be obtained. |
Content | String | Log content Note: This field may return null, indicating that no valid values can be obtained. |
Instance information
Used by actions: DescribeClusterInstanceGrps, DescribeInstances.
Name | Type | Description |
---|---|---|
Uin | String | User Uin |
AppId | Integer | User AppId |
ClusterId | String | Cluster ID |
ClusterName | String | Cluster name |
InstanceId | String | Instance ID |
InstanceName | String | Instance name |
ProjectId | Integer | Project ID |
Region | String | Region |
Zone | String | AZ |
Status | String | Instance status |
StatusDesc | String | Instance status description |
DbMode | String | Instance type, which is used to indicate whether it is a serverless instance. |
DbType | String | Database type |
DbVersion | String | Database version |
Cpu | Integer | Number of CPU cores |
Memory | Integer | Memory in GB |
Storage | Integer | Storage capacity in GB |
InstanceType | String | Instance type |
InstanceRole | String | Current instance role |
UpdateTime | Timestamp | Update time |
CreateTime | Timestamp | Creation time |
VpcId | String | VPC ID |
SubnetId | String | Subnet ID |
Vip | String | Private IP of instance |
Vport | Integer | Private port of instance |
PayMode | Integer | Billing mode |
PeriodEndTime | Timestamp | Instance expiration time |
DestroyDeadlineText | String | Termination deadline |
IsolateTime | Timestamp | Isolation time |
NetType | Integer | Network type |
WanDomain | String | Public domain name |
WanIP | String | Public IP |
WanPort | Integer | Public port |
WanStatus | String | Public network status |
DestroyTime | String | Instance termination time |
CynosVersion | String | TDSQL-C kernel version |
ProcessingTask | String | Task in progress |
RenewFlag | Integer | Renewal flag |
MinCpu | Float | Minimum number of CPU cores for serverless instance |
MaxCpu | Float | Maximum number of CPU cores for serverless instance |
ServerlessStatus | String | Serverless instance status. Valid values: resume pause |
StorageId | String | Prepaid storage ID Note: this field may return null , indicating that no valid value can be obtained. |
StoragePayMode | Integer | Storage billing mode |
PhysicalZone | String | Physical zone |
BusinessType | String | Business type Note: This field may return null, indicating that no valid value can be obtained. |
Tasks | Array of ObjectTask | Task Note: This field may return null, indicating that no valid values can be obtained. |
IsFreeze | String | Whether to freeze Note: This field may return null, indicating that no valid values can be obtained. |
ResourceTags | Array of Tag | The resource tag Note: This field may return null, indicating that no valid values can be obtained. |
MasterZone | String | Source AZ Note: This field may return null, indicating that no valid value can be obtained. |
SlaveZones | Array of String | Replica AZ Note: This field may return null, indicating that no valid value can be obtained. |
InstanceNetInfo | Array of InstanceNetInfo | Instance network information Note: This field may return null, indicating that no valid value can be obtained. |
ResourcePackages | Array of ResourcePackage | Information of the resource pack bound to an instance when packageType is CCU . Note: This field may return null, indicating that no valid values can be obtained. |
Instance details
Used by actions: DescribeInstanceDetail.
Name | Type | Description |
---|---|---|
Uin | String | User Uin |
AppId | Integer | User AppId |
ClusterId | String | Cluster ID |
ClusterName | String | Cluster name |
InstanceId | String | Instance ID |
InstanceName | String | Instance name |
ProjectId | Integer | Project ID |
Region | String | Region |
Zone | String | AZ |
Status | String | Instance status |
StatusDesc | String | Instance status description |
DbType | String | Database type |
DbVersion | String | Database version |
Cpu | Integer | Number of CPU cores |
Memory | Integer | Memory in GB |
Storage | Integer | Storage capacity in GB |
InstanceType | String | Instance type |
InstanceRole | String | Current instance role |
UpdateTime | Timestamp | Update time |
CreateTime | Timestamp | Creation time |
PayMode | Integer | Billing mode |
PeriodEndTime | Timestamp | Instance expiration time |
NetType | Integer | Network type |
VpcId | String | VPC ID |
SubnetId | String | Subnet ID |
Vip | String | Private IP of instance |
Vport | Integer | Private port of instance |
WanDomain | String | Public domain name of instance |
Charset | String | Character set |
CynosVersion | String | TDSQL-C kernel version |
RenewFlag | Integer | Renewal flag |
MinCpu | Float | The minimum number of CPU cores for a serverless instance |
MaxCpu | Float | The maximum number of CPU cores for a serverless instance |
ServerlessStatus | String | Serverless instance status. Valid values: resume pause |
Instance group information
Used by actions: DescribeClusterInstanceGrps.
Name | Type | Description |
---|---|---|
AppId | Integer | User appId |
ClusterId | String | Cluster ID |
CreatedTime | Timestamp | Creation time |
DeletedTime | Timestamp | Deletion time |
InstanceGrpId | String | Instance group ID |
Status | String | Status |
Type | String | Instance group type. ha: HA group; ro: RO group |
UpdatedTime | Timestamp | Update time |
Vip | String | Private IP |
Vport | Integer | Private port |
WanDomain | String | Public domain name |
WanIP | String | Public IP |
WanPort | Integer | Public port |
WanStatus | String | Public network status |
InstanceSet | Array of CynosdbInstance | Information of instances contained in instance group |
UniqVpcId | String | VPC ID Note: This field may return null, indicating that no valid values can be obtained. |
UniqSubnetId | String | Subnet ID Note: This field may return null, indicating that no valid values can be obtained. |
OldAddrInfo | OldAddrInfo | Information of the old IP Note: This field may return null, indicating that no valid values can be obtained. |
ProcessingTasks | Array of String | Task in progress |
Tasks | Array of ObjectTask | Task list |
NetServiceId | Integer | biz_net_service table ID |
Database permission list
Used by actions: ModifyAccountPrivileges.
Name | Type | Required | Description |
---|---|---|---|
Db | String | Yes | Database |
Privileges | Array of String | Yes | Permission list |
Database table information
Used by actions: CreateBackup, SearchClusterTables.
Name | Type | Required | Description |
---|---|---|---|
Database | String | No | Database name Note: This field may return null, indicating that no valid values can be obtained. |
Tables | Array of String | No | Table name list Note: This field may return null, indicating that no valid values can be obtained. |
Database details
Used by actions: DescribeClusterDetailDatabases.
Name | Type | Description |
---|---|---|
DbName | String | Database name |
CharacterSet | String | Character set |
Status | String | Database status |
CollateRule | String | Collation |
Description | String | Database remarks Note: This field may return null, indicating that no valid values can be obtained. |
UserHostPrivileges | Array of UserHostPrivilege | User permissions Note: This field may return null, indicating that no valid values can be obtained. |
DbId | Integer | Database ID Note: This field may return null, indicating that no valid values can be obtained. |
CreateTime | Timestamp ISO8601 | Creation time Note: This field may return null, indicating that no valid values can be obtained. |
UpdateTime | Timestamp ISO8601 | Update time Note: This field may return null, indicating that no valid values can be obtained. |
AppId | Integer | User appid Note: This field may return null, indicating that no valid values can be obtained. |
Uin | String | User Uin Note: This field may return null, indicating that no valid values can be obtained. |
ClusterId | String | Cluster ID Note: This field may return null, indicating that no valid values can be obtained. |
The export format for an error log
Used by actions: ExportInstanceErrorLogs.
Name | Type | Required | Description |
---|---|---|---|
Timestamp | String | No | Time Note: This field may return null, indicating that no valid values can be obtained. |
Level | String | No | Log level. Valid values: error , warning , note . Note: This field may return null, indicating that no valid values can be obtained. |
Content | String | No | Log content Note: This field may return null, indicating that no valid values can be obtained. |
Account. Valid values: accountName
, host
.
Used by actions: DeleteAccounts, ModifyAccountHost, ModifyAccountPrivileges.
Name | Type | Required | Description |
---|---|---|---|
AccountName | String | Yes | Account |
Host | String | No | Host. Default value: % |
Audit rule details of the instance, which is an output parameter of the DescribeAuditRuleWithInstanceIds
API.
Used by actions: DescribeAuditRuleWithInstanceIds.
Name | Type | Description |
---|---|---|
InstanceId | String | Instance ID. |
AuditRule | Boolean | Whether the audit is rule audit. Valid values: true (rule audit), false (full audit).Note: This field may return null, indicating that no valid values can be obtained. |
AuditRuleFilters | Array of AuditRuleFilters | Audit rule details, which is valid only when AuditRule is true .Note: This field may return null, indicating that no valid values can be obtained. |
Instance initialization configuration information
Used by actions: CreateClusters.
Name | Type | Required | Description |
---|---|---|---|
Cpu | Integer | Yes | Instance CPU |
Memory | Integer | Yes | Instance memory |
InstanceType | String | Yes | Instance type. Valid values:rw , ro . |
InstanceCount | Integer | Yes | Number of the instances. Value range: 1-15. |
MinRoCount | Integer | No | Minimum number of serverless instances. Value range: 1-15. |
MaxRoCount | Integer | No | Maximum number of serverless instances. Value range: 1-15. |
MinRoCpu | Float | No | Minimum specifications for serverless instance |
MaxRoCpu | Float | No | Maximum specifications for serverless instance |
Instance network information
Used by actions: DescribeInstances.
Name | Type | Description |
---|---|---|
InstanceGroupType | String | Network type Note: This field may return null, indicating that no valid values can be obtained. |
InstanceGroupId | String | Instance group ID Note: This field may return null, indicating that no valid values can be obtained. |
VpcId | String | VPC ID Note: This field may return null, indicating that no valid values can be obtained. |
SubnetId | String | Subnet ID Note: This field may return null, indicating that no valid values can be obtained. |
NetType | Integer | Network type Note: This field may return null, indicating that no valid values can be obtained. |
Vip | String | VPC IP Note: This field may return null, indicating that no valid values can be obtained. |
Vport | Integer | VPC port Note: This field may return null, indicating that no valid values can be obtained. |
WanDomain | String | Public network domain name Note: This field may return null, indicating that no valid values can be obtained. |
WanIP | String | |
WanPort | Integer | Public network port Note: This field may return null, indicating that no valid values can be obtained. |
WanStatus | String | Public network status Note: This field may return null, indicating that no valid values can be obtained. |
Instance parameter information
Used by actions: DescribeInstanceParams.
Name | Type | Description |
---|---|---|
InstanceId | String | Instance ID |
ParamsItems | Array of ParamItemDetail | List of instance parameters |
Details of purchasable instance specifications. Cpu
and Memory
determine the instance specification during instance creation. The value range of the storage capacity is [MinStorageSize,MaxStorageSize]
Used by actions: DescribeInstanceSpecs.
Name | Type | Description |
---|---|---|
Cpu | Integer | Number of instance CPU cores |
Memory | Integer | Instance memory in GB |
MaxStorageSize | Integer | Maximum instance storage capacity GB |
MinStorageSize | Integer | Minimum instance storage capacity GB |
HasStock | Boolean | Whether there is an inventory. |
MachineType | String | Machine type |
MaxIops | Integer | Maximum IOPS |
MaxIoBandWidth | Integer | Maximum bandwidth |
ZoneStockInfos | Array of ZoneStockInfo | Inventory information in a region Note: This field may return null, indicating that no valid values can be obtained. |
StockCount | Integer | Quantity in stock Note: This field may return null, indicating that no valid values can be obtained. |
Details of whether the parameter can be modified
Used by actions: DescribeClusterParams, DescribeClusterPasswordComplexity, DescribeParamTemplateDetail.
Name | Type | Description |
---|
Information of the modified instance parameter
Used by actions: AddInstances, ModifyInstanceParam, ModifyParamTemplate.
Name | Type | Required | Description |
---|---|---|---|
ParamName | String | Yes | Parameter name |
CurrentValue | String | Yes | Current parameter value |
OldValue | String | No | Old parameter value, which is used only in output parameters. Note: This field may return null, indicating that no valid values can be obtained. |
Modules supported by the system
Used by actions: DescribeZones.
Name | Type | Description |
---|---|---|
IsDisable | String | Whether it is supported. Valid values: yes , no . |
ModuleName | String | Module name |
Network information
Used by actions: DescribeClusters, DescribeProxies.
Name | Type | Description |
---|---|---|
Vip | String | Private network IP Note: this field may return null , indicating that no valid values can be obtained. |
Vport | Integer | Private network port number Note: this field may return null , indicating that no valid values can be obtained. |
WanDomain | String | Public network domain name Note: this field may return null , indicating that no valid values can be obtained. |
WanPort | Integer | Public network port number Note: this field may return null , indicating that no valid values can be obtained. |
NetType | String | Network type. Valid values: ro (read-only), rw or ha (read-write)Note: this field may return null , indicating that no valid values can be obtained. |
UniqSubnetId | String | Subnet ID Note: This field may return null, indicating that no valid values can be obtained. |
UniqVpcId | String | VPC ID Note: This field may return null, indicating that no valid values can be obtained. |
Description | String | Description Note: This field may return null, indicating that no valid values can be obtained. |
WanIP | String | Public IP Note: This field may return null, indicating that no valid values can be obtained. |
WanStatus | String | Public network status Note: This field may return null, indicating that no valid values can be obtained. |
InstanceGroupId | String | Instance group ID Note: This field may return null, indicating that no valid values can be obtained. |
The newly created x08 account
Used by actions: CreateAccounts.
Name | Type | Required | Description |
---|---|---|---|
AccountName | String | Yes | Account name, which can contain 1-16 letters, digits, and underscores. It must begin with a letter and end with a letter or digit. |
AccountPassword | String | Yes | Password, which can contain 8-64 characters. |
Host | String | Yes | Host |
Description | String | No | Description |
MaxUserConnections | Integer | No | Maximum number of user connections, which cannot be above 10,240. |
Task information
Used by actions: DescribeClusterDetail, DescribeClusterInstanceGrps, DescribeClusters, DescribeInstances, DescribeProxies.
Name | Type | Required | Description |
---|---|---|---|
TaskId | Integer | No | Auto-Incrementing task ID Note: this field may return null, indicating that no valid values can be obtained. |
TaskType | String | No | Task type Note: this field may return null, indicating that no valid values can be obtained. |
TaskStatus | String | No | Task status Note: this field may return null, indicating that no valid values can be obtained. |
ObjectId | String | No | Task ID (cluster ID | instance group ID | instance ID) Note: this field may return null, indicating that no valid values can be obtained. |
ObjectType | String | No | Task type Note: this field may return null, indicating that no valid values can be obtained. |
Database address
Used by actions: DescribeClusterInstanceGrps.
Name | Type | Description |
---|---|---|
Vip | String | IP Note: This field may return null, indicating that no valid values can be obtained. |
Vport | Integer | Port Note: This field may return null, indicating that no valid values can be obtained. |
ReturnTime | String | Expected valid hours of old IPs Note: This field may return null, indicating that no valid values can be obtained. |
Resource pack
Used by actions: DescribeResourcePackageList.
Name | Type | Description |
---|---|---|
AppId | Integer | AppID Note: This field may return null, indicating that no valid values can be obtained. |
PackageId | String | The unique ID of a resource pack Note: This field may return null, indicating that no valid values can be obtained. |
PackageName | String | Resource pack name Note: This field may return null, indicating that no valid values can be obtained. |
PackageType | String | Resource pack type. Valid values: CCU (compute resource pack), DISK (storage resource pack). Note: This field may return null, indicating that no valid values can be obtained. |
PackageRegion | String | Region of the resource pack. Valid values: China (Chinese mainland), overseas (outside Chinese mainland). Note: This field may return null, indicating that no valid values can be obtained. |
Status | String | Resource pack status. Valid values: creating , using , expired , normal_finish (used up), apply_refund (requesting a refund), refund (refunded). Note: This field may return null, indicating that no valid values can be obtained. |
PackageTotalSpec | Float | Total number of resource packs Note: This field may return null, indicating that no valid values can be obtained. |
PackageUsedSpec | Float | Consumed usage of resource packs Note: This field may return null, indicating that no valid values can be obtained. |
HasQuota | Boolean | Remaining usage of resource packs Note: This field may return null, indicating that no valid values can be obtained. |
BindInstanceInfos | Array of BindInstanceInfo | Information of the instance bound Note: This field may return null, indicating that no valid values can be obtained. |
StartTime | String | Validity time: 2022-07-01 00:00:00 Note: This field may return null, indicating that no valid values can be obtained. |
ExpireTime | String | Validity time: 2022-08-01 00:00:00 Note: This field may return null, indicating that no valid values can be obtained. |
Resource pack details
Used by actions: DescribeResourcePackageDetail.
Name | Type | Description |
---|---|---|
AppId | Integer | Account ID of AppId Note: This field may return null, indicating that no valid values can be obtained. |
PackageId | String | The unique ID of a resource pack Note: This field may return null, indicating that no valid values can be obtained. |
InstanceId | String | Instance ID Note: This field may return null, indicating that no valid values can be obtained. |
SuccessDeductSpec | Float | The successfully deducted capacity Note: This field may return null, indicating that no valid values can be obtained. |
PackageTotalUsedSpec | Float | Used capacity of a resource pack as of now Note: This field may return null, indicating that no valid values can be obtained. |
StartTime | String | Deduction start time Note: This field may return null, indicating that no valid values can be obtained. |
EndTime | String | Deduction end time Note: This field may return null, indicating that no valid values can be obtained. |
ExtendInfo | String | Extended information Note: This field may return null, indicating that no valid values can be obtained. |
Instance parameter details
Used by actions: DescribeParamTemplateDetail.
Name | Type | Description |
---|---|---|
ParamName | String | Parameter name |
ParamType | String | Parameter type. Valid values: integer , enum , float , string , func . |
SupportFunc | Boolean | Whether func is supported. Valid values: true (supported), false (not supported). |
Default | String | Default value |
Description | String | Parameter description |
CurrentValue | String | Current value of the parameter |
NeedReboot | Integer | Whether to restart the database for the modified parameters to take effect. Valid values: 0 (no), 1 (yes). |
Max | String | Maximum value of the parameter |
Min | String | Minimum value of the parameter |
EnumValue | Array of String | Enumerated values of the parameter. It is null if the parameter is non-enumerated. Note: This field may return null, indicating that no valid values can be obtained. |
IsGlobal | Integer | Valid values: 1 (global parameter), 0 (non-global parameter). |
MatchType | String | The match type. Valid value: multiVal . |
MatchValue | String | Match values, which will be separated by comma when MatchType is multiVal . |
IsFunc | Boolean | Whether it is a func type. Valid values: true (yes), false (no). Note: This field may return null, indicating that no valid values can be obtained. |
Func | String | Formula content returned when ParamType is func . Note: This field may return null, indicating that no valid values can be obtained. |
ModifiableInfo | ModifiableInfo | Whether the parameter can be modified Note: This field may return null, indicating that no valid values can be obtained. |
Parameter information
Used by actions: DescribeClusterParams, DescribeClusterPasswordComplexity.
Name | Type | Description |
---|---|---|
CurrentValue | String | Current value |
Default | String | Default value |
EnumValue | Array of String | List of valid values when parameter type is enum , string or bool .Note: This field may return null, indicating that no valid values can be obtained. |
Max | String | Maximum value when parameter type is float or integer . |
Min | String | Minimum value when parameter type is float or integer . |
ParamName | String | Parameter name |
NeedReboot | Integer | Whether to restart the instance for the modified parameters to take effect. |
ParamType | String | Parameter type: integer , float , string , enum , bool . |
MatchType | String | Match type. Regex can be used when parameter type is string . Valid value: multiVal . |
MatchValue | String | Match values, which will be separated by semicolon when match type is multiVal . |
Description | String | Parameter description |
IsGlobal | Integer | Whether it is global parameter Note: This field may return null, indicating that no valid values can be obtained. |
ModifiableInfo | ModifiableInfo | Whether the parameter can be modified Note: This field may return null, indicating that no valid values can be obtained. |
IsFunc | Boolean | Whether it is a function Note: This field may return null, indicating that no valid values can be obtained. |
Func | String | Function Note: This field may return null, indicating that no valid values can be obtained. |
Parameter to be modified
Used by actions: CreateClusters, CreateParamTemplate, ModifyClusterParam.
Name | Type | Required | Description |
---|---|---|---|
ParamName | String | Yes | Parameter name |
CurrentValue | String | Yes | New value |
OldValue | String | Yes | Original value |
Instance parameter information
Used by actions: DescribeInstanceParams.
Name | Type | Description |
---|---|---|
CurrentValue | String | Current value |
Default | String | Default value |
EnumValue | Array of String | Enumerated values of the parameter It is null if the parameter is non-enumerated. |
IsGlobal | Integer | Valid values: 1 (global parameter), 0 (non-global parameter). |
Max | String | Maximum value |
Min | String | Minimum value |
NeedReboot | Integer | Whether to restart the database for the modified parameters to take effect. Valid values: 0 (no), 1 (yes) |
ParamName | String | Parameter name |
ParamType | String | Parameter type. Valid values: integer , enum , float , string , func . |
Description | String | Parameter description |
IsFunc | Boolean | Whether ParamType is a func Note: This field may return null, indicating that no valid values can be obtained. |
Func | String | Parameter configuration formula Note: This field may return null, indicating that no valid values can be obtained. |
Parameter template information
Used by actions: DescribeParamTemplates.
Name | Type | Description |
---|---|---|
Id | Integer | Parameter template ID |
TemplateName | String | Parameter template name |
TemplateDescription | String | Parameter template description |
EngineVersion | String | Engine version |
DbMode | String | Database Type. Valid values: NORMAL , SERVERLESS . |
ParamInfoSet | Array of TemplateParamInfo | Parameter template details Note: This field may return null, indicating that no valid values can be obtained. |
Security group rule
Used by actions: DescribeDBSecurityGroups, DescribeProjectSecurityGroups.
Name | Type | Description |
---|---|---|
Action | String | Policy, which can be ACCEPT or DROP |
CidrIp | String | Source IP or source IP range, such as 192.168.0.0/16 |
PortRange | String | Port |
IpProtocol | String | Network protocol, such as UDP and TCP |
ServiceModule | String | Protocol port ID or protocol port group ID. |
AddressModule | String | IP address ID or IP address group ID. |
Id | String | id |
Desc | String | Description |
Connection pool information for the database proxy
Used by actions: DescribeProxies.
Name | Type | Required | Description |
---|---|---|---|
ConnectionPoolTimeOut | Integer | Yes | Connection persistence timeout in seconds Note: This field may return null, indicating that no valid values can be obtained. |
OpenConnectionPool | String | No | Whether the connection pool is enabled Note: This field may return null, indicating that no valid values can be obtained. |
ConnectionPoolType | String | No | Connection pool type. Valid value: SessionConnectionPool (session-level).Note: This field may return null, indicating that no valid values can be obtained. |
Proxy group
Used by actions: DescribeProxies.
Name | Type | Description |
---|---|---|
ProxyGroupId | String | Database proxy group ID |
ProxyNodeCount | Integer | Number of nodes in the proxy group |
Status | String | Database proxy group status |
Region | String | Region |
Zone | String | AZ |
CurrentProxyVersion | String | Current proxy version |
ClusterId | String | Cluster ID Note: This field may return null, indicating that no valid values can be obtained. |
AppId | Integer | User AppId Note: This field may return null, indicating that no valid values can be obtained. |
OpenRw | String | Enabling read/write separation for database proxy Note: This field may return null, indicating that no valid values can be obtained. |
Database proxy group details
Used by actions: DescribeProxies.
Name | Type | Description |
---|---|---|
ProxyGroup | ProxyGroup | Database proxy group Note: This field may return null, indicating that no valid values can be obtained. |
ProxyGroupRwInfo | ProxyGroupRwInfo | Read/write separation information of the database proxy group Note: This field may return null, indicating that no valid values can be obtained. |
ProxyNodes | Array of ProxyNodeInfo | Node information of the database proxy Note: This field may return null, indicating that no valid values can be obtained. |
ConnectionPool | ProxyConnectionPoolInfo | Connection pool information for the database proxy Note: This field may return null, indicating that no valid values can be obtained. |
NetAddrInfos | Array of NetAddr | Network information for database proxy Note: This field may return null, indicating that no valid values can be obtained. |
Tasks | Array of ObjectTask | Task set of the database proxy Note: This field may return null, indicating that no valid values can be obtained. |
Read/write separation information of the database proxy group
Used by actions: DescribeProxies.
Name | Type | Required | Description |
---|---|---|---|
ConsistencyType | String | No | Consistency type. Valid values: eventual (eventual consistency), session (session consistency), global (global consistency). |
ConsistencyTimeOut | Integer | No | Consistency timeout period |
WeightMode | String | No | Weight mode. Valid values: system (auto-assigned), custom . |
FailOver | String | No | Whether to enable failover |
AutoAddRo | String | No | Whether to automatically add read-only instance. Valid value: yes , no . |
InstanceWeights | Array of ProxyInstanceWeight | No | Instance weight array |
OpenRw | String | No | Whether to enable read-write node. Valid values: yes , no .Note: This field may return null, indicating that no valid values can be obtained. |
RwType | String | No | Read/write attribute. Valid values: READWRITE , READONLY . |
TransSplit | Boolean | No | Transaction split |
AccessMode | String | No | Connection mode. Valid values: balance , nearby . |
Weight ratio between read-write instances and read-only instances
Used by actions: CreateProxyEndPoint, DescribeProxies, ModifyProxyRwSplit.
Name | Type | Required | Description |
---|---|---|---|
InstanceId | String | Yes | InstanID |
Weight | Integer | Yes | Instance weight |
Node in the database proxy group
Used by actions: DescribeProxies, DescribeProxyNodes.
Name | Type | Description |
---|---|---|
ProxyNodeId | String | Database proxy node ID |
ProxyNodeConnections | Integer | Current node connections, which is not returned by the DescribeProxyNodes API. |
Cpu | Integer | CPU of the database proxy node |
Mem | Integer | Memory of the database proxy node |
Status | String | Status of the database proxy node |
ProxyGroupId | String | Database proxy group ID |
ClusterId | String | Cluster ID |
AppId | Integer | User AppID |
Region | String | Region |
Zone | String | AZ |
Database proxy specifications
Used by actions: DescribeProxySpecs.
Name | Type | Description |
---|---|---|
Cpu | Integer | Number of database proxy CPU cores |
Mem | Integer | Database proxy memory |
Number of proxy nodes and their AZs
Used by actions: CreateProxy, UpgradeProxy.
Name | Type | Required | Description |
---|---|---|---|
ProxyNodeZone | String | No | AZ of the proxy node |
ProxyNodeCount | Integer | No | The number of proxy nodes |
Query filter
Used by actions: DescribeClusters, DescribeInstances, DescribeProxyNodes.
Name | Type | Required | Description |
---|---|---|---|
Names | Array of String | Yes | Search field. Valid values: "InstanceId", "ProjectId", "InstanceName", "Vip" |
Values | Array of String | Yes | Search string |
ExactMatch | Boolean | No | Whether to use exact match |
Name | String | No | Search field |
Operator | String | No | Operator |
Filters for query
Used by actions: DescribeProxies.
Name | Type | Required | Description |
---|---|---|---|
Names | Array of String | Yes | Search field. Valid values: "InstanceId", "ProjectId", "InstanceName", "Vip" |
Values | Array of String | Yes | Search string |
ExactMatch | Boolean | No | Whether to use exact match |
Information of a resource pack
Used by actions: DescribeClusterDetail, DescribeClusters, DescribeInstances.
Name | Type | Required | Description |
---|---|---|---|
PackageId | String | No | The unique ID of a resource pack Note: This field may return null, indicating that no valid values can be obtained. |
PackageType | String | No | Resource pack type. Valid values: CCU (compute resource pack), DISK (storage resource pack). Note: This field may return null, indicating that no valid values can be obtained. |
Rollback time range
Used by actions: DescribeRollbackTimeRange.
Name | Type | Description |
---|---|---|
TimeRangeStart | String | Start time |
TimeRangeEnd | String | End time |
Filter of the audit rule
Used by actions: CreateAuditRuleTemplate, DescribeAuditRuleTemplates, DescribeAuditRuleWithInstanceIds, ModifyAuditRuleTemplates, ModifyAuditService, OpenAuditService.
Name | Type | Required | Description |
---|---|---|---|
Type | String | Yes | Filter parameter name of the audit rule. Valid values: host (client IP), user (database account), dbName (database name), sqlType (SQL type), sql (SQL statement). |
Compare | String | Yes | Filter match type of the audit rule. Valid values: INC (including), EXC (excluding), EQS (equal to), NEQ (not equal to). |
Value | Array of String | Yes | Filter match value of the audit rule |
Resource pack details
Used by actions: DescribeResourcePackageSaleSpec.
Name | Type | Description |
---|---|---|
PackageRegion | String | Region of the resource pack Note: This field may return null, indicating that no valid values can be obtained. |
PackageType | String | Resource pack type. Valid values: CCU (compute resource pack), DISK (storage resource pack). Note: This field may return null, indicating that no valid values can be obtained. |
PackageVersion | String | Resource pack edition. Valid values: base (basic edition), common (general edition), enterprise (enterprise edition). Note: This field may return null, indicating that no valid values can be obtained. |
MinPackageSpec | Float | Minimum number of resources for the current edition of the resource pack. Unit of the compute resources: pcs. Unit of the storage resources: GB. Note: This field may return null, indicating that no valid values can be obtained. |
MaxPackageSpec | Float | Maximum number of resources for the current edition of the resource pack. Unit of the compute resources: pcs. Unit of the storage resources: GB. Note: This field may return null, indicating that no valid values can be obtained. |
ExpireDay | Integer | Validity period of a resource pack in days Note: This field may return null, indicating that no valid values can be obtained. |
Information of a purchasable region
Used by actions: DescribeZones.
Name | Type | Description |
---|---|---|
Region | String | Region name |
RegionId | Integer | Numeric ID of a region |
RegionZh | String | Region name |
ZoneSet | Array of SaleZone | List of purchasable AZs |
DbType | String | Engine type |
Modules | Array of Module | Supported modules in a region |
Information of a purchasable AZ
Used by actions: DescribeZones.
Name | Type | Description |
---|---|---|
Zone | String | AZ name |
ZoneId | Integer | Numeric ID of an AZ |
ZoneZh | String | AZ name |
IsSupportServerless | Integer | Whether serverless cluster is supported. Valid values: 0 : No1 : Yes |
IsSupportNormal | Integer | Whether standard cluster is supported. Valid values: 0 : No1 : Yes |
PhysicalZone | String | Physical zone |
HasPermission | Boolean | Whether the user has AZ permission Note: This field may return null, indicating that no valid values can be obtained. |
IsWholeRdmaZone | String | Whether it is a full-linkage RDMA AZ. |
Security group details
Used by actions: DescribeDBSecurityGroups, DescribeProjectSecurityGroups.
Name | Type | Description |
---|---|---|
ProjectId | Integer | Project ID |
CreateTime | String | Creation time in the format of yyyy-mm-dd hh:mm:ss |
Inbound | Array of PolicyRule | Inbound rule |
Outbound | Array of PolicyRule | Outbound rule |
SecurityGroupId | String | Security group ID |
SecurityGroupName | String | Security group name |
SecurityGroupRemark | String | Security group remarks |
Used by actions: DescribeClusterDetail.
Name | Type | Description |
---|---|---|
Zone | String | |
BinlogSyncWay | String |
Slow query information of the instance
Used by actions: DescribeInstanceSlowQueries.
Name | Type | Description |
---|---|---|
Timestamp | Integer | Execution timestamp |
QueryTime | Float | Execution duration in seconds |
SqlText | String | SQL statement |
UserHost | String | Client host |
UserName | String | Username |
Database | String | Database name |
LockTime | Float | Lock duration in seconds |
RowsExamined | Integer | Number of scanned rows |
RowsSent | Integer | Number of returned rows |
SqlTemplate | String | SQL template |
SqlMd5 | String | MD5 value of the SQL statement |
MySQL table permission
Used by actions: ModifyAccountPrivileges.
Name | Type | Required | Description |
---|---|---|---|
Db | String | Yes | Database name |
TableName | String | Yes | Table name |
Privileges | Array of String | Yes | Permission list |
Information of tags associated with cluster, including TagKey
and TagValue
Used by actions: CreateClusters, DescribeClusterDetail, DescribeClusters, DescribeInstances.
Name | Type | Required | Description |
---|---|---|---|
TagKey | String | Yes | Tag key |
TagValue | String | Yes | Tag value |
Parameter template details
Used by actions: DescribeParamTemplates.
Name | Type | Description |
---|---|---|
CurrentValue | String | Current value |
Default | String | Default value |
EnumValue | Array of String | The collection of valid value types when parameter type is enum .Note: This field may return null, indicating that no valid values can be obtained. |
Max | String | Maximum value when parameter type is float or integer .Note: This field may return null, indicating that no valid values can be obtained. |
Min | String | Minimum value when parameter type is float or integer .Note: This field may return null, indicating that no valid values can be obtained. |
ParamName | String | Parameter name |
NeedReboot | Integer | Whether to restart the instance for the parameter to take effect |
Description | String | Parameter description |
ParamType | String | Parameter type. Valid value: integer , float , string , enum . |
Billing details
Used by actions: InquirePriceCreate, InquirePriceRenew.
Name | Type | Description |
---|---|---|
TotalPrice | Integer | The non-discounted total price of monthly subscribed resources (unit: US cent) Note: This field may return null, indicating that no valid values can be obtained. |
Discount | Float | Total discount. 100 means no discount. |
TotalPriceDiscount | Integer | The discounted total price of monthly subscribed resources (unit: US cent). If a discount is applied, TotalPriceDiscount will be the product of TotalPrice and Discount .Note: This field may return null, indicating that no valid values can be obtained. |
UnitPrice | Integer | The non-discounted unit price of pay-as-you-go resources (unit: US cent) Note: This field may return null, indicating that no valid values can be obtained. |
UnitPriceDiscount | Integer | The discounted unit price of pay-as-you-go resources (unit: US cent). If a discount is applied, UnitPriceDiscount will be the product of UnitPrice and Discount .Note: This field may return null, indicating that no valid values can be obtained. |
ChargeUnit | String | Price unit |
User host permissions
Used by actions: CreateClusterDatabase, DescribeClusterDetailDatabases, ModifyClusterDatabase.
Name | Type | Required | Description |
---|---|---|---|
DbUserName | String | Yes | Authorized user |
DbHost | String | Yes | Client IP Note: This field may return null, indicating that no valid values can be obtained. |
DbPrivilege | String | Yes | User permissions Note: This field may return null, indicating that no valid values can be obtained. |
Inventory information in an AZ
Used by actions: DescribeInstanceSpecs.
Name | Type | Description |
---|---|---|
Zone | String | AZ |
HasStock | Boolean | Whether there is an inventory. |
StockCount | Integer | Quantity in stock |
Was this page helpful?