Cria uma lista de prefixos.
Descrição da operação
Notas de uso
-
Uma lista de prefixos é uma coleção de prefixos de rede (blocos CIDR) e pode ser referenciada para configurar regras de rede para outros recursos. Para mais informações, consulte Visão geral.
-
Ao criar uma lista de prefixos, observe os seguintes itens:
- Você deve especificar uma família de endereços IP (IPv4 ou IPv6) para a lista de prefixos e não pode alterar a família de endereços IP após a criação da lista de prefixos. Não é possível combinar blocos CIDR IPv4 e IPv6 em uma única lista de prefixos.
- Você deve especificar o número máximo de entradas que a lista de prefixos pode conter. Não é possível modificar o número máximo de entradas após a criação da lista de prefixos.
- Você pode especificar entradas para a lista de prefixos. Cada entrada consiste em um bloco CIDR e a descrição do bloco CIDR. O número total de entradas não pode exceder o número máximo de entradas especificado.
-
Para mais informações sobre os limites de listas de prefixos e outros recursos, consulte Limites.
-
Você pode criar usuários do Resource Access Management (RAM) e conceder a eles permissões mínimas. Isso elimina a necessidade de compartilhar o par de AccessKey da sua conta Alibaba Cloud com outros usuários e reduz os riscos de segurança para suas empresas. Para informações sobre como conceder permissões em listas de prefixos a usuários RAM, consulte Conceder permissões em listas de prefixos a um usuário RAM
Depuração
Informações de autorização
A tabela a seguir mostra as informações de autorização correspondentes à API. As informações de autorização podem ser usadas no elemento de política Action para conceder a um usuário RAM ou função RAM as permissões para chamar esta operação de API. Descrição:
- Operação: o valor que você pode usar no elemento Action para especificar a operação em um recurso.
- Nível de acesso: o nível de acesso de cada operação. Os níveis são leitura, gravação e listagem.
- Tipo de recurso: o tipo do recurso no qual você pode autorizar o usuário RAM ou a função RAM a realizar a operação. Observe os seguintes itens:
- Para tipos de recurso obrigatórios, indicados com o prefixo * .
- Se as permissões não puderem ser concedidas no nível do recurso,
Todos os Recursosé usado na coluna Tipo de recurso da operação.
- Chave de condição: a chave de condição definida pelo serviço em nuvem.
- Operação associada: outras operações que o usuário RAM ou a função RAM deve ter permissões para realizar a fim de concluir a operação. Para concluir a operação, o usuário RAM ou a função RAM deve ter as permissões para realizar as operações associadas.
| Operação | Nível de acesso | Tipo de recurso | Chave de condição | Operação associada |
|---|---|---|---|---|
| ecs:CreatePrefixList | criar | *Todos os Recursos * |
| nenhuma |
Parâmetros de solicitação
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| RegionId | string | Sim | O ID da região na qual criar a lista de prefixos. | cn-chengdu |
| MaxEntries | integer | Sim | O número máximo de entradas que a lista de prefixos pode conter. Valores válidos: 1 a 200. | 10 |
| AddressFamily | string | Sim | A família de endereços IP. Valores válidos:
| IPv4 |
| ClientToken | string | Não | O token do 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 único entre diferentes solicitações. O | 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 pode conter letras, dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hífens (-). Deve começar com uma letra e não pode começar com | 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 | This is description. |
| Entry | array<object> | Não | Os detalhes das entradas na lista de prefixos. | |
| object | Não | |||
| Description | string | Não | A descrição na entrada N. A descrição deve ter de 2 a 32 caracteres de comprimento e não pode começar com | Description Sample 01 |
| Cidr | string | Sim | O bloco CIDR na entrada N. Valores válidos de N: 0 a 200. Notas:
Para mais informações sobre blocos CIDR, consulte O que é CIDR? Este parâmetro é deixado vazio por padrão. | 192.168.1.0/24 |
| Tag | array<object> | Não | As tags a serem adicionadas à lista de prefixos. | |
| object | Não | Tag N a ser adicionada à lista de prefixos. | ||
| Key | string | Não | A chave da tag N. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres de comprimento e não pode começar com | TestKey |
| Value | string | Não | O valor da tag N. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres de comprimento e não pode conter | TestValue |
| ResourceGroupId | string | Não | O ID do grupo de recursos ao qual atribuir a lista de prefixos. | rg-bp67acfmxazb4p**** |
Parâmetros de resposta
Exemplos
Exemplos de respostas bem-sucedidas
Formato JSON
{
"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 não foi especificado. |
| 400 | InvalidParameter.AddressFamily | The parameter AddressFamily should be IPv4 or IPv6. | O parâmetro AddressFamily especificado é inválido. Os valores válidos deste parâmetro são IPv4 e IPv6. |
| 400 | InvalidParameter | %s | O parâmetro especificado é inválido. |
| 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. | A descrição do recurso é inválida. A descrição deve ter de 2 a 256 caracteres de comprimento e não pode começar com http:// ou https://. |
| 400 | InvalidClientToken.ValueNotSupported | The ClientToken provided is invalid. | O parâmetro ClientToken especificado é inválido. |
| 400 | InvalidParameter.CidrMalformed | %s | O bloco CIDR especificado é inválido. |
| 400 | InvalidParameter.CidrDuplicated | %s | Blocos CIDR duplicados foram especificados. |
| 400 | LimitExceed.Entry | The number of entries added or removed exceeds the limit. | O número de entradas a adicionar ou remover de uma vez excede o limite superior. |
| 400 | LimitExceed.MaxEntries | The number of entries exceeds the MaxEntries of the specified prefix list. | O número de entradas especificadas excede o valor de MaxEntries. |
| 404 | LimitExceed.PrefixListPerRegion | The number of prefix lists in the region exceeds the limit. | O número máximo de listas de prefixos na região atual foi atingido. |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | O ID da região especificado não existe. |
| 404 | InvalidResourceGroup.NotFound | The specified resource group is not found. | Não foi possível encontrar o grupo de recursos correspondente |
Para uma lista de códigos de erro, visite os Códigos de erro do serviço.
Histórico de alterações
| Data da alteração | Resumo das alterações | Operação |
|---|---|---|
| 2025-11-24 | O código de erro foi alterado | Ver detalhes da alteração |
| 2025-04-21 | O código de erro foi alterado. Os parâmetros de solicitação da API foram alterados | Ver detalhes da alteração |
| 2025-01-02 | Atualização da descrição da API. A operação da API não está obsoleta. O código de erro foi alterado | Ver detalhes da alteração |
| 2023-11-13 | O código de erro foi alterado | Ver detalhes da alteração |