数据结构

AccountType

String

否

Normal

账号类型，取值范围：

• Super - 高权限账号
• Normal - 普通账号

AccountStatus

String

否

Available

账号状态：取值为：

• Unavailable：不可用。
• Available：可用。

AccountPrivilege

String

是

ReadWrite

授权数据库权限类型，当数据库引擎为 MySQL 时，取值范围：

• ReadWrite：读写权限。
• ReadOnly：只读权限。
• DDLOnly：仅 DDL 权限。
• DMLOnly：仅 DML 权限。
• Custom：自定义权限。

AccountPrivilegeDetail

String

否

SELECT,INSERT,UPDATE

数据库权限字符串，
作为请求参数时，当 AccountPrivilege 为 Custom 时必填，取值：

• SELECT
• INSERT
• UPDATE
• DELETE
• CREATE
• DROP
• REFERENCES
• INDEX
• ALTER
• CREATE TEMPORARY TABLES
• LOCK TABLES
• EXECUTE
• CREATE VIEW
• SHOW VIEW
• CREATE ROUTINE
• ALTER ROUTINE
• EVENT
• TRIGGER
  作为返回结果时，不管 AccountPrivilege 是不是 Custom，都展示 AccountPrivilege 的详细权限。

DNSVisibility

Boolean

否

FALSE

• FALSE：火山引擎私网解析（默认）。
• TRUE：火山引擎私网以及公网解析。

BackupStatus

String

否

Success

备份状态，取值：

• Success：成功。
• Failed：失败。
• Running：执行中。

BackupType

String

否

Full

备份类型，取值：

• Full：全量备份。
• Increment：增量备份。

BackupMethod

String

否

Logical

备份方式，取值：

• Logical：逻辑备份。
• Physical：物理备份。
• Snapshot：快照备份。

DownloadStatus

String

否

NotDownload

下载状态。取值：

• NotDownload：未下载。
• Success：已下载。
• Failed：下载失败。
• Running：下载中。

InstanceStatus

String

否

Running

实例状态，取值：

• Running：运行中。
• Creating：创建中。
• Deleting：删除中。
• Restarting：重启中。
• Restoring：恢复中。
• Updating：变更中。
• Upgrading：升级中。
• Error：错误。

DBEngineVersion

String

否

MySQL_8_0

• MySQL_5.7 - MySQL 5.7
• MySQL_8_0 - MySQL 8.0

兼容版本。取值：

StorageType

String

否

LocalSSD

实例存储类型。取值：
LocalSSD - 本地SSD盘

LowerCaseTableNames

String

否

TRUE

表名是否区分大小写，默认取值为 TRUE。
取值范围：

• FALSE：表名被存储成固定且表名称大小写敏感。
• TRUE：表名将被存储成小写且表名称大小写不敏感。

DataSyncMode

String

否

SemiSync

数据同步方式，取值：

• SemiSync：半同步。
• Async：异步。

Tags

Array of TagObject

否

[
{
"Key": "key1",
"Value": "value1"
}
]

绑定的标签键和标签值数组对象。关于 Tags 的更多详情，请参见数据结构。

BackupStatus

String

否

Success

备份状态。取值：

• Success：备份成功。
• Failed：备份失败。
• Running：备份中。

DownloadStatus

String

否

NotDownload

下载状态。取值：

• NotDownload：未下载。
• Success：已下载。
• Failed：下载失败。
• Running：下载中。

ChargeType

String

否

PostPaid

付费类型。取值：

• PostPaid：按量付费（后付费）。
• PrePaid：包年包月（预付费）。

AutoRenew

Boolean

否

true

预付费场景下是否自动续费。

• true：到期自动续费。
• false：到期不自动续费。

PeriodUnit

String

否

Month

预付费场景下的购买周期。

• Month：购买周期为月。
• Year：购买周期为年。

ChargeStatus

String

否

Normal

付费状态。取值：

• Normal：正常。
• Overdue：欠费。
• Unpaid：等待支付。

ChargeType

String

是

PostPaid

付费类型。取值：

• PostPaid：按量付费（后付费）。
• PrePaid：包年包月（预付费）。

AutoRenew

Bool

否

Autorenew_Enable

预付费场景下是否到期自动续费。

• Autorenew_Enable：到期自动续费。
• Autorenew_Disable：到期不自动续费。默认。

PeriodUnit

String

否

Month

预付费场景下的购买周期。

• Month：购买周期为月。默认。
• Year：购买周期为年。

Period

Integer

否

1

预付费场景下的购买时长。默认值为 1。

Number

Integer

否

1

实例购买数量。默认值为 1。

ChargeItemType

String

否

Primary

付费项名称，取值：

• Primary：主节点。
• Secondary：备节点。
• ReadOnly：只读节点
• Storage： 物理存储空间。

ChargeItemKey

String

否

rds.mysql.d1.1c2g_cn-guangzhou

如果 ChargeItemType 取值为 Primary、Secondary 或 ReadOnly，则该参数返回实例的规格，如 rds.mysql.d1.1c2g_cn-guangzhou。

如果 ChargeItemType 取值为 Storage，该参数返回存储的 Key。

ChargeItemValue

Integer

否

100

如果 ChargeItemType 取值为 Primary、Secondary 或 ReadOnly，则该参数返回实例节点个数，均为 1。

如果 ChargeItemType 取值为 Storage，该参数返回单个节点存储空间大小。

Allowed

Boolean

否

TRUE

当 proxy 开启时，返回是否允许关闭 proxy；当 proxy 关闭时，返回是否允许开启 proxy。取值：

• true（是）。
• false（否）。

DBStatus

String

否

Available

数据库状态：取值为：

• Unavailable：不可用。
• Available：可用。

DatabasePrivileges

Array of DatabasePrivilegeObject

否

[
{
"AccountName": "user1",
"AccountPrivilege":"ReadWrite"
}
]

数据库账号权限列表。更多关于 DatabasePrivileges 的详细信息，请参见数据结构。

AccountPrivilege

String

是

ReadWrite

授予的账号权限类型，取值：

• ReadWrite：读写权限。
• ReadOnly：只读权限。
• DDLOnly：仅DDL权限。
• DMLOnly：仅DML权限。
• Custom：自定义权限。

AccountPrivilegeDetail

String

否

SELECT,INSERT,UPDATE

数据库权限字符串，
作为请求参数时，当 AccountPrivilege 取值为 Custom 时必填，取值：SELECT、INSERT、UPDATE、DELETE、CREATE、DROP、REFERENCES、INDEX、ALTER、CREATE TEMPORARY TABLES、LOCK TABLES、EXECUTE、CREATE VIEW、SHOW VIEW、CREATE ROUTINE、ALTER ROUTINE、EVENT、TRIGGER
作为返回结果时，不管 AccountPrivilege 的值是否为 Custom，都会展示 AccountPrivilege 的详细权限。

EndpointType

String

否

Cluster

终端类型：

• Cluster：默认终端（默认创建）。
• Primary：主节点终端。
• Custom：自定义终端。

ReadWriteMode

String

否

ReadOnly

读写模式：

• ReadWrite：读写。
• ReadOnly：只读。

Addresses

Array of AddressObject

否

[
{
"DNSVisibility":FALSE,
"Domain":"mysql38f7a19b****.rds.ivolces.com",
"EipId":"",
"IPAddress":"192.168.24.114",
"NetworkType":"Private",
"Port":"3306",
"SubnetId":"subnet-2bzr8zdx5o8ao2dx0efq4e5or"
}
]

地址列表。更多关于 Addresses 的详细信息，请参见数据结构。

ReadOnlyNodeWeight

Array of NodeWeightObject

否

[
{
"NodeType" : "Primary",
"Weight" : 100
},
{
"NodeId" : "mysql-050b3e08****-2",
"Weight" : 100
},
{
"NodeId" : "mysql-050b3e08****-3",
"Weight" : 200
}
]

连接终端配置的节点列表及对应的只读权重。更多关于 NodeWeightObject 的信息，请参见数据结构。

AutoAddNewNodes

String

否

Enable

当终端类型为读写终端或只读终端时，支持设置新节点是否自动加入。取值：

• Enable - 自动加入
• Disable - 不自动加入（默认）。

EnableReadWriteSplitting

String

否

Enable

是否已开启读写分离，取值：

• Enable：开启。
• Disable：未开启。

EnableReadOnly

String

否

Enable

是否已开启全局只读，取值：

• Enable：开启。
• Disable：未开启。

HAChangeType

String

否

System

主备切换类型。

• System：系统自动主备切换。
• User：用户手动主备切换。

Enable

Boolean

否

false

是否开启。取值：

• true：开启。

• false：关闭。

Support

Boolean

否

true

是否支持该功能。取值：

• true：支持。

• false：不支持。

InstanceStatus

String

否

Running

实例状态，取值如下：

• Running：运行中。
• Creating：创建中。
• Deleting：删除中。
• Restarting：重启中。
• Restoring：恢复中。
• Updating：变更中。
• Upgrading：升级中。
• MasterChanging：主备切换中。
• Error：错误。

DBEngineVersion

String

否

MySQL_8_0

兼容版本。取值：

• MySQL_5.7 - MySQL 5.7
• MySQL_8_0 - MySQL 8.0

LowerCaseTableNames

String

否

1

表名是否区分大小写，默认取值为 1。
取值范围：

• 0：表名被存储成固定且表名称大小写敏感。
• 1：表名将被存储成小写且表名称大小写不敏感。

AddressObject

Array of AddressObject

否

[
{
"Domain":"mysql77c004acdd3c.rds.ivolces.com",
"EipId":"",
"IPAddress":"",
"NetworkType":"Private",
"Port":"3306",
"SubnetId":""
}
]

默认终端的连接信息。更多关于 Addresses 的详细信息，请参见数据结构。

MaintenanceWindow

MaintenanceWindowObject

否

{
"DayKind": "Week",
"DayOfMonth": [],
"DayOfWeek": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday",
"Sunday"
],
"MaintenanceTime": "18:00Z-21:59Z"
}

可维护窗口。可维护窗口。更多关于 MaintenanceWindow 的信息，请参见数据结构。

DBEngineVersion

String

否

MySQL_8_0

兼容版本。取值：

• MySQL_5_7
• MySQL_8_0

SpecStatus

String

否

Normal

规格所在az的状态，包含以下状态：
- Normal：在售。
- Soldout：售罄。

DayKind

String

否

Week

可维护周期粒度，取值：

• Week：周。
• Month：月。

NodeType

String

是

Primary

节点类型，取值：

• Primary：主节点。
• Secondary：备节点。
• ReadOnly：只读节点。

NodeOperateType

String

否

Modify

操作类型。创建实例时无需传入，修改实例配置时需要传入。取值范围：

• Create：增加。
• Delete：删除。
• Modify：修改。

NodeType

String

否

Primary

节点类型。取值：

• Primary：主节点。
• Secondary：备节点。
• ReadOnly：只读节点。

NodeStatus

String

否

Running

节点状态，取值：

• Running：运行中。
• Creating：创建中。
• Deleting：删除中。
• Restarting：重启中。
• Restoring：恢复中。
• Updating：变更中。
• Upgrading：升级中。
• Error：错误。

Weight

Integer

是

100

节点的读权重，以 100 递增，最大值为 10000。

Status

String

否

Applied

状态。取值：

• Applied：已生效。
• Invalid：未生效。
• Syncing：正在应用，尚未生效。

TemplateParams

Array of InstanceParamObject

否

[
{
"Name": "auto_increment_increment",
"RunningValue": "1"
}
]

模板所包含的参数。关于 TemplateParams 的更多详细信息，请参见数据结构。

TemplateSource

String

否

System

参数模板的类型。取值：

• System（系统模板）。
• User（用户模板）。

TemplateType

String

否

MySQL

参数模板数据库类型，取值范围：
MySQL - MySQL 数据库。

TemplateTypeVersion

String

否

MySQL_Community_5_7

参数模板数据库版本，取值范围：

• MySQL_Community_5_7： MySQL 5.7 版本
• MySQL_8_0： MySQL 8.0 版本。

NewDBName

String

否

testdb2

DB 新名称。
如果只是恢复表，其值可以与 DBName 一样。

Table

Array of TableObject

否

[
{
"TableName" : "table1",
"NewTableName" : "table2"
}
]

指定恢复的 DB 内的表，当 Table 为空时全库恢复。更多关于 Table 的信息，请参见数据结构。

Value

String

否

ExampleValue

用于查询筛选的标签值。