AgenticSpace是AgenticFS中为单个Agent终端用户分配的独立工作空间,支持容量配额、文件数配额、访问隔离与性能隔离。本文介绍如何通过控制台或OpenAPI创建、修改、删除AgenticSpace,以及在ECS或Agent Sandbox中挂载AgenticSpace。
使用限制
创建AgenticSpace
支持控制台和OpenAPI两种方式。创建时需指定路径与配额,下表为关键参数。
参数 | 必填 | 说明 |
FileSystemPath | 是 | AgenticSpace路径,例如 |
SizeLimit | 是 | 配额总容量限制,单位:Byte。 取值范围:
|
FileCountLimit | 是 | 配额文件数量限制,取值范围:
|
方式一:控制台
登录NAS控制台,进入目标AgenticFS文件系统的AgenticSpace页签。
单击创建AgenticSpace,按上表填写参数后提交。
方式二:OpenAPI
调用CreateAgenticSpace接口,请求示例:
POST /AgenticSpace/Create HTTP/1.1
Host: nas.aliyuncs.com
Content-Type: application/json
{
"FileSystemId":"031*******",
"FileSystemPath":"/test5/",
"RegionId":"cn-shanghai",
"Azone":"cn-shanghai-f",
"Quota.SizeLimit":"110595407872",
"Quota.FileCountLimit":100004
}查看与修改配额
在AgenticSpace列表中可查看目录路径、可用区、容量配额GiB/当前容量GiB、文件数配额/当前文件数、创建时间等字段。单击目标行操作列的编辑调整容量限制、文件数限制;也可调用SetAgenticSpaceQuota接口。
新配额必须高于当前已使用值,否则修改失败。
接入点(AccessPoint)
接入点是AgenticFS的NFS协议访问入口,承担挂载寻址、权限校验与流量隔离。AgenticFS的接入点支持两种粒度:
AgenticFS粒度:接入点指向AgenticFS根,用于平台运维、批量管理AgenticSpace等可信场景。当前版本AgenticFS根目录暂不支持挂载,仅用于OpenAPI管控调用。
AgenticSpace粒度:接入点指向单个AgenticSpace,挂载后视图被限制在对应AgenticSpace内,是Agent会话拉起的标准入口。
RAM访问授权
挂载前,请为挂载凭据对应的RAM用户或RAM角色配置访问策略。相关操作权限和接入点限制说明如下。
策略元素 | 配置项 | 说明 |
|
| 允许挂载文件系统和读取数据。只读、读写场景均需授予。 |
|
| 允许写入数据。需与 |
|
| 允许以root身份访问文件系统,按需授予。该权限不替代写入权限。 |
|
| 限定允许访问的接入点。填写目标接入点的ARN,例如, |
根据业务需求选择以下策略,并将<接入点ARN>替换为目标AgenticSpace接入点的ARN。
只读策略
允许挂载和读取数据,不授予写入权限。
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"nas:ClientMount"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"nas:AccessPointArn": "<接入点ARN>"
}
}
}
]
}读写策略
允许挂载、读取和写入数据。
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"nas:ClientMount",
"nas:ClientWrite"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"nas:AccessPointArn": "<接入点ARN>"
}
}
}
]
}如需以root身份访问文件系统,请在所选策略的Action数组中追加nas:ClientRootAccess。以root身份写入数据时,需同时授予nas:ClientMount、nas:ClientWrite和nas:ClientRootAccess。
创建策略后,将其授权给挂载凭据对应的RAM用户或RAM角色。
建议为不同Agent应用、不同终端用户使用相互隔离的RAM角色与接入点,避免越权访问其他AgenticSpace。
挂载AgenticSpace
AgenticSpace支持在ECS上通过ALINAS客户端直接挂载。需先完成上文 接入点(AccessPoint) 的RAM授权,且计算节点需与AgenticFS接入点在同一VPC。
说明 当前版本仅支持挂载AgenticSpace,AgenticFS根目录暂不支持挂载。
场景一:在ECS上挂载
在AgenticSpace列表中获取挂载地址。挂载地址即对应AgenticSpace接入点的NFS域名,挂载后视图自动限制在该AgenticSpace内。
在ECS(Linux)安装NFS客户端:
# CentOS / Alibaba Cloud Linux sudo yum install -y nfs-utils # Ubuntu / Debian sudo apt-get install -y nfs-common确认用于挂载的RAM用户已获得上文所需的访问权限,然后配置该用户的AccessKey凭据,用于接入点鉴权。需要写入数据时,请使用读写策略。
sudo mkdir -p /etc/aliyun/alinas sudo tee /etc/aliyun/alinas/.credentials > /dev/null <<EOF [NASCredentials] accessKeyID = <子账号AK> accessKeySecret = <子账号SK> EOF执行以下挂载命令:
sudo mount -t alinas -o tls,vers=3,ram <挂载地址>:/ /mnt/agenticspace挂载后,执行
df -h检查挂载结果。然后,使用应用实际运行的用户身份验证文件读取。对于读写场景,还应在具有写入权限的目录中创建临时文件,验证写入是否成功。
删除AgenticSpace
删除前需卸载所有接入点并备份数据,删除操作不可恢复。
在AgenticSpace管理列表中单击目标行操作列的删除,或调用DeleteAgenticSpace接口。删除完成后,原路径可重新创建AgenticSpace。
常见问题
挂载时返回 access denied?
检查ECS与AgenticFS是否在同一VPC。
已挂载成功,但无法写入文件怎么办?
检查挂载凭据对应的RAM用户或RAM角色是否同时拥有nas:ClientMount和nas:ClientWrite权限。仅授予nas:ClientMount可以挂载和读取数据,无法获得写入权限。
同时,确认策略中的nas:AccessPointArn与当前挂载的接入点一致,并检查应用运行用户是否具有目标目录的写入权限。如需以root身份访问文件系统,还需授予nas:ClientRootAccess。
写入返回 no space?
已达到容量或文件数配额上限。通过修改配额扩容,或清理AgenticSpace中的文件。
是否支持跨AgenticFS迁移AgenticSpace?
当前版本不支持。需先创建新AgenticSpace,再通过应用层复制数据。
能否使用SMB或Windows访问?
不支持。AgenticFS当前仅支持NFS v3协议与Linux客户端。