メインコンテンツまでスキップ
バージョン: User Guides (Cloud)

バックアップファイルの管理

このガイドでは、既存のバックアップファイルを表示・名前変更・削除する方法について説明します。

📘Notes

この機能はDedicatedクラスターでのみ利用可能です。

制限​

  • アクセス制御: プロジェクト管理者、組織オーナー、またはバックアップ権限を持つカスタムロールが必要です。

バックアップファイルの表示​

完了済みまたは進行中のすべてのバックアップファイルの一覧を表示し、その詳細を確認できます。

ウェブコンソール経由​

Zilliz Cloudウェブコンソールでバックアップファイルとその詳細を表示するには、左側のナビゲーションメニューから「Backups」をクリックします。

Cdf2b3by2o6SlOxUhKXcbMrMnth

RESTful API経由​

  • すべてのバックアップファイルを表示

    次の例では、プロジェクトIDもクラスターIDも指定されていないため、現在の組織内のすべてのバックアップファイルが一覧表示されます。特定のプロジェクトまたはクラスターのバックアップを表示するには、リクエストに該当するプロジェクトIDまたはクラスターIDを含めてください。RESTful APIの詳細については、List Backupsを参照してください。

    curl --request GET \
         --url "${BASE_URL}/v2/backups" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json"

以下は出力例です。

  • バックアップファイルの詳細を表示

    次の例では、バックアップファイルの詳細を確認します。RESTful API の詳細については、「Describe Backup」を参照してください。

    curl --request GET \
         --url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/${BACKUP_ID}" \
         --header "Authorization: Bearer ${TOKEN}" \
         --header "Accept: application/json"

    以下は出力例です。

    {
      "code": 0,
      "data": {
        "clusterId": "in01-3e5ad8adc38xxxx",
        "clusterName": "Dedicated-01",
        "regionId": "aws-us-west-2",
        "projectId": "proj-20e13e974c7d659a83xxxx",
        "backupId": "backup1_0b9d15a0ddexxxx",
        "backupName": "Dedicated-01_backup3",
        "backupType": "CLUSTER",
        "creationMethod": "AUTO",
        "status": "AVAILABLE",
        "size": 0,
        "collections": [],
        "createTime": "2024-08-26T02:27:51Z",
        "expireTime": "2024-09-02T02:27:51Z"
      }
    }

Rename backup files​

現在、バックアップファイルの名前変更はウェブコンソール経由でのみサポートされています。

以下のデモでは、Zilliz Cloud ウェブコンソールでバックアップファイルの名前を変更する方法を示します。

Delete backup files​

Zilliz Cloud では、バックアップの作成方法に応じて削除の挙動が異なります。

  • 手動バックアップ は、クラスターが削除されても永続的に保持されます。コストを削減するため、不要になった手動バックアップは手動で削除することを推奨します。

  • 自動バックアップ は、保持期間が終了するか、関連するクラスターが削除されると自動的に削除されます。また、いつでも手動で削除することも可能です。

ウェブコンソール経由​

以下のデモでは、Zilliz Cloud ウェブコンソールでバックアップファイルを削除する方法を示します。

RESTful API経由​

以下の例では、バックアップファイルを削除します。RESTful API の詳細については、Delete Backup をご覧ください。

curl --request DELETE \
     --url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/${BACKUP_ID}" \
     --header "Authorization: Bearer ${TOKEN}" \
     --header "Accept: application/json" \
     --header "Content-type: application/json"

以下は出力例です。

{
  "code": 0,
  "data": {
    "backupId": "backup11_dbf5a40a6e5xxxx",
    "backupName": "medium_articles_backup4"
  }
}