UpdateTransitRouterPeerAttachmentAttribute - Modificar atributo de conexão de par do roteador de trânsito - : Central de Documentação do Alibaba Cloud

Observações de uso

UpdateTransitRouterPeerAttachmentAttribute é uma operação assíncrona. Após enviar a solicitação, o sistema retorna o ID da solicitação, mas a operação continua sendo executada em segundo plano. Chame ListTransitRouterPeerAttachments para consultar o status de uma conexão inter-região.

Se uma conexão inter-região estiver no estado Modifying, a conexão está sendo modificada. Nesse estado, é possível consultar a conexão, mas não é possível executar outras operações.
Se uma conexão inter-região estiver no estado Attached, a conexão foi modificada com sucesso.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame 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	UpdateTransitRouterPeerAttachmentAttribute	A operação que você deseja executar. Defina o valor como UpdateTransitRouterPeerAttachmentAttribute.
ClientToken	String	Não	02fb3da4-130e-11e9-8e44-001****	O token do cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas certifique-se de que ele seja exclusivo entre diferentes solicitações. O ClientToken pode conter apenas caracteres ASCII. Nota Se você não definir esse parâmetro, o ClientToken será definido com o valor do RequestId. O valor do RequestId pode ser diferente para cada solicitação de API.
TransitRouterAttachmentId	String	Sim	tr-attach-ft94dcrbc3e5taun3x	O ID da conexão inter-região.
TransitRouterAttachmentName	String	Não	testname	O novo nome da conexão inter-região. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hífens (-). O nome deve começar com uma letra.
TransitRouterAttachmentDescription	String	Não	testdesc	A nova descrição da conexão inter-região. A descrição deve ter de 2 a 256 caracteres. A descrição deve começar com uma letra, mas não pode começar com `http://` ou `https://`.
AutoPublishRouteEnabled	Boolean	Não	false	Especifica se o roteador de trânsito Enterprise Edition local deve anunciar automaticamente as rotas da conexão inter-região para o roteador de trânsito par. Valores válidos: false (padrão): não. true: sim.
DryRun	Boolean	Não	false	Especifica se uma verificação prévia deve ser executada para validar informações como permissões e status da instância. Valores válidos: false (padrão): verifica a solicitação. Se a solicitação passar na verificação, a conexão inter-região será modificada. true: executa uma verificação prévia da solicitação sem executar a operação. A conexão inter-região não será modificada após a solicitação passar na verificação prévia. Com esse valor, o sistema verifica os parâmetros obrigatórios e a sintaxe da solicitação. Se a solicitação não passar na verificação prévia, uma mensagem de erro será retornada. Se a solicitação passar na verificação, o sistema retorna o ID da solicitação.
Bandwidth	Integer	Não	2	O valor máximo de largura de banda da conexão inter-região. Unidade: Mbit/s. Este parâmetro especifica o valor máximo de largura de banda para a conexão inter-região quando BandwidthType é definido como BandwidthPackage. Este parâmetro especifica o limite de limitação de largura de banda para a conexão inter-região quando BandwidthType é definido como DataTransfer.
CenBandwidthPackageId	String	Não	cenbwp-3xrxupouolw5ou****	O ID do plano de largura de banda usado para alocar largura de banda à conexão inter-região. Nota Se você definir BandwidthType como DataTransfer, não será necessário definir este parâmetro.
BandwidthType	String	Não	BandwidthPackage	O método de alocação de largura de banda. Valores válidos: BandwidthPackage: aloca largura de banda de um plano de largura de banda. DataTransfer: a largura de banda é cobrada com base no método de medição por transferência de dados.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	A01FEDD7-7D69-4EB3-996D-CF79F6F885CA	O ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=UpdateTransitRouterPeerAttachmentAttribute
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&TransitRouterAttachmentId=tr-attach-ft94dcrbc3e5taun3x
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testdesc
&AutoPublishRouteEnabled=false
&DryRun=false
&Bandwidth=2
&CenBandwidthPackageId=cenbwp-3xrxupouolw5ou****
&BandwidthType=BandwidthPackage
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<UpdateTransitRouterPeerAttachmentAttributeResponse>
    <RequestId>A01FEDD7-7D69-4EB3-996D-CF79F6F885CA</RequestId>
</UpdateTransitRouterPeerAttachmentAttributeResponse>

Formato JSON

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

{
  "RequestId" : "A01FEDD7-7D69-4EB3-996D-CF79F6F885CA"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.	A mensagem de erro retornada porque o ID da instância de rede não existe.

Para obter uma lista de códigos de erro, visite a Central de Erros da API.