Todos os produtos
Search

Este produto

    Express Connect:ModifyVirtualBorderRouterAttribute

    Central de documentação

    Express Connect:ModifyVirtualBorderRouterAttribute

    Última atualização: Jun 29, 2026

    Modifica a configuração de um virtual border router (VBR).

    Descrição da operação

    • VlanId só pode ser modificado pelo proprietário do circuito do Express Connect.

    • O mesmo ID de VLAN no mesmo circuito do Express Connect não pode ser usado por dois VBRs simultaneamente.

    • Um VBR com o status terminated retém seu ID de VLAN exclusivamente por 7 dias, período durante o qual nenhum outro VBR pode usá-lo. Após 7 dias, o ID de VLAN fica disponível para outros VBRs.

    • Instâncias de VBR pertencentes a outras contas não podem configurar LocalGatewayIp, PeerGatewayIp ou PeeringSubnetMask.

    • PeeringSubnetMask aceita máscaras de sub-rede de /24 a /30 (255.255.255.0 a 255.255.255.252).

    • LocalGatewayIp e PeerGatewayIp devem pertencer ao mesmo segmento de rede. Por exemplo: LocalGatewayIp: 192.168.XX.XX, PeerGatewayIp: 192.168.XX.XX, PeeringSubnetMask: 255.255.255.248.

    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 do VBR.

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

    cn-shanghai
    VbrId

    string

    Sim

    O ID do VBR.

    vbr-bp1lhl0taikrte****
    VlanId

    integer

    Não

    O ID de VLAN do VBR. Valores válidos: 0 a 2999.

    Nota

    Este parâmetro está disponível apenas para proprietários do Express Connect. Os IDs de VLAN dos VBRs no mesmo circuito do Express Connect devem ser exclusivos.

    0
    CircuitCode

    string

    Não

    O código do circuito do Express Connect. O código do circuito é fornecido pelo provedor de conectividade.

    Nota

    Apenas o proprietário do circuito do Express Connect pode definir esta propriedade.

    longtel001
    LocalGatewayIp

    string

    Não

    O endereço IP do VBR.

    Apenas o proprietário do VBR pode definir ou modificar este parâmetro.

    192.168.XX.XX
    PeerGatewayIp

    string

    Não

    O endereço IP do dispositivo de gateway no data center.

    Apenas o proprietário do VBR pode definir ou modificar este parâmetro.

    192.168.XX.X
    PeeringSubnetMask

    string

    Não

    A máscara de sub-rede para os endereços IP dos dispositivos de gateway no lado do Alibaba Cloud e no lado do cliente. Apenas o proprietário do VBR pode definir ou modificar este parâmetro.

    Os dois endereços IP devem estar na mesma sub-rede.

    255.255.255.252
    MinTxInterval

    integer

    Não

    O intervalo de tempo para enviar pacotes BFD. Valores válidos: 200 a 1000. Unidade: milissegundos.

    300
    MinRxInterval

    integer

    Não

    O intervalo de tempo para receber pacotes BFD. Valores válidos: 200 a 1000. Unidade: milissegundos.

    300
    DetectMultiplier

    integer

    Não

    O número máximo de pacotes perdidos permitidos pelo receptor quando o iniciador transmite pacotes. Este valor pode ser usado para verificar se uma conexão funciona conforme o esperado.

    Valores válidos: 3 a 10.

    3
    Description

    string

    Não

    A descrição do VBR.

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

    desc
    Name

    string

    Não

    O nome do VBR.

    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. Não pode começar com http:// ou https://.

    VBR
    AssociatedPhysicalConnections

    string

    Não

    As informações sobre o circuito do Express Connect associado ao VBR, incluindo os seguintes parâmetros:

    • CircuitCode: o código do circuito fornecido pelo provedor de conectividade para o circuito do Express Connect.

    • LocalGatewayIp: o endereço IP do dispositivo de gateway no lado do Alibaba Cloud.

    • PeerGatewayIp: o endereço IP do dispositivo de gateway no lado do cliente.

    • PeeringSubnetMask: a máscara de sub-rede para os endereços IP dos dispositivos de gateway no lado do Alibaba Cloud e no lado do cliente.

    • PhysicalConnectionId: o ID do circuito do Express Connect.

    [ { "VlanId": "5", "CircuitCode": "longtel001", "LocalGatewayIp": "192.168.XX.XX", "PeerGatewayIp": "192.168.XX.XX", "PeeringSubnetMask": "255.255.255.252", "LocalIpv6GatewayIp": "fd00:XXXX:1030:3f41::1", "PeerIpv6GatewayIp": "fd00:XXXX:1030:3f41::2", "PeeringIpv6SubnetMask": "fd00:0:1030:3f41::/126", "ipv6Enable": true, "PhysicalConnectionId": "pc-kojok19****" } ]
    ClientToken

    string

    Não

    O token de cliente usado para garantir a idempotência da solicitação.

    Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII.

    Nota

    Se você não especificar este parâmetro, o sistema usará automaticamente o ID da solicitação como o token do cliente. O ID da solicitação pode ser diferente para cada solicitação.

    02fb3da4-130e-11e9-8e44-00****
    LocalIpv6GatewayIp

    string

    Não

    O endereço IPv6 do VBR.

    2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
    PeerIpv6GatewayIp

    string

    Não

    O endereço IPv6 do dispositivo de gateway no data center.

    • Apenas o proprietário do VBR pode definir ou modificar esta propriedade.

    • Esta propriedade é obrigatória quando você cria um VBR para o proprietário do circuito do Express Connect. Você pode ignorar esta propriedade ao criar um VBR para outra conta do Alibaba Cloud.

    2001:XXXX:3c4d:0015:0000:0000:0000:2a2b
    PeeringIpv6SubnetMask

    string

    Não

    A máscara de sub-rede dos endereços IPv6 do VBR e do dispositivo de gateway no data center.

    Os dois endereços IPv6 devem estar na mesma sub-rede.

    2408:4004:cc:400::/56
    EnableIpv6

    boolean

    Não

    Especifica se o IPv6 deve ser ativado. Valores válidos:

    • true

    • false (padrão)

    false
    Bandwidth

    integer

    Não

    O valor da largura de banda. Unidade: Mbit/s.

    100
    SitelinkEnable

    boolean

    Não

    Indica se o acesso ao serviço entre data centers deve ser permitido. Valores válidos:

    • true

    • false

    false
    Mtu

    integer

    Não

    O valor de MTU suportado pelo VBR. Valores válidos: 1500 e 8500.

    Este valor pode ser definido apenas quando o VBR está anexado a um ECR. O valor também afeta todos os outros VBRs e VPCs no mesmo ECR.

    1500

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    O ID da solicitação.

    RequestId

    string

    O ID da solicitação.

    980960B0-2969-40BF-8542-EBB34FD358AB

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "980960B0-2969-40BF-8542-EBB34FD358AB"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 IllegalParam.AssociatedPhysicalConnections The specified AssociatedPhysicalConnections is illegal. The specified AssociatedPhysicalConnections is illegal.
    400 IllegalParam.IpAddress The specified IpAddress is illegal. The specified IpAddress is illegal
    400 IllegalParam.CidrBlock The specified CidrBlock is illegal. The operation failed because CidrBlock is set to an invalid value.
    400 InvalidVbrId.NotFound The specified VirutalBorderRouter is not found.
    400 IllegalParam.MinTxInterval The specified MinTxInterval is not in proper range. The specified MinTxInterval is not in the proper range.
    400 IllegalParam.MinRxInterval The specified MinRxInterval is not in proper range. The specified MinRxInterval is not in the proper range.
    400 IllegalParam.DetectMultiplier The specified DetectMultiplier is not in proper range. DetectMultiplier parameters are not in the proper range.
    400 InvalidVlanId.Used The specified VlanId has been used.
    400 Duplicated.LocalGatewayIp The specified LocalGatewayIps are duplicated.
    400 Duplicated.PeerGatewayIp The specified PeerGatewayIp are duplicated.
    400 IllegalParam.LocalGatewayIp The specified LocalGatewayIp already exists.
    400 IllegalParam.PeerGatewayIp The specified PeerGatewayIp already exists.
    400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid.
    400 InvalidVlanId.Malformed The specified VlanId is not valid.
    400 InvalidIp.Malformed The specified ip address is not valid.
    400 InvalidPeeringSubnetMask.Malformed The specified PeeringSubnetMask is not valid. PeeringSubnetMask is set to an invalid value.
    400 InvalidName.Malformed The specified Name is not valid. The Name parameter is set to an invalid value.
    400 InvalidDescription.Malformed The specifid Description is not valid. The Description parameter is set to an invalid value.
    400 MissingParameter LocalGatewayIp, peerGatewayIp and peeringSubnetMask must not be null. The following parameters are required but not set: LocalGatewayIp, peerGatewayIp, and peeringSubnetMask.
    400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet. The IP addresses of the local gateway and the peer gateway do not fall within the same subnet.
    400 InvalidParameter %s
    400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use. The VLAN ID is already used.
    400 IncorrectStatus.VirtualBorderRouter %s
    400 OperationUnsupported.IPV6ForThisRegion This Region do not support IPV6. The region does not support IPv6.
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. Billing for outbound data transfer is disabled.
    400 OperationDenied.VBRAssociateVPconn The operation is not allowed because of VBRAssociateVPconn. The operation failed because you cannot associate a VBR with the hosted connection.
    400 OperationFailed.PhysicalConnectionFinancialLocked Update failed, the physical connection is financial locked. The shared port is locked due to overdue payments and you cannot modify the VLAN.
    400 OperationFailed.PhysicalConnectionTerminated Update failed, the physical connection is terminated. The shared port is disabled and you cannot modify the VLAN.
    400 OperationFailed.VbrBandWidthMust0InVlan0Vbr The operation is failed because of VbrBandWidthMust0InVlan0Vbr. Operation failed, speed limit configuration is not allowed.
    400 MissingParam.DetectMultiplier The parameter DetectMultiplier is mandatory. Missing parameter DetectMultiplier. When configuring BFD packets, you need to configure three parameters: the sending interval, the receiving interval, and the detection time multiple.
    400 MissingParam.MinRxInterval The parameter MinRxInterval is mandatory. Missing parameter MinRxInterval. When configuring BFD packets, you need to configure three parameters: the sending interval, the receiving interval, and the detection time multiple.
    400 MissingParam.MinTxInterval The parameter MinTxInterval is mandatory. Missing parameter MinTxInterval. When configuring BFD packets, you need to configure three parameters: the sending interval, the receiving interval, and the detection time multiple.
    400 DuplicatedParam.LocalGatewayIp The LocalGatewayIp values are duplicated. The error message returned because a duplicate IP address is used for communication. Change the IP address and try again.
    400 OperationUnsupported.VirtualBorderRouterEnableIPv6 The operation failed. The device or region does not support IPv6 functions. The operation failed because the device or region does not support IPv6.
    400 OperationFailed.PconnAllocateVlan0 Vlan 0 Vbr cannot share the physical connection with another Vbr. The operation failed because VLAN 0 is set to a VBR associated with the Express Connect circuit and you cannot set VLAN 0 to other VBRs.
    400 IllegalParam.VlanId The parameter VlanId is illegal. The operation failed because VlanId is set to an invalid value.
    400 OperationFailed.VbrLocked The VBR is locked. The border router is locked, please try again later.
    400 IllegalParam.%s The param of %s is illegal. The parameter is invalid.
    400 OperationDenied.NotInWhiteList User does not have permission to turn on jumbo frames.
    400 IncorrectStatus.Ecr The express connect router is not in a steady state and cannot operate.
    400 ResourceInConfiguring.NodeId The express connect router subinstance is not in a steady state and cannot operate.
    400 UnsupportedFeature.JumboFrame The jumbo frame feature is not supported in the current region.
    403 Forbidden.CircuitCodeNotAllowedByCaller The caller is not allowed to modify.
    403 Forbidden.LocalGatewayIpNotAllowedByCaller The caller is not allowed to specify the LocalGatewayIp parameter.
    403 Forbidden.PeerGatewayIpNotAllowedByCaller The caller is not allowed to specify the PeerGatewayIp parameter.
    403 Forbidden.PeeringSubnetMaskNotAllowedByCaller The caller is not allowed to specify the PeeringSubnetMask parameter.
    403 Forbidden.VlanIdNotAllowedByCaller The caller is not allowed to specify the VlanId.
    403 Forbidden.NameNotAllowedByCaller The caller is not allowed to specify the Name parameter.
    403 Forbidden.DescriptionNotAllowedByCaller The caller is not allowed to specify the Description parameter.
    404 InvalidRegionId.NotFound The specified RegionId is not found. The specified region ID is invalid. Check whether the service is available in the specified region.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.