文档首页/ 智能体身份/ API参考/ API/ 策略集/ 更新策略集
更新时间：2026-11-04 GMT+08:00
查看PDF
分享

更新策略集

功能介绍

更新策略集的描述和标签。

URI

PUT /v1/policy-engines/{policy_engine_id}

表1 路径参数

参数

是否必选

参数类型

描述

policy_engine_id

是

String

参数解释：

策略集ID，系统自动生成的唯一标识符。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字及"-"、"_"组成，长度为12~59个字符。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

description

否

String

参数解释：

策略集的更新描述。

约束限制：

不涉及。

取值范围：

长度为1~4096个字符。

默认取值：

不涉及。

tags

否

Array of Tag objects

参数解释：

自定义标签列表，用于为工作负载身份添加标签，便于分类和管理。

约束限制：

列表最多20个标签。

取值范围：

不涉及。

默认取值：

不涉及。
表3 Tag

参数

是否必选

参数类型

描述

key

是

String

参数解释：

标签键，用于标识标签的名称。

约束限制：

首尾不能包含空格，不能以"_sys_"开头。

取值范围：

可以包含任意语种字母、数字、空格以及"_"、"."、":"、"/"、"="、"+"、"-"、"@"符号的任意组合，长度为1~128个字符。

默认取值：

不涉及。

value

是

String

参数解释：

标签值，用于标识标签的具体内容。

约束限制：

不涉及。

取值范围：

可以包含任意语种字母、数字、空格以及"_"、"."、":"、"/"、"="、"+"、"-"、"@"、"&"符号的任意组合，可以是空字符串，长度为0~255个字符。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

policy_engine

PolicyEngine object

参数解释：

策略集对象。

取值范围：

不涉及。
表5 PolicyEngine

参数

参数类型

描述

policy_engine_id

String

参数解释：

策略集ID，系统自动生成的唯一标识符。

取值范围：

只能由英文字母、数字及"-"、"_"组成，长度为12~59个字符。

name

String

参数解释：

策略集名称，由用户指定且不可变。

取值范围：

只能以英文字母开头，由英文字母、数字及"_"组成，长度为1~48个字符。

type

String

参数解释：

策略集类型，用于按类型过滤策略集。不指定时返回所有类型的策略集。

取值范围：

  • GATEWAY：用于网关的策略集，可绑定到网关实例。

  • TOKEN_VAULT：用于TokenVault的策略集，只能绑定到TokenVault实例。

description

String

参数解释：

策略集的可读描述。

取值范围：

长度为1~4096个字符。

urn

String

参数解释：

策略集的统一资源名称（URN）。

取值范围：

长度为1~1024个字符。

tags

Array of Tag objects

参数解释：

自定义标签列表。

取值范围：

不涉及。

created_at

String

参数解释：

UTC时间戳，记录资源的创建或更新时间。

取值范围：

使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ssZ。例如：2025-01-01T00:00:00Z。

updated_at

String

参数解释：

UTC时间戳，记录资源的创建或更新时间。

取值范围：

使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ssZ。例如：2025-01-01T00:00:00Z。
表6 Tag

参数

参数类型

描述

key

String

参数解释：

标签键，用于标识标签的名称。

取值范围：

可以包含任意语种字母、数字、空格以及"_"、"."、":"、"/"、"="、"+"、"-"、"@"符号的任意组合，长度为1~128个字符。

value

String

参数解释：

标签值，用于标识标签的具体内容。

取值范围：

可以包含任意语种字母、数字、空格以及"_"、"."、":"、"/"、"="、"+"、"-"、"@"、"&"符号的任意组合，可以是空字符串，长度为0~255个字符。

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

加密后的认证失败信息，可以通过STS5解密接口进行解密。

取值范围：

不涉及。

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

加密后的认证失败信息，可以通过STS5解密接口进行解密。

取值范围：

不涉及。

状态码：409

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

加密后的认证失败信息，可以通过STS5解密接口进行解密。

取值范围：

不涉及。

请求示例

更新策略集的描述和标签。

PUT https://{endpoint}/v1/policy-engines/{policy_engine_id}

{
  "description" : "Updated description",
  "tags" : [ {
    "key" : "environment",
    "value" : "production"
  }, {
    "key" : "team",
    "value" : "platform"
  } ]
}

响应示例

状态码：200

{
  "policy_engine" : {
    "policy_engine_id" : "285624f5-5958-4f36-b171-168303615bce",
    "name" : "my_policy_engine",
    "type" : "GATEWAY",
    "description" : "Updated description",
    "urn" : "agentIdentity:<region>:<account-id>:policyEngine:<policy-engine-id>",
    "tags" : [ {
      "key" : "environment",
      "value" : "production"
    }, {
      "key" : "team",
      "value" : "platform"
    } ],
    "created_at" : "2025-01-01 00:00:00",
    "updated_at" : "2025-01-03 00:00:00"
  }
}

状态码

状态码

描述

200

请求成功。

400

请求体异常。

404

未找到相应的资源。

409

请求冲突。

错误码

请参见错误码。

父主题： 策略集

相关文档