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

マネージドボリューム

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

考慮事項​

  • ボリュームは AWS および Google Cloud でのみ利用可能です。Azure をご利用の場合は、サポートにお問い合わせ ください。

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

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

  • ボリュームを作成および管理するには、プロジェクト管理者である必要があります。

  • ボリュームが作成されると、その設定を編集することはできません。ボリュームの設定を変更したい場合は、必要な設定で新しいボリュームを作成してください。

  • 各組織で作成できるマネージドボリュームの最大数は 100 です。

開始前の準備​

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

ボリュームマネージャーは、Zilliz Cloud のボリュームサービスへの接続を維持します。ボリュームを管理する前に、ボリュームマネージャーを初期化する必要があります。

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、およびボリューム名を以下のように指定する必要があります。

    # 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

    このパラメータを省略した場合、デフォルトでマネージドクラスターが作成されます。

  • ウェブコンソール経由

    1

    左側のナビゲーションで ボリュームs をクリックします。

    2

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

    3

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

    マネージドボリュームの作成時に使用する各パラメータの説明を次の表に示します。

    パラメータ

    説明

    Name

    ボリューム名は、組織全体で一意である必要があり、64文字以内で、文字またはアンダースコアで始まり、文字、数字、ハイフン、アンダースコアのみを含む必要があります。

    Description

    このパラメータはオプションです。

    ボリューム Type

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

    請求 Type

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

    • 本番ワークロードの場合は、従量課金ボリュームを作成します。

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

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

    4

    Create をクリックします。

List managed volumes​

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

  • SDK経由

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

  • ウェブコンソール経由

    Hp1Hwxoj9hkJqdbECCYcB4G6nVe

Describe managed volume​

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

  • Via SDKs

    # 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"
    # }
    export BASE_URL="https://api.cloud.zilliz.com"
    export TOKEN="YOUR_API_KEY"

    curl --request GET \
    --url "${BASE_URL}/v2/volumes/${VOLUME_NAME}" \
    --header "Authorization: Bearer ${TOKEN}" \
    --header "Content-Type: application/json"

    # {
    #    "code": 0,
    #    "data": {
    #        "volumeName": "ext-volume",
    #        "type": "MANAGED",
    #        "regionId": "aws-us-west-2",
    #        "status": "RUNNING",
    #        "createTime": "2024-04-15T12:00:00Z"
    #    }
    #}

  • ウェブコンソール経由

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

    FU4ow2zIuht0CfbRiBJcFZ6RnYf

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

現在、マネージドボリュームへのデータファイルまたはフォルダのアップロードは SDK を介してのみ行えます。

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

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

    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. ファイルまたはフォルダーのアップロード

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

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

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

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

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

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

      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

左側のナビゲーションで、ボリュームs をクリックします。

2

Files タブに切り替えます。

3

Actions 列で ... をクリックし、次に Delete をクリックします。

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

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

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

🚧Warning

削除されたボリュームは復元できません。慎重に進めてください。

  • SDK を使用する場合

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

    # 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

  • ウェブコンソール経由

    1

    左側のナビゲーションで ボリュームs をクリックします。

    2

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

    3

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

請求​

マネージドボリュームを作成する際、無料トライアル または pay-as-you-go プランを選択できます。以下の表では、それぞれの典型的なユースケースと制限を比較しています。

Free Trial

Pay-as-you-go

ユースケース

テスト環境のみ。

本番環境での使用。

容量

5 GB

無制限

アップロードごとのファイルサイズとファイル数

最大 1 GB のデータ、各アップロードあたり最大 1,000 ファイル

最大 100 GB のデータ、各アップロードあたりファイル数無制限

ボリュームの最大数

1

100

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

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

  • 各組織は無料トライアルボリュームを 1 つだけ保有できます。

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

従量課金ボリューム

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

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

    • マネージドボリュームが実行中の場合のみ課金されます。

    • 料金の詳細については、料金ガイド を参照してください。

    • ボリュームの料金計算方法については、ストレージコスト を参照してください。

FAQs​

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

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

ボリュームの使用を継続するには、まずすべての未払いの請求書を精算してください。

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

組織に無料トライアルボリュームが作成されると、無料トライアルボリュームのオプションは非表示になります。各組織は無料トライアルボリュームを 1 つだけ作成できます。

ボリュームのステータスはどのような意味ですか？

以下の表に、ボリュームの可能性のあるステータスを示します。

ステータス

説明

Available

ボリュームはアクティブで使用可能です。

Frozen

組織が未払いの請求書により凍結されています。ボリュームは新しい操作には使用できません。ボリュームの使用を継続するには、請求書をお支払いください。