AddEntriesToAcl - Server Load Balancer: Central de Documentação do Alibaba Cloud

Descrição da operação

Cada grupo de políticas pode conter várias entradas de endereço IP ou entradas de bloco CIDR. Os limites de entradas para um grupo de políticas de controle de acesso são os seguintes:
- Número máximo de entradas de endereço IP que podem ser adicionadas por conta por chamada: 20.
- Número máximo de entradas que cada grupo de políticas de controle de acesso pode conter: 500.
A operação AddEntriesToAcl é assíncrona. Depois de chamar essa operação, o sistema retorna um ID de solicitação, mas as entradas de IP não são adicionadas imediatamente ao grupo de políticas de controle de acesso. A tarefa de adição ainda está sendo executada em segundo plano. Você pode chamar ListAclEntries para consultar o status de adição das entradas de IP:
- Se o grupo de políticas de controle de acesso estiver no estado Adding, as entradas de IP estão sendo adicionadas.
- Se o grupo de políticas de controle de acesso estiver no estado Available, as entradas de IP foram adicionadas.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

alb:AddEntriesToAcl

create

*Acl.

acs:alb:{#regionId}:{#accountId}:acl/{#aclId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AclId	string	Sim	O ID da instância de ACL.	acl-hp34s2h0xx1ht4nwo****
AclEntries	array<object>	Sim	A lista de entradas de controle de acesso a serem adicionadas. Você pode adicionar até 20 entradas de controle de acesso em uma única chamada.
	object	Não	A estrutura da política de controle de acesso.
Description	string	Não	A descrição da entrada de controle de acesso. A descrição deve ter de 2 a 256 caracteres e pode conter letras, dígitos, caracteres chineses, vírgulas (,), pontos (.), ponto e vírgulas (;), barras (/), arrobas (@), sublinhados (_) e hifens (-). Você pode adicionar até 20 entradas de controle de acesso em uma única chamada.	test-entry
Entry	string	Sim	O bloco CIDR da entrada de controle de acesso.	10.0.1.0/24
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode gerar o valor do parâmetro a partir do seu cliente e garantir que o valor seja exclusivo em diferentes solicitações. O parâmetro ClientToken aceita apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId de cada solicitação de API é exclusivo.	5A2CFF0E-5718-45B5-9D4D-70B3******
DryRun	boolean	Não	Especifica se deve ser realizada apenas uma pré-verificação da solicitação. Valores válidos: true: O sistema faz a pré-verificação da solicitação sem adicionar entradas de IP ao grupo de políticas de controle de acesso. O sistema verifica se os parâmetros obrigatórios foram especificados, o formato da solicitação e os limites do serviço. Se a solicitação falhar na pré-verificação, o erro correspondente será retornado. Se a solicitação passar na pré-verificação, o código de erro DryRunOperation será retornado. false (padrão): O sistema envia uma solicitação normal. Se a solicitação passar na pré-verificação, o sistema retornará um código de status HTTP 2xx e executará a operação.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Adiciona entradas de IP a um grupo de políticas de controle de acesso.
JobId	string	O ID da tarefa assíncrona.	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	O ID da solicitação.	365F4154-92F6-4AE4-92F8-7FF34******

Exemplos

Resposta de sucesso

JSON formato

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34******"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ResourceAlreadyExist.AclEntry	The specified resource %s already exists.	A entrada de IP já existe no grupo de políticas de controle de acesso.
400	ResourceQuotaExceeded.AclEntriesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	A cota %s foi excedida. O recurso é %s. O uso atual é %s. A cota é %s.
400	IncorrectStatus.Acl	The status of %s [%s] is incorrect.	O status atual do grupo de políticas de controle de acesso ACL não suporta esta operação.
400	ResourceQuotaExceeded.ListenerAclEntriesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	A cota %s foi excedida. O recurso é %s. O uso atual é %s. A cota é %s.
400	ResourceQuotaExceeded.LoadBalancerAclEntriesNum	The quota of %s is exceeded for resource %s, usage %s/%s.	A cota %s foi excedida. O recurso é %s. O uso atual é %s. A cota é %s.
404	ResourceNotFound.Acl	The specified resource %s is not found.	O grupo de políticas de controle de acesso ACL 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.