跳到主要内容

create_volume()

此操作用于在指定项目和区域中创建卷。

请求语法​

python
create_volume(
    project_id: str,
    region_id: str,
    volume_name: str,
    volume_type: Optional[str] = None,
    storage_integration_id: Optional[str] = None,
    path: Optional[str] = None,
) -> requests.Response

参数：

  • project_id (str) -
    [必填]
    待创建卷所属的Zilliz Cloud项目 ID。

  • region_id (str) -
    [必填]
    待创建卷所属的Zilliz Cloud区域 ID。

  • volume_name (str) -
    [必填]
    待创建的卷名称。

  • volume_type (Optional[str]) -
    默认值：None
    卷类型。支持的值包括MANAGED和EXTERNAL，默认为MANAGED。

  • storage_integration_id (Optional[str]) -
    默认值：None
    EXTERNAL卷所需的存储集成 ID。

  • path (Optional[str]) -
    默认值：None
    EXTERNAL卷的存储路径。若未指定，则使用存储集成的根目录；若指定路径，则必须以/结尾。

返回类型：

requests.Response

返回值：

包含卷创建请求信息的 HTTP 响应。

异常：

  • MilvusException
    当服务器拒绝请求或 RPC 调用失败时抛出。请查看服务器错误消息以了解具体的失败原因。

示例​

以下示例展示了如何创建卷。

python
from pymilvus.bulk_writer import VolumeFileManager, VolumeManager

manager = VolumeManager(cloud_endpoint="https://api.cloud.zilliz.com", api_key="YOUR_API_KEY")
manager.create_volume(project_id="proj-xxxx", region_id="aws-us-west-2", volume_name="book-volume", volume_type="EXTERNAL")
manager.describe_volume("book-volume")
manager.list_volumes(project_id="proj-xxxx", volume_type="EXTERNAL")

file_manager = VolumeFileManager(cloud_endpoint="https://api.cloud.zilliz.com", api_key="YOUR_API_KEY", volume_name="book-volume")
file_manager.upload_file_to_volume(source_file_path="./data/books.parquet", target_volume_path="datasets/books/books.parquet", upload_concurrency=4)
Ctrl I