学步园

该系列博客的目录:

    概述与请求方式: http://blog.csdn.net/hyzhou33550336/article/details/41620595 (请先看这篇了解公共请求参数)

    实例管理:   http://blog.csdn.net/hyzhou33550336/article/details/41620749

    数据库管理: http://blog.csdn.net/hyzhou33550336/article/details/41620833

    数据迁入:   http://blog.csdn.net/hyzhou33550336/article/details/41620863

    账号管理:   http://blog.csdn.net/hyzhou33550336/article/details/41620879

    备份恢复:   http://blog.csdn.net/hyzhou33550336/article/details/41620899

    监控查询:   http://blog.csdn.net/hyzhou33550336/article/details/41620907

    日志查询:   http://blog.csdn.net/hyzhou33550336/article/details/41620917

    性能优化:   http://blog.csdn.net/hyzhou33550336/article/details/41620931

    参数设置:   http://blog.csdn.net/hyzhou33550336/article/details/41620595

实例管理类接口 目录(Ctrl + F 搜索跳转)

• 创建数据库实例
• 删除数据库实例
• 变更配置
• 查看数据库实例列表
• 查看数据库实例详情
• 切换实例内外网类型
• 重启数据库实例
• 查询可用的物理位置
• 修改实例备注
• 修改实例访问白名单
• 修改实例可维护时间
• 数据库版本升级
• 清除事物日志

 

创建数据库实例:

描述:

说明:实例创建成功之后需要调用创建数据库和创建帐号接口

登录:创建完成后，登录数据库方法为:

ConnectionString：testconn01.mysql.rds.Aliyuncs.com(创建数据库实例接口返回的)

AccountName：testacc01
(通过创建帐号接口创建的)

Port：3306

AccountPassword：pw1234

#mysql-h testconn01.mysql.rds.Aliyuncs.com -utestacc01 –ppw1234 -P3306

实例状态要求:可通过调用查看数据库实例列表获取实例当前状态

请求参数:

返回参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=CreateDBInstance

&RegionId=cn-hangzhou

&Engine=MySQL

&EngineVersion=5.5

&DBInstanceClass=rds.mys2.small

&DBInstanceStorage=5

&DBInstanceNetType=Internet

&SecurityIPList=11.11.11.11

&PayType=Postpaid

&ClientToken=ETnLKlblzczshOTUbOCziJZNwHlYBQ

&<公共请求参数>

返回示例:

XML格式:

<CreateDBInstanceResponse>

<OrderId>100789370230206</OrderId>

<ConnectionString>rdsaiiabnaiiabn.mysql.rds.aliyuncs.com</ConnectionString>

<DBInstanceId>rdsaiiabnaiiabn</DBInstanceId>

<port>3306</port>

<RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>

</CreateDBInstanceResponse>

JSON格式:

{

"OrderId":"100789370230206",

"ConnectionString":"rdsaiiabnaiiabn.mysql.rds.aliyuncs.com",

"DBInstanceId":"rdsaiiabnaiiabn",

"Port":"3306",

"RequestId":"1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"

}

 

删除数据库实例:

描述:

说明：删除指定实例

接口调用要求如下，否则操作将失败：

实例状态为运行中

实例没有被人为锁定

实例类型为主实例（按量付费类型）、只读实例、灾备实例、临时实例

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=DeleteDBInstance

&DBInstanceId=rdsaiiabnaiiabn

&<公共请求参数>

返回示例:

XML格式:

<DeleteDBInstanceResponse>

<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>

</DeleteDBInstanceResponse>

JSON格式:

{

"RequestId":"65BDA532-28AF-4122-AA39-B382721EEE64"

}

 

变更配置:

描述:

说明:该接口可以对实例的两个属性进行升级配置或降低配置，分别为实例规格和存储空间，说明如下

接口调用要求如下,否则操作将失败:

实例为运行中

实例当前无正在运行的备份

实例规格和存储空间必须指定一项

降低磁盘空间配置，输入的磁盘空间不能小于实际使用空间大小的1.1倍

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=ModifyDBInstanceSpec

&DBInstanceId=rdsaiiabnaiiabn

&PayType=Postpaid

&DBInstanceStorage=10

&<公共请求参数>

返回示例:

XML格式:

<ModifyDBInstanceSpecResponse>

<RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>

</ModifyDBInstanceSpecResponse>

JSON格式:

{

"RequestId":" 3C5CFDEE-F774-4DED-89A2-1D76EC63C575 "

}

 

查看数据库实例列表:

描述:

说明:

用户只能查看属于自己的实例列表或被RAM授权的实例列表

返回实例列表信息包括：实例状态、公网/私网、实例连接地址/端口，是否被锁，是否过期等

以供用户追加数据库、修改实例等操作。用户也可以查找指定名称、类型、状态的实例信息。

实例状态要求：无

请求参数:

返回参数:

DBInstance的参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=DescribeDBInstances

&RegionId=cn-hangzhou

&Engine=MySQL

&<公共请求参数>

返回示例:

XML格式:

<DescribeDBInstancesResponse>

<PageRecordCount>2</PageRecordCount>

<Items>

<DBInstance>

<DBInstanceDescription>testforRemarks</DBInstanceDescription>

<ExpireTime>2014-10-10T16:00:00Z</ExpireTime>

<DBInstanceId>rdsmjfirvmjfirv</DBInstanceId>

<DBInstanceNetType>Internet</DBInstanceNetType>

<PayType>Prepaid</PayType>

<DBInstanceStatus>Running</DBInstanceStatus>

<DBInstanceType>Primary</DBInstanceType>

<Engine>MySQL</Engine>

<LockMode>Unlock</LockMode>

<LockReason></LockReason>

<RegionId>cn-hangzhou</RegionId>

</DBInstance>

<DBInstance>

<DBInstanceDescription>testforcreate</DBInstanceDescription>

<ExpireTime></ExpireTime>

<DBInstanceId>rdsabqumfabqumf</DBInstanceId>

<DBInstanceNetType>Intranet</DBInstanceNetType>

<PayType>Postpaid</PayType>

<DBInstanceStatus>Running</DBInstanceStatus>

<DBInstanceType>Primary</DBInstanceType>

<Engine>MySQL</Engine>

<LockMode>Unlock</LockMode>

<LockReason></LockReason>

<RegionId>cn-hangzhou</RegionId>

</DBInstance>

</Items>

<PageNumber>1</PageNumber>

<TotalRecordCount>2</TotalRecordCount>

<RequestId>2553A660-E4EB-4AF4-A402-8AFF70A49143</RequestId>

</DescribeDBInstancesResponse>

JSON格式:

{

"PageNumber":1,

"Items":{

"DBInstance":[

{

"Engine":"MySQL",

"DBInstanceType":"Primary",

"DBInstanceStatus":"Running",

"DBInstanceDescription":"testforRemarks",

"LockMode":"Unlock",

"RegionId":"cn-hangzhou",

"DBInstanceId":"rdsmjfirvmjfirv",

"PayType":"Prepaid",

"ExpireTime":"2014-10-10T16:00:00Z",

"DBInstanceNetType":"Internet",

"LockReason":""

},

{

"Engine":"MySQL",

"DBInstanceType":"Primary",

"DBInstanceStatus":"Running",

"DBInstanceDescription":"testforcreate",

"LockMode":"Unlock",

"RegionId":"cn-hangzhou",

"DBInstanceId":"rdsabqumfabqumf",

"PayType":"Postpaid",

"ExpireTime":"",

"DBInstanceNetType":"Intranet",

"LockReason":""

}

]

},

"TotalRecordCount":2,

"PageRecordCount":2,

"RequestId":"2553A660-E4EB-4AF4-A402-8AFF70A49143"

}

 

查看数据库实例详情:

描述:

说明:查看指定实例的详细属性

实例状态:无

请求参数:

返回参数:

DBInstanceAttribute的参数:

ReadOnlyDBInstanceId:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=DescribeDBInstanceAttribute

&DBInstanceId=rdsaiiabnaiiabn

&<公共请求参数>

返回示例:

XML格式:

<CreateDBInstanceResponse>

<RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>

<Items>

<DBInstanceAttribute>

<LockMode>Unlock</LockMode>

<ConnectionString>rdsfnjfqu7vjnuj.mysql.rds.aliyuncs.com</ConnectionString>

<CreationTime>2014-10-10T10:28:48Z</CreationTime>

<DBInstanceNetType>Internet</DBInstanceNetType>

<MaxConnections>60</MaxConnections>

<LockReason></LockReason>

<Engine>MySQL</Engine>

<AvailabilityValue>100.0%</AvailabilityValue>

<AccountMaxQuantity>50</AccountMaxQuantity>

<DBMaxQuantity>200</DBMaxQuantity>

<RegionId>cn-hangzhou</RegionId>

<ReadOnlyDBInstanceIds>

<ReadOnlyDBInstanceId></ReadOnlyDBInstanceId>

</ReadOnlyDBInstanceIds>

<TempDBInstanceId></TempDBInstanceId>

<DBInstanceMemory>240</DBInstanceMemory>

<MaxIOPS>150</MaxIOPS>

<DBInstanceType>Primary</DBInstanceType>

<DBInstanceStatus>Running</DBInstanceStatus>

<MasterInstanceId></MasterInstanceId>

<EngineVersion>5.5</EngineVersion>

<IncrementSourceDBInstanceId></IncrementSourceDBInstanceId>

<GuardDBInstanceId></GuardDBInstanceId>

<DBInstanceStorage>10</DBInstanceStorage>

<DBInstanceDescription></DBInstanceDescription>

<DBInstanceId>rdsfnjfqu7vjnuj</DBInstanceId>

<PayType>Postpaid</PayType>

<ExpireTime></ExpireTime>

<MaintainTime></MaintainTime>

<DBInstanceClass>rds.mys2.small</DBInstanceClass>

<SecurityIPList>11.11.11.11</SecurityIPList>

<Port>3306</Port>

</DBInstanceAttribute>

</CreateDBInstanceResponse>

JSON格式:

{

"Items":{

"DBInstanceAttribute":[

{

"LockMode":"Unlock",

"ConnectionString":"rdsfnjfqu7vjnuj.mysql.rds.aliyuncs.com",

"CreationTime":"2014-10-10T10:28:48Z",

"DBInstanceNetType":"Internet",

"ReadOnlyDBInstanceIds":{

"ReadOnlyDBInstanceId":[]

},

"MaxConnections":60,

"LockReason":"",

"Engine":"MySQL",

"AvailabilityValue":"100.0%",

"AccountMaxQuantity":50,

"DBMaxQuantity":200,

"RegionId":"cn-hangzhou",

"TempDBInstanceId":"",

"DBInstanceMemory":240,

"MaxIOPS":150,

"DBInstanceType":"Primary",

"DBInstanceStatus":"Running",

"MasterInstanceId":"",

"EngineVersion":"5.5",

"IncrementSourceDBInstanceId":"",

"GuardDBInstanceId":"",

"DBInstanceStorage":10,

"DBInstanceDescription":"",

"DBInstanceId":"rdsfnjfqu7vjnuj",

"PayType":"Postpaid",

"ExpireTime":"",

"MaintainTime":"",

"DBInstanceClass":"rds.mys2.small",

"SecurityIPList":"11.11.11.11",

"Port":"3306"

}

]

},

"RequestId":"27BB49FA-DA47-4162-B39D-FC001E35C1C1"

}

 

切换实例内外网类型:

描述:

用户在必要的时候，可以进行内外网切换，即原来是内网，则会切换到外网，反之亦然。

切换后连接地址会发生变化，需要用户修改代码中的连接地址并重启应用。

实例状态要求:

必须满足以下条件，否则将修改失败:

实例当前状态:使用中

实例一天切换次数低于20次，按24小时为一天计算

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=SwitchDBInstanceNetType

&DBInstanceId=rdsaiiabnaiiabn

&ConnectionStringPrefix=test11wangyicheng

&<公共请求参数>

返回示例:

XML格式:

<SwitchDBInstanceNetTypeResponse>

<RequestId>087E2E17-36BB-49EA-BA6D-674164553D2C</RequestId>

</SwitchDBInstanceNetTypeResponse>

JSON格式：

{

"RequestId":" 087E2E17-36BB-49EA-BA6D-674164553D2C "

}

 

重启数据库实例:

描述:

说明：根据用户的需求可以重启指定的实例，重启一般在10S钟内完成，如果当时有大量的事务需要提交或回滚，可能会延长1分钟左右。

操作必须满足以下条件，否则操作将失败

实例使用中

实例无正在运行的系统自动备份

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=RestartDBInstance

&DBInstanceId=rdsaiiabnaiiabn

&<公共请求参数>

返回示例:

XML格式:

<SwitchDBInstanceNetTypeResponse>

<RequestId>087E2E17-36BB-49EA-BA6D-674164553D2C</RequestId>

</SwitchDBInstanceNetTypeResponse>

JSON格式:

{

"RequestId":" 65BDA532-28AF-4122-AA39-B382721EEE64"

}

 

查询可用的物理位置:

描述:

查看该用户可以使用的物理位置，调用创建实例接口之前查看该函数查询用户可以使用的RegionId

请求参数:

返回参数:

RDSRegion:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=DescribeRegions

&<公共请求参数>

返回示例:

XML格式:

<DescribeRegionsResponse>

<Regions>

<RDSRegion>

<RegionId>cn-hangzhou</RegionId>

</RDSRegion>

<RDSRegion>

<RegionId>cn-qingdao</RegionId>

</RDSRegion>

<RDSRegion>

<RegionId>cn-beijing</RegionId>

</RDSRegion>

<RDSRegion>

<RegionId>cn-hongkong</RegionId>

</RDSRegion>

<RDSRegion>

<RegionId>cn-shenzhen</RegionId>

</RDSRegion>

</Regions>

<RequestId>A36D9720-7902-42A4-B8B9-014A2135E6C3</RequestId>

</DescribeRegionsResponse>

JSON格式:

{

"Regions":{

"RDSRegion":[

{"RegionId":"cn-hangzhou"},

{"RegionId":"cn-qingdao"},

{"RegionId":"cn-beijing"},

{"RegionId":"cn-hongkong"},

{"RegionId":"cn-shenzhen"}

]

},

"RequestId":"A36D9720-7902-42A4-B8B9-014A2135E6C3"

}

 

修改实例备注:

描述:

修改实例的备注名，用于方便用户记录该实例，比如为该实例修改备注名为“阿里云测试环境实例”

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=ModifyDBInstanceDescription

&DBInstanceId=rdsaiiabnaiiabn

&DBInstanceDescription=testwangyichengdescribe

&<公共请求参数>

返回示例:

XML格式:

<ModifyDBInstanceDescriptionResponse>

<RequestId>17F57FEE-EA4F-4337-8D2E-9C23CAA63D74</RequestId>

</ModifyDBInstanceDescriptionResponse>

JSON格式:

{

RequestId":" 17F57FEE-EA4F-4337-8D2E-9C23CAA63D74"

}

 

修改实例访问白名单:

描述:

说明:修改允许访问实例的IP名单

接口调用必须满足以下条件，否则将失败:

实例运行中

实例没有被锁定

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=ModifySecurityIps

&DBInstanceId=rdsaiiabnaiiabn

&SecurityIps=192.168.1.2

&<公共请求参数>

返回示例:

XML格式:

<ModifySecurityIpsResponse>

<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>

</ModifySecurityIpsResponse>

JSON格式:

{

"RequestId":"65BDA532-28AF-4122-AA39-B382721EEE64"

}

 

修改实例可维护时间:

描述:

修改实例可例行维护的时间，您可以设置一个业务的一个低峰的时间段。

阿里云如果进行例行维护时间，会在您设置的可维护时间段内进行，对您的业务影响降到最低。

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=ModifyDBInstanceMaintainTime

&DBInstanceId=rdsaiiabnaiiabn

&MaintainTime=22:00Z-02:00Z

&<公共请求参数>

返回示例:

XML格式:

<ModifyDBInstanceMaintainTimeResponse>

<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>

</ModifyDBInstanceMaintainTimeResponse>

JSON格式:

{

"RequestId":"65BDA532-28AF-4122-AA39-B382721EEE64"

}

 

数据库版本升级:

描述:

针对实例进行数据库版本升级，如将数据库版本MySQL5.1升级至MySQL5.5版本。

如果主实例下挂载着只读实例或者灾备实例，请先升级只读实例或者灾备实例的数据库版本。

操作必须满足以下条件，否则操作将失败:

实例为运行中

输入的数据库版本号必须大于当前实例的版本号

请求参数:

返回参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion

&DBInstanceId=rdsaiiabnaiiabn

&EngineVersion=5.6

&<公共请求参数>

返回示例:

XML格式:

<UpgradeDBInstanceEngineVersionResponse>

<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>

<TaskId>124378</Taskid>

</UpgradeDBInstanceEngineVersionResponse>

JSON格式:

{

"RequestId":"65BDA532-28AF-4122-AA39-B382721EEE64"

"TaskId": "124378"

}

 

清除事物日志:

描述:

对于MySQL类型的实例，将清空实例的所有BINLOG日志。

对于SQLServer实例，产生一个临时备份。临时备份完成后，将收缩RDS磁盘空间。

请求参数:

示例:

请求示例:

https://rds.aliyuncs.com/?Action=PurgeDBInstanceLog

&DBInstanceId=rdsaiiabnaiiabn

&<公共请求参数>

返回示例:

XML格式:

<PurgeDBInstanceLogResponse>

<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>

</PurgeDBInstanceLogResponse>

JSON格式:

{

"RequestId":"65BDA532-28AF-4122-AA39-B382721EEE64"

}