ModifyRouterInterfaceAttribute - Express Connect: Central de Documentação do Alibaba Cloud

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

vpc:ModifyRouterInterfaceAttribute

update

*RouterInterface

acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}

vpc:TargetAccountRDId

Nenhuma

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 deve excluir os endereços IP de verificação de integridade configurados na interface de roteador. 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.	O valor do parâmetro Name é inválido.
400	InvalidOppositeRouterType.ValueNotSupported	The specified OppositeRouterType is not valid.	O valor do parâmetro OppositeRouterType é inválido.
400	InvalidDescription.Malformed	The Description is illegal.	A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
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	Os parâmetros para edição da interface de roteador são inválidos.
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.	O endereço IP de verificação de integridade é inválido.
400	OperationFailed.OperationLocked	Operation failed because OperationLocked.	A operação falhou porque a instância já está bloqueada para manutenção.
400	IncorrectStatus.RouterInterface	This openeration would not be allowed because status of this RouterInterface is not correct.	O estado da interface do roteador é anormal.
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.