Todos os produtos
Search
Central de documentação

:GrantSagInstanceToCcn

Última atualização: Jul 03, 2026

Autoriza uma instância do Smart Access Gateway (SAG) a se comunicar com uma instância do Cloud Connect Network (CCN) pertencente a outra conta da Alibaba Cloud.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

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

A operação a ser executada. Defina o valor como GrantSagInstanceToCcn.

RegionId String Sim cn-shanghai

O ID da região onde a instância do SAG está implantada.

SmartAGId String Sim sag-tzirqx07bvcngm****

O ID da instância do SAG.

CcnInstanceId String Sim ccn-n2935s1mnwv8i*****

O ID da instância do CCN.

CcnUid Long Sim 1210123456123456

O ID da conta da Alibaba Cloud à qual a instância do CCN pertence.

GrantTrafficService Boolean Não true

Especifique se a instância do CCN deve receber permissões para gerenciar o tráfego de rede da instância do SAG.

Após a concessão das permissões, a instância do CCN pode redirecionar o tráfego de rede enviado da instância do SAG para a Internet ao Cloud Security Access Service (CSAS) para auditoria de segurança.

  • true: concede as permissões.
  • false: não concede as permissões.
Nota Se você definir o valor como true e a instância do SAG conectada à instância do CCN tiver o recurso de reroteamento seguro ativado, não será possível revogar as permissões.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

6E1674AC-083C-4031-B047-7A66E418E0C6

O ID da solicitação.

InstanceId

String

sgc-6z21oj0vjjrx6s****

O ID da política de permissão.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=GrantSagInstanceToCcn
&RegionId=cn-shanghai
&SmartAGId=sag-tzirqx07bvcngm****
&CcnInstanceId=ccn-n2935s1mnwv8i*****
&CcnUid=1210123456123456
&GrantTrafficService=true
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<GrantSagInstanceToCcnResponse>
    <RequestId>6E1674AC-083C-4031-B047-7A66E418E0C6</RequestId>
    <InstanceId>sgc-6z21oj0vjjrx6s****</InstanceId>
</GrantSagInstanceToCcnResponse>

Formato JSON

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

{
  "RequestId" : "6E1674AC-083C-4031-B047-7A66E418E0C6",
  "InstanceId" : "sgc-6z21oj0vjjrx6s****"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

CCN.InvalidUid

The specified CCN user ID is invalid.

A mensagem de erro retornada porque o UID especificado da conta da Alibaba Cloud à qual a instância do CCN pertence é inválido.

400

CCN.InvalidId

You must specify the CCN instance ID.

A mensagem de erro retornada porque o ID da instância do CCN especificado não existe.

400

SAG.InstanceIdEmpty

You must specify the SAG instance ID.

A mensagem de erro retornada porque o ID da instância do SAG não foi definido.

400

SAG.InstanceNoFound

The specified SAG instance does not exist.

A mensagem de erro retornada porque a instância do SAG especificada não existe.

400

SAG.GrantDuplicated

You have authorized another CCN instance to bind to the specified SAG instance. Revoke the authorization first.

A mensagem de erro retornada porque a instância do SAG especificada já está associada a outra instância do CCN. Desassocie primeiro a instância do SAG da instância do CCN.

Para obter uma lista de códigos de erro, visite o API Error Center.