メインコンテンツまでスキップ

Managed Volumes

Region availability

この機能は、すべての AWS リージョンおよび Google Cloud リージョンで利用可能ですが、Microsoft Azure では利用できません。Azure でボリュームを使用する場合は、お問い合わせください。

マネージドボリュームは、インポートや移行で使用するデータファイルを格納するための Zilliz Cloud ホスト型オブジェクトストアです。このページでは、Web コンソールおよび SDK を使用したマネージドボリュームの作成、管理、削除の方法について説明します。

考慮事項​

  • ボリュームは、プロジェクトが属するクラウドプロバイダーおよびリージョンに限定されます。たとえば、プロジェクトが AWS us-west-2 にある場合、作成できるボリュームも AWS us-west-2 のみに限られます。

  • クラスターでボリュームを使用するには、そのクラスターがボリュームと同じクラウドプロバイダーおよびリージョンに存在する必要があります。

  • ボリュームの作成および管理を行うには、Project Admin 権限が必要です。

  • ボリュームの設定は作成後に変更できません。設定を変更したい場合は、希望する設定で新しいボリュームを作成してください。

  • 1 つの組織あたり、最大 100 個のマネージドボリュームを作成できます。

事前準備​

SDK を使用してボリュームを作成・管理する場合は、まずボリュームマネージャーを初期化する必要があります。

ボリュームマネージャーは、Zilliz Cloud のボリュームサービスへの接続を維持します。ボリュームを管理する前に、ボリュームマネージャーを初期化してください。

python
from pymilvus.bulk_writer.volume_manager import VolumeManager

volume_manager = VolumeManager(
    cloud_endpoint="https://api.cloud.zilliz.com",
    api_key="YOUR_API_KEY"
)

マネージドボリュームの作成​

ボリュームは、Web コンソールまたは SDK を通じて作成できます。

  • SDK を使用する場合

    ボリュームは Zilliz Cloud プロジェクトに固有のものです。ボリュームを作成する際は、以下のようにプロジェクト ID、リージョン ID、ボリューム名を指定する必要があります。

    python
    # Initiate a volume manager
    from pymilvus.bulk_writer.volume_manager import VolumeManager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    # Create a managed volume
    volume_manager.create_volume(
        project_id="proj-xxxxxxxxxxxxxxxxxxxxxxx", 
        region_id="aws-us-west-2", 
        volume_name="managed_volume"
    )

    print(f"\nVolume managed_volume created")

    # Volume managed_volume created

    各パラメーターの説明は以下の表のとおりです。

    パラメーター説明
    projectIdボリュームを作成するプロジェクトの ID です。
    regionId作成するボリュームのリージョンは、データのインポートまたは移行先となるターゲットクラスターのクラウドプロバイダーおよびリージョンと一致している必要があります。
    volumeName作成するボリュームの名前は、組織全体で一意である必要があります。64 文字以内で、先頭は英字またはアンダースコアとし、使用できる文字は英数字、ハイフン、アンダースコアに限られます。
    type(任意)選択肢: MANAGED、EXTERNAL
    このパラメーターを省略した場合、デフォルトでマネージドクラスターが作成されます。
    description(任意)作成するボリュームの説明です。最大 255 文字まで入力できます。

  • Web コンソールを使用する場合

    1

    左側のナビゲーションメニューから Volumes をクリックします。

    2

    ボリューム一覧ページで + Volume をクリックします。

    3

    ボリュームの設定を行います。

    マネージドボリューム作成時の各パラメーターについては、以下の表を参照してください。

    パラメーター

    説明

    名前

    ボリューム名は組織全体で一意である必要があります。64 文字以内で、先頭は英字またはアンダースコアとし、使用できる文字は英数字、ハイフン、アンダースコアに限られます。

    説明 (任意)

    任意のパラメーターです。最大 255 文字まで入力できます。

    ボリュームタイプ

    ボリュームタイプとして「Managed」を選択します。

    課金タイプ

    • マネージドボリューム機能を試用するだけの場合は、無料トライアルボリュームを作成してください。無料トライアルボリュームは組織ごとに 1 回のみ作成可能で、容量やファイルアップロード数に制限があります。詳細は、課金セクションの比較表をご確認ください。

    • 本番ワークロードで使用する場合は、従量課金ボリュームを作成してください。

    クラウドプロバイダーとリージョン

    ボリュームのクラウドプロバイダーおよびリージョンは、データのインポートまたは移行先となるターゲットクラスターのものと一致している必要があります。

    4

    Create をクリックします。

マネージドボリュームの一覧表示​

プロジェクト内の既存のボリュームをすべて確認できます。

  • SDK を使用する場合

    python
    # Initiate a volume manager
    from pymilvus.bulk_writer.volume_manager import VolumeManager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    # View volumes
    volume_list = volume_manager.list_volumes(
        project_id="proj-xxxxxxxxxxxxxxxxxxxxxxx",
        current_page=1, 
        page_size=10
    )

    print(f"\nlistVolumes results: \n", volume_list.json()['data'])

    # listVolumes results: 
    # 
    # {
    #     "count": 1,
    #     "currentPage": 1,
    #     "pageSize": 10,
    #     "volumes": [
    #         {
    #             "volumeName": "external_volume"
    #             "type":"EXTERNAL"
    #         }        
    #     ]
    # }

  • Web コンソールを使用する場合

    Hp1Hwxoj9hkJqdbECCYcB4G6nVe

マネージドボリュームの詳細確認​

特定のマネージドボリュームの詳細を確認することもできます。

  • SDK を使用する場合

    python
    # Initiate a volume manager
    from pymilvus.bulk_writer.volume_manager import VolumeManager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    # View volumes
    volume_list = volume_manager.describe_volume(
        volume_name="managed_volume",
    )

    print(f"\ndescVolume result: \n", volume_list.json()['data'])

    # describeVolume result: 
    # {
    #    "volumeName": "managed_volume",
    #    "type": "MANAGED",
    #    "regionId": "aws-us-west-2",
    #    "status": "RUNNING",
    #    "createTime": "2026-05-06T02:24:26Z"
    # }

  • Web コンソールを使用する場合

    プロジェクト内のボリューム一覧を表示し、ボリューム名をクリックするとその詳細を確認できます。

    FU4ow2zIuht0CfbRiBJcFZ6RnYf

マネージドボリュームへのデータアップロード​

現在、データファイルまたはフォルダーをマネージドボリュームにアップロードするには、SDK を使用する必要があります。

  1. ボリュームファイルマネージャーの初期化

    ボリュームファイルマネージャーは、Zilliz Cloud のボリュームサービス上の特定のボリュームとの接続を管理します。ボリュームにファイルをアップロードする前に、ボリュームファイルマネージャーを初期化する必要があります。

    python
    from pymilvus.bulk_writer.volume_file_manager import VolumeFileManager

    volume_file_manager = VolumeFileManager(
        cloud_endpoint='https://api.cloud.zilliz.com',
        api_key='YOUR_API_KEY',
        volume_name='managed_volume',
    )

  2. ファイルまたはフォルダーのアップロード

    ボリュームファイルマネージャーの準備ができたら、それを使用して指定したマネージドボリュームにファイルまたはフォルダーをアップロードします。

    • ファイルのアップロード

      次の例では、ソースファイルパスのローカルファイルをボリューム内のターゲットファイルパスにアップロードします。

      python
      result = volume_file_manager.upload_file_to_volume(
          source_file_path="/path/to/your/local/data/file", 
          target_volume_path="data/"
      )

      print(f"\nuploadFileToVolume results: {result}")

      # uploadFileToVolume results: 
      # 
      # {
      #     "volumeName": "managed_volume",
      #     "path": "data/"
      # }

    • フォルダーのアップロード

      次の例では、ソースファイルパスのローカルファイルをボリューム内のターゲットファイルパスにアップロードします。

      python
      result = volume_file_manager.upload_file_to_volume(
          source_file_path="/path/to/your/local/data/folder/", 
          target_volume_path="data/"
      )

      print(f"\nuploadFileToVolume results: {result}")

      # uploadFileToVolume results: 
      # 
      # {
      #     "volumeName": "managed_volume",
      #     "path": "data/"
      # }

マネージドボリュームからデータを削除する​

マネージドボリュームからのデータ削除は、ファイルやフォルダーのサイズに応じて数分かかる場合があります。

📘⚠️ Warning

削除したファイルやフォルダーは復元できません。操作の際はご注意ください。

現在、マネージドボリュームからのデータ削除は Web コンソールでのみ行えます。

1

左側のナビゲーションで Volumes をクリックします。

2

Files タブに切り替えます。

3

Actions 列の ... をクリックし、Delete をクリックします。

マネージドボリュームを削除する​

不要になったマネージドボリュームはいつでも削除できます。なお、無料トライアルボリュームを作成できるのは組織あたり 1 回のみです。一度削除すると、再度作成することはできません。

マネージドボリュームを削除すると、そのボリューム内のすべてのファイルとフォルダーも同時に削除されます。

📘⚠️ Warning

削除したボリュームは復元できません。操作の際はご注意ください。

  • SDK を使用する場合

    マネージドボリュームは以下の方法で削除できます。

    python
    # Initiate a volume manager
    from pymilvus.bulk_writer.volume_manager import VolumeManager

    volume_manager = VolumeManager(
        cloud_endpoint="https://api.cloud.zilliz.com",
        api_key="YOUR_API_KEY"
    )

    # Delete a volume
    volume_manager.delete_volume(
        volume_name="managed_volume"
    )

    print(f"\nVolume managed_volume deleted")

    # Volume managed_volume deleted

  • Web コンソールを使用する場合

    1

    左側のナビゲーションで Volumes をクリックします。

    2

    Actions 列の ... をクリックし、Delete を選択します。

    3

    ボリューム名を入力し、Delete をクリックします。

課金​

マネージドボリュームの作成時に、無料トライアルまたは従量課金プランを選択できます。下表に、それぞれの一般的なユースケースと制限を示します。

無料トライアル従量課金
ユースケーステスト環境専用本番環境向け
容量5 GB無制限
アップロード時のファイルサイズと件数1 回のアップロードにつき最大 1 GB、ファイル数は 1,000 件まで1 回のアップロードにつき最大 100 GB、ファイル数は無制限
作成可能な最大ボリューム数1100

無料トライアルボリューム

  • 支払い方法の登録は不要です。

  • 無料トライアルボリュームは、各組織につき 1 つのみ作成できます。

  • 無料トライアルボリュームは 30 日間保持され、その後自動的に削除されます。

従量課金ボリューム

  • 有効な支払い方法の登録が必要です。

  • 従量課金ボリュームの使用には料金が発生します。

    • 料金は、マネージドボリュームが利用可能な状態にある期間のみ請求されます。

    • 価格の詳細については、Pricing Guide を参照してください。

    • ボリューム料金の計算方法については、Storage Cost を参照してください。

よくある質問​

請求書の未払いにより組織が凍結された場合、ボリュームはどうなりますか？

組織が凍結されると、無料トライアルおよび従量課金を含むすべてのマネージドボリュームと、そこに保存されているすべてのファイルが削除され、復元できなくなります。外部ボリュームも凍結され、新たな操作には使用できませんが、ご自身のバケット内のデータに影響はありません。

ボリュームの利用を再開するには、まず未払いの請求書をすべてお支払いください。

Web コンソールに無料トライアルボリュームのオプションが表示されないのはなぜですか？

組織内で一度でも無料トライアルボリュームを作成すると、そのオプションは非表示になります。無料トライアルボリュームは各組織につき 1 つのみ作成可能です。

ボリュームのステータスにはどのような意味がありますか？

ボリュームのステータスとその説明を下表に示します。

ステータス説明
Availableボリュームがアクティブで、使用可能な状態です。
Frozen請求書の未払いにより組織が凍結されています。このボリュームでは新たな操作を行えません。利用を再開するには、請求書のお支払いが必要です。
Ctrl I