Todos os produtos
Search
Central de documentação

Virtual Private Cloud:ModifyRouterInterfaceAttribute

Última atualização: Jul 07, 2026

Modifica a configuração de uma interface de roteador.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região da interface de roteador.

Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-shanghai

RouterInterfaceId

string

Sim

O ID da interface de roteador.

ri-2zeo3xzyf38r4urz****

Name

string

Não

O nome da interface de roteador.

O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). O nome deve começar com uma letra.

TEST

Description

string

Não

A descrição da interface de roteador.

O valor deve ter de 2 a 256 caracteres. Deve começar com uma letra, mas não pode começar com http:// ou https://.

路由器接口

OppositeInterfaceId

string

Não

O ID da interface de roteador par.

ri-2zeo3xzyf38r4urz****

OppositeRouterId

string

Não

O ID do roteador par.

vrt-bp1jcg5cmxjbl9xgc****

OppositeRouterType

string

Não

O tipo de roteador ao qual a interface de roteador par pertence. Valores válidos:

  • VRouter

  • VBR (padrão)

VBR

OppositeInterfaceOwnerId

integer

Não

O ID da conta Alibaba Cloud à qual a interface de roteador par pertence.

28768383240243****

HealthCheckSourceIp

string

Não

O endereço IP de origem usado para realizar verificações de integridade. O endereço IP de origem deve ser um endereço IP livre da nuvem privada virtual (VPC) local.

Nota

Você pode definir este parâmetro quando um circuito do Express Connect for utilizado.

116.62.XX.XX

HealthCheckTargetIp

string

Não

O endereço IP de destino usado para realizar verificações de integridade.

Nota

Este parâmetro é obrigatório quando HealthCheckSourceIp é especificado.

116.62.XX.XX

HcThreshold

integer

Não

O limite de integridade. Unidade: pacotes. Recomendamos que você defina o valor como 8. Este valor especifica o número de pacotes de sondagem enviados durante uma verificação de integridade.

8

HcRate

integer

Não

A taxa de verificações de integridade. Unidade: milissegundos. O valor recomendado é 2000. Este valor especifica o intervalo no qual os pacotes de sondagem são enviados durante uma verificação de integridade.

Neste exemplo, HcThreshold é definido como 8 e HcRate é definido como 2000. Neste exemplo, pacotes de sondagem são enviados de HealthCheckSourceIp (endereço de origem) para HealthCheckTargetIp (endereço de destino) a cada 2.000 milissegundos. Se nenhuma resposta for retornada por oito vezes consecutivas, a verificação de integridade falha.

2000

DeleteHealthCheckIp

boolean

Não

Especifica se os endereços IP de verificação de integridade configurados na interface de roteador devem ser excluídos. Valores válidos:

  • true

  • false (padrão)

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

4EC47282-1B74-4534-BD0E-403F3EE64CAF

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Forbidden.FinancialLocked This RouterInterface is financiel locked because of bills outstanding.
400 InvalidName.Malformed The attribute name is illegal.
400 InvalidOppositeRouterType.ValueNotSupported The specified OppositeRouterType is not valid. The value of the OppositeRouterType parameter is invalid.
400 InvalidDescription.Malformed The Description is illegal.
400 Forbbiden The Router instance owner error
400 LinkRole.NotSupport This linkrole is not supported
400 Forbbiden.ModifyIdAndType Opposite is VBR, cannot modify the ID and type
400 InvalidParam.ModifyRouterInterface Modify routerinterface param invalid
400 INSTANCE_IN_PROCESSIONG Instance is in processing,please wait and try again
400 IllegalParam.HcThreshold %s
400 IllegalParam.HcRate %s
400 InvalidHealthCheckIP.Malformd Healthcheck sourceip or targetip is not valid.
400 IllegalParam.HcSourceIp The specified healthCheck Ip is not valid. The IP address used for health checks is invalid.
400 OperationFailed.OperationLocked Operation failed because OperationLocked. The operation failed because the instance is locked due to O&M.
400 IncorrectStatus.RouterInterface This openeration would not be allowed because status of this RouterInterface is not correct.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidRouterInterfaceId.NotFound The specified RouterInterfaceId does not exist in our records.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.