CreateRouterInterface - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Cria uma interface de roteador.

Descrição da operação

Ao chamar esta operação, observe os seguintes limites:

Você pode criar apenas um par de interfaces a serem conectadas entre dois roteadores.
Você pode criar no máximo cinco interfaces de roteador para um roteador.
Se sua conta Alibaba Cloud tiver uma interface de roteador com pagamentos em atraso, você não poderá criar novas interfaces de roteador.
Cada CIDR de destino das entradas de rota na mesma tabela de rotas deve ser único.
Um virtual border router (VBR) pode servir apenas como solicitante. O VBR deve estar no estado Activated.
Você pode chamar esta operação para criar interfaces de roteador por assinatura e pay-as-you-go.

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 à qual a interface de roteador pertence. Você pode chamar a operação DescribeRegions para obter o ID da região.	cn-hangzhou
Role	string	Sim	A função da interface de roteador. Valores válidos: InitiatingSide: solicitante AcceptingSide: aceitante	InitiatingSide
OppositeRegionId	string	Sim	O ID da região na qual o aceitante está implantado.	cn-shanghai
Spec	string	Sim	A especificação da interface de roteador e a largura de banda correspondente. Valores válidos: Mini.2: 2 Mbit/s Mini.5: 5 Mbit/s Small.1: 10 Mbit/s Small.2: 20 Mbit/s Small.5: 50 Mbit/s Middle.1: 100 Mbit/s Middle.2: 200 Mbit/s Middle.5: 500 Mbit/s Large.1: 1.000 Mbit/s Large.2: 2.000 Mbit/s Large.5: 5.000 Mbit/s Xlarge.1: 10.000 Mbit/s Nota Se Role estiver definido como AcceptingSide, defina Spec como Negative. Isso indica que você não precisa especificar a especificação ao criar uma interface de roteador aceitante.	Mini.2
RouterType	string	Sim	O tipo de roteador associado à interface de roteador. Valores válidos: VRouter VBR	VRouter
RouterId	string	Sim	O ID do roteador associado à interface de roteador.	vbr-m5ebm6g9ptc9mly1c****
OppositeInterfaceId	string	Não	O ID da interface de roteador do par.	ri-2zeo3xzyf38r4urzd****
OppositeRouterId	string	Não	O ID do roteador do par.	vrt-bp1lhl0taikrteen8****
OppositeRouterType	string	Não	O tipo de roteador associado à interface de roteador do par. Valores válidos: VRouter VBR	VRouter
OppositeInterfaceOwnerId	string	Não	O ID da conta Alibaba Cloud à qual a interface de roteador do par pertence.	253460731706911258
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 ocioso da virtual private cloud (VPC) local. Nota Você pode definir este parâmetro quando um circuito Express Connect é usado.	192.168.0.6
HealthCheckTargetIp	string	Não	O endereço IP de destino usado para realizar verificações de integridade. Nota Este parâmetro é obrigatório se você especificar HealthCheckSourceIp.	192.168.0.8
AccessPointId	string	Não	O ID do ponto de acesso ao qual o VBR pertence. Você pode chamar a operação DescribeAccessPoints para obter os IDs dos pontos de acesso. Nota Este parâmetro é obrigatório se o VBR estiver conectado a um circuito Express Connect.	ap-cn-hangzhou-yh-ts-A
OppositeAccessPointId	string	Não	O ID do ponto de acesso ao qual o par pertence. Nota Este parâmetro é obrigatório se a interface de roteador do par estiver associada a um VBR. O valor especificado não pode ser alterado após a criação da interface de roteador.	ap-cn-shanghai-nt-aligroup-C
Description	string	Não	A descrição da interface de roteador. A descrição deve ter de 2 a 256 caracteres. Deve começar com uma letra e não pode começar com `http://` ou `https://`.	abcabc
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, pontos (.), underscores (_) e hifens (-).	abc
Period	integer	Não	A duração da assinatura. Valores válidos: Valores válidos quando PricingCycle está definido como Month: 1 a 9. Valores válidos quando PricingCycle está definido como Year: 1 a 3. Nota Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid.	3
InstanceChargeType	string	Não	O método de cobrança da interface de roteador. Valores válidos: PrePaid: assinatura PostPaid: pay-as-you-go	PrePaid
AutoPay	boolean	Não	Especifica se o pagamento automático deve ser ativado. Valores válidos: false (padrão): O pagamento automático está desativado. Se você selecionar esta opção, deverá ir ao Centro de Pedidos para concluir o pagamento após a geração de um pedido. true: O pagamento automático está ativado. Os pagamentos são concluídos automaticamente após a geração de um pedido. Nota Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid.	false
PricingCycle	string	Não	O ciclo de cobrança da assinatura. Valores válidos: Month (padrão) Year Nota Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid.	Month
ClientToken	string	Não	O token do 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 único entre diferentes solicitações. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o ID da solicitação como token do cliente. O ID da solicitação pode ser diferente para cada solicitação.	123e4567-e89b-12d3-a456-426655440000
ClientToken	string	Não	O token do 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 único entre diferentes solicitações. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o ID da solicitação como token do cliente. O ID da solicitação pode ser diferente para cada solicitação.	123e4567-e89b-12d3-a456-426655440000
FastLinkMode	boolean	Não	Especifica se o VBR criado no modo Fast Link é vinculado à interface de roteador. O modo Fast Link ajuda a conectar automaticamente interfaces de roteador criadas para o VBR e sua VPC par. Valores válidos: true false Nota Este parâmetro tem efeito apenas se RouterType estiver definido como VBR e OppositeRouterType estiver definido como VRouter. Se FastLinkMode estiver definido como true, Role deve ser definido como InitiatingSide. Neste caso, AccessPointId, OppositeRouterType, OpppsiteRouterId e OppositeInterfaceOwnerId são obrigatórios.	false
AutoRenew	boolean	Não	Especifica se a renovação automática deve ser ativada. Valores válidos: false (padrão) true	false
ResourceGroupId	string	Não	O ID do grupo de recursos. Para mais informações sobre grupos de recursos, consulte O que é Resource Management?	rg-acfmxazb4ph6aiy****
Tags	array<object>	Não	A tag a ser adicionada ao recurso.
	object	Não
Key	string	Não	A chave da tag a ser adicionada ao recurso. Você deve inserir pelo menos uma chave de tag. Você pode especificar até 20 chaves de tag. A chave de tag não pode ser uma string vazia. Uma chave de tag pode ter no máximo 128 caracteres. Não pode começar com `aliyun` ou `acs:`, e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag a ser adicionado ao recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com `acs:` ou `aliyun`. Não pode conter `http://` ou `https://`.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
RequestId	string	O ID da solicitação.	079874CD-AEC1-43E6-AC03-ADD96B6E4907
OrderId	integer	O número do pedido. Este parâmetro é retornado se InstanceChargeType estiver definido como PrePaid.	20210101123456
RouterInterfaceId	string	O ID da interface de roteador.	ri-2ze7fbuohm****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "079874CD-AEC1-43E6-AC03-ADD96B6E4907",
  "OrderId": 20210101123456,
  "RouterInterfaceId": "ri-2ze7fbuohm****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidPrice.NotFound	Pricing plan result not found.	The Price parameter is set to an invalid value.
400	InvalidAliuid	Invalid Aliuid.	The Aliuid parameter is set to an invalid value.
400	InvalidRole.ValueNotSupported	The specified Role is not valid.
400	InvalidSpec.ValudNotSupported	The specified Spec is not supported.
400	InvalidRouterType.ValueNotSupported	The specified RouterType is not valid.
400	InvalidName.Malformed	The specified "Name" is not valid.
400	Forbidden.BillsOutstanding	You cannot create more RouterInterface because you have bills outstanding.
400	LimitationExceed.InterfaceNumberOnRouter	Total number of RouterInterfaces on a Router exceeded.
400	Forbidden.NotInRouterInterfaceCreateWhitelist	Not in router interface create whitelist.
400	RI_CREATE_ONE_LIMIT_BY_SYNC	Create ri only one limit by sync.
400	InvalidAccessPoint.ValueNotAllowed	The non-vbr router interface cannot have access point configured.
400	InvalidParam.NotFound	Parameter must not be null,uid, bid,regionNo, remoteRegionNo, routerId or accessPointId	The parameter value cannot be null.
400	InvalidAccessPoint.NotMatch	The accessPoint id is not matched
400	InvalidAccessPoint.NotExist	The accessPoint not exit
400	INVAID_VBR_STATUS	VBR status must be active
400	IncorrectStatus.CenStatus	Cen status must not be middle status.	Check the status of the CEN instance.
400	Forbidden.AcceptRoleNotSupportPrePay	Acception side ri not support chargetype for prepaid.	The subscription billing method is not supported.
400	InvalidRouterInterfaceSpec.Malformed	Specified RouterInterface spec is not valid.	The RouterInterface Spec parameter is set to an invalid value.
400	VpcSubnet.NotFound	Vpc subnet not exist.	The VPC subnet does not exist.
400	IllegalParam.HealthcheckIp	Healthcheck ip cannot equal with instance ip.	The IP address configured for health checks cannot be the same as the IP address of the instance.
400	OperationFailed.HcForInvalidRiType	Healthchecksourceip and healthchecktargetip is only valid for vr ri that is connected to vbr.	The IP address configured for health checks is invalid.
400	OperationFailed.SyncOrderToSub	SyncOrderToSub error.	The operation failed.
400	IllegalParam.CrossBorderBandwidth	CrossBorder bandwidth error.	The inter-region bandwidth plan is invalid.
400	IllegalParam.VRouterType	The VRouterType is not supported.	The VRouterType parameter is set to an invalid value.
400	IllegalParam.Spec	The spec is illegal.	The spec parameter is set to an invalid value.
400	Forbidden.CrossBorder	User not authorized to create cross border routerInterface.	You do not have the permissions to create a cross-border router interface.
400	InvalidRouterId.NotFound	Param is not valid,this user does not have this router or aliuid bid regionNo and routerId must have something wrong.	The RouterId parameter is set to an invalid value.
400	InvalidCommodity.NotFound	Commodity is not exist.	The Commodity parameter is set to an invalid value.
400	InvalidRouterInterfaceChargeType.Malformed	Specified RouterInterface ChargeType is not valid.	The RouterInterface ChargeType parameter is set to an invalid value.
400	IllegalParam.RegionId	The specified regionId is illegal.	The regionId parameter is set to an invalid value.
400	PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL	User withhoding argeement is illegal.
400	QuotaExceeded	RiPerUser quota exceeded
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	Billing for outbound data transfer is disabled.
400	InvalidRegionId.NotFound	The regionId provided does not exist in ec region list.
400	ResourceNotInResourceGroup	The specified resource is not in the specified ResourceGroup.	The specified resource does not belong to the resource group.
400	HaveConnectionBetweenRouters	Have connection between routers	A connection is established between the two routers.
400	InvalidDescription.Malformed	The specified "Description" is not valid.	The description can be 2 to 256 characters in length and cannot start with http:// and https.
400	InvalidBandwidth.NotEnough	Bandwidth not enough.	The bandwidth plan has insufficient bandwidth.
400	ForbiddenAction	The user does not support this action.	You do not have the required permissions.
400	OperationFailed.NotSupportIPv6	Router interface not support IPv6.	The router interface does not support IPv6.
400	InvalidParam.AvailableZoneId	The specified AvailableZoneId did not retrieve the corresponding cluster IP address.	The specified AvailableZoneId does not obtain the corresponding cluster IP address.
400	OperationFailed.NoAvailableAmount	The available amount of your account is less than 0, please recharge before attempting to purchase.	Your account balance is negative. Top up your account before you can make a purchase.
400	OperationFailed.OperationLocked	Operation failed because OperationLocked.	The operation failed because the instance is locked due to O&M.
400	OperationFailed.InvalidEcGrant	The VBR have no grant to create EC.	The VBR instance is not grant by the VPC instance. Please try again after grant.
400	OperationFailed.CannotConnectOtherOwnerInstance	Can not connect with other owner VPC or CEN.	Failed to bind the current resource to another account's VPC or CEN. Check whether you have the relevant permissions and try again.
400	InvalidParams.NotNull	params must not null.	The parameter is required.
404	InvalidRegionId.NotFound	The regionId provided does not exist in our records.	The RegionId parameter is set to an invalid value. Specify a valid value and try again.
404	InvalidRouterId.NotFound	The specified RouterId does not exist in our recored.
404	InvalidRouterId.AttacedToCEN	Can not create ri when attaced to CEN.	You cannot attach the router interface to the CEN instance.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.