创建 AgenticBucket Volume

存储配置

agenticBucketVolumeConfig 的字段与 Python SDK 参数对应如下：

挂载配置

mountConfig 用于保存挂载所需的 RAM 角色 ARN（Alibaba Cloud Resource Name，资源名称）。Python SDK 对应参数为 mount_config，类型为 models.CreateVolumeInputMountConfig。

AgenticBucket Volume 不支持 mountConfig.vpcConfig。

在创建 Volume 时保存角色配置，后续创建 Sandbox 挂载该 Volume 时复用这些配置。角色的创建方法及选择规则参见配置 RAM 角色。

环境变量说明

以下环境变量供本文示例读取。访问凭证按上述 SDK 说明配置，其余参数在创建示例中设置。

创建示例

在已配置访问凭证的终端中，设置以下参数，并将占位符替换为实际值。各变量的取值参见环境变量说明。

export SANDBOX_REGION_ID="<REGION>"
export SANDBOX_ENDPOINT="sandbox.${SANDBOX_REGION_ID}.aliyuncs.com"

export SANDBOX_TEAM_ID="<TEAM-ID>"
export SANDBOX_ROLE_ARN="acs:ram::<ACCOUNT-UID>:role/<ROLE-NAME>"
export SANDBOX_VOLUME_NAME="<VOLUME-NAME>"

export AGENTIC_BUCKET_NAME="<AGENTIC-BUCKET-FULL-NAME>"
export BUCKET_SPACE_NAME="<BUCKET-SPACE-FULL-NAME>"
export OSS_ENDPOINT="https://oss-<REGION>-internal.aliyuncs.com"

将以下代码保存为 10_create_agentic_bucket_volume.py：

import os

from alibabacloud_sandbox20260820 import models
from alibabacloud_sandbox20260820.client import Client as SandboxClient
from alibabacloud_tea_openapi import utils_models as open_api_models


def require_env(name: str) -> str:
    value = os.environ.get(name, "").strip()
    if not value:
        raise RuntimeError(f"缺少环境变量: {name}")
    return value


config = open_api_models.Config(
    access_key_id=require_env("ALIBABA_CLOUD_ACCESS_KEY_ID"),
    access_key_secret=require_env("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
    security_token=os.environ.get("ALIBABA_CLOUD_SECURITY_TOKEN"),
    region_id=require_env("SANDBOX_REGION_ID"),
    endpoint=require_env("SANDBOX_ENDPOINT"),
)

pop_client = SandboxClient(config)

response = pop_client.create_volume(
    models.CreateVolumeRequest(
        body=models.CreateVolumeInput(
            team_id=require_env("SANDBOX_TEAM_ID"),
            volume_name=require_env("SANDBOX_VOLUME_NAME"),
            mount_config=models.CreateVolumeInputMountConfig(
                role=require_env("SANDBOX_ROLE_ARN"),
            ),
            agentic_bucket_volume_config=models.AgenticBucketVolumeConfig(
                agentic_bucket=require_env("AGENTIC_BUCKET_NAME"),
                bucket_name=require_env("BUCKET_SPACE_NAME"),
                bucket_path="/",
                endpoint=require_env("OSS_ENDPOINT"),
                read_only=False,
            ),
        )
    )
)

if response.body is None or response.body.volume is None:
    raise RuntimeError("CreateVolume 未返回 Volume")

volume = response.body.volume
print(f"request_id={response.body.request_id}")
print(f"volume_id={volume.volume_id}")
print(f"volume_name={volume.volume_name}")
print(f"storage_class={volume.storage_class}")
print(f"status={volume.status}")

在同一终端运行：

python 10_create_agentic_bucket_volume.py

创建成功仅表示 Volume 配置已保存。参见挂载 AgenticBucket Volume创建 Sandbox 并按 Volume 名称挂载该 Volume，通过实际读写确认挂载可用。