機能の概要
指定されたOceanBase Cloudインスタンスのバックアップセットに対するダウンロードリンクを作成します。バックアップセットIDを指定する必要があります。システムは一時的なダウンロードタスクIDを生成します。このリンクは、後でバックアップセットファイルをダウンロードするために使用できます。
呼び出しの説明
インターフェース制約
呼び出し元はマルチクラウドAPIにアクセスするためのキーを保有している必要があります。AccessKey IDとAccessKey Secretの取得方法については、アクセスキーの管理を参照してください。
リクエストパス
POST /api/v2/instances/{instanceId}/backup/link
リクエストパラメータ
Path
パラメータ |
タイプ |
必須 |
説明 |
例 |
|---|---|---|---|---|
| instanceId | String | はい | OceanBaseクラスタID | obcluster-***** |
Query
パラメータ |
タイプ |
必須 |
説明 |
例 |
|---|---|---|---|---|
| requestId | String | はい | 追跡用のリクエストID | d04eabba**** |
Body
パラメータ |
タイプ |
必須 |
説明 |
例 |
|---|---|---|---|---|
| instanceId | String | はい | OceanBaseクラスタID | obcluster-***** |
| backupSetId | String | はい | バックアップセットID | backup_1**** |
| UID | String | いいえ | ユーザーID。 | 20000600**** |
| User_ID | String | いいえ | ユーザーID | 20000600**** |
| requestId | String | いいえ | 追跡用のリクエストID | dc302d76-66b5-48d8-ab53-a035******** |
| callerType | String | いいえ | 呼び出し元のタイプ | sub |
| accessKeyId | String | いいえ | アクセスキーID | ak-xxxxx**** |
| securityToken | String | いいえ | セキュリティトークン | sts-token-xxxxxxxx |
| callerUid | String | いいえ | 呼び出し元のID | 20000600**** |
| callerBid | String | いいえ | 呼び出し元のBID | xxxxxx |
| stsTokenCallerUid | String | いいえ | STSトークン呼び出し元UID | 20000600**** |
| stsTokenCallerBid | String | いいえ | STSトークン呼び出し元BID | xxxxxx |
| acceptLanguage | String | いいえ | リクエストまたはレスポンスで使用する言語。 | zh-CN |
| pageNumber | Integer | いいえ | ページ番号 | 1 |
| pageSize | Integer | いいえ | ページサイズ | 10 |
| mergedCallerBid | String | いいえ | マージ後の呼び出し元業務アイデンティティID。 | xxxxxx |
戻り値
フィールド |
タイプ |
説明 |
サンプル値 |
|---|---|---|---|
| success | Boolean | 成功かどうか | true |
| errorCode | String | エラーコード | INVALID_PARAMETER |
| errorMessage | String | エラーメッセージ | Invalid parameter |
| data | Object | 業務データ(object) | None |
| data.downloadTaskId | Integer | ダウンロードタスクID | xxxxxx |
| cost | Number | 所要時間 | 1.0 |
| server | String | サーバーアドレス、通常はOBServerノードのIP | 10.0.0.10 |
| requestId | String | リクエストID | d04eabba**** |
| totalCount | Number | 総レコード数。 | 100.0 |
| extra | Object | 拡張情報。 | {} |
例
リクエスト例
curl --digest -u '<Your AccessKey ID:AccessKey Secret>' \
-X POST \
'https://api-cloud.oceanbase.com/api/v2/instances/{instanceId}/backup/link?requestId=d04eabba****' \
-H 'Content-Type: application/json' \
-d '{
"instanceId": "obcluster-*****",
"backupSetId": "backup_1****"
}'
レスポンス例
JSON形式
{
"success": true,
"errorCode": "INVALID_PARAMETER",
"errorMessage": "Invalid parameter",
"data": {
"downloadTaskId": 1
},
"cost": 1.0,
"server": "xxx.xxx.x.xxx:xxx",
"requestId": "d04eabba****",
"totalCount": 100.0,
"extra": "{}"
}