UpdateAgentStoragePolicy 更新访问控制策略-表格存储 Tablestore(Tablestore)-阿里云帮助中心

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

前提条件

说明

AgentStorage 管理 API 需使用 Tablestore 的 OpenAPI 域名，格式为 tablestore.<region>.aliyuncs.com，各地域完整域名请参见OpenAPI Endpoints。

拥有阿里云账号并获取 AccessKey（AccessKey ID 和 AccessKey Secret），用于管控面 OpenAPI 签名认证。
当前账号或 RAM 子账号具备 AgentStorage 管理权限（如 AliyunOTSFullAccess 或对应管控策略）。
目标 AgentStorage 实例须存在且状态为 normal；已从 GetAgentStorage 获取当前 PolicyVersion，建议先调用 CheckAgentStoragePolicy 校验新策略。

请求语法

POST /v2/openapi/updateagentstoragepolicy HTTP/1.1

请求参数

字段	类型	必填	说明
`AgentStorageName`	string	是	AgentStorage 名称。
`Policy`	string	是	JSON 格式的实例访问控制策略。
`PolicyVersion`	integer	是	访问控制策略版本。更新前从 `GetAgentStorage` 获取当前值。

请求示例

{
  "AgentStorageName": "agent-prod",
  "Policy": "{\"Version\":\"1\",\"Statement\":[{\"Action\":[\"ots:*\"],\"Resource\":[\"acs:ots:*:<account-id>:agentstorage/agent-prod*\"],\"Principal\":[\"*\"],\"Effect\":\"Allow\",\"Condition\":{\"StringEquals\":{\"ots:TLSVersion\":[\"1.2\"]}}}]}",
  "PolicyVersion": 2
}

响应

字段	类型	说明
`requestId`	string	请求 ID。当前公开 OpenAPI 示例使用小写开头。
`Code`	string	响应状态码。
`Message`	string	响应消息。

{
  "requestId": "B37BBA04-D827-55C8-B901-5264B904E8C6",
  "Code": "200",
  "Message": "success"
}

更新前建议先调用 CheckAgentStoragePolicy，更新后再次查询实例确认策略版本。