UpdateList - 更新自定义列表 - 边缘安全加速

调试

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

esa:UpdateList

update

*全部资源

*

无

名称	类型	必填	描述	示例值
Id	integer	是	自定义列表的 ID，可通过调用 ListLists 接口获取。	40000001
Name	string	是	更新后的自定义列表名称（需同时传入；不传保持原名称）。命名规则：仅支持字母、数字、下划线（`^\w{1,64}$`），长度 1–64；	example
Description	string	是	更新后的列表描述。	a custom list
Items	array	是	更新后的列表内容（JSON 数组字符串，例 `["1.1.1.1","2.2.2.2"]`）。全量覆盖语义：传入的 `Items` 会完全覆盖原有列表内容，不是追加。说明 ⚠️ 不传或传空时，原列表内容会被清空。若需保留原项并追加，请先调用 `GetList` 取现有 `Items`，拼接后一次性提交。元素格式：与列表创建时的 `Kind` 相关（UpdateList 不支持修改 Kind）： Kind = `ip`：每个元素必须为合法 IP 地址或 CIDR，不合法时返回 `WrongValueMatched` 其他 Kind：元素格式以约定为准，数量受租户 quota `NumberItemsPerList` 限制（仅 `ip` Kind 不受此限制）	a custom list
	string	否	更新后的列表内容项。	10.1.1.1

正常返回示例

JSON格式

{
  "RequestId": "36af3fcc-43d0-441c-86b1-428951dc8225"
}

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	The specified parameter is invalid.	输入参数规范校验失败。
400	InternalException	Failed to call the service. Try again later or contact technical support.	调用服务失败，请稍后重试或联系客服咨询详情。
403	%s.NotSupport	The specified resource type %s is not supported.	不支持指定的资源类型。如需使用该类型资源，请与我们联系。
403	%s.OverQuota	The quantity of %s exceeds the quota.	该资源的数量超出了配额所规定的范围，如需申请更多的额度，请与我们联系。
403	%s.WrongValueMatched	The value of specified parameter %s can not pass the matching check.	指定的参数对应的值不能通过匹配校验。如果您确定需要使用该参数值，请与我们联系。
403	List.NotExist	The specified list does not exist.	指定的列表不存在。

访问错误中心查看更多错误码。

更多信息，参考变更详情。