Todos os produtos
Search
Central de documentação

:ModifySagUserDns

Última atualização: Jul 03, 2026

Modifica os servidores DNS de uma instância do Smart Access Gateway (SAG).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

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

Operação a executar. Defina o valor como ModifySagUserDns.

RegionId String Sim cn-shanghai

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

SmartAGId String Sim sag-whfn****

ID da instância SAG.

SmartAGSn String Sim sag32a30****

Número de série do dispositivo SAG associado à instância.

MasterDns String Sim 192.XX.XX.1

Endereço IP do servidor dns primário.

Nota Caso este parâmetro não seja definido, o endereço IP do servidor dns existente será removido.
SlaveDns String Sim 192.XX.XX.2

Endereço IP do servidor dns secundário.

Nota Caso este parâmetro não seja definido, o endereço IP do servidor dns existente será removido.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

1120228A-E5E1-4E9C-B56D-96887E1A2B2F

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://smartag.cn-shanghai.aliyuncs.com/?Action=ModifySagUserDns
&MasterDns=192.XX.XX.1
&RegionId=cn-shanghai
&SlaveDns=192.XX.XX.2
&SmartAGId=sag-whfn****
&SmartAGSn=sag32a30****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifySagUserDnsResponse>
    <RequestId>1120228A-E5E1-4E9C-B56D-96887E1A2B2F</RequestId>
</ModifySagUserDnsResponse>

Formato JSON

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

{
  "RequestId" : "1120228A-E5E1-4E9C-B56D-96887E1A2B2F"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

SAG.InstanceNoFound

The specified SAG instance does not exist.

A instância SAG especificada não existe.

400

SAG.SoftwareNotSupport

The specified SAG software edition instance does not support ACL.

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

400

InstanceNotExit

The specified instance does not exist.

A instância especificada não existe.

400

ConfigUnsynchronized

The network configuration is not synchronized.

As configurações de rede não estão sincronizadas.

403

SmartAccessGatewayNotOnline

The specified smart access gateway is not online.

O dispositivo SAG especificado não está conectado ao Alibaba Cloud e o sistema não conseguiu processar a solicitação.

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 espera não oferece suporte a este recurso.

500

SmartAccessGatewayInArrears

The specified Smart Access Gateway has expired.

A instância SAG especificada expirou. Renove a instância SAG.

500

SmartAccessGatewayNotActivated

The specified Smart Access Gateway has not been activated.

A instância SAG especificada não está ativada. Ative-a antes de continuar.

500

SmartAccessGatewayOffline

The request cannot be completed. The Smart Access Gateway is offline.

O dispositivo SAG especificado não está conectado ao Alibaba Cloud e o sistema não conseguiu processar a solicitação.

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