Todos os produtos
Search
Central de documentação

:AssociateACL

Última atualização: Jul 03, 2026

Associa uma lista de controle de acesso (ACL) a uma instância do Smart Access Gateway (SAG).

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

AssociateACL

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

RegionId

String

Sim

cn-shanghai

ID da região onde a ACL foi criada.

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

AclId

String

Sim

acl-ohlexqptfhy****

ID da ACL.

SmartAGId

String

Sim

sag-4yr0p2xa6o3k****

ID da instância do SAG a ser associada à ACL.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

C9A75915-0260-4335-851A-D866A7ED396C

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=AssociateACL
&RegionId=cn-shanghai
&AclId=acl-ohlexqptfhy****
&SmartAGId=sag-4yr0p2xa6o3k****
&Common request parameters

Exemplo de resposta de sucesso

Formato XML

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

<AssociateACLResponse>
    <RequestId>C9A75915-0260-4335-851A-D866A7ED396C</RequestId>
</AssociateACLResponse>

Formato JSON

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

{
  "RequestId" : "C9A75915-0260-4335-851A-D866A7ED396C"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

SAG.SoftwareNotSupport

The specified SAG software edition instance does not support ACL.

A instância SAG vCPE não oferece suporte a listas de controle de acesso (ACLs).

403

Forbidden

User not authorized to operate on the specified resource.

Você não tem permissão para gerencie o recurso especificado.

403

MissingParameter

The input parameter is missing, please check your input.

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

403

InvalidId.SMARTAG

The specified smart access gateway instance id is invalid.

O ID da instância do SAG especificado é inválido.

403

FeatureNotSupport

The current edition of the smart access gateway does not support this feature.

A versão atual do dispositivo SAG especificado não oferece suporte a este recurso.

403

FeatureNotSupportForActiveSmartAG

The current edition of the active smart access gateway does not support this feature.

A versão atual do dispositivo SAG ativo não oferece suporte a este recurso.

403

FeatureNotSupportForStandBySmartAG

The current edition of the standby smart access gateway does not support this feature.

A versão atual do dispositivo SAG em standby não oferece suporte a este recurso.

403

SmartAGAlreadyAssociateAcl

The specified smart access gateway has already been associated with the specified ACL.

A instância do SAG selecionada já está associada a uma ACL.

403

AclPerSmartagAmountLimit

No more ACL can be associated with this smart access gateway.

O número de grupos de ACL associados à instância do SAG atingiu o limite máximo.

403

InternalError

An internal server error occurred.

Ocorreu um erro interno do servidor.

403

InvalidId.ACL

The specified ACL ID is invalid.

O ID da ACL especificado é inválido.

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