Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
使用人工智能平台 Python SDK 查询存储配额、购买存储资源、创建 Volume、扩容、共享、删除和配置目录级权限。
quota = client.volumes.get_quota()
print(quota.data)
detail = client.volumes.get_quota_detail()
for item in detail.data:
print(item)
resp = client.orders.buy_storage(
orders=[
{
"quantity": 1,
"duration_days": 30,
"size_in_gi": 500,
"fs_type": "gpfs",
}
],
idempotency_key="storage-order-20260916-001",
)
print(resp.data)
200 替换为实际订单 ID：
orders = client.orders.list_storage_orders(status="active")
detail = client.orders.get_storage_order(order_id=200)
print(detail.data)
client.orders.renew_storage_order(order_id=200, duration_days=30)
client.orders.set_storage_auto_renew(order_id=200, enabled=True)
resp = client.volumes.create(
name="shared-dataset-v1",
capacity="500Gi",
fs_type="gpfs",
)
volume_id = resp.data["id"]
print(volume_id)
volumes = client.volumes.list(page=1, page_size=20)
for volume in volumes.rows:
print(volume)
detail = client.volumes.get(volume_id=50)
print(detail.data)
my_volumes = client.volumes.list_my_volumes()
print(my_volumes.data)
quota_chart = client.volumes.chart_quota_pie()
capacity_chart = client.volumes.chart_capacity_pie()
usage_chart = client.volumes.chart_usage_bar()
print(quota_chart.data)
print(capacity_chart.data)
print(usage_chart.data)
client.volumes.resize(volume_id=50, capacity="1Ti")
client.volumes.delete(volume_id=50)
client.volumes.delete_batch(volume_ids=[50, 51])
client.volumes.share(
volume_id=50,
users=[
{"user": "alice", "read_only": False},
{"user": "bob", "read_only": True},
],
)
client.volumes.share_add_users(
volume_id=50,
users=[
{"user": "carol", "read_only": False},
],
)
client.volumes.share_delete_users(
volume_id=50,
users=["bob"],
)
client.volumes.set_admins(
volume_id=50,
resource_admins=["admin1", "admin2"],
)
client.volumes.update_dir_mode(
volume_id=230,
dir_mode=True,
dir_whitelist=["alice", "bob", "carol"],
)
config = client.volumes.get_dir_config(volume_id=230)
print(config.data)
whitelist = client.volumes.get_dir_whitelist(volume_id=230)
print(whitelist.data)
get_dir_config() 会返回目录级权限完整配置，包括是否开启目录级权限、用户目录根、授权用户范围，以及公共目录、自定义目录和用户目录的授权信息。get_dir_whitelist() 可查询目录授权候选用户；如果已配置授权用户范围，候选用户来自该范围，否则来自当前 Volume 的授权用户。
创建公共目录：
client.volumes.create_dir(
volume_id=230,
dir_type="public",
path="/shared-volume/datasets",
perm="r",
note="public dataset",
)
resp = client.volumes.create_dir(
volume_id=230,
dir_type="custom",
path="/shared-volume/project-a",
)
entry_id = resp.data["id"]
client.volumes.set_dir_grants(
volume_id=230,
entry_id=entry_id,
grants=[
{"user": "alice", "perm": "rw"},
{"user": "bob", "perm": "r"},
],
)
perm。自定义目录需要通过 set_dir_grants() 显式授权，grants 不传或传空列表会清空该目录授权；公共目录不使用 set_dir_grants() 配置用户授权。
设置用户目录根路径和目录配额：
client.volumes.set_user_dir_base(
volume_id=230,
user_dir_base="/shared-volume/users",
)
client.volumes.set_dir_quota(
volume_id=230,
entry_id=13,
limit_quota="100Gi",
)
resp = client.volumes.list_my_dir_volumes()
print(resp.data)
quota = client.volumes.get_quota()
print(quota.data)
resp = client.volumes.create(
name="shared-dataset-v1",
capacity="500Gi",
fs_type="gpfs",
)
volume_id = resp.data["id"]
client.volumes.share(
volume_id=volume_id,
users=[
{"user": "alice", "read_only": False},
{"user": "bob", "read_only": True},
],
)
client.volumes.update_dir_mode(
volume_id=230,
dir_mode=True,
dir_whitelist=["alice", "bob"],
)
resp = client.volumes.create_dir(
volume_id=230,
dir_type="custom",
path="/shared-volume/project-a",
)
entry_id = resp.data["id"]
client.volumes.set_dir_grants(
volume_id=230,
entry_id=entry_id,
grants=[
{"user": "alice", "perm": "rw"},
{"user": "bob", "perm": "r"},
],
)