更新 AgentStorage

更新时间:
复制 MD 格式

使用 UpdateAgentStorage 接口更新 AgentStorage 的别名、描述或网络 ACL。

前提条件

  • 拥有阿里云账号并获取 AccessKey(AccessKey ID 和 AccessKey Secret),用于管控面 OpenAPI 签名认证。

  • 当前账号或 RAM 子账号具备 AgentStorage 管理权限(如 AliyunOTSFullAccess 或对应管控策略)。

  • 目标 AgentStorage 实例须存在且状态为 normal;网络 ACL 变更可能影响现有数据面连接,更新前评估影响。

请求语法

POST /v2/openapi/updateagentstorage HTTP/1.1

请求参数

字段

类型

必填

说明

AgentStorageName

string

是

AgentStorage 名称。

AliasName

string

否

新的实例别名。

AgentStorageDescription

string

否

新的实例描述。

NetworkTypeACL

array<string>

否

允许的网络类型:CLASSIC、INTERNET、VPC。

NetworkSourceACL

array<string>

否

允许的网络来源;TRUST_PROXY 表示控制台。

Network 字段已经废弃,新请求不要使用。

请求示例

{
  "AgentStorageName": "agent-prod",
  "AliasName": "production-agent-storage",
  "AgentStorageDescription": "Production knowledge and memory storage",
  "NetworkTypeACL": ["VPC"]
}

响应

{
  "RequestId": "39871ED2-62C0-578F-A32E-B88072D5582F"
}

网络 ACL 变更可能影响现有数据面连接。更新后应使用 GetAgentStorage 确认配置,并验证应用连通性。