获取自定义备份时间

最近更新时间:2019-12-04 15:19:04

1. 接口描述

本接口(CdbTdsqlGetBackupTime)用于获取自定义备份时间。
接口请求域名:tdsql.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为CdbTdsqlGetBackupTime。

参数名称 是否必选 类型 描述
cdbInstanceIds.n (cdbInstanceIds 为数组,此处入参需要填写数组元素 ) String 要拉取的实例ID,n从0开始

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。
codeDesc String 英文错误提示
data Array 返回数据
data.instances Array 返回的实例列表
data.instances.id Int 实例ID
data.instances.uuid String 实例的UUID
data.instances.sbackuptime String 实例每天备份区间的开始时间,实际执行可能会有一点误差
data.instances.ebackuptime String 实例每天备份区间的结束时间,实际执行可能会有一点误差

4. 错误码表

以下是本接口常见的错误码,如果有不在此列的错误请查阅TDSQL错误码表

错误码 描述
DbOperationFailed DB内部失败
OssOpertaionFailed OSS内部失败
OSSGetInstanceError OSS获取实例信息错误
InnerSystemError 内部系统错误,和业务无关

5. 示例

输入

https://tdsql.api.qcloud.com/v2/index.php?Action=CdbTdsqlGetBackupTime
&<公共请求参数>
&cdbInstanceIds.0=40746

输出

{
    "code":"0",
    "message":"",
    "codeDesc":"Success",
    "data":{
        "totalCnt":"1",
        "instances":[
            {
                "id":"40746",
                "uuid":"tdsql-33y5ai5p",
                "sbackuptime":"00:00",
                "ebackuptime":"23:59"
            }
        ]
    }
}