修改指定端口列表的名称、条目,支持增加、修改和删除条目。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 端口列表所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
ClientToken | string | 否 | 保证请求幂等性。 | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
PortRangeListId | string | 是 | 待修改的端口列表 ID。 | prl-2ze9743**** |
PortRangeListName | string | 否 | 端口列表的名称。长度为 2~128 个字符,必须以大小字母或中文开头,不能以 http://、https://、com.aliyun 和 com.alibabacloud 开头。可以包含中文、英文、数字、半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)。 | PortRangeListNameSample |
Description | string | 否 | 端口列表的描述信息。长度为 2~256 个英文或中文字符,不能以 http://和 https://开头。 | This is description. |
AddEntry | array<object> | 否 | 增加或修改的端口列表条目数组。 | |
object | 否 | 增加或修改的端口列表条目对象。 | ||
PortRange | string | 否 | 端口范围,N 的取值范围:0~200。使用限制:
| 80/80 |
Description | string | 否 | 端口范围的描述信息。长度为 2~32 个英文或中文字符,不能以 http://和 https://开头。N 的取值范围:0~200。 | This is description. |
RemoveEntry | array<object> | 否 | 删除的端口列表条目数组。 | |
object | 否 | 删除的端口列表条目对象。 | ||
PortRange | string | 否 | 端口范围,N 的取值范围:0~200。使用限制:
| 80/80 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidOperation.Conflict | The port range list has conflict task. | 端口列表存在冲突的任务。 |
400 | InvalidPortRangeListId.NotFound | The specified port range list was not found. | 未找到指定的端口列表。 |
400 | InvalidOperation.MaxEntriesCountExceed | The specified MaxEntries exceeded the upper limit. | 指定的MaxEntries参数超过了最大限制值。 |
400 | InvalidOperation.EntryCountExceedMaxEntries | The number of entries in the port list exceeds MaxEntries. | 指定的条目数量超过了端口列表的MaxEntries的值。 |
400 | LimitExceed.MaxEntries | The number of entries exceeds the MaxEntries of the specified PortRangeList. | 端口列表中的条目数量超过了MaxEntries的值。 |
400 | LimitExceed.Entry | The number of entries added or removed exceeds the limit. | 单次增加或删除的条目数量超出限制。 |
400 | InvalidParameter.PortRangeDuplicated | The specified PortRange is duplicated. | 指定的端口范围存在重复。 |
400 | InvalidParameter.PortRangeListName | The specified parameter PortRangeListName is not valid. | 指定的端口列表名称不合法。 |
400 | InvalidMaxEntries.LessThanCurrentEntries | The specified MaxEntries is less than current entries. | 端口列表最大条目数,小于当前条目数量。 |
400 | InvalidParameter.PortRange | The specified parameter PortRange is not valid. It should be two integers less than 65535 in specified format. | 端口列表中的条目PortRange不符合格式要求。应该指定小于65535的两个整数,用斜杠分隔。 |
400 | MissingParameter | Missing mandatory parameter. | 参数不得为空。 |
400 | InvalidDescription.Malformed | The specifid Description is not valid. | 指定的资源描述格式不合法。长度为 2-256 个字符,不能以 http:// 和 https:// 开头。 |
403 | AuthorizationLimitExceed | The limit of authorization records in the security group reaches. | 安全组授权规则数达到上限,请您检查授权规则是否合理。 |
404 | InvalidRegionId.NotFound | The specified parameter RegionId is not valid. | 指定的RegionId不存在,请您检查此产品在该地域是否可用。 |
访问错误中心查看更多错误码。