管理AgenticSpace

更新时间:
复制 MD 格式

AgenticSpace是AgenticFS中为单个Agent终端用户分配的独立工作空间,支持容量配额、文件数配额、访问隔离与性能隔离。本文介绍如何通过控制台或OpenAPI创建、修改、删除AgenticSpace,以及在ECS或Agent Sandbox中挂载AgenticSpace。

使用限制

  • 已创建AgenticFS文件系统。AgenticFS目前为白名单开放功能。如需开通,请前往配额中心提交AgenticFS白名单开通申请。如需加急审批,请提交工单

  • 单个AgenticFS最多100万个AgenticSpace;单个AgenticSpace上限1 PiB容量、10亿文件。

  • 路径不支持重命名、软链接,不支持AgenticSpace嵌套。

  • 仅支持NFS v3(Linux),不支持SMB与Windows。支持ECS、ACS Agent Sandbox等支持NFS v3挂载的Linux计算节点。

创建AgenticSpace

支持控制台和OpenAPI两种方式。创建时需指定路径与配额,下表为关键参数。

参数

必填

说明

FileSystemPath

是

AgenticSpace路径,例如 /workspace_user001。

SizeLimit

是

配额总容量限制,单位:Byte。

取值范围:

  • 最小值:10,737,418,240(10 GiB)。

  • 最大值:1,099,511,627,776,000(1024000 GiB)

  • 步长:107,3741,824(1 GiB)。

FileCountLimit

是

配额文件数量限制,取值范围:

  • 最小值:10,000。

  • 最大值:1,000,000,000。

方式一:控制台

  1. 登录NAS控制台,进入目标AgenticFS文件系统的AgenticSpace页签。

  2. 单击创建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角色配置访问策略。相关操作权限和接入点限制说明如下。

策略元素

配置项

说明

Action

nas:ClientMount

允许挂载文件系统和读取数据。只读、读写场景均需授予。

Action

nas:ClientWrite

允许写入数据。需与nas:ClientMount一起授予。

Action

nas:ClientRootAccess

允许以root身份访问文件系统,按需授予。该权限不替代写入权限。

Condition

nas:AccessPointArn

限定允许访问的接入点。填写目标接入点的ARN,例如,acs:nas:cn-shanghai:117848947****:accesspoint/ap-****。您可以在接入点的基本信息页面中获取ARN。具体操作,请参见查看接入点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上挂载

  1. 在AgenticSpace列表中获取挂载地址。挂载地址即对应AgenticSpace接入点的NFS域名,挂载后视图自动限制在该AgenticSpace内。

  2. 在ECS(Linux)安装NFS客户端:

    # CentOS / Alibaba Cloud Linux
    sudo yum install -y nfs-utils
    
    # Ubuntu / Debian
    sudo apt-get install -y nfs-common
  3. 确认用于挂载的RAM用户已获得上文所需的访问权限,然后配置该用户的AccessKey凭据,用于接入点鉴权。需要写入数据时,请使用读写策略。

    sudo mkdir -p /etc/aliyun/alinas
    sudo tee /etc/aliyun/alinas/.credentials > /dev/null <<EOF
    [NASCredentials]
    accessKeyID = <子账号AK>
    accessKeySecret = <子账号SK>
    EOF
  4. 执行以下挂载命令:

    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客户端。