Modifica o nome, a descrição ou as entradas de uma lista de prefixos. Você pode adicionar, modificar e excluir entradas na lista de prefixos.
Descrição da operação
Notas de uso
-
O bloco CIDR especificado deve ser válido. Por exemplo, 10.0.0.0/8 é um bloco CIDR válido, enquanto 10.0.0.1/8 não é. Para mais informações, consulte a seção O que é CIDR? no tópico "FAQ de Rede".
-
Ao adicionar ou excluir uma entrada, você não pode especificar blocos CIDR duplicados. Exemplos:
- Para blocos CIDR IPv4, você não pode especificar o bloco CIDR 10.0.0.0/8 em duas entradas. Você não pode especificar o bloco CIDR 10.0.0.1/32 em uma entrada e o bloco CIDR 10.0.0.1 em outra entrada. Os dois blocos CIDR são iguais.
- Para blocos CIDR IPv6, você não pode especificar o bloco CIDR 2001:fd01:0:0:0:0:0:0/32 em uma entrada e o bloco CIDR 2001:fd01::/32 em outra entrada. Os dois blocos CIDR são iguais.
-
O bloco CIDR em uma entrada a ser adicionada não pode ser igual ao de uma entrada a ser excluída. Por exemplo, ao adicionar uma entrada na qual o bloco CIDR 10.0.0.0/8 é especificado, certifique-se de que o bloco CIDR 10.0.0.0/8 não esteja especificado em uma entrada a ser excluída.
-
Se você deseja modificar a descrição de uma entrada, deve especificar o bloco CIDR (
AddEntry.N.Cidr) e a nova descrição (AddEntry.N.Description) para a entrada.
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 lista.
- Tipo de recurso: o tipo de recurso no qual você pode autorizar o usuário RAM ou a função RAM a executar a operação. Observe os seguintes itens:
- Para tipos de recursos 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 de nuvem.
- Operação associada: outras operações que o usuário RAM ou a função RAM deve ter permissão para executar para concluir a operação. Para concluir a operação, o usuário RAM ou a função RAM deve ter as permissões para executar as operações associadas.
| Operação | Nível de acesso | Tipo de recurso | Chave de condição | Operação associada |
|---|---|---|---|---|
| ecs:ModifyPrefixList | atualização | *PrefixList acs:ecs:{#regionId}:{#accountId}:prefixlist/{#PrefixListId} |
| nenhuma |
Parâmetros de solicitação
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| RegionId | string | Sim | O ID da região da lista de prefixos. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente. | cn-chengdu |
| PrefixListId | string | Sim | O ID da lista de prefixos. | pl-x1j1k5ykzqlixdcy**** |
| PrefixListName | string | Não | O nome da lista de prefixos. O nome deve ter de 2 a 128 caracteres. 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 e não pode começar com | This is description. |
| AddEntry | array<object> | Não | As entradas a serem adicionadas à 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 e não pode começar com | Description Sample 01 |
| Cidr | string | Sim | O bloco CIDR na entrada N a ser adicionado à lista de prefixos. Valores válidos de N: 0 a 200. Observe os seguintes itens ao adicionar as entradas:
| 192.168.2.0/24 |
| RemoveEntry | array<object> | Não | As entradas a serem excluídas da lista de prefixos. | |
| object | Não | |||
| Cidr | string | Sim | O bloco CIDR na entrada N a ser excluído da lista de prefixos. Valores válidos de N: 0 a 200. Observe os seguintes itens ao excluir as entradas:
| 192.168.1.0/24 |
Parâmetros de resposta
Exemplos
Exemplos de respostas bem-sucedidas
Formato JSON
{
"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.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 e não pode começar com http:// ou https://. |
| 400 | InvalidParameter.CidrDuplicated | %s | Blocos CIDR duplicados foram especificados. |
| 400 | InvalidParameter.CidrMalformed | %s | O bloco CIDR especificado é inválido. |
| 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. |
| 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 | TaskConflict | The operation is too frequent, please wait a moment and try again. | - |
| 404 | InvalidPrefixListId.NotFound | The specified prefix list was not found. | A lista de prefixos não existe. |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | O ID da região especificado não existe. |
Para obter 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 |
|---|---|---|
| 2026-01-13 | Atualização da descrição da API. 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 |