创建数据库实例
URI
- URI格式
- URI样例
https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
租户在某一region下的project ID。
获取方法请参见获取项目ID。
请求消息
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
name |
是 |
String |
实例名称。 用于表示实例的名称,同一租户下,同类型的实例名可重名。取值范围如下:
|
datastore |
是 |
Object |
数据库信息。 详情请参见表4。 |
ha |
否 |
Object |
HA配置参数,创建HA实例时使用。 详情请参见表5。 |
configuration_id |
否 |
String |
参数模板ID。 |
port |
否 |
String |
数据库端口信息。
当不传该参数时,默认端口如下:
|
password |
否 |
String |
数据库密码。 取值范围: 数据库支持的密码长度是8~32个字符,至少包含大写字母、小写字母、数字、特殊字符三种字符的组合。 其中允许的特殊字符如下:
建议您输入高强度密码,以提高安全性,防止出现密码被暴力破解等安全风险。 |
backup_strategy |
否 |
Object |
高级备份策略。 详情请参见表6。 |
enterprise_project_id |
否 |
String |
企业项目ID。 使用请参考《企业管理 API参考》的“查询企业项目列表”响应消息表“enterprise_project字段数据结构说明”的“id”。 |
disk_encryption_id |
否 |
String |
用于磁盘加密的密钥ID,默认为空。 |
flavor_ref |
是 |
String |
规格码,取值范围:非空。 |
volume |
是 |
Object |
volume信息。 详情请参见表7。 |
region |
是 |
String |
区域ID。 取值范围:非空,请参见地区和终端节点。 |
availability_zone |
是 |
String |
可用区ID。对于数据库实例类型不是单机的实例,需要分别为实例所有节点指定可用区,并用逗号隔开。详见示例。 取值范围:非空,请参见地区和终端节点。 |
vpc_id |
是 |
String |
虚拟私有云ID,获取方法如下:
|
subnet_id |
是 |
String |
子网的网络ID信息,获取方法如下:
|
data_vip |
否 |
String |
指定实例的内网IP,获取方法如下:
|
security_group_id |
是 |
String |
指定实例所属的安全组。
|
charge_info |
否 |
Object |
计费类型信息,支持包年包月和按需,默认为按需。 详情请参见表8。 |
time_zone |
否 |
String |
UTC时区。
|
dsspool_id |
否 |
String |
Dec用户专属存储ID,每个az配置的专属存储不同,Dec用户创建实例时,对于数据库实例类型不是单机或只读的实例,需要分别为实例所有节点指定dsspoolId,并用逗号隔开。 |
tags |
否 |
Array of objects |
标签列表,根据标签键值对创建实例。
如果创建实例时同时使用多个标签键值对,中间使用逗号分隔开,最多包含10组。 详情请参见 表9。 |
unchangeable_param |
否 |
Object |
不可变更参数列表。该对象中的参数,在数据库初始化之前指定,指定后不支持修改。 详情参见表11。 |
collation |
否 |
String |
仅限Microsoft SQL Server实例创建使用。对于MySQL和PostgreSQL实例,该参数无意义。 取值范围:根据查询SQL Server可用字符集查询可设置的字符集。 |
dry_run |
否 |
Boolean |
是否只预检此次请求,仅支持MySQL。
|
count |
否 |
Integer |
批量创建实例的数量,取值范围为1~50,仅支持MySQL创建包周期实例和按需实例。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
name |
是 |
String |
实例名称。 用于表示实例的名称,同一租户下,同类型的实例名可重名。 取值范围:
|
replica_of_id |
是 |
String |
主实例ID,用于创建只读实例。 |
enterprise_project_id |
否 |
String |
项目标签。 |
disk_encryption_id |
否 |
String |
用于磁盘加密的密钥ID,默认为空。 |
flavor_ref |
是 |
String |
规格码,取值范围:非空,。 |
volume |
是 |
Object |
volume信息。 详情请参见表7。 |
region |
否 |
String |
区域ID。当前只支持创建与主实例同region的只读实例。 取值范围:非空,请参见地区和终端节点。 |
availability_zone |
是 |
String |
可用区ID。 取值范围:非空,请参见地区和终端节点。 |
charge_info |
否 |
Object |
计费类型信息,支持包年/包月和按需,默认为按需。 详情请参见表8。 |
dsspool_id |
否 |
String |
Dec用户专属存储ID,每个az配置的专属存储不同,Dec用户创建实例时,对于数据库实例类型不是单机或只读的实例,需要分别为实例所有节点指定dsspoolId,并用逗号隔开。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
type |
是 |
String |
数据库引擎,取值如下:
|
version |
是 |
String |
数据库版本。
数据库支持的详细版本信息,可调用查询数据库引擎的版本接口获取。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
mode |
是 |
String |
实例主备模式,取值:Ha(主备),不区分大小写。 |
replication_mode |
是 |
String |
备机同步参数。 取值:
说明:
|
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
start_time |
是 |
String |
备份时间段。自动备份将在该时间段内触发。 取值范围:非空,格式必须为hh:mm-HH:MM且有效,当前时间指UTC时间。
取值示例:
|
keep_days |
否 |
Integer |
指定备份文件的可保存天数。 取值范围:0~732。该参数缺省,或取值为0,表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请,自动备份最长可以保留2562天。 须知:
SQL Server的HA实例不支持关闭自动备份策略。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
type |
是 |
String |
磁盘类型。 取值范围如下,区分大小写:
|
size |
是 |
Integer |
磁盘大小。 取值范围:40GB~4000GB,必须为10的整数倍。 MySQL部分用户支持11GB~10000GB,如果您想创建存储空间最大为10000GB的数据库实例,或提高扩容上限到10000GB,请联系客服开通。 说明:
对于只读实例,该参数无效,磁盘大小,默认和主实例相同。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
charge_mode |
是 |
String |
计费模式。 取值范围:
|
period_type |
否 |
String |
订购周期类型。 取值范围:
|
period_num |
否 |
Integer |
“charge_mode”为“prePaid”时生效,且为必选值,指定订购的时间。 取值范围:
|
is_auto_renew |
否 |
boolean |
创建包周期实例时可指定,表示是否自动续订,续订的周期和原周期相同,且续订时会自动支付。
|
is_auto_pay |
否 |
boolean |
创建包周期时可指定,表示是否自动从客户的账户中支付,此字段不影响自动续订的支付方式。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
key |
是 |
String |
标签键。最大长度36个unicode字符。 key不能为空或者空字符串,不能为空格。 字符集:A-Z,a-z , 0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。 |
value |
是 |
String |
标签值。最大长度43个unicode字符。 可以为空字符串。 字符集:A-Z,a-z , 0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。 |
时区 |
标准时间偏移 |
备注 |
---|---|---|
Afghanistan Standard Time |
UTC+04:30 |
喀布尔 |
Alaskan Standard Time |
UTC-09:00 |
阿拉斯加 |
Arabian Standard Time |
UTC+04:00 |
阿布扎比,马斯喀特 |
Atlantic Standard Time |
UTC-04:00 |
大西洋时间(加拿大) |
AUS Central Standard Time |
UTC+09:30 |
达尔文 |
AUS Eastern Standard Time |
UTC+10:00 |
堪培拉,墨尔本,悉尼 |
Belarus Standard Time |
UTC+03:00 |
明斯克 |
Canada Central Standard Time |
UTC-06:00 |
萨斯喀彻温 |
Cape Verde Standard Time |
UTC-01:00 |
佛得角群岛 |
Cen. Australia Standard Time |
UTC+09:30 |
阿德莱德 |
Central America Standard Time |
UTC-06:00 |
中美洲 |
Central Asia Standard Time |
UTC+06:00 |
阿斯塔纳 |
Central Brazilian Standard Time |
UTC-04:00 |
库亚巴 |
Central Europe Standard Time |
UTC+01:00 |
贝尔格莱德,布拉迪斯拉发,布达佩斯,卢布尔雅那,布拉格 |
Central European Standard Time |
UTC+01:00 |
萨拉热窝,斯科普里,华沙,萨格勒布 |
Central Pacific Standard Time |
UTC+11:00 |
所罗门群岛,新喀里多尼亚 |
Central Standard Time |
UTC-06:00 |
中部时间(美国和加拿大) |
China Standard Time |
UTC+08:00 |
北京,重庆,香港,乌鲁木齐 |
E. Africa Standard Time |
UTC+03:00 |
内罗毕 |
E. Australia Standard Time |
UTC+10:00 |
布里斯班 |
E. Europe Standard Time |
UTC+02:00 |
基希讷乌 |
E. South America Standard Time |
UTC-03:00 |
巴西利亚 |
Eastern Standard Time |
UTC-05:00 |
东部时间(美国和加拿大) |
Georgian Standard Time |
UTC+04:00 |
第比利斯 |
GMT Standard Time |
UTC |
都柏林,爱丁堡,里斯本,伦敦 |
Greenland Standard Time |
UTC–03:00 |
格陵兰 |
Greenwich Standard Time |
UTC |
蒙罗维亚,雷克雅未克 |
GTB Standard Time |
UTC+02:00 |
雅典,布加勒斯特 |
Hawaiian Standard Time |
UTC-10:00 |
夏威夷 |
India Standard Time |
UTC+05:30 |
钦奈,加尔各答,孟买,新德里 |
Jordan Standard Time |
UTC+02:00 |
安曼 |
Korea Standard Time |
UTC+09:00 |
首尔 |
Middle East Standard Time |
UTC+02:00 |
贝鲁特 |
Mountain Standard Time |
UTC-07:00 |
山地时间(美国和加拿大) |
US Mountain Standard Time |
UTC-07:00 |
亚利桑那 |
New Zealand Standard Time |
UTC+12:00 |
奥克兰,惠灵顿 |
Newfoundland Standard Time |
UTC-03:30 |
纽芬兰 |
Pacific SA Standard Time |
UTC-03:00 |
圣地亚哥 |
Pacific Standard Time |
UTC-08:00 |
太平洋时间(美国和加拿大) |
Russian Standard Time |
UTC+03:00 |
莫斯科,圣彼得堡 |
SA Pacific Standard Time |
UTC-05:00 |
波哥大,利马,基多,里奥布朗库 |
SE Asia Standard Time |
UTC+07:00 |
曼谷,河内,雅加达 |
China Standard Time |
UTC+08:00 |
吉隆坡,新加坡 |
Tokyo Standard Time |
UTC+09:00 |
大阪,札幌,东京 |
US Eastern Standard Time |
UTC-05:00 |
印地安那州(东部) |
UTC |
UTC |
协调世界时间 |
UTC-02 |
UTC-02:00 |
协调世界时间-02 |
UTC-08 |
UTC-08:00 |
协调世界时间-08 |
UTC-09 |
UTC-09:00 |
协调世界时间-09 |
UTC-11 |
UTC-11:00 |
协调世界时间-11 |
UTC+12 |
UTC+12:00 |
协调时间时间+12 |
W. Australia Standard Time |
UTC+08:00 |
珀斯 |
W. Central Africa Standard Time |
UTC+01:00 |
中非西部 |
W. Europe Standard Time |
UTC+01:00 |
阿姆斯特丹,柏林,伯尔尼,罗马,斯德哥尔摩,维也纳 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
lower_case_table_names |
否 |
String |
表名大小写是否敏感,默认值是“1”,当前仅MySQL 8.0支持。 取值范围:
说明:
恢复已有实例时,目标实例与原实例表名大小写设置不一致,可能会导致恢复失败。 |

请求样例中参数“region”和“availability_zone”的值为示例值。
- 请求样例
{ "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.6" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "Test@12345678", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 }
MySQL 8.0创建单实例指定初始化参数:
{ "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "8.0" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "eu-de", "region": "aaa", "availability_zone": "eu-de-01", "availability_zone": "bbb", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "Test@12345678", "configuration_id": "452408-ef4b-44c5-94be-305145fg" "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "unchangeable_param": { "lower_case_table_names": "1" }, "dry_run": false, "count": 12 }
SQL Server创建单实例支持指定字符集
{ "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "8.0" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "eu-de", "region": "aaa", "availability_zone": "eu-de-01", "availability_zone": "bbb", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "collation": "Cyrillic_General_CI_AS", "password": "Test@12345678", "configuration_id": "452408-ef4b-44c5-94be-305145fg" "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], }
DeC用户创建单实例:
{ "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.6" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "Test@12345678", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "dsspool_id":"3278327382738217382173872183721837213", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 }
创建HA实例:
{ "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.6" }, "ha": { "mode": "ha", "replication_mode": "semisync" }, "flavor_ref": "rds.mysql.s1.large.ha", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb,ccc", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "Test@12345678", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 }
DeC用户创建HA实例:
{ "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.6" }, "ha": { "mode": "ha", "replication_mode": "semisync" }, "flavor_ref": "rds.mysql.s1.large.ha", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb,ccc", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "Test@12345678", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "dsspool_id":"327832738273821772133432,21489938273821772133432", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 }
创建只读实例:
{ "name": "rds-instance-rep2", "replica_of_id": "afdsad-fds-fdsagin01", "flavor_ref": "rds.mysql.s1.large.rr", "volume": { "type": "ULTRAHIGH" }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb", "enterprise_project_id": "fdsa-3rds", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
DeC用户创建只读实例:
{ "name": "rds-instance-rep2", "replica_of_id": "afdsad-fds-fdsagin01", "flavor_ref": "rds.mysql.s1.large.rr", "volume": { "type": "ULTRAHIGH" }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb", "enterprise_project_id": "fdsa-3rds" "dsspool_id":"3278327382738217382173872183721837213", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ]
响应消息
- 正常响应要素说明
表12 要素说明 名称
参数类型
说明
instance
Object
实例信息。
详情请参见表13。
job_id
String
实例创建的任务id。
查询详细任务信息请参见获取指定ID的任务信息。
仅创建按需实例时会返回该参数。
order_id
String
订单号,创建包年包月时返回该参数。
表13 instance说明 名称
参数类型
说明
id
String
实例id,批量创建实例时,该字段为空。
name
String
实例名称。用于表示实例的名称,同一租户下,同类型的实例名称可相同。
取值范围:
- MySQL数据库支持的字符长度是4~64个字符,必须以字母开头,区分大小写,可以包含字母、数字、中文字符、中划线或者下划线,不能包含其他的特殊字符。
- PostgreSQL和SQL Server数据库支持的字符长度是4~64个字符,必须以字母开头,区分大小写,可以包含字母、数字、中划线或者下划线,不能包含其他的特殊字符。
status
String
实例状态。如BUILD,表示创建中。
仅创建按需实例时会返回该参数。
datastore
Object
数据库信息。
详情请参见表14。
ha
Object
HA配置参数,仅当您选择创建HA实例时该参数才可见。
详情请参见表15。
configuration_id
String
参数模板id,仅当您创建实例指定用户自定义参数组时,该参数才可见。
port
String
数据库端口信息,与请求参数相同。
backup_strategy
Object
自动备份策略。
详情请参见表16。
enterprise_project_id
String
项目标签。
disk_encryption_id
String
用于磁盘加密的密钥ID,仅当您创建实例选择该参数时才可见,默认为空。
flavor_ref
String
规格码,取值范围:非空。
volume
Object
volume信息。
详情请参见表17。
region
String
区域ID。
availability_zone
String
可用区ID。
vpc_id
String
虚拟私有云ID,获取方法如下:
- 方法1:登录虚拟私有云服务的控制台界面,在虚拟私有云的详情页面查找VPC ID。
- 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询VPC列表。
subnet_id
String
子网的网络ID信息,获取方法如下:
- 方法1:登录虚拟私有云服务的控制台界面,单击VPC下的子网,进入子网详情页面,查找网络ID。
- 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询子网列表。
security_group_id
String
指定实例所属的安全组。
- 方法1:登录虚拟私有云服务的控制台界面,在安全组的详情页面查找安全组ID。
- 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询安全组列表。
charge_info
Object
付费方式信息,支持包年/包月和按需。
详情请参见表18。
collation
String
Microsoft SQL Server设定的字符集信息。
表14 datastore字段数据结构说明 名称
参数类型
说明
type
String
数据库引擎,返回值如下:
- MySQL
- PostgreSQL
- SQLServer
version
String
数据库版本。
数据库支持的详细版本信息,可调用查询数据库引擎的版本接口获取。
表15 ha字段数据结构说明 名称
参数类型
说明
mode
String
实例主备模式,取值范围:Ha(主备)。
replication_mode
String
备机同步参数。实例主备模式为Ha时有效。
取值:
- MySQL为“async”或“semisync”。
- PostgreSQL为“async”或“sync”。
- Microsoft SQL Server为“sync”。
说明:- “async”为异步模式。
- “semisync”为半同步模式。
- “sync”为同步模式。
表16 backupStrategy字段数据结构说明 名称
参数类型
说明
start_time
String
备份时间段。自动备份将在该时间段内触发。
取值范围:非空,格式必须为hh:mm-HH:MM且有效,当前时间指UTC时间。
- HH取值必须比hh大1。
- mm和MM取值必须相同,且取值必须为00、15、30或45。
取值示例:
- 08:15-09:15
- 23:00-00:00
如果请求体中“backup_strategy”为空,则响应体中 “start_time”默认返回“02:00-03:00”。
keep_days
Integer
指定已生成备份文件的可保存天数。
取值范围:0~732。该参数缺省,或取0值,表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请,自动备份最长可以保留2562天。
如果请求体中“backup_strategy”为空,则响应体中 “keep_days”默认返回“7”。

响应样例中参数“region”和“availability_zone”的值为示例值。
- 正常响应样例
{ "instance": { "id": "dsfae23fsfdsae3435in01", "name": "trove-instance-rep2", "datastore": { "type": "MySQL", "version": "5.6" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": "8635", "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 3 }, "configuration_id": "452408-44c5-94be-305145fg", "charge_info": { "charge_mode": "postPaid" } }, "job_id": "dff1d289-4d03-4942-8b9f-463ea07c000d" }
SQL Server单实例:
{ "instance": { "id": "dsfae23fsfdsae3435in01", "name": "trove-instance-rep2", "datastore": { "type": "sqlserver", "version": "2014_SE" }, "flavor_ref": "rds.mssql.2014.se.s3.large.2", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": "8635", "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 3 }, "configuration_id": "452408-44c5-94be-305145fg", "charge_info": { "charge_mode": "postPaid" }, "collation": "Cyrillic_General_CI_AS" }, "job_id": "dff1d289-4d03-4942-8b9f-463ea07c000d" }
HA实例:
{ "instance":{ "id": "dsfae23fsfdsae3435in01", "name": "trove-instance-rep2", "datastore": { "type": "MySQL", "version": "5.6" }, "ha": { "mode": "ha", "replication_mode": "semisync" }, "flavor_ref": "rds.mysql.s1.large.ha", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb,ccc", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": "8635", "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 3 }, "configuration_id": "452408-44c5-94be-305145fg", "charge_info": { "charge_mode": "postPaid" }, }, "job_id": "dff1d289-4d03-4942-8b9f-463ea07c000d" }
只读实例:
{ "instance":{ "id": "dsfae23fsfdsae3435in01", "name": "trove-instance-rep2", "flavor_ref": "rds.mysql.s1.large.rr", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "aaa", "availability_zone": "bbb", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": "8635", "configuration_id": "452408-44c5-94be-305145fg" }, "job_id": "dff1d289-4d03-4942-8b9f-463ea07c000d" }
- 异常响应
请参见异常请求结果。
状态码
请参见状态码。
错误码
请参见错误码。
