Todos os produtos
Search
Central de documentação

:CrieACL

Última atualização: Jul 03, 2026

Cria uma lista de controle de acesso (ACL).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateACL

Operação a ser executada. Defina o valor como CreateACL.

RegionId String Sim cn-shanghai

ID da região onde a ACL será criada.

Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

Name String Sim username

Nome da ACL.

O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). É obrigatório iniciar com uma letra.

AclType String Não acl-hardware

Tipo de instância SAG a ser associada à ACL. Valores válidos:

  • acl-hardware (padrão): instância SAG CPE
  • acl-software: instância do aplicativo SAG

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

EE837E9F-BD50-4C2B-9E47-260F9D848480

ID da solicitação.

AclId

String

acl-o6yol7zowii5n2****

ID da ACL.

ResourceGroupId

String

rg-acfm2iu4fnc****

ID do grupo de recursos ao qual a ACL pertence.

AclType

String

acl-hardware

Tipo de instância SAG a ser associada à ACL.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateACL
&RegionId=cn-shanghai
&Name=username
&AclType=acl-hardware
&Common request parameters

Exemplos de respostas

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateACLResponse>
    <RequestId>EE837E9F-BD50-4C2B-9E47-260F9D848480</RequestId>
    <AclId>acl-o6yol7zowii5n2****</AclId>
    <ResourceGroupId>rg-acfm2iu4fnc****</ResourceGroupId>
    <AclType>acl-hardware</AclType>
</CreateACLResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "EE837E9F-BD50-4C2B-9E47-260F9D848480",
  "AclId" : "acl-o6yol7zowii5n2****",
  "ResourceGroupId" : "rg-acfm2iu4fnc****",
  "AclType" : "acl-hardware"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

403

Forbidden

User not authorized to operate on the specified resource.

Erro retornado devido à falta de permissões para gerencie o recurso especificado.

403

MissingParameter

The input parameter is missing, please check your input.

Erro retornado porque um ou mais parâmetros obrigatórios estão vazios. Verifique se todos os parâmetros necessários foram configurados.

403

InvalidName

Name not valid.

Erro retornado porque o nome da ACL é inválido.

403

AclAmountLimit

No more ACL can be created. You can open a ticket to increase the quota of ACLs.

Erro retornado porque o número de ACLs atingiu o limite superior. Para aumentar a cota, envie um ticket.

403

InternalError

An internal server error occurred.

Erro retornado devido a uma falha interna do servidor.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.