ModifyPortRangeList - 修改端口列表的属性

修改指定端口列表的名称、条目,支持增加、修改和删除条目。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

端口列表所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
ClientTokenstring

保证请求幂等性。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PortRangeListIdstring

待修改的端口列表 ID。

prl-2ze9743****
PortRangeListNamestring

端口列表的名称。长度为 2~128 个字符,必须以大小字母或中文开头,不能以 http://、https://、com.aliyun 和 com.alibabacloud 开头。可以包含中文、英文、数字、半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)。

PortRangeListNameSample
Descriptionstring

端口列表的描述信息。长度为 2~256 个英文或中文字符,不能以 http://和 https://开头。

This is description.
AddEntryarray<object>

增加或修改的端口列表条目数组。

object

增加或修改的端口列表条目对象。

PortRangestring

端口范围,N 的取值范围:0~200。使用限制:

  • 条目数量不能大于最大条目容量(MaxEntries)。

  • 不允许设置重复的 PortRange

  • 不允许与RemoveEntry.N.PortRange 参数值重复。

80/80
Descriptionstring

端口范围的描述信息。长度为 2~32 个英文或中文字符,不能以 http://和 https://开头。N 的取值范围:0~200。

This is description.
RemoveEntryarray<object>

删除的端口列表条目数组。

object

删除的端口列表条目对象。

PortRangestring

端口范围,N 的取值范围:0~200。使用限制:

  • 不允许设置重复的PortRange

  • 不允许与AddEntry.N.PortRange 参数值重复。

80/80

返回参数

名称类型描述示例值
object

返回参数集合。

RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HTTP status code错误码错误信息描述
400InvalidOperation.ConflictThe port range list has conflict task.端口列表存在冲突的任务。
400InvalidPortRangeListId.NotFoundThe specified port range list was not found.未找到指定的端口列表。
400InvalidOperation.MaxEntriesCountExceedThe specified MaxEntries exceeded the upper limit.指定的MaxEntries参数超过了最大限制值。
400InvalidOperation.EntryCountExceedMaxEntriesThe number of entries in the port list exceeds MaxEntries.指定的条目数量超过了端口列表的MaxEntries的值。
400LimitExceed.MaxEntriesThe number of entries exceeds the MaxEntries of the specified PortRangeList.端口列表中的条目数量超过了MaxEntries的值。
400LimitExceed.EntryThe number of entries added or removed exceeds the limit.单次增加或删除的条目数量超出限制。
400InvalidParameter.PortRangeDuplicatedThe specified PortRange is duplicated.指定的端口范围存在重复。
400InvalidParameter.PortRangeListNameThe specified parameter PortRangeListName is not valid.指定的端口列表名称不合法。
400InvalidMaxEntries.LessThanCurrentEntriesThe specified MaxEntries is less than current entries.端口列表最大条目数,小于当前条目数量。
400InvalidParameter.PortRangeThe specified parameter PortRange is not valid. It should be two integers less than 65535 in specified format.端口列表中的条目PortRange不符合格式要求。应该指定小于65535的两个整数,用斜杠分隔。
400MissingParameterMissing mandatory parameter.参数不得为空。
400InvalidDescription.MalformedThe specifid Description is not valid.指定的资源描述格式不合法。长度为 2-256 个字符,不能以 http:// 和 https:// 开头。
403AuthorizationLimitExceedThe limit of authorization records in the security group reaches.安全组授权规则数达到上限,请您检查授权规则是否合理。
404InvalidRegionId.NotFoundThe specified parameter RegionId is not valid.指定的RegionId不存在,请您检查此产品在该地域是否可用。

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