实例相关接口API文档

Transcription

1 云数据库 MySQL 实例相关接口 API 文档

2 版权声明 腾讯云版权所有 本文档著作权归腾讯云单独所有, 未经腾讯云事先书面许可, 任何主体不得以任何形式复制 修改 抄袭 传 播全部或部分本文档内容 商标声明 及其它腾讯云服务相关的商标均为腾讯云计算 ( 北京 ) 有限责任公司及其关联公司所有 本文档涉及的第三方 主体的商标, 依法由权利人所有 服务声明 本文档意在向客户介绍腾讯云全部或部分产品 服务的当时的整体概况, 部分产品 服务的内容可能有所调整 您所购买的腾讯云产品 服务的种类 服务标准等应由您与腾讯云之间的商业合同约定, 除非双方另有约定, 否则, 腾讯云对本文档内容不做任何明示或模式的承诺或保证 第 2 页共 133 页

3 文档目录 文档声明... 2 创建实例 ( 包年包月 )... 4 查询价格 ( 包年包月 )... 9 创建实例 ( 按量计费 ) 查询价格 ( 按量计费 ) 查询可创建规格 ( 支持可用区 配置自定义 ) 查询可创建规格 查询实例列表 查询只读实例列表 初始化实例 查询初始化任务详情 续费实例 销毁实例 ( 按量计费 ) 恢复实例 ( 按量计费 ) 设置自动续费 修改实例所属项目 重置密码 修改名称 修改端口 修改字符集 查询参数列表 修改参数 查询参数修改记录 查询修改参数任务详情 查询回档任务详情 查询回档任务列表 查询私有网络子网实例数量 第 3 页共 133 页

4 创建实例 ( 包年包月 ) 1. 接口描述 本接口 (CreateCdb) 用于创建包年包月的实例, 可通过传入实例规格 MySQL 版本号 购买时长和数量等信息创建云数据库实例 您还可以使用查询实例列表接口查询该实例的详细信息 接口请求域名 :cdb.api.qcloud.com 1. 首先请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口查询可创建的实例规格信息, 然后请使用查询价格 ( 包年包月 ) 接口查询可创建实例的售卖价格 ; 2. 单次创建实例最大支持 10 个, 实例时长最大支持 36 个月 ; 3. 支持创建 MySQL5.5 和 MySQL5.6 版本 ; 4. 支持创建主实例 灾备实例, 暂不支持创建只读实例, 您可使用创建实例 ( 按量计费 ) 接口创建只读实例 ; 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 CreateCdb 参数名称 必选 类型 描述 cdbtype 是 String 实例规格, 支持固定规格和自定义规格 传 CUSTOM 代表自定义规格 ; 固定规格的取值, 请使用查询可创建规格接口获取 固定规格类型将会下线, 推荐使用自定义规格 engineversion 是 String MySQL 版本, 值包括 :5.5 和 5.6, 请使 第 4 页共 133 页

5 参数名称 必选 类型 描述用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例版本 period 是 Int 实例时长, 单位 : 月, 最小 查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例时长, 该接口返回字段 timespa n 表示时长可选值 goodsnum 是 Int 实例数量, 默认值为 1, 最小 查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例数量 vpcid 否 String 私有网络 ID, 如果不传则默认选择基础网络, 请使用查询私有网络列表 subnetid 否 String 私有网络下的子网 ID, 如果设置了 vpcid, 则 subnetid 必填, 请使用查询子网列表 projectid 否 Int 项目 ID, 不填为默认项目 请使用查询项目列表接口获取项目 ID memory 否 Int 实例内存大小, 单位 :MB, 当 cdbtype 值为 第 5 页共 133 页

6 参数名称 必选 类型 描述 CUSTOM 时, memory 为必填 ; 当 cdbtype 为整型值时, 传入 memory 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的内存规格 volume 否 Int 实例硬盘大小, 单位 :GB, 当 cdbtype 值为 CUSTOM 时, volume 为必填 ; 当 cdbtype 为整型值时, 传入 volume 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的硬盘范围 zoneid 否 Int 可用区 ID, 该参数缺省时, 系统会自动选择一个可用区, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的可用区 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 错误信息 第 6 页共 133 页

7 参数名称类型描述 codedesc String 英文错误描述 dealids Array 订单号 其中,data 参数的构成如下 : 参数名称 类型 描述 dealids Array 短订单 ID, 用于调用云 API 相关接口, 如获取订单信息 dealnames Array 长订单 ID, 用于反馈订单问题给腾讯云官方客服 cdbinstanceids Array 实例短 ID, 以订单号为 key 返回实例短 ID 4. 示例 输入 &< 公共请求参数 > &engineversion=5.5 &cdbtype=custom &memory=1000 &volume=25 &period=1 &goodsnum=1 &zoneid= 输出 "code": 0, "message": "", 第 7 页共 133 页

8 "dealids": [ " " "data": "dealnames": [ " " "dealids": [ "457605" "cdbinstanceids": " ": [ "cdb-259sstxx" ] 第 8 页共 133 页

9 查询价格 ( 包年包月 ) 1. 接口描述 本接口 (InquiryCdbPrice) 用于查询云数据库实例某一个类型的包年包月价格, 可传入实例类型 购买时长 购买数量 内存大小 硬盘大小和可用区 ID 来查询实例价格 您还可以使用创建实例 ( 包年包月 ) 接口来创建一个新实例 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 InquiryCdbPrice 参数名称 必选 类型 描述 cdbtype 是 String 实例规格, 支持固定规格和自定义规格 ; 传 CUSTOM 代表自定义规格, 固定规格的取值, 请使用查询可创建规格接口获取 固定规格类型将会下线, 推荐使用自定义规格 period 是 Int 实例时长, 单位 : 月, 最小 查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例时长, 该接口返回字段 timespa n 表示时长可选值 第 9 页共 133 页

10 参数名称必选类型描述 goodsnum 是 Int 实例数量, 默认值为 1, 最小 查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例数量 memory 否 Int 实例内存大小, 单位 :MB, 当 cdbtype 值为 CUSTOM 时, memory 为必填 ; 当 cdbtype 为整型值时, 传入 memory 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的内存规格 volume 否 Int 实例硬盘大小, 单位 :GB, 当 cdbtype 值为 CUSTOM 时, volume 为必填 ; 当 cdbtype 为整型值时, 传入 volume 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的硬盘范围 zoneid 否 Int 可用区 ID, 该参数缺省时, 系统会自动选择一个可用区, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 第 10 页共 133 页

11 参数名称必选类型描述 接口获取可创建的可用区 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 错误信息 codedesc String 英文错误描述 price Int 实例价格, 单位 : 分 ( 人民币 ) 4. 示例 输入 &< 公共请求参数 > &cdbtype=custom &memory=1000 &volume=25 &period=1 &goodsnum=1 输出 "code": 0, "message": "", "codedesc": "Success", "price": 第 11 页共 133 页

12 第 12 页共 133 页

13 创建实例 ( 按量计费 ) 1. 接口描述 本接口 (CreateCdbHour) 用于创建按量计费的实例, 可通过传入实例规格 MySQL 版本号和数量等信息创建云数据库实例 您还可以使用查询实例列表接口查询该实例的详细信息 接口请求域名 :cdb.api.qcloud.com 1. 首先请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口查询可创建的实例规格信息, 然后请使用查询价格 ( 按量计费 ) 接口查询可创建实例的售卖价格 ; 2. 单次创建实例最大支持 10 个, 实例时长最大支持 36 个月 ; 3. 支持创建 MySQL5.5 和 MySQL5.6 版本 ; 4. 支持创建主实例 灾备实例和只读实例 ; 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 CreateCdbHour 参数名称 是否必选 类型 描述 cdbtype 是 String 实例规格, 支持固定规格和自定义规格 传 CUSTOM 代表自定义规格 ; 固定规格的取值, 请使用查询可创建规格接口获取 固定规格类型将会下线, 推荐使用自定义规格 engineversion 是 String MySQL 版本, 值包括 :5.5 和 5.6, 请使 第 13 页共 133 页

14 参数名称 是否必选 类型 描述用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例版本 goodsnum 是 Int 实例数量, 默认值为 1, 最小 查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例数量 vpcid 否 String 私有网络 ID, 如果不传则默认选择基础网络, 请使用查询私有网络列表 subnetid 否 String 私有网络下的子网 ID, 如果设置了 vpcid, 则 subnetid 必填, 请使用查询子网列表 projectid 否 Int 项目 ID, 不填为默认项目 请使用查询项目列表接口获取项目 ID memory 否 Int 实例内存大小, 单位 :MB, 当 cdbtype 值为 CUSTOM 时, memory 为必填 ; 当 cdbtype 为整型值时, 传入 memory 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的内存规格 第 14 页共 133 页

15 参数名称 是否必选 类型 描述 volume 否 Int 实例硬盘大小, 单位 :GB, 当 cdbtype 值为 CUSTOM 时, volume 为必填 ; 当 cdbtype 为整型值时, 传入 volume 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的硬盘范围 zoneid 否 Int 可用区 ID, 该参数缺省时, 系统会自动选择一个可用区, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的可用区 cdbinstanceid 否 String 实例 ID, 购买只读实例时必填, 该字段表示只读实例的主实例 ID, 请使用查询实例列表接口查询云数据库实例 ID instancerole 否 String 实例类型, 默认为 master, 支持值包括 :master- 表示主实例和灾备实例,ro- 表示只读实例 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 第 15 页共 133 页

16 参数名称类型描述 codedesc String 英文错误描述 dealids Array 订单号 其中,data 参数的构成如下 : 参数名称 类型 描述 dealids Array 短订单 ID, 用于调用云 API 相关接口, 如获取订单信息 dealnames Array 长订单 ID, 用于反馈订单问题给腾讯云官方客服 cdbinstanceids Array 实例短 ID, 以订单号为 key 返回实例短 ID 4. 示例 输入 &< 公共请求参数 > &engineversion=5.5 &cdbtype=custom &memory=1000 &volume=25 &goodsnum=1 &zoneid= 输出 "code": "0", "message": "", "dealids": [ 第 16 页共 133 页

17 " " "data": "dealnames": [ " " "dealids": [ "457605" "cdbinstanceids": " ": [ "cdb-259sstxx" ] 第 17 页共 133 页

18 查询价格 ( 按量计费 ) 1. 接口描述 本接口 (InquiryCdbPriceHour) 用于查询云数据库实例某一个类型的按量计费价格 ( 单位 : 元 / 小时 ), 可传入实例类型 购买数量 内存大小 硬盘大小和可用区 ID 来查询实例价格 您还可以使用创建实例 ( 按量计费 ) 接口来创建一个新实例 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 InquiryCdbPriceHour 参数名称 是否必选 类型 描述 cdbtype 是 String 实例规格, 支持固定规格和自定义规格 ; 传 CUSTOM 代表自定义规格, 固定规格的取值, 请使用查询可创建规格接口获取 固定规格类型将会下线, 推荐使用自定义规格 goodsnum 是 Int 实例数量, 默认值为 1, 最小 查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的实例数量 memory 否 Int 实例内存大小, 单位 :MB 第 18 页共 133 页

19 参数名称 是否必选 类型 描述, 当 cdbtype 值为 CUSTOM 时, memory 为必填 ; 当 cdbtype 为整型值时, 传入 memory 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的内存规格 volume 否 Int 实例硬盘大小, 单位 :GB, 当 cdbtype 值为 CUSTOM 时, volume 为必填 ; 当 cdbtype 为整型值时, 传入 volume 值将无效, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的硬盘范围 zoneid 否 Int 可用区 ID, 该参数缺省时, 系统会自动选择一个可用区, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口获取可创建的可用区 instancerole 否 String 实例类型, 默认为 master, 支持值包括 :master- 表示主实例和灾备实例,ro- 表示只读实例 3. 输出参数 第 19 页共 133 页

20 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 price Int 实例价格, 单位 : 分 ( 人民币 ) 4. 示例 输入 &< 公共请求参数 > &cdbtype=custom &memory=1000 &volume=25 &goodsnum=1 &zoneid= 输出 "code": 0, "message": "", "codedesc": "Success", "price": 35 第 20 页共 133 页

21 查询可创建规格 ( 支持可用区 配置自定义 ) 1. 接口描述 本接口 (DescribeCdbProductListNew) 用于查询可创建的云数据库实例规格, 返回可创建实例的购买时长和单次购买数量限制, 以及按可用区分类返回可创建实例的数据库版本号 内存大小和磁盘范围 您还可以使用查询价格 ( 包年包月 ) 或查询价格 ( 按量计费 ) 接口查询可创建实例的价格, 使用创建实例 ( 包年包月 ) 或创建实例 ( 按量计费 ) 接口创建一个新实例 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 此接口没有请求参数, 正式调用时只需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字 段为 DescribeCdbProductListNew 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 错误信息 configs Object 可创建实例规格的配置信息 其中 configs 表示可创建实例规格的配置信息, 其参数构成如下 : 参数名称 类型 描述 timespan Array 当前用户 地域下可购买的时间, 单位 : 月 mingoodsnumperdeal Int 单次允许购买的最小数量 maxgoodsnumperdeal Int 单次允许购买的最大数量 goodsdescription Object 可创建的实例规格信息 其中 goodsdescription 表示实例配置信息, 其参数构成如下 : 第 21 页共 133 页

22 参数名称类型描述 /100003/... Object 可用区 ID 其中 的值表示该可用区下支持的实例信息, 其参数构成如下 : 参数名称 类型 描述 issupportvpc Bool 是否支持私有网络, 其值包括 :true 和 false types Object 支持的实例规格内容 其中 types 表示支持的实例规格内容, 其参数构成如下 : 参数名称 类型 描述 typename String 实例类型中文名称, 如 : 高 IO 版 memory String 实例内存大小, 每一个内存值对应一个可选的磁盘大小范围, 单位 :MB volumemax Int 选定内存后, 实例硬盘大小可选的最大值, 单位 :GB volumemin Int 选定内存后, 实例硬盘大小可选的最小值, 单位 :GB volumestep Int 选定内存后, 实例硬盘大小的步长, 单位 :GB; 创建实例时, 硬盘 (vol ume) 的取值是 :volume= volumemin + volumestep * n; 同时 volumemin <= volume <= volumemax qps Int 选定内存后, 支持的每秒访问次数, 单位 : 次 / 秒 mysqlversion Array 支持的 MySQL 版本, 可能返回值 :5.5 和 示例 输入 第 22 页共 133 页

23 &< 公共请求参数 > 输出 "code":"0", "message":"", "codedesc":"success", "configs": "timespan":[ "1", "2", "3", "4", "5", "6", "7", "8", "9", "12", "24", "36" "mingoodsnumperdeal":"1", "maxgoodsnumperdeal":"10", "goodsdescription": "100002": "issupportvpc":true, "types":[ "typename":" 高 IO 版 ", "memory":"360", 第 23 页共 133 页

24 "volumemax":"50", "volumemin":"10", "volumestep":"5", "qps":"120", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"1000", "volumemax":"125", "volumemin":"25", "volumestep":"5", "qps":"1000", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"2000", "volumemax":"125", "volumemin":"25", "volumestep":"5", "qps":"2400", "mysqlversion":[ "5.5", "5.6" ] 第 24 页共 133 页

25 "typename":" 高 IO 版 ", "memory":"4000", "volumemax":"125", "volumemin":"25", "volumestep":"5", "qps":"4400", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"8000", "volumemax":"250", "volumemin":"25", "volumestep":"5", "qps":"7200", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"12000", "volumemax":"250", "volumemin":"25", "volumestep":"5", "qps":"15000", "mysqlversion":[ "5.5", "5.6" ] 第 25 页共 133 页

26 ] "100003": "issupportvpc":true, "types":[ "typename":" 高 IO 版 ", "memory":"1000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"1000", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"2000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"2400", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"4000", "volumemax":"3000", 第 26 页共 133 页

27 "volumemin":"25", "volumestep":"5", "qps":"4400", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"8000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"7200", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"16000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"18000", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", 第 27 页共 133 页

28 "memory":"32000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"25000", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"64000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"37689", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"96000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"40919", "mysqlversion":[ "5.5", "5.6" ] 第 28 页共 133 页

29 "typename":" 高 IO 版 ", "memory":"128000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"61378", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"244000", "volumemax":"3000", "volumemin":"25", "volumestep":"5", "qps":"122755", "mysqlversion":[ "5.5", "5.6" ] "typename":" 高 IO 版 ", "memory":"488000", "volumemax":"6000", "volumemin":"6000", "volumestep":"5", "qps":"245509", "mysqlversion":[ "5.5", "5.6" 第 29 页共 133 页

30 ] ] 第 30 页共 133 页

31 查询可创建规格 1. 接口描述 本接口 (DescribeCdbProductList) 用于查询可创建的云数据库实例规格, 返回可创建实例的购买时长和单次购买数量限制, 以及按基础网络和私有网络分类返回可创建实例的数据库版本号下可创建实例的规格信息 该接口不支持可用区和配置自定义, 推荐使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口来查询实例可创建规格 您还可以使用查询价格 ( 包年包月 ) 或查询价格 ( 按量计费 ) 接口查询可创建实例的价格, 使用创建实例 ( 包年包月 ) 或创建实例 ( 按量计费 ) 接口创建一个新实例 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 此接口没有请求参数, 正式调用时只需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字 段为 DescribeCdbProductList 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 错误信息 codedesc String 英文错误描述 configs Object 可创建实例规格的配置信息 其中 configs 表示可创建实例规格的配置信息, 其参数构成如下 : 参数名称类型描述 第 31 页共 133 页

32 参数名称 类型 描述 code Int 错误码, 0: 成功, 其他值 : 失败 message String 错误信息 timespan Array 当前用户 地域下可购买的时长, 单位 : 月 mingoodsnumperdeal Int 单次允许购买的最小数量 maxgoodsnumperdeal Int 单次允许购买的最大数量 goodsdescription Object 可创建实例的规格信息 其中 goodsdescription 表示实例配置信息, 其参数构成如下 : 参数名称 类型 描述 basenet Object 基础网络, 可创建实例的网络类型, 可能返回值 : basenet 和 VPCNet VPCNet Object 私有网络, 可创建实例的网络类型, 可能返回值 : basenet 和 VPCNet 其中 basenet 表示基础网络, 其参数构成如下 : 参数名称 类型 描述 MySQL5.5 Object 基础网络下可创建实例的数据库引擎版本号, 可能返回值 : MySQL5.5 和 MySQL5.6 MySQL5.6 Object 基础网络下可创建实例的数据库引擎版本号, 可能返回值 : MySQL5.5 和 MySQL5.6 其中 MySQL5.5 表示可创建的数据库版本号, 其参数构成如下 : 参数名称 类型 描述 20 Object 实例规格信息, 每一种实例规格用一个数字表示, 其包含该规格的配置内容 20.cdbType Int 实例规格, 可用于查询价格和创建实 第 32 页共 133 页

33 参数名称 类型 描述例, 自定义规格该字段值为 CUSTOM, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口查询支持可用区和自定义的实例规格 20.typeName String 实例类型中文名称, 如 : 高 IO 版 20.subTypeName String 实例类型扩展名称, 如 : 微型 20.volume Int 实例磁盘大小, 单位 :GB 20.memory Int 实例内存大小, 单位 :MB 20.visits Int 支持的每秒访问次数, 单位 : 次 / 秒 20.binlogSize Int binlog 大小, 单位 GB 20.suitinfo String 每一种规格推荐使用的场景描述 20.typeOrder Int 排序用字段 20.subTypeOrder Int 排序用字段 其中 VPCNet 表示私有网络, 其参数构成如下 : 参数名称 类型 描述 MySQL5.5 Object 私有网络下可创建实例的数据库引擎版本号, 可能返回值 : MySQL5.5 和 MySQL5.6 MySQL5.6 Object 私有网络下可创建实例的数据库引擎版本号, 可能返回值 : MySQL5.5 和 MySQL5.6 其中 MySQL5.5 或 MySQL5.6 表示可创建实例的数据库引擎版本号, 其参数构成如下 : 参数名称 类型 描述 20 Object 实例规格信息, 每一种实例规格用一个数字表示, 其包含该规格的配置内容 第 33 页共 133 页

34 参数名称 类型 描述 20.cdbType Int 实例规格, 可用于查询价格和创建实例, 自定义规格该字段值为 CUSTOM, 请使用查询可创建规格 ( 支持可用区 配置自定义 ) 接口查询支持可用区和自定义的实例规格 20.typeName String 实例类型中文名称, 如 : 高 IO 版 20.subTypeName String 实例类型扩展名称, 如 : 微型 20.volume Int 实例磁盘大小, 单位 :GB 20.memory Int 实例内存大小, 单位 :MB 20.visits Int 实例每秒访问次数, 单位 : 次 / 秒 20.binlogSize Int binlog 大小, 单位 :GB 20.suitinfo String 每一种规格推荐使用的场景描述 20.typeOrder Int 排序用字段 20.subTypeOrder Int 排序用字段 4. 示例 输入 & 输出 "code": 0, "message": "", 第 34 页共 133 页

35 "configs": "timespan": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36 "mingoodsnumperdeal": 1, "maxgoodsnumperdeal": 10, "goodsdescription": "basenet": "MySQL5.5": "20": "cdbtype": 20, "typename": " 高 IO 版 ", "subtypename": " 微型 ", "volume": 25, "visits": 1000, "binlogsize": 3, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", "typeorder": 3, "subtypeorder": 1, "memory": 1000 "21": "cdbtype": 21, 第 35 页共 133 页

36 "typename": " 高 IO 版 ", "subtypename": " 小型 ", "volume": 50, "visits": 2400, "binlogsize": 7, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", "typeorder": 3, "subtypeorder": 2, "memory": 2000 "22": "cdbtype": 22, "typename": " 高 IO 版 ", "subtypename": "C 型 ", "volume": 100, "visits": 4400, "binlogsize": 15, "suitinfo": " 日活跃用户数上十万人级别的中型游戏应用 ", "typeorder": 3, "subtypeorder": 3, "memory": 4000 "23": "cdbtype": 23, "typename": " 高 IO 版 ", "subtypename": " 中型 ", "volume": 250, "visits": 15000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 5, "memory": 第 36 页共 133 页

37 "24": "cdbtype": 24, "typename": " 高 IO 版 ", "subtypename": " 大型 ", "volume": 500, "visits": 23000, "binlogsize": 100, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 7, "memory": "25": "cdbtype": 25, "typename": " 高 IO 版 ", "subtypename": " 超大型 ", "volume": 1000, "visits": 37000, "binlogsize": 200, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 8, "memory": "26": "cdbtype": 26, "typename": " 高 IO 版 ", "subtypename": "A 型 ", "volume": 400, "visits": 18000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 6, 第 37 页共 133 页

38 "memory": "27": "cdbtype": 27, "typename": " 高 IO 版 ", "subtypename": "B 型 ", "volume": 200, "visits": 7200, "binlogsize": 30, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 4, "memory": 8000 "MySQL5.6": "20": "cdbtype": 20, "typename": " 高 IO 版 ", "subtypename": " 微型 ", "volume": 25, "visits": 1000, "binlogsize": 3, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", "typeorder": 3, "subtypeorder": 1, "memory": 1000 "21": "cdbtype": 21, "typename": " 高 IO 版 ", "subtypename": " 小型 ", "volume": 50, "visits": 2400, 第 38 页共 133 页

39 "binlogsize": 7, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", "typeorder": 3, "subtypeorder": 2, "memory": 2000 "22": "cdbtype": 22, "typename": " 高 IO 版 ", "subtypename": "C 型 ", "volume": 100, "visits": 4400, "binlogsize": 15, "suitinfo": " 日活跃用户数上十万人级别的中型游戏应用 ", "typeorder": 3, "subtypeorder": 3, "memory": 4000 "23": "cdbtype": 23, "typename": " 高 IO 版 ", "subtypename": " 中型 ", "volume": 250, "visits": 15000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 5, "memory": "24": "cdbtype": 24, "typename": " 高 IO 版 ", "subtypename": " 大型 ", 第 39 页共 133 页

40 "volume": 500, "visits": 23000, "binlogsize": 100, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 7, "memory": "25": "cdbtype": 25, "typename": " 高 IO 版 ", "subtypename": " 超大型 ", "volume": 1000, "visits": 37000, "binlogsize": 200, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 8, "memory": "26": "cdbtype": 26, "typename": " 高 IO 版 ", "subtypename": "A 型 ", "volume": 400, "visits": 18000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 6, "memory": "27": "cdbtype": 27, 第 40 页共 133 页

41 "typename": " 高 IO 版 ", "subtypename": "B 型 ", "volume": 200, "visits": 7200, "binlogsize": 30, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 4, "memory": 8000 "VPCNet": "MySQL5.5": "20": "cdbtype": 20, "typename": " 高 IO 版 ", "subtypename": " 微型 ", "volume": 25, "visits": 1000, "binlogsize": 3, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", "typeorder": 3, "subtypeorder": 1, "memory": 1000 "21": "cdbtype": 21, "typename": " 高 IO 版 ", "subtypename": " 小型 ", "volume": 50, "visits": 2400, "binlogsize": 7, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", 第 41 页共 133 页

42 "typeorder": 3, "subtypeorder": 2, "memory": 2000 "22": "cdbtype": 22, "typename": " 高 IO 版 ", "subtypename": "C 型 ", "volume": 100, "visits": 4400, "binlogsize": 15, "suitinfo": " 日活跃用户数上十万人级别的中型游戏应用 ", "typeorder": 3, "subtypeorder": 3, "memory": 4000 "23": "cdbtype": 23, "typename": " 高 IO 版 ", "subtypename": " 中型 ", "volume": 250, "visits": 15000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 5, "memory": "24": "cdbtype": 24, "typename": " 高 IO 版 ", "subtypename": " 大型 ", "volume": 500, "visits": 23000, 第 42 页共 133 页

43 "binlogsize": 100, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 7, "memory": "25": "cdbtype": 25, "typename": " 高 IO 版 ", "subtypename": " 超大型 ", "volume": 1000, "visits": 37000, "binlogsize": 200, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 8, "memory": "26": "cdbtype": 26, "typename": " 高 IO 版 ", "subtypename": "A 型 ", "volume": 400, "visits": 18000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 6, "memory": "27": "cdbtype": 27, "typename": " 高 IO 版 ", "subtypename": "B 型 ", 第 43 页共 133 页

44 "volume": 200, "visits": 7200, "binlogsize": 30, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 4, "memory": 8000 "MySQL5.6": "20": "cdbtype": 20, "typename": " 高 IO 版 ", "subtypename": " 微型 ", "volume": 25, "visits": 1000, "binlogsize": 3, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", "typeorder": 3, "subtypeorder": 1, "memory": 1000 "21": "cdbtype": 21, "typename": " 高 IO 版 ", "subtypename": " 小型 ", "volume": 50, "visits": 2400, "binlogsize": 7, "suitinfo": " 日活跃用户数上万的小型游戏应用或百万人级别的工具类应用 ", "typeorder": 3, "subtypeorder": 2, "memory": 2000 第 44 页共 133 页

45 "22": "cdbtype": 22, "typename": " 高 IO 版 ", "subtypename": "C 型 ", "volume": 100, "visits": 4400, "binlogsize": 15, "suitinfo": " 日活跃用户数上十万人级别的中型游戏应用 ", "typeorder": 3, "subtypeorder": 3, "memory": 4000 "23": "cdbtype": 23, "typename": " 高 IO 版 ", "subtypename": " 中型 ", "volume": 250, "visits": 15000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 5, "memory": "24": "cdbtype": 24, "typename": " 高 IO 版 ", "subtypename": " 大型 ", "volume": 500, "visits": 23000, "binlogsize": 100, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 7, 第 45 页共 133 页

46 "memory": "25": "cdbtype": 25, "typename": " 高 IO 版 ", "subtypename": " 超大型 ", "volume": 1000, "visits": 37000, "binlogsize": 200, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 8, "memory": "26": "cdbtype": 26, "typename": " 高 IO 版 ", "subtypename": "A 型 ", "volume": 400, "visits": 18000, "binlogsize": 65, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", "typeorder": 3, "subtypeorder": 6, "memory": "27": "cdbtype": 27, "typename": " 高 IO 版 ", "subtypename": "B 型 ", "volume": 200, "visits": 7200, "binlogsize": 30, "suitinfo": " 日活跃用户数在百万人级别的大型游戏应用 ", 第 46 页共 133 页

47 "typeorder": 3, "subtypeorder": 4, "memory": 8000 第 47 页共 133 页

48 查询实例列表 1. 接口描述 本接口 (DescribeCdbInstances) 用于查询云数据库实例列表, 支持通过项目 ID 实例长 ID/ 实例短 ID 访问地 址 实例状态等来筛选实例 接口请求域名 :cdb.api.qcloud.com 1. 可根据项目 ID 实例长 ID 实例短 ID 访问地址或实例状态作为过滤条件来查询实例列表; 2. 不指定任何过滤条件, 则默认返回 20 条实例记录, 单次请求最多支持返回 100 条实例记录 ; 3. 支持查询主实例和灾备实例列表, 暂不支持查询只读实例列表, 您可使用查询只读实例列表接口来查询只读实例列表 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 DescribeCdbInstances 参数名称 必选 类型 描述 projectid 否 Int 项目 ID, 请使用查询项目列表接口查询项目 ID cdbinstanceids.n 否 String 一个或者多个实例 ID,n 表示从 0 开始的数组下标, 支持实例长 ID 或实例短 ID 查询 请使用查询实例列表接口查询云数据库实例 ID cdbinstancevips.n 否 String 一个或者多个实例访问地址,n 表示从 0 开始的数组下标 请使用查询实例列表接口查询云数据库实例访问地址 status.n 否 Int 实例状态, 默认值为 1, 一个或者多个状态值,n 表示 第 48 页共 133 页

49 参数名称 必选 类型 描述从 0 开始的数组下标, 值包括 : 0- 创建中 1- 运行中 4- 删除中 5- 隔离中 offset 否 Int 记录偏移量, 默认值为 0 limit 否 Int 单次请求返回的数量, 默认值为 20, 最大值为 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 错误信息 codedesc String 英文错误描述 totalcount Int 符合查询条件的实例总数 cdbinstanceset Array 返回的实例信息 其中,cdbInstanceSet 参数的构成如下 : 参数名称 类型 描述 cdbinstanceid String 实例长 ID, 实例唯一标识 实例创建成功后才返回此 ID, 创建中的实例只返回实例短 ID 可用于查询实例信息或管理实例 uinstanceid String 实例短 ID, 实例唯一标识 功能同 cd binstanceid 字段 推荐使用 initflag Int 实例初始化标记, 可能返回值 :0- 未初始化 ;1- 已初始化 storagesize Int 实例存储容量, 同 volume 第 49 页共 133 页

50 参数名称 类型 描述字段值相同, 推荐使用 volume 字段, 单位 :G maxquerycount Int 实例最大查询次数, 单位 : 次 / 秒 cdbinstancename String 实例名称 cdbinstancevip String 实例访问 IP cdbinstancevport Int 实例访问端口 status Int 实例状态, 可能返回值 : 0- 创建中 1- 运行中 4- 删除中 5- 隔离中 taskstatus Int 实例任务状态, 可能返回值 : 0- 没有任务 1- 升级中 2- 数据导入中 3- 开放 Slave 中 4- 外网访问开通中 5- 批量操作执行中 6- 回档中 7- 外网访问关闭中 8- 密码修改中 9- 实例名修改中 10- 重启中 12- 自建迁移中 13- 删除库表中 14- 灾备实例创建同步中 engineversion String 实例数据库引擎版本, 可能返回值 : 和 5.6 cdbinstancecreatetime String 实例创建时间, 时间格式 :yyyymm-dd hh:mm:ss cdbinstancedeadlinetime String 实例到期时间, 如实例为按量计费模式, 则此字段值为 :00:00 时间格式:yyyy-mm-dd 第 50 页共 133 页

51 参数名称 类型 描述 hh:mm:ss cdbtypeset String 实例类型的序号, 可用此参数购买同类型实例或者查询同类型实例的续费价格 cdbtype String 实例规格描述, 如 :CUSTOM, 请使用查询可创建规格接口查询 cdbtype 详情 memory Int 实例内存大小, 单位 :MB volume Int 实例硬盘大小, 单位 :GB autorenew Int 自动续费标记, 可能返回值 :0- 不自动续费 ;1- 自动续费 zoneid Int 实例所在可用区 ID vpcid Int 实例所在私有网络 ID, 请使用查询私有网络列表 subnetid Int 实例所在私有网络子网 ID, 请使用查询私有网络列表 projectid Int 实例所在项目 ID, 请使用查询项目列表接口获取项目 ID paytype Int 实例计费类型, 可能返回值 :0- 包年包月 ;1- 按量计费 ;2- 后付费月结 4. 示例 输入 &< 公共请求参数 > &cdbinstanceids.0=qcdb598684d39e b56d5ab9ee71 第 51 页共 133 页

52 输出 "code": 0, "message": "", "codedesc": "Success", "totalcount": "1", "cdbinstanceset": [ "cdbinstanceid": "qcdb598684d39e b56d5ab9ee71", "uinstanceid": "cdb-ri5pu9m7", "initflag": 1, "storagesize": 125, "maxquerycount": 4400, "cdbinstancename": "mytest76031", "cdbinstancevip": " ", "cdbinstancevport": 1025, "status": 1, "taskstatus": 0, "engineversion": "5.6", "cdbinstancecreatetime": " :03:35", "cdbinstancedeadlinetime": " :03:34", "cdbtypeset": " ", "cdbtype": "CUSTOM", "memory": 4000, "volume": 125, "autorenew": 1, "zoneid": , "vpcid": 3307, "subnetid": 9779, "projectid": , "paytype": 0 ] 第 52 页共 133 页

53 第 53 页共 133 页

54 查询只读实例列表 1. 接口描述 本接口 (GetCdbReadOnlyInstances) 用于查询主实例关联的只读实例列表, 支持按多个主实例长 ID 或主实例短 ID 查询 您还可以使用查询实例列表接口查询主实例和灾备实例列表 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 GetCdbReadOnlyInstances 参数名称 是否必选 类型 描述 cdbinstanceids.n 是 String 一个或者多个主实例 ID,n 表示从 0 开始的数组下标, 支持实例长 ID 或实例短 ID 查询 请使用查询实例列表接口查询云数据库实例 ID 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Array 只读实例数据 其中,data 的参数构成如下 : 第 54 页共 133 页

55 参数名称 类型 描述 mastercdbinstanceid String 只读实例的主实例 ID, 可使用查询实例列表接口查询实例 ID groupid Int 只读实例组 ID, 每个主实例暂支持三个只读实例组 groupname String 只读实例组名 cdbversion String 只读实例数据库引擎版本, 可能返回值 :5.5 和 5.6 cdbtype String 只读实例规格描述, 如 :CUSTOM, 请使用查询可创建规格接口查询 cdbtype 详情 status Int 只读实例状态, 可能返回值 : 0- 创建中 1- 运行中 4- 删除中 5- 隔离中 vip String 只读实例访问 IP vport Int 只读实例访问端口 vpcid Int 只读实例所在私有网络 ID, 请使用查询私有网络列表 subnetid Int 只读实例所在私有网络子网 ID, 请使用查询私有网络列表 addtimestamp Int 只读实例组创建时间, 时间格式 :yy yy-mm-dd hh:mm:ss modtimestamp Int 只读实例组最后修改时间, 时间格式 :yyyy-mm-dd hh:mm:ss rolist Int 只读实例组包含的只读实例列表, 每个只读实例组目前暂支持一个只读实例 第 55 页共 133 页

56 其中,roList 的参数构成如下 : 参数名称 类型 描述 groupid Int 只读实例所在的只读实例组 ID cdbinstanceid String 只读实例长 ID, 实例唯一标识 实例创建成功后才返回此 ID, 创建中的实例只返回实例短 ID 可用于查询实例信息或管理实例 uinstanceid String 只读实例短 ID, 实例唯一标识 功能同 cdbinstanceid 字段 推荐使用 cdbinstancename String 只读实例名称 status Int 只读实例状态, 可能返回值 : 0- 创建中 1- 运行中 4- 删除中 5- 隔离中 taskstatus Int 只读实例任务状态, 可能返回值 : 0- 当前没有任务 - 升级任务 2- 数据导入 3- 开放 slave 读 4- 外网访问开通中 5- 批量操作 6- 回档 7- 外网访问关闭中 8- 修改密码 9- 改名 10- 参数修改任务 11- 初始化任务 12- 自建迁移 cdbversion String 只读实例数据库引擎版本, 可能返回值 :5.5 和 5.6 cdbtype String 只读实例规格描述, 如 :CUSTOM typename String 只读实例类型名称, 如 : 高 IO 版 第 56 页共 133 页

57 参数名称 类型 描述 initflag Int 只读实例初始化标记, 可能返回值 : 0- 未初始化 ;1- 已初始化 autorenewflag Int 只读实例自动续费标记, 可能返回值 :0- 不自动续费 ;1- 自动续费 dealid String 只读实例订单 ID paytype Int 只读实例计费类型, 可能返回值 :0- 包年包月 ;1- 按量计费 ;2- 后付费月结 cdbmem Int 只读实例内存大小, 单位 :MB cdbvolume Int 只读实例硬盘大小, 单位 :GB cdbqps Int 只读实例最大查询次数, 单位 : 次 / 秒 zoneid Int 只读实例所在可用区 ID deadline String 只读实例到期时间, 如实例为按量计费模式, 则此字段值为 :00:00 时间格式:yyyy-mm-dd hh:mm:ss modtimestamp String 只读实例修改时间, 时间格式 :yyyymm-dd hh:mm:ss addtimestamp String 只读实例创建时间, 时间格式 :yyyymm-dd hh:mm:ss 4. 示例 输入 &< 公共请求参数 > &cdbinstanceids.0=qcdbb1fc f735b78bb95892e9079cf 输出 第 57 页共 133 页

58 "code": 0, "message": "", "codedesc": "Success", "data": [ "groupid": 46, "groupname": "Rogroup_ ", "cdbversion": "5.6", "cdbtype": "CUSTOM", "status": 1, "vip": " ", "vport": 3306, "vpcid": 0, "subnetid": 0, "addtimestamp": " :58:28", "modtimestamp": " :58:30", "rolist": [ "groupid": 46, "status": 1, "cdbversion": "5.6", "cdbtype": "CUSTOM", "taskstatus": 0, "initflag": 1, "autorenewflag": 0, "deadline": " :58:28", "modtimestamp": " :30:05", "addtimestamp": " :58:28", "dealid": " ", "paytype": 1, "uinstanceid": "cdbro-quaopawc", "cdbmem": 4000, "cdbvolume": 110, 第 58 页共 133 页

59 "zoneid": , "cdbqps": 4400, "typename": " 高 IO 版 ", "type": "CUSTOM", "cdbinstanceid": "qcdbfbde368e4f3d549f5eeef81b411bb541", "cdbinstancename": "cdb_ro_46" "mastercdbinstanceid": "qcdbb1fc f735b78bb95892e9079cf" "groupid": 56, "groupname": "Rogroup_ ", "cdbversion": "5.6", "cdbtype": "CUSTOM", "status": 1, "vip": " ", "vport": 3306, "vpcid": 0, "subnetid": 0, "addtimestamp": " :25:30", "modtimestamp": " :25:31", "rolist": [ "groupid": 56, "status": 1, "cdbversion": "5.6", "cdbtype": "CUSTOM", "taskstatus": 0, "initflag": 1, "autorenewflag": 0, "deadline": " :25:30", "modtimestamp": " :26:32", "addtimestamp": " :25:30", 第 59 页共 133 页

60 "dealid": " ", "paytype": 1, "uinstanceid": "cdbro-oio5hxy8", "cdbmem": 4000, "cdbvolume": 100, "zoneid": , "cdbqps": 4400, "typename": " 高 IO 版 ", "type": "CUSTOM", "cdbinstanceid": "qcdb d5f62d88322e92eb0436", "cdbinstancename": "cdb_ro_56" "mastercdbinstanceid": "qcdbb1fc f735b78bb95892e9079cf" ] 第 60 页共 133 页

61 初始化实例 1. 接口描述 本接口 (CdbMysqlInit) 用于初始化云数据库实例, 初始化实例时可设置实例的字符集 端口 表名大小写是否 敏感和 root 帐号的密码 ; 实例初始化完成后, 就可以投入使用了 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 CdbMysqlInit 参数名称 是否必选 类型 描述 cdbinstanceid 是 String 支持实例长 ID 和实例短 ID, 请使用查询实例列表接口查询云数据库实例 ID charset 是 String 字符集, 支持的字符集 :["l atin1","utf8","gbk"," utf8mb4"] port 是 Int 自定义端口, 端口支持范围 :[ ] lowercasetablenames 是 Int 表名是否只存储为小写, 可能返回值 :1- 表名存储为小写 ; 0- 表名大小写敏感 password 是 String 设置 root 帐号密码, 密码规则 :8-16 个字符, 至少包含字母 数字 字符 ( 支持的字符 :!@#$%^*()) 中的两种 3. 输出参数 第 61 页共 133 页

62 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 jobid Int 初始化实例任务 ID 初始化实例是异步操作, 提交成功后会返回一个任务 ID, 可使用任务 ID 查询任务进度, 请使用查询初始化异步任务详情接口查询任务详情 4. 示例 输入 &< 公共请求参数 > &cdbinstanceid=qcdbc89b29ad834ddb aa363255ea2 &charset=utf8 &port=3306 &password=cloud &lowercasetablenames=0 输出 "code":"0", "message":"", "codedesc":"success", "jobid":"11" 第 62 页共 133 页

63 查询初始化任务详情 1. 接口描述 本接口 (GetCdbInitInfo) 用于查询实例初始化的任务详情 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 GetCdbInitInfo 参数名称 是否必选 类型 描述 jobid 是 Int 初始化任务 ID, 是执行初始化实例时的返回值 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Array 任务详情 其中,data 参数的构成如下 : 参数名称类型描述 jobid String 初始化任务 ID starttime String 初始化任务开始时间, 时间格式如 : 第 63 页共 133 页

64 参数名称 类型 描述 :52:21 endtime String 初始化任务结束时间, 时间格式如 : :53:23 status String 初始化任务状态值, 状态值包括 :0- 运行中,2- 执行成功,3- 执行失败, 4- 已中止,5- 已删除,6- 正在中止 progress String 初始化任务进度值, 可能返回值 :0 至 100, 数值表示任务完成的百分比 errorcode String 初始化任务错误码, 0 表示成功, 其他值表示失败 message String 初始化任务信息, 任务失败返回出错信息, 任务成功返回 success 4. 示例 输入 &< 公共请求参数 > &jobid=9 输出 "code":"0", "message":"", "codedesc": "Success", "data": "jobid":"9", "starttime":" :52:21", "endtime":" :53:23", 第 64 页共 133 页

65 "status":"2", "progress":"100", "errorcode":"0", "message":"success" 第 65 页共 133 页

66 续费实例 1. 接口描述 本接口 (RenewCdb) 用于续费实例 仅支持包年包月实例的续费, 按量计费实例是按小时自动扣款, 不需要续 费 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 RenewCdb 参数名称 必选 类型 描述 cdbinstanceid 是 String 支持实例长 ID 或实例短 ID, 请使用 DescribeCdbInstances 接口查询实例 ID period 是 Int 续费时长, 单位 : 月, 最小 查询可创建规格接口获取可创建的实例时长, 该接口返回字段 timespa n 表示时长可选值 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 第 66 页共 133 页

67 参数名称类型描述 codedesc String 英文错误描述 dealids Array 续费订单号 4. 示例 输入 &< 公共请求参数 > &cdbinstanceid=qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5 &period=1 输出 "code": 0, "message": "", "codedesc":"success", "dealids": [ "447276" ] 第 67 页共 133 页

68 销毁实例 ( 按量计费 ) 1. 接口描述 本接口 (CloseCdbH our) 用于销毁按量计费的实例, 销毁后实例将设置为隔离状态, 可使用 DescribeCdbInstances 接口来查询隔离中的实例 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 CloseCdbHour 参数名称 是否必选 类型 描述 cdbinstanceids.n 是 String 一个或者多个实例 ID,n 表示从 0 开始的数组下标, 支持实例长 ID 或实例短 ID 请使用 DescribeCdbInstances 接口查询实例 ID instancerole 否 String 实例类型, 默认为 master, 支持 master( 表示主实例或灾备实例 ),ro( 表示只读实例 ) 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 第 68 页共 133 页

69 参数名称类型描述 codedesc String 英文错误描述 data Array 返回的数据 其中,data 的参数构成如下 : 参数名称 类型 描述 instancerole String 实例类型, 默认为 master, 支持 ma ster( 表示主实例或灾备实例 ),ro ( 表示只读实例 ) cdbinstanceids Array 销毁实例的结果列表 其中,cdbInstanceIds 的参数构成如下 : 参数名称 类型 描述 cdbinstanceid String 实例长 ID result Int 执行结果, 可能返回的值 :0- 成功 ; 非 0- 失败 err String 错误描述, 当 result 为非 0 时, 该值有效 4. 示例 输入 &< 公共请求参数 > &cdbinstanceids.0=qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5 &instancerole=ro 输出 第 69 页共 133 页

70 "code":"0", "message":"", "codedesc":"success", "data": "cdbinstanceids":[ "cdbinstanceid":"qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5", "result":"0", "err":"" "instancerole":"ro" 第 70 页共 133 页

71 恢复实例 ( 按量计费 ) 1. 接口描述 本接口 (OpenCdbHour) 用于恢复按量计费且已被隔离的实例, 恢复实例前请确保账户已充值 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 OpenCdbHour 参数名称 是否必选 类型 描述 cdbinstanceids.n 是 String 一个或者多个实例 ID,n 表示从 0 开始的数组下标, 支持实例长 ID 或实例短 ID 请使用 DescribeCdbInstances 接口查询实例 ID instancerole 否 String 实例类型, 默认为 master, 支持 master( 表示主实例或灾备实例 ),ro( 表示只读实例 ) 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Array 返回数据 第 71 页共 133 页

72 其中,data 的参数构成如下 : 参数名称 类型 描述 instancerole String 实例类型, 默认为 master, 支持 m aster( 表示主实例或灾备实例 ),r o( 表示只读实例 ) cdbinstanceids Array 恢复实例的结果列表 其中,cdbInstanceIds 的参数构成如下 : 参数名称 类型 描述 oldstatus String 实例更改前的状态值, 可能包含的值 :1- 运行中 ;5- 为隔离中 result Int 处理结果, 可能包含的值 :0- 成功, 非 0- 失败 err String 错误描述, 当 result 为非 0 时, 该值有效 cdbinstanceid String 实例 ID 4. 示例 输入 &< 公共请求参数 > &cdbinstanceids.0=cdb-41lrk52w &instancerole=master 输出 "code":"0", "message":"", 第 72 页共 133 页

73 "codedesc":"success", "data": "cdbinstanceids":[ "oldstatus":"5", "result":"0", "err":"", "cdbinstanceid":"cdb-41lrk52w" "instancerole":"master" 第 73 页共 133 页

74 设置自动续费 1. 接口描述 本接口 (SetCdbAutoRenew) 用于设置或取消云数据库实例的自动续费功能 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 SetCdbAutoRenew 参数名称 必选 类型 描述 cdbinstanceid 是 String 支持实例长 ID 或短 ID, 请使用 DescribeCdbInstances 接口查询实例 ID isautorenew 是 String 是否自动续费 :Y/N,Y- 表示设置实例为自动续费,N - 表示设置实例为不自动续费 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Array 数据 4. 示例 输入 第 74 页共 133 页

75 &< 公共请求参数 > &cdbinstanceid=qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5 &isautorenew=y 输出 "code":"0", "message":"", "codedesc":"success", "data":[] 第 75 页共 133 页

76 修改实例所属项目 1. 接口描述 本接口 (ModifyCdbInstanceProject) 用于修改实例所属项目 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 ModifyCdbInstanceProject 参数名称 是否必选 类型 描述 cdbinstanceids.n 是 String 一个或者多个实例 ID,n 表示从 0 开始的数组下标, 支持实例长 ID 或实例短 ID 请使用 DescribeCdbInstances 接口查询实例 ID projectid 是 Int 项目 ID, 请使用 DescribeProject 接口查询项目 ID 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Array 返回的数据 第 76 页共 133 页

77 4. 示例 输入 &< 公共请求参数 > &cdbinstanceids.0=qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5 &projectid=0 输出 "code":"0", "message":"", "codedesc":"success", "data":[] 第 77 页共 133 页

78 重置密码 1. 接口描述 本接口 (ResetCdbInstancesPassword) 用于重置云数据库实例 root 帐号的密码 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 ResetCdbInstancesPassword 参数名称 必选 类型 描述 cdbinstanceid 是 String 支持实例长 ID 和实例短 ID, 请使用 DescribeCdbInstances 接口查询实例 ID password 是 String root 帐号的新密码, 密码规则 :8-16 个字符, 至少包含字母 数字 字符 ( 支持字符 :!@#$%^*()) 中的两种 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 错误信息 data Object 数据 其中,data 参数构成如下 : 第 78 页共 133 页

79 参数名称类型描述 taskid Int 任务 Id 4. 示例 输入 &< 公共请求参数 > &cdbinstanceid=qcdbxxxxxxxxxxx 输出 "code": 0, "message": "", "data": "taskid": 第 79 页共 133 页

80 修改名称 1. 接口描述 本接口 (ModifyCdbInstanceName) 用于修改云数据库实例名称, 实例名称最大支持 60 个字符, 修改实例名称 是异步处理过程, 您可使用查询任务详情接口查询任务处理状态 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 ModifyCdbInstanceName 参数名称 必选 类型 描述 cdbinstanceid 是 String 支持实例长 ID 或短 ID, 请使用 DescribeCdbInstances 接口查询实例 ID cdbinstancename 是 String 实例名称, 名称规则 :1-6 0 个字母 数字 非符号中文 _ - 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Object 数据 其中,data 参数构成如下 : 参数名称类型描述 第 80 页共 133 页

81 参数名称类型描述 taskid Int 修改名称任务 ID 4. 示例 输入 &< 公共请求参数 > &cdbinstanceid=qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5 &cdbinstancename=newname 输出 "code":"0", "message":"", "codedesc":"success", "data": "taskid": 第 81 页共 133 页

82 修改端口 1. 接口描述 本接口 (ModifyCdbInstanceVport) 用于修改实例的端口号, 端口号支持 1024 至 的整数 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 ModifyCdbInstanceVport 参数名称 是否必选 类型 描述 cdbinstanceids.n 是 String 一个或者多个实例 ID,n 表示从 0 开始的数组下标, 支持实例长 ID 或实例短 ID 请使用 DescribeCdbInstances 接口查询实例 ID port 是 Int 修改后的端口号, 值支持范围 :1024 至 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Array 返回的数据 4. 示例 第 82 页共 133 页

83 输入 &< 公共请求参数 > &cdbinstanceids.0=qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5 &port=3307 输出 "code":"0", "message":"", "codedesc":"success", "data":[] 第 83 页共 133 页

84 修改字符集 1. 接口描述 本接口 (ModifyCdbCharset) 用于修改实例的字符集, 目前实例支持 latin1 utf8 gbk 和 utf8mb4 四种字符集 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数页面 其中, 此接口的 Action 字段为 ModifyCdbCharset 参数名称 必选 类型 描述 cdbinstanceid 是 String 支持实例长 ID 或实例短 ID, 请使用 DescribeCdbInstances 接口查询实例 ID charset 是 String 修改后的字符集, 支持的字符集 :["latin1","utf8"," gbk","utf8mb4"] 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Object 返回数据 其中,data 参数构成如下 : 第 84 页共 133 页

85 参数名称类型描述 taskid Int 修改字符集任务 ID 4. 示例 输入 &< 公共请求参数 > &cdbinstanceid=qcdbde9cabcdf6bdb5843c4ee73cfcd86cf5 &charset=utf8 输出 "code":"0", "message":"", "codedesc":"success", "data": "taskid":" " 第 85 页共 133 页

86 查询参数列表 1. 接口描述 本接口 (GetCdbParams) 用于查询云数据库实例的参数列表 您还可以使用修改参数接口来修改云数据库实例的参数 接口请求域名 :cdb.api.qcloud.com 2. 输入参数 以下请求参数列表仅列出了 接口请求参数, 正式调用时需要加上公共请求参数, 见公共请求参数 页面 其中, 此接口的 Action 字段为 GetCdbParams 参数名称 是否必选 类型 描述 cdbinstanceid 是 String 实例 ID, 请使用查询实例列表接口查询云数据库实例 ID 3. 输出参数 参数名称 类型 描述 code Int 公共错误码, 0 表示成功, 其他值表示失败 详见错误码页面的公共错误码 message String 模块错误信息描述, 与接口相关 codedesc String 英文错误描述 data Array 返回的数据 其中,data 的参数构成如下 : 参数名称类型描述 cur_value String 当前值 default String 系统默认值 第 86 页共 133 页

87 参数名称 类型 描述 enum_value Array 参数的可选枚举值, 如果非枚举参数, 则为空 max Int 最大允许值 min Int 最小允许值 name String 参数名 need_reboot Int 修改参数后是否需要重启数据库以使参数生效, 值包括 :0- 不需要重启 ; 1- 需要重启 type String 参数类型, 值包括 :integer- 整数 ; enum- 枚举 ;string- 字符串 ;boole an- 布尔值 ;float 浮点值 4. 示例 输入 &< 公共请求参数 > &cdbinstanceid=qcdbc89b29ad834ddb aa363255ea2 输出 "code":"0", "message":"", "codedesc":"success", "data":[ "cur_value":"1", "default":"1", "desc":"controls the interval between successive column values.", "enum_value":[ 第 87 页共 133 页

88 "max":"65535", "min":"1", "name":"auto_increment_increment", "need_reboot":"0", "type":"integer" "cur_value":"1", "default":"1", "desc": "Determines the starting point for the AUTO_INCREMENT column value.", "enum_value":[ "max":"65535", "min":"1", "name":"auto_increment_offset", "need_reboot":"0", "type":"integer" "cur_value":"210", "default":"1", "desc": "The number of outstanding connection requests MySQL can have.", "enum_value":[ "max":"65535", "min":"1", "name":"back_log", "need_reboot":"1", 第 88 页共 133 页

89 "type":"integer" "cur_value":"none", "default":"none", "desc": "When enabled, this variable causes the master to write a checksum for each even t in the binary log.", "enum_value":[ "NONE", "CRC32" "max":"0", "min":"0", "name":"binlog_checksum", "need_reboot":"0", "type":"enum" "cur_value":"utf8", "default":"latin1", "desc":"specify default server character set", "enum_value":[ "latin1", "utf8", "gbk", "utf8mb4" "max":"0", "min":"0", "name":"character_set_server", "need_reboot":"1", "type":"string" 第 89 页共 133 页

90 "cur_value":"11", "default":"10", "desc": "The number of seconds that the mysqld server waits for a connect packet before responding with Bad handshake", "enum_value":[ "max":"1800", "min":"2", "name":"connect_timeout", "need_reboot":"0", "type":"integer" "cur_value":"0", "default":"0", "desc":"the default mode value to use for the WEEK() function", "enum_value":[ "max":"7", "min":"0", "name":"default_week_format", "need_reboot":"0", "type":"integer" "cur_value":"4", "default":"4", "desc": "This variable indicates the number of digits by which to increase the scale of the result of division operations performed with the operator", 第 90 页共 133 页

91 "enum_value":[ "max":"30", "min":"0", "name":"div_precision_increment", "need_reboot":"0", "type":"integer" "cur_value":"off", "default":"off", "desc":"this variable indicates the status of the Event Scheduler", "enum_value":[ "ON", "OFF" "max":"0", "min":"0", "name":"event_scheduler", "need_reboot":"0", "type":"enum" "cur_value":"1024", "default":"1024", "desc": "The maximum permitted result length in bytes for the GROUP_CONCAT() function", "enum_value":[ "max":" ", "min":"4", "name":"group_concat_max_len", 第 91 页共 133 页

92 "need_reboot":"0", "type":"integer" "cur_value":"on", "default":"on", "desc": "Whether the InnoDB adaptive hash index is enabled or disabled.", "enum_value":[ "ON", "OFF" "max":"0", "min":"0", "name":"innodb_adaptive_hash_index", "need_reboot":"0", "type":"boolean" "cur_value":"1", "default":"1", "desc":"the lock mode to use for generating auto-increment values.", "enum_value":[ "max":"2", "min":"0", "name":"innodb_autoinc_lock_mode", "need_reboot":"1", "type":"integer" "cur_value":"2", "default":"1", 第 92 页共 133 页

93 "desc": "Controls the balance between strict ACID compliance for commit operations, and higher performance that is possible when commitrelated I/O operations are rearranged and done in batches.", "enum_value":[ "max":"2", "min":"0", "name":"innodb_flush_log_at_trx_commit", "need_reboot":"0", "type":"integer" "cur_value":"84", "default":"84", "desc":"maximum character length of words that are stored in an InnoDB FULLTEXT index.", "enum_value":[ "max":"84", "min":"10", "name":"innodb_ft_max_token_size", "need_reboot":"1", "type":"integer" "cur_value":"3", "default":"3", "desc":"minimum length of words that are stored in an InnoDB FULLTEXT index.", "enum_value":[ 第 93 页共 133 页

94 "max":"16", "min":"0", "name":"innodb_ft_min_token_size", "need_reboot":"1", "type":"integer" "cur_value":"off", "default":"off", "desc":"enable this option to allow index key prefixes longer than 767 bytes (up to 3072 bytes) for InnoDB tables that use the DYNAMIC and COMPRESSED row formats.", "enum_value":[ "ON", "OFF" "max":"0", "min":"0", "name":"innodb_large_prefix", "need_reboot":"0", "type":"boolean" "cur_value":"7200", "default":"7200", "desc":"the length of time in seconds an InnoDB transaction waits for a row lock before giving up", "enum_value":[ "max":" ", "min":"1", "name":"innodb_lock_wait_timeout", "need_reboot":"0", 第 94 页共 133 页

95 "type":"integer" "cur_value":"75", "default":"75", "desc":"innodb tries to flush data from the buffer pool so that the percentage of dirty pages does not exceed this value", "enum_value":[ "max":"99", "min":"0", "name":"innodb_max_dirty_pages_pct", "need_reboot":"0", "type":"integer" "cur_value":"37", "default":"37", "desc":"specifies the approximate percentage of the InnoDB buffer pool used for the old block sublist", "enum_value":[ "max":"95", "min":"5", "name":"innodb_old_blocks_pct", "need_reboot":"0", "type":"integer" "cur_value":"1000", "default":"1000", "desc":"specifies the approximate percentage of the InnoDB buffer pool used for 第 95 页共 133 页

96 the old block sublist", "enum_value":[ "max":" ", "min":"0", "name":"innodb_old_blocks_time", "need_reboot":"0", "type":"integer" "cur_value":"1024", "default":"300", "desc":"it specifies the maximum number of.ibd files that MySQL can keep open at one time.", "enum_value":[ "max":"8192", "min":"1", "name":"innodb_open_files", "need_reboot":"1", "type":"integer" "cur_value":"off", "default":"off", "desc":"when this option is enabled, information about all deadlocks in InnoDB user transactions is recorded in the mysqld error log.", "enum_value":[ "ON", "OFF" "max":"0", 第 96 页共 133 页

97 "min":"0", "name":"innodb_print_all_deadlocks", "need_reboot":"0", "type":"boolean" "cur_value":"300", "default":"300", "desc":"the granularity of changes, expressed in units of redo log records, that trigger a purge operation, flushing the changed buffer pool blocks to disk.", "enum_value":[ "max":"5000", "min":"1", "name":"innodb_purge_batch_size", "need_reboot":"0", "type":"integer" "cur_value":"1", "default":"1", "desc":"the number of background threads devoted to the InnoDB purge operation.", "enum_value":[ "max":"32", "min":"1", "name":"innodb_purge_threads", "need_reboot":"0", "type":"integer" 第 97 页共 133 页

98 "cur_value":"56", "default":"56", "desc":"controls the sensitivity of linear read-ahead that InnoDB uses to prefetch pages into the buffer pool", "enum_value":[ "max":"64", "min":"0", "name":"innodb_read_ahead_threshold", "need_reboot":"0", "type":"integer" "cur_value":"12", "default":"4", "desc":"the number of I/O threads for read operations in InnoDB.", "enum_value":[ "max":"64", "min":"1", "name":"innodb_read_io_threads", "need_reboot":"1", "type":"integer" "cur_value":"off", "default":"off", "desc":"if innodb_rollback_on_timeout is specified, a transaction timeout causes InnoDB to abort and roll back the entire transaction.", "enum_value":[ "ON", 第 98 页共 133 页

99 "OFF" "max":"0", "min":"0", "name":"innodb_rollback_on_timeout", "need_reboot":"0", "type":"boolean" "cur_value":"off", "default":"off", "desc":"when this variable is enabled, InnoDB updates statistics when metadata statements such as SHOW TABLE STATUS or SHOW INDEX are run, or when accessing the INFORMATION_SCHEMA tables TABLES or STATISTICS", "enum_value":[ "ON", "OFF" "max":"0", "min":"0", "name":"innodb_stats_on_metadata", "need_reboot":"0", "type":"boolean" "cur_value":"on", "default":"off", "desc":"when innodb_strict_mode is ON, InnoDB returns errors rather than warnings for certain conditions", "enum_value":[ "ON", "OFF" "max":"0", 第 99 页共 133 页

100 "min":"0", "name":"innodb_strict_mode", "need_reboot":"0", "type":"boolean" "cur_value":"on", "default":"on", "desc":"if autocommit = 0, InnoDB honors LOCK TABLES; MySQL does not return from LOCK TABLES... WRITE until all other threads have released all their locks to the table. The default value of innodb_table_locks is 1, which means that LOCK TABLES causes InnoDB to lock a table internally if autocommit = 0.", "enum_value":[ "ON", "OFF" "max":"0", "min":"0", "name":"innodb_table_locks", "need_reboot":"0", "type":"boolean" "cur_value":"0", "default":"0", "desc":"innodb tries to keep the number of operating system threads concurrently inside InnoDB less than or equal to the limit given by this variable.", "enum_value":[ "max":"128", "min":"0", "name":"innodb_thread_concurrency", 第 100 页共 133 页

101 "need_reboot":"0", "type":"integer" "cur_value":"10000", "default":"0", "desc":"how long InnoDB threads sleep before joining the InnoDB queue, in microseconds. ", "enum_value":[ "max":" ", "min":"0", "name":"innodb_thread_sleep_delay", "need_reboot":"0", "type":"integer" "cur_value":"12", "default":"4", "desc":"the number of I/O threads for write operations in InnoDB.", "enum_value":[ "max":"64", "min":"1", "name":"innodb_write_io_threads", "need_reboot":"1", "type":"integer" "cur_value":"3600", "default":"3600", "desc":"the number of seconds the server waits for activity on an interactive 第 101 页共 133 页

102 connection before closing it", "enum_value":[ "max":"86400", "min":"1", "name":"interactive_timeout", "need_reboot":"0", "type":"integer" "cur_value":"off", "default":"off", "desc":"whether queries that do not use indexes are logged to the slow query log", "enum_value":[ "ON", "OFF" "max":"0", "min":"0", "name":"log_queries_not_using_indexes", "need_reboot":"0", "type":"boolean" "cur_value":" ", "default":"10", "desc":"if a query takes longer than this many seconds, the server increments the Slow_queries status variable", "enum_value":[ "max":"3600", 第 102 页共 133 页

103 "min":"0.1", "name":"long_query_time", "need_reboot":"0", "type":"float" "cur_value":"off", "default":"off", "desc":"if set to true, all INSERT, UPDATE, DELETE, and LOCK TABLE WRITE statements wait until there is no pending SELECT or LOCK TABLE READ on the affected table", "enum_value":[ "ON", "OFF" "max":"0", "min":"0", "name":"low_priority_updates", "need_reboot":"0", "type":"boolean" "cur_value":"0", "default":"0", "desc":"if set to 0, table names are stored as specified and comparisons are case sensitive. If set to 1, they are stored in lowercase on disk and comparisons are not case sensitive.", "enum_value":[ "max":"1", "min":"0", "name":"lower_case_table_names", "need_reboot":"1", 第 103 页共 133 页

104 "type":"integer" "cur_value":" ", "default":" ", "desc":"the maximum size of one packet or any generated/intermediate string.", "enum_value":[ "max":" ", "min":"1024", "name":"max_allowed_packet", "need_reboot":"0", "type":"integer" "cur_value":" ", "default":"100", "desc":"if more than this many successive connection requests from a host are interrupted without a successful connection, the server blocks that host from further connections.", "enum_value":[ "max":" ", "min":"1", "name":"max_connect_errors", "need_reboot":"0", "type":"integer" "cur_value":"800", "default":"151", "desc":"the maximum permitted number of simultaneous client connections.", 第 104 页共 133 页