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

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

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

制限​

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

バックアップファイルの確認​

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

ウェブコンソール経由​

Zilliz Cloud のウェブコンソールですべてのバックアップファイルとその詳細を確認するには、左側のナビゲーションで「Backups」をクリックしてください。

Cdf2b3by2o6SlOxUhKXcbMrMnth

RESTful API経由​

  • すべてのバックアップファイルを確認

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

    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-31a6b840e50b72d",
        "clusterName": "Dedicated-01",
        "projectId": "proj-b44a39b0c51cf21791a841",
        "backupId": "backup0_1e3c0988ecb7f0d",
        "backupName": "Dedicated-01_backup1",
        "backupType": "CLUSTER", // cluster/collection
        "creationMethod": "MANUAL", // auto/manual
        "status": "AVAILABLE",
        "size": 112, // unit: B
        "regionId": "aws-us-west-2",
        "expireTime": "2024-08-30T16:49:50Z",
        "collections": [
           {
               "collectionName": "medium_articles",
               "description": "Sample collection",
               "status": "LOADED" // LOADED/UNLOADED
           }
         ],
         "dbCollections": [
            {
              "dbName": "",
              "collections": [
               {
                   "collectionName": "medium_articles",
                   "description": "Sample collection",
                   "status": "LOADED" // LOADED/UNLOADED
               }
               ]
            }
         ],
        "createTime": "2024-07-30T16:49:50Z",
        "restoreNewInstancePolicies": [
                "LATEST",
                "ORIGINAL"
             ]
      }
    }

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"
  }
}