云數據庫MySQL

幫助中心 > 數據庫 > 云數據庫MySQL > API文檔 > 備份相關

備份相關

1.數據備份列表

接口地址

https://api.yisu.com/rds/backup/getDataLogList

HTTP METHOD

POST

HTTP BODY編碼格式

application/x-www-form-urlencoded

請求參數

以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見公共請求參數。

名稱	類型	是否必填	說明
instanceId	string	是
startTime	string	否	開始時間
endTime	string	否	結束時間：默認為該時間當天的23:59:59
currentPage	string	否	頁碼
pageSize	string	否	每頁數量

返回數據

名稱	類型	是否必須	備注	其他信息
code	number	非必須	錯誤碼
message	string	非必須	錯誤信息
data	object	非必須	返回數據
├─ totalResult	number	非必須	總記錄數
├─ currentPage	number	非必須	頁碼
├─ pageSize	number	非必須	每頁數量
├─ logFiles	object []	非必須	數據備份列表	item 類型: object
├─ fileName	string	必須	文件名
├─ fileSize	string	必須	文件大小
├─ backupMethod	number	必須	備份方式：2物理備份、1邏輯備份
├─ backupStrategy	number	必須	備份策略:1實例備份、2單庫備份
├─ backupType	number	必須	備份方式:1全量備份
├─ startTime	string	必須	備份開始時間
├─ endTime	string	必須	備份完成時間
├─ recoverTime	string	必須	備份機恢復時間點
├─ backupDbs	string []	必須	單庫備份數據庫列表	item 類型: string
├─		非必須
├─ enableRecover	number	必須	是否允許恢復備份1是0否
requestId	string	非必須	請求ID

請求示例

    curl -XPOST
    "https://api.yisu.com/rds/backup/getDataLogList" \
    -H "content-type: application/x-www-form-urlencoded" \
    -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=startTime=2021-07-10=endTime=2021-07-9=currentPage=1=pageSize=2"

返回示例

{
    "code": 200,
    "message": "請求成功",
    "data": {
        "totalResult": 6,
        "currentPage": 1,
        "pageSize": 10,
        "logFiles": [
            {
                "fileName": "auto_1625854443_840.xb",
                "fileSize": "165.98M",
                "backupMethod": 2,
                "backupStrategy": 1,
                "backupType": 1,
                "startTime": "2021-07-10 02:14:03",
                "endTime": "2021-07-10 02:14:08",
                "recoverTime": "2021-07-10 02:14:03",
                "backupDbs": [],
                "enableRecover": 1
            },
        ]
    },
    "requestId": "250e16d8ca796d7bc8a20a6cd8791558"
}

2.binlog備份列表

接口地址

https://api.yisu.com/rds/backup/getBinlogList

HTTP METHOD

POST

HTTP BODY編碼格式

application/x-www-form-urlencoded

請求參數

以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見公共請求參數。

名稱	類型	是否必填	說明
instanceId	string	是
startTime	string	否	開始時間
endTime	string	否	結束時間：默認為該時間當天的23:59:59
currentPage	string	否	頁碼
pageSize	string	否	每頁數量

返回數據

名稱	類型	是否必須	備注	其他信息
code	number	非必須	錯誤碼
message	string	非必須	錯誤信息
data	object	非必須	返回數據
├─ totalResult	number	非必須	總記錄數
├─ currentPage	number	非必須	頁碼
├─ pageSize	string	非必須	每頁數量
├─ logFiles	object []	非必須	數據備份列表	item 類型: object
├─ fileName	string	必須	文件名
├─ fileSize	string	必須	文件大小
├─ beginTime	string	必須	備份開始時間
├─ endTime	string	必須	備份完成時間
requestId	string	非必須	請求ID

請求示例

    curl -XPOST
    "https://api.yisu.com/rds/backup/getBinlogList" \
    -H "content-type: application/x-www-form-urlencoded" \
    -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=startTime=2021-07-9=endTime=2021-07-8=currentPage=1=pageSize=2"

返回示例

{
    "code": 200,
    "message": "請求成功",
    "data": {
        "totalResult": 4,
        "currentPage": 1,
        "pageSize": "2",
        "logFiles": [
            {
                "fileName": "mysql-bin.000005",
                "fileSize": "2.75K",
                "beginTime": "2021-07-08 14:46:28",
                "endTime": "2021-07-08 4:08:02"
            }
        ]
    },
    "requestId": "3f93023b89e532d730bf50301d81c074"
}

3.獲取備份設置明細

接口地址

https://api.yisu.com/rds/backup/getBackupSettingDetail

HTTP METHOD

POST

HTTP BODY編碼格式

application/x-www-form-urlencoded

請求參數

以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見公共請求參數。

名稱	類型	是否必填	說明
instanceId	string	是

返回數據

名稱	類型	是否必須	備注
code	number	非必須	錯誤碼
message	string	非必須	錯誤信息
data	object	非必須	返回數據
├─ backupSettings	object	非必須	備份設置明細
├─ instanceId	string	非必須	實例ID
├─ nextBackupTime	string	非必須	下次備份時間
├─ dataBackupPeriod	string	非必須	數據備份周期：Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday；多個用英文逗號隔開
├─ dataKeepDays	string	非必須	數據備份保留天數
├─ dataBackupTime	string	非必須	數據備份時間點：03:10-04:10
├─ backupLog	string	非必須	是否開啟日志備份
├─ logKeepDays	string	非必須	日志備份保留天數
requestId	string	非必須	請求ID

請求示例

    curl -XPOST
    "https://api.yisu.com/rds/backup/getBackupSettingDetail" \
    -H "content-type: application/x-www-form-urlencoded" \
    -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171"

返回示例

{
    "code": 200,
    "message": "請求成功",
    "data": {
        "backupSettings": {
            "instanceId": "yisurds-60e69eab6173d8-66643171",
            "nextBackupTime": "2021-07-11 02:00:00",
            "dataBackupPeriod": "Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday",
            "dataKeepDays": "7",
            "dataBackupTime": "02:00-04:00",
            "backupLog": "1",
            "logKeepDays": "7"
        }
    },
    "requestId": "6a235a15721d1b5c4d4d65f896508af9"
}

4.創建備份

接口地址

https://api.yisu.com/rds/backup/createBackup

HTTP METHOD

POST

HTTP BODY編碼格式

application/x-www-form-urlencoded

請求參數

以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見公共請求參數。

名稱	類型	是否必填	說明
instanceId	string	是	實例ID
backupStrategy	string	是	備份策略：1實例備份、2單庫備份
backupMethod	string	是	備份方式：2物理備份、1邏輯備份

返回數據

名稱	類型	是否必須	備注
code	number	非必須	錯誤碼
message	string	非必須	錯誤信息
requestId	string	非必須	請求ID

請求示例

    curl -XPOST
    "https://api.yisu.com/rds/backup/createBackup" \
    -H "content-type: application/x-www-form-urlencoded" \
    -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=backupStrategy=1=backupMethod=1"

返回示例

{
    "code": 200,
    "message": "請求成功",
    "requestId": "ecbd142fdba284b949538e7cd562ba4e"
}

5.獲取備份集的數據庫、表信息

接口地址

https://api.yisu.com/rds/backup/getRecordDbsInfo

HTTP METHOD

POST

HTTP BODY編碼格式

application/x-www-form-urlencoded

請求參數

以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見公共請求參數。

名稱	類型	是否必填	說明
instanceId	string	是	實例ID
fileName	string	是	備份集文件名

返回數據

名稱	類型	是否必須	備注	其他信息
code	number	非必須	錯誤碼
message	string	非必須	錯誤信息
data	object	非必須	返回數據
├─ filename	string	非必須	文件名
├─ dbs	object []	非必須	當前備份文件時間點的數據庫列表	item 類型: object
├─ db_name	string	必須	數據庫名
├─ tables	object []	必須	數據表列表	item 類型: object
├─ name	string	必須	表名
├─ size	string	必須	數據大小，單位MB
requestId	string	非必須	請求ID

請求示例

    curl -XPOST
    "https://api.yisu.com/rds/backup/getRecordDbsInfo" \
    -H "content-type: application/x-www-form-urlencoded" \
    -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=fileName=auto_1626027242_716.xb"

返回示例

{
    "code": 200,
    "message": "請求成功",
    "data": {
        "filename": "auto_1626027242_716.xb",
        "dbs": [
            {
                "db_name": "db2",
                "tables": [
                    {
                        "name": "sbtest1",
                        "size": "23.063"
                    }
                ]
            }
        ]
    },
    "requestId": "148ccfe12bc5947e7ec41b9b1f2cf038"
}

6.恢復備份

接口地址

https://api.yisu.com/rds/backup/recoverBackup

HTTP METHOD

POST

HTTP BODY編碼格式

application/x-www-form-urlencoded

請求參數

以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見公共請求參數。

名稱	類型	是否必填	說明
instanceId	string	是	實例ID
fileName	string	是	文件名
backupInfos	string	是	恢復明細

返回數據

名稱	類型	是否必須	備注
code	number	非必須	錯誤碼
message	string	非必須	錯誤信息
requestId	string	非必須	請求ID

請求示例

    curl -XPOST
    "https://api.yisu.com/rds/backup/recoverBackup" \
    -H "content-type: application/x-www-form-urlencoded" \
    -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=fileName=auto_1626027242_716.xb=backupInfos=%5B%7B%22backupType%22%3A%22db%22%2C%22dbName%22%3A%22db2%22%2C%22backupDbName%22%3A%22db2_backup_backup%22%2C%22tableName%22%3A%22%22%2C%22backupTableName%22%3A%22%22%7D%2C%7B%22backupType%22%3A%22table%22%2C%22dbName%22%3A%22t101%22%2C%22backupDbName%22%3A%22t101%22%2C%22tableName%22%3A%22T1%22%2C%22backupTableName%22%3A%22T1_backup_backup%22%7D%5D"

返回示例

{
    "code": 200,
    "message": "請求成功",
    "requestId": "108207b88d3975ac162ed8697e8ea899"
}

7.獲得備份文件下載地址

接口地址

https://api.yisu.com/rds/backup/getDownloadLink

HTTP METHOD

POST

HTTP BODY編碼格式

application/x-www-form-urlencoded

請求參數

以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見公共請求參數。

名稱	類型	是否必填	說明
instanceId	string	是	實例ID
fileName	string	是	文件名

返回數據

名稱	類型	是否必須	備注
code	number	非必須	錯誤碼
message	string	非必須	錯誤信息
data	object	非必須	返回數據
├─ fileLinks	object	非必須	下載鏈接信息
├─ outer_address	string	非必須	下載鏈接地址
requestId	string	非必須	請求ID

請求示例

    curl -XPOST
    "https://api.yisu.com/rds/backup/getDownloadLink" \
    -H "content-type: application/x-www-form-urlencoded" \
    -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=fileName=auto_1626027242_716.xb"

返回示例

{
    "code": 200,
    "message": "請求成功",
    "data": {
        "fileLinks": {
            "outer_address": "http://rpm9.file.yisu.com/mysql/1229/auto_1626027242_716.xb?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=download%2F20210712%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210712T025129Z&X-Amz-Expires=7200&X-Amz-SignedHeaders=host&X-Amz-Signature=eda3eee7be52b2f5d7b3b5d94d2413fb22040a3273877b8dd2ceb2eac2053346"
        }
    },
    "requestId": "48b2ca4fb446cfe251e2964504aef23a"
}

備份相關

1.數據備份列表

接口地址

HTTP METHOD

HTTP BODY編碼格式

請求參數

返回數據

請求示例

返回示例

2.binlog備份列表

接口地址

HTTP METHOD

HTTP BODY編碼格式

請求參數

返回數據

請求示例

返回示例

3.獲取備份設置明細

接口地址

HTTP METHOD

HTTP BODY編碼格式

請求參數

返回數據

請求示例

返回示例

4.創建備份

接口地址

HTTP METHOD

HTTP BODY編碼格式

請求參數

返回數據

請求示例

返回示例

5.獲取備份集的數據庫、表信息

接口地址

HTTP METHOD

HTTP BODY編碼格式

請求參數

返回數據

請求示例

返回示例

6.恢復備份

接口地址

HTTP METHOD

HTTP BODY編碼格式

請求參數

返回數據

請求示例

返回示例

7.獲得備份文件下載地址

接口地址

HTTP METHOD

HTTP BODY編碼格式

請求參數

返回數據

請求示例

返回示例

5.獲取備份集的數據庫、表信息