ModifyPortRangeList - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Modifica el nombre y las entradas de una lista de rangos de puertos especificada. Puede agregar, modificar y eliminar entradas.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:ModifyPortRangeList

update

*PortRangeList.

acs:ecs:{#regionId}:{#accountId}:portrangelist/{#portRangeListId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región de la lista de rangos de puertos. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
ClientToken	string	No	El ID de la región de la lista de rangos de puertos. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
PortRangeListId	string	Sí	El token de cliente que se usa para garantizar la idempotencia de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PortRangeListName	string	No	El ID de la lista de rangos de puertos que se va a modificar.	prl-2ze9743****
Description	string	No	El nombre de la lista de rangos de puertos. El nombre debe tener de 2 a 128 caracteres y debe comenzar con una letra o un carácter chino. No puede comenzar con http://, https://, com.aliyun ni com.alibabacloud. Puede contener letras, caracteres chinos, dígitos, dos puntos (:), guiones bajos (_), puntos (.) y guiones (-).	EjemploNombreListaRangosPuertos
AddEntry	array<object>	No	La descripción de la lista de rangos de puertos. La descripción debe tener de 2 a 256 caracteres y no puede comenzar con http:// ni https://.	Esta es la descripción
	object	No	La entrada que se va a agregar o modificar en la lista de rangos de puertos.
PortRange	string	No	El rango de puertos. Valores válidos de N: 0 a 200. Configuración: El número de entradas no puede exceder la capacidad máxima de entradas (`MaxEntries`). No puede especificar valores duplicados para `PortRange`. El valor no puede ser igual al valor del parámetro `RemoveEntry.N.PortRange`.	80/80
Description	string	No	La descripción del rango de puertos. La descripción debe tener entre 2 y 32 caracteres de longitud y no puede comenzar con http:// o https://. Valores válidos de N: 0 a 200.	Esta es una descripción
RemoveEntry	array<object>	No	Las entradas que se van a agregar o modificar en la lista de rangos de puertos.
	object	No	La entrada que se va a agregar o modificar en la lista de rangos de puertos.
PortRange	string	No	El rango de puertos. Valores válidos de N: 0 a 200. Configuración: El número de entradas no puede exceder el número máximo de entradas (MaxEntries). No puede especificar valores de PortRange duplicados. El valor no puede ser igual a un valor del parámetro RemoveEntry.N.PortRange.	80/80

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidOperation.Conflict	The port range list has conflict task.	Esta operación no está permitida debido a un conflicto de tareas.
400	InvalidPortRangeListId.NotFound	The specified port range list was not found.	No se encontró la libreta de direcciones de puertos especificada.
400	InvalidOperation.MaxEntriesCountExceed	The specified MaxEntries exceeded the upper limit.	El parámetro MaxEntries especificado excede el valor máximo permitido.
400	InvalidOperation.EntryCountExceedMaxEntries	The number of entries in the port list exceeds MaxEntries.	El número de entradas especificado excede el valor de MaxEntries de la libreta de direcciones de puertos.
400	LimitExceed.MaxEntries	The number of entries exceeds the MaxEntries of the specified PortRangeList.	El número de entradas supera el número máximo de entradas admitidas por la lista de prefijos especificada.
400	LimitExceed.Entry	The number of entries added or removed exceeds the limit.	El número de entradas agregadas o eliminadas en una sola operación supera el límite.
400	InvalidParameter.PortRangeDuplicated	The specified PortRange is duplicated.	El rango de puertos especificado contiene entradas duplicadas.
400	InvalidParameter.PortRangeListName	The specified parameter PortRangeListName is not valid.	El nombre de la libreta de direcciones de puertos especificado no es válido.
400	InvalidMaxEntries.LessThanCurrentEntries	The specified MaxEntries is less than current entries.	El número máximo de entradas en la libreta de direcciones de puertos es menor que el número actual de entradas.
400	InvalidParameter.PortRange	The specified parameter PortRange is not valid. It should be two integers less than 65535 in specified format.	La entrada PortRange en la libreta de direcciones de puertos no cumple con los requisitos de formato. Especifique dos números enteros menores que 65535 separados por una barra diagonal.
400	MissingParameter	Missing mandatory parameter.	Falta un parámetro obligatorio.
400	InvalidDescription.Malformed	The specifid Description is not valid.	El formato de descripción del recurso especificado no es válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// o https://.
403	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.
404	InvalidRegionId.NotFound	The specified parameter RegionId is not valid.	El valor especificado para RegionId no existe. Verifique si el producto está disponible en esta región.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.