Todos os produtos
Search
Central de documentação

:ModifiqueSagWan

Última atualização: Jul 03, 2026

Modifica as configurações da porta WAN de um dispositivo Smart Access Gateway (SAG).

Informações prévias

Recomendamos compreender a funcionalidade da porta WAN antes de modificar suas configurações. Para mais informações, consulte Configurar uma porta WAN.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar 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 ModifySagWan

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

RegionId String Sim cn-shanghai

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

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

SmartAGId String Sim sag-whfn****

ID da instância SAG.

SmartAGSn String Sim sag32a30****

Número de série do dispositivo SAG.

PortName String Sim 0

Número da porta WAN.

IPType String Sim DHCP

Tipo de conexão da porta WAN. Valores válidos:

  • DHCP: a porta WAN conecta-se à Internet por meio de um endereço IP atribuído dinamicamente pelo servidor Dynamic Host Configuration Protocol (DHCP).
  • STATIC: a porta WAN conecta-se à Internet usando um endereço IP estático. Ao definir este valor, configure um endereço IP estático, uma máscara de sub-rede e um endereço IP de gateway para a porta WAN.
  • PPPOE: a porta WAN conecta-se à Internet via discagem. Se esta opção for selecionada, insira o nome de usuário e a senha da conta PPPoE fornecidos pelo provedor de serviços de Internet (ISP).
IP String Não 192.XX.XX.1

Endereço IP da porta WAN.

Nota Este parâmetro é obrigatório quando a porta WAN utiliza um endereço IP estático.
Mask String Não 255.255.255.0

Máscara de sub-rede do endereço IP da porta WAN.

Nota Defina este parâmetro caso a porta WAN use um endereço IP estático.
Gateway String Não 192.XX.XX.254

Endereço IP do gateway.

Nota
  • Configure este parâmetro se a porta WAN utilizar um endereço IP estático.
  • Após a definição deste parâmetro, o dispositivo SAG gera uma rota padrão.
Username String Não P12ppp***

Nome de usuário da conta PPPoE.

O nome de usuário deve ter entre 6 e 30 caracteres e pode conter dígitos e letras.

Nota Especifique este parâmetro quando o tipo de conexão da porta WAN for PPPoE.
Password String Não P12ppq***

Senha da conta PPPoE.

A senha deve ter entre 6 e 30 caracteres e pode conter dígitos e letras.

Nota Informe este parâmetro se o tipo de conexão da porta WAN for PPPoE. Caso não precise modificar a senha, ignore este parâmetro.
Priority Integer Não 1

Prioridade da porta WAN.

Valores válidos: -1 e 1 a 50.

Um valor menor indica maior prioridade. O valor -1 desativa o encaminhamento de tráfego na porta WAN.

Weight Integer Não 100

Peso da porta WAN.

Valores válidos: 1 a 100. Valor padrão: 100.

ISP String Não CT

ISP utilizado pela porta WAN. Valores válidos:

  • CT: China Telecom
  • CM: China Mobile
  • CU: China Unicom
  • Other: Outros ISPs.
Bandwidth Integer Não 50

Largura de banda máxima da porta WAN. Unidade: Mbit/s.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://smartag.cn-shanghai.aliyuncs.com/?Action=ModifySagWan
&IPType=DHCP
&PortName=0
&RegionId=cn-shanghai
&SmartAGId=sag-whfn****
&SmartAGSn=sag32a30****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifySagWanResponse>
   <RequestId>AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545</RequestId>
</ModifySagWanResponse>

Formato JSON

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

{
  "RequestId" : "AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

Sag.PortNotExist

The specified port does not exist.

A mensagem de erro retornada porque a porta especificada não existe.

400

Sag.PortRoleInvalid

The port role is invalid.

A função da porta é inválida.

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