UpdateTransitRouterPeerAttachmentAttribute - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Modifica a configuração de uma conexão inter-região em um roteador de trânsito Enterprise Edition chamando a operação UpdateTransitRouterPeerAttachmentAttribute.

Descrição da operação

UpdateTransitRouterPeerAttachmentAttribute é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um RequestId, mas a conexão inter-região ainda não foi modificada. A tarefa de modificação continua sendo executada em segundo plano. Você pode chamar ListTransitRouterPeerAttachments para consultar o status da conexão inter-região.

Se a conexão inter-região estiver no estado Modifying, ela está sendo modificada. Nesse estado, você pode apenas consultar a conexão inter-região, mas não pode executar outras operações nela.
Se a conexão inter-região estiver no estado Attached, ela foi modificada com sucesso.

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

cen:UpdateTransitRouterPeerAttachmentAttribute

update

*TransitRouterPeerAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
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 ele seja único entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId como ClientToken. O RequestId de cada solicitação de API pode ser diferente.	02fb3da4-130e-11e9-8e44-001****
TransitRouterAttachmentId	string	Sim	O ID da conexão inter-região.	tr-attach-ft94dcrbc3e5taun3x.
TransitRouterAttachmentName	string	Não	O novo nome da conexão inter-região. O nome pode estar vazio ou ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	testname.
TransitRouterAttachmentDescription	string	Não	A nova descrição da conexão inter-região. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	testdesc.
AutoPublishRouteEnabled	boolean	Não	Especifica se o roteador de trânsito Enterprise Edition deve anunciar automaticamente as rotas da conexão inter-região para a região par. false (padrão): não. true: sim.	false.
DryRun	boolean	Não	Especifica se deve ser realizado um dry run, incluindo verificação de permissões e status da instância. Valores válidos: false (padrão): envia uma solicitação normal e modifica diretamente a configuração da conexão inter-região após a solicitação passar na verificação. true: envia uma solicitação de verificação. Apenas a verificação é realizada e a configuração da conexão inter-região não é modificada. Os itens de verificação incluem se os parâmetros obrigatórios foram especificados e o formato da solicitação. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o ID da solicitação correspondente será retornado.	false.
Bandwidth	integer	Não	O valor de largura de banda da conexão inter-região. Unidade: Mbit/s. Se BandwidthType estiver definido como BandwidthPackage, este parâmetro especifica a largura de banda que a conexão inter-região pode utilizar. Se BandwidthType estiver definido como DataTransfer, este parâmetro especifica o limite de largura de banda da conexão inter-região.	2
CenBandwidthPackageId	string	Não	O ID do pacote de largura de banda a ser associado à conexão inter-região. Nota Se BandwidthType estiver definido como DataTransfer, você não precisa configurar este parâmetro.	cenbwp-3xrxupouolw5ou****
BandwidthType	string	Não	O método de alocação de largura de banda. Valores válidos: BandwidthPackage: aloca largura de banda a partir de um pacote de largura de banda. DataTransfer: não aloca largura de banda para a conexão inter-região. A cobrança é baseada no volume de tráfego.	BandwidthPackage.
DefaultLinkType	string	Não	O tipo de link padrão. Valores válidos: Platinum e Gold. Valor padrão: Gold. O valor só pode ser definido como Platinum quando o método de alocação de largura de banda for pagamento por transferência de dados.	Gold.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	A01FEDD7-7D69-4EB3-996D-CF79F6F885CA.

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.	O TransitRouterAttachmentId especificado na solicitação não existe.
400	OperationUnsupported.BandwidthType	The specified BandwidthType does not support the operation.	O BandwidthType atual não suporta esta operação.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	O parâmetro de valor de largura de banda é obrigatório.
400	IncorrectStatus.Attachment	The resource is not in a valid state for the attachment operation.	O status atual da conexão não suporta esta operação. Tente novamente mais tarde.
400	IllegalParam.BandwidthType	BandwidthType is illegal.	O tipo de pacote de largura de banda é inválido.
400	IllegalParam.Bandwidth	Bandwidth is illegal.	O ID do pacote de largura de banda é inválido.
400	ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold	Cen bandwidthPackage only support Gold.	Quando o método de alocação de largura de banda está definido como pacote de largura de banda, o tipo de link padrão suporta apenas Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold	DataTransfer only support Platinum and Gold.	Quando o método de alocação de largura de banda é pagamento por transferência de dados, o tipo de link padrão suporta apenas Platinum e Gold.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold	CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.	Quando os roteadores de trânsito em ambas as extremidades da conexão inter-regiões não são todos da Edição Empresarial e o método de alocação de largura de banda é pagamento por transferência de dados, o tipo de link padrão suporta apenas Gold.
400	OperationNotAllowed.DefaultLinkTypeOnlySupportGold	Operation is not allowed because this user can only set default link type to Gold.	Este usuário só pode definir o tipo de link padrão como Gold.
400	OperationUnsupported.TransitRouterAttachment	The specified TransitRouterAttachment has configured TransitRegion. Please remove the configuration first.	Existe uma configuração de reutilização de largura de banda. Exclua-a e tente novamente.
400	IllegalParam.BandwidthLessThanQosPolicyBandwidth	The input bandwidth value is less than the sum of the Qos policy bandwidth.	O valor de largura de banda especificado é menor que o limite total de taxa alocado pela largura de banda do QoS.
400	IllegalParam.BandwidthPackageStatus	The status of the bandwidth package is incorrect.	O pacote de largura de banda está em um estado incorreto.
400	QuotaExceeded.Bandwidth	Bandwidth quota exceeded.	O valor de largura de banda excede o limite de cota.
400	ParamExclusive.BandwidthTypeAndCenBandwidthPackageId	DataTransfer and CenBandwidthPackageId is mutually exclusive.	Quando o método de alocação de largura de banda é CDT, o campo CenBandwidthPackageId não pode ser definido.
400	OperationUnsupported.CloudDataTransferService	CCN region not support cloud data transfer service.	O serviço Cloud Data Transfer não é suportado em regiões CCN.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem permissão para realizar esta operação.
400	ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver	CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.	Quando os roteadores de trânsito em ambas as extremidades da conexão inter-regional não são todos da Enterprise Edition e o método de alocação de largura de banda é pagamento por transferência de dados, o tipo de link padrão oferece suporte apenas a Silver (UnderlaySilver).
400	ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver	Cen bandwidthPackage only support UnderlaySilver.	Quando o método de alocação de largura de banda é plano de largura de banda, o tipo de link padrão oferece suporte apenas a Silver (UnderlaySilver).
400	OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver	This user can only set the default link type to UnderlaySilver.	Este usuário só pode definir o tipo de link padrão como Silver (UnderlaySilver).
400	InvalidOperation.QueueLinkTypeNotEqualsAttachmentLinkType	The operation is invalid because the link type of an existing QoS queue does not match the link type of the attachment.	Na política de QoS configurada, o tipo de link de uma fila difere do tipo de link da conexão entre regiões.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.