CreatePrefixList - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Cria uma lista de prefixos.

Descrição da operação

Uma lista de prefixos é uma coleção de prefixos de rede, que são Classless Inter-Domain Routing. Você pode referenciar uma lista de prefixos ao configurar regras de rede para outros recursos. Para obter mais informações sobre listas de prefixos, consulte Visão geral da lista de prefixos.
Ao criar uma lista de prefixos:
- Você deve especificar uma família de endereços (IPv4 ou IPv6) para a lista de prefixos. As entradas na mesma lista de prefixos devem pertencer à mesma família de endereços, e a família de endereços não pode ser modificada após a criação da lista de prefixos.
- Você deve configurar as definições para o número máximo de entradas da lista de prefixos, que não pode ser modificado após a criação da lista de prefixos.
- Você pode especificar entradas para a lista de prefixos. Cada entrada consiste em um Classless Inter-Domain Routing e uma descrição. O número de entradas não pode exceder o número máximo de entradas configurado nas definições.
Para obter informações sobre os limites de listas de prefixos e outros recursos, consulte Limites.
Os usuários do RAM ajudam a evitar o compartilhamento das credenciais da sua conta Alibaba Cloud com outros usuários. Você pode alocar o menor privilégio possível aos usuários sob demanda para reduzir os riscos de segurança da informação da sua empresa. Para obter mais informações sobre como conceder permissões relacionadas a listas de prefixos aos usuários do Resource Access Management (RAM), consulte Conceder permissões relacionadas a listas de prefixos aos usuários do RAM.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região.	cn-chengdu
MaxEntries	integer	Sim	O número máximo de entradas suportadas pela lista de prefixos. Valores válidos: 1 a 200.	10
AddressFamily	string	Sim	A família de endereços da lista de prefixos. Valores válidos: IPv4. IPv6.	IPv4
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para obter mais informações, consulte Garantir idempotência.	0c593ea1-3bea-11e9-b96b-88e9fe637760
PrefixListName	string	Sim	O nome da lista de prefixos. O nome deve ter de 2 a 128 caracteres de comprimento e deve começar com uma letra ou um caractere chinês. Não pode começar com `http://`, `https://`, `com.aliyun` ou `com.alibabacloud`. Pode conter caracteres chineses, letras, dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).	PrefixListNameSample
Description	string	Não	A descrição da lista de prefixos. A descrição deve ter de 2 a 256 caracteres de comprimento e não pode começar com `http://` ou `https://`.	This is description.
Entry	array<object>	Não	As informações da entrada da lista de prefixos.
	object	Não
Description	string	Não	A descrição da entrada da lista de prefixos. A descrição deve ter de 2 a 32 caracteres de comprimento e não pode começar com `http://` ou `https://`. Valores válidos de N: 0 a 200.	Description Sample 01
Cidr	string	Sim	O Classless Inter-Domain Routing da entrada da lista de prefixos. Valores válidos de N: 0 a 200. Precauções: O número de entradas na lista de prefixos não pode exceder o número máximo de entradas (MaxEntries). O tipo de Classless Inter-Domain Routing em uma entrada é determinado pela família de endereços. Uma lista de prefixos não pode conter Classless Inter-Domain Routing IPv4 e IPv6 simultaneamente. O Classless Inter-Domain Routing em várias entradas não pode ser duplicado. Por exemplo, você não pode especificar duas configurações como 192.168.1.0/24. Você pode especificar um único endereço IP nas configurações, e o sistema o transforma automaticamente em um Classless Inter-Domain Routing. Por exemplo, se você especificar 192.168.1.100 nas configurações, o sistema o transformará automaticamente em 192.168.1.100/32. Se você usar um Classless Inter-Domain Routing IPv6, o sistema o transforma automaticamente em um formato com compressão de zeros e converte as letras para minúsculas. Por exemplo, se você especificar 2001:0DB8:0000:0000:0000:0000:0000:0000/32 nas configurações, o sistema o transformará automaticamente em 2001:db8::/32. Para obter mais informações sobre o Classless Inter-Domain Routing, consulte O que é CIDR. Valor padrão: vazio.	192.168.1.0/24
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag da lista de prefixos. Valores válidos de N: 1 a 20. Se você especificar este parâmetro, ele não poderá ser uma string vazia. A chave da tag pode ter até 128 caracteres de comprimento e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	TestKey
Value	string	Não	O valor da tag da lista de prefixos. Valores válidos de N: 1 a 20. Este parâmetro pode ser uma string vazia. O valor da tag pode ter até 128 caracteres de comprimento e não pode conter `http://` ou `https://`.	TestValue
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual a lista de prefixos pertence.	rg-bp67acfmxazb4p****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PrefixListId	string	O ID da lista de prefixos.	pl-x1j1k5ykzqlixdcy****
RequestId	string	O ID da solicitação.	38793DB8-A4B2-4AEC-BFD3-111234E9188D

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s	Um parâmetro obrigatório está ausente.
400	InvalidParameter.AddressFamily	The parameter AddressFamily should be IPv4 or IPv6.	A família de endereços deve ser IPv4 ou IPv6.
400	InvalidParameter	%s	Os parâmetros da solicitação atual são inválidos. Tente novamente.
400	InvalidParameter.PrefixListName	The parameter PrefixListName is not valid.	O nome da lista de prefixos é inválido.
400	InvalidDescription.Malformed	The specified Description is wrongly formed.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	O ClientToken especificado é inválido.
400	InvalidParameter.CidrMalformed	%s	O bloco CIDR especificado é inválido.
400	InvalidParameter.CidrDuplicated	%s	O bloco CIDR especificado é uma duplicata.
400	LimitExceed.Entry	The number of entries added or removed exceeds the limit.	O número de entradas a serem adicionadas ou removidas por vez excede o limite.
400	LimitExceed.MaxEntries	The number of entries exceeds the MaxEntries of the specified prefix list.	O número de entradas excede o número máximo de entradas suportado pela lista de prefixos especificada.
404	LimitExceed.PrefixListPerRegion	The number of prefix lists in the region exceeds the limit.	O número de listas de prefixos na região atual excede o limite.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	InvalidResourceGroup.NotFound	The specified resource group is not found.	O grupo de recursos especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.