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

Descrição da operação

A operação CreateAcl é assíncrona. Após invocar esta operação, o sistema retorna um ID de instância, mas o grupo de políticas de controle de acesso não é criado imediatamente porque o nó de criação ainda está sendo executado em segundo plano. Você pode invocar ListAcls para consultar o status de criação do grupo de políticas de controle de acesso:\n- Se o grupo de políticas de controle de acesso estiver no estado Creating, o grupo de políticas de controle de acesso está sendo criado.\n- Se o grupo de políticas de controle de acesso estiver no estado Available, o grupo de políticas de controle de acesso foi criado.

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

create

*Acl.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
AclName	string	Não	O nome da ACL. O nome deve começar com uma letra, caractere chinês ou dígito e pode conter dígitos, pontos (.), sublinhados (_), hifens (-) e espaços. O nome deve ter de 2 a 128 caracteres de comprimento.	test-acl
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação.\n\nVocê pode gerar o valor do parâmetro em seu cliente para garantir que o valor seja exclusivo em diferentes solicitações. O token de cliente aceita apenas caracteres ASCII.\n\n> 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 realizado um dry run na solicitação. Valores válidos:\n- true: O sistema realiza um dry run na solicitação sem criar o grupo de políticas de controle de acesso. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites de serviço são atendidos. Se a solicitação falhar no dry run, o sistema retorna um erro. Se a solicitação passar no dry run, o sistema retorna o código de erro `DryRunOperation`.\n- false (padrão): O sistema envia uma solicitação normal. Se a solicitação passar no dry run, o sistema retorna um código de status HTTP 2xx e executa a operação.	true
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-atstuj3rtop****
Tag	array<object>	Não	As tags.	rg-12313
	object	Não	A estrutura da tag.
Key	string	Não	A chave da tag. A chave da tag pode ter até 128 caracteres de comprimento. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.	env
Value	string	Não	O valor da tag. O valor da tag pode ter até 128 caracteres de comprimento. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.	product

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A lista de controle de acesso.
AclId	string	O ID da instância da ACL.	acl-hp34s2h0xx1ht4nwo****
JobId	string	O ID da tarefa assíncrona.	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	O ID da solicitação.	CEF72CEB-54B6-4AE8-B225-F876******

Exemplos

Resposta de sucesso

JSON formato

{
  "AclId": "acl-hp34s2h0xx1ht4nwo****",
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876******"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	QuotaExceeded.AclsNum	The quota of %s is exceeded, usage %s/%s.	A cota %s foi excedida. O uso atual é %s e a cota é %s.
400	NotExist.ResourceGroup	ResourceGroup does not exist.	O grupo de recursos não existe.
403	Forbidden.Acl	ACL authentication has failed.	Falha na autenticação da ACL.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.