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

Crea una lista de prefijos.

Descripción de la operación

Notas de uso

Una lista de prefijos es un conjunto de prefijos de red (bloques CIDR) y se puede utilizar como referencia para configurar reglas de red en otros recursos. Para obtener más información, consulte Visión general.
Al crear una lista de prefijos, tenga en cuenta los siguientes puntos:
- Debe especificar una familia de direcciones IP (IPv4 o IPv6) para la lista de prefijos, y no puede cambiarla después de crear la lista. No puede combinar bloques CIDR IPv4 e IPv6 en una misma lista de prefijos.
- Debe especificar el número máximo de entradas que puede contener la lista de prefijos. No puede modificar este límite después de crear la lista.
- Puede especificar entradas para la lista de prefijos. Cada entrada consta de un bloque CIDR y su descripción. El número total de entradas no puede superar el máximo que haya especificado.
Para obtener más información sobre los límites de las listas de prefijos y otros recursos, consulte Límites.
Puede crear usuarios de Resource Access Management (RAM) y otorgarles permisos mínimos. Esto elimina la necesidad de compartir el par de AccessKey de su cuenta de Alibaba Cloud con otros usuarios y reduce los riesgos de seguridad para su empresa. Para obtener información sobre cómo otorgar permisos en listas de prefijos a usuarios RAM, consulte Otorgar permisos a un usuario RAM en listas de prefijos

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:CreatePrefixList

create

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región en la que se creará la lista de prefijos.	cn-chengdu
RegionId	string	Sí	El ID de la región en la que se creará la lista de prefijos.	cn-chengdu
MaxEntries	integer	Sí	El número máximo de entradas que puede contener la lista de prefijos. Valores válidos: de 1 a 200.	10
AddressFamily	string	Sí	La familia de direcciones IP. Valores válidos: IPv4 IPv6	IPv4
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que sea único entre diferentes solicitudes. El `token` solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	0c593ea1-3bea-11e9-b96b-88e9fe637760
PrefixListName	string	Sí	El nombre de la lista de prefijos. El nombre debe tener entre 2 y 128 caracteres de longitud, y puede contener letras, dígitos, dos puntos (:), guiones bajos (_), puntos (.) y guiones (-). Debe comenzar con una letra y no puede empezar con `http://`, `https://`, `com.aliyun` ni `com.alibabacloud`.	PrefixListNameSample
Description	string	No	La descripción de la lista de prefijos. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`.	Esta es una descripción
Entry	array<object>	No	Los detalles de las entradas en la lista de prefijos.
	object	No
Description	string	No	La descripción en la entrada N. La descripción debe tener entre 2 y 32 caracteres de longitud y no puede comenzar con `http://` ni `https://`. Valores válidos de N: de 0 a 200.	Ejemplo de descripción 01
Cidr	string	Sí	El bloque CIDR en la entrada N. Valores válidos de N: de 0 a 200. Notas: El número total de entradas no puede superar el valor de `MaxEntries`. Los tipos de bloques CIDR están determinados por la familia de direcciones IP. No puede combinar bloques CIDR IPv4 e IPv6 en una misma lista de prefijos. Los bloques CIDR deben ser únicos en todas las entradas de una lista de prefijos. Por ejemplo, no puede especificar 192.168.1.0/24 dos veces en las entradas de la lista. Puede establecer una única dirección IP. El sistema convierte automáticamente la dirección IP en un bloque CIDR. Por ejemplo, si establece 192.168.1.100, el sistema la convierte automáticamente en 192.168.1.100/32. Si utiliza un bloque CIDR IPv6, el sistema convierte automáticamente el bloque CIDR a ceros y las letras a minúsculas. Por ejemplo, si especifica 2001:0DB8:0000:0000:0000:0000:0000:0000/32, el sistema lo convierte en 2001:db8::/32. Para obtener más información sobre los bloques CIDR, consulte ¿Qué es CIDR? Este parámetro se deja vacío de forma predeterminada.	192.168.1.0/24
Tag	array<object>	No	Las etiquetas que se agregarán a la lista de prefijos.
	object	No	La etiqueta N que se agregará a la lista de prefijos.
Key	string	No	La clave de la etiqueta N. Valores válidos de N: de 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con `acs:` ni `aliyun`. No puede contener `http://` ni `https://`.	TestKey
Value	string	No	El valor de la etiqueta N. Valores válidos de N: de 1 a 20. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`.	TestValue
ResourceGroupId	string	No	El ID del grupo de recursos al que se asignará la lista de prefijos.	rg-bp67acfmxazb4p****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
PrefixListId	string	El ID de la lista de prefijos.	pl-x1j1k5ykzqlixdcy****
RequestId	string	El ID de la solicitud.	38793DB8-A4B2-4AEC-BFD3-111234E9188D

Ejemplos

Respuesta exitosa

JSON Formato

{
  "PrefixListId": "pl-x1j1k5ykzqlixdcy****",
  "RequestId": "38793DB8-A4B2-4AEC-BFD3-111234E9188D"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter	%s	A parameter is not specified.
400	InvalidParameter.AddressFamily	The parameter AddressFamily should be IPv4 or IPv6.	The specified AddressFamily parameter is invalid. The valid values of this parameter are IPv4 and IPv6.
400	InvalidParameter	%s	The specified parameter is invalid.
400	InvalidParameter.PrefixListName	The parameter PrefixListName is not valid.	The prefix list name is invalid.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	The specified ClientToken parameter is invalid.
400	InvalidParameter.CidrMalformed	%s	The specified CIDR block is invalid.
400	InvalidParameter.CidrDuplicated	%s	Duplicate CIDR blocks are specified.
400	LimitExceed.Entry	The number of entries added or removed exceeds the limit.	The number of entries to add or remove at a time exceeds the upper limit.
400	LimitExceed.MaxEntries	The number of entries exceeds the MaxEntries of the specified prefix list.	The number of specified entries exceeds the MaxEntries value.
404	LimitExceed.PrefixListPerRegion	The number of prefix lists in the region exceeds the limit.	The maximum number of prefix lists in the current region has been reached.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	The specified region ID does not exist.
404	InvalidResourceGroup.NotFound	The specified resource group is not found.	Cannot find the corresponding resource group

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.