CreateTransitRouterPeerAttachment - : Central de Documentação do Alibaba Cloud

Informações básicas

Por padrão, 1 Kbit/s de largura de banda está disponível para comunicação inter-região entre transit routers. Esse valor permite testar a conectividade de redes IPv4 inter-região. Para permitir a comunicação entre serviços implantados em diferentes regiões, crie uma conexão inter-região e aloque recursos de largura de banda para essa conexão.

Os transit routers da Enterprise Edition permitem alocar recursos de largura de banda para conexões inter-região pelos seguintes métodos:

Allocate bandwidth resources from a bandwidth plan:

Adquira um plano de largura de banda e aloque recursos desse plano para as conexões inter-região. Para mais informações, consulte CreateCenBandwidthPackage.

Use pay-by-data-transfer bandwidth resources:

Defina um valor máximo de largura de banda para uma conexão inter-região. A cobrança ocorre com base na quantidade de dados transferidos pela conexão. Para mais informações, consulte Cross-region data transfers.

Observações de uso

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

Se uma conexão inter-região estiver no estado Attaching, ela estará em processo de criação. Nesse estágio, é possível consultar a conexão, mas não é possível executar outras operações.
Quando a conexão inter-região estiver no estado Attached, a criação foi concluída com sucesso.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateTransitRouterPeerAttachment	A operação a ser executada. Defina o valor como CreateTransitRouterPeerAttachment.
ClientToken	String	No	02fb3da4-130e-11e9-8e44-001****	Token do cliente usado para garantir a idempotência da solicitação. Gere o valor pelo cliente, mas garanta que ele seja único entre diferentes solicitações. O ClientToken pode conter apenas caracteres ASCII. Nota Se este parâmetro não for definido, o sistema usará automaticamente o RequestId como ClientToken. O valor do RequestId de cada solicitação de API pode ser diferente.
CenId	String	No	cen-j3jzhw1zpau2km****	ID da instância da Cloud Enterprise Network (CEN).
TransitRouterId	String	No	tr-bp1su1ytdxtataupl****	ID do transit router local da Enterprise Edition.
RegionId	String	No	cn-hangzhou	ID da região onde o transit router local da Enterprise Edition está implantado. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
TransitRouterAttachmentName	String	No	testname	Nome da conexão inter-região. O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.
TransitRouterAttachmentDescription	String	No	testdesc	Descrição da conexão inter-região. A descrição deve ter de 2 a 256 caracteres. Deve começar com uma letra, mas não pode iniciar com `http://` ou `https://`.
PeerTransitRouterId	String	Yes	tr-m5eq27g6bndum7e88****	ID do transit router par.
PeerTransitRouterRegionId	String	No	cn-qingdao	ID da região onde o transit router par está implantado.
AutoPublishRouteEnabled	Boolean	No	false	Especifica se o transit router local da Enterprise Edition deve anunciar automaticamente as rotas da conexão inter-região para o transit router par. Valores válidos: false (padrão): não. true: sim.
Bandwidth	Integer	No	2	Valor de largura de banda da conexão inter-região. Unidade: Mbit/s. Se BandwidthType for definido como BandwidthPackage, este parâmetro especifica a largura de banda disponível para a conexão inter-região. Se BandwidthType for definido como DataTransfer, este parâmetro indica o limite de largura de banda da conexão inter-região.
CenBandwidthPackageId	String	No	cenbwp-3xrxupouolw5ou****	ID do plano de largura de banda usado para alocar largura de banda à conexão inter-região. Nota Ao definir BandwidthType como DataTransfer, não é necessário configurar este parâmetro.
DryRun	Boolean	No	false	Especifica se a solicitação deve ser verificada sem executar a operação. O sistema valida as permissões e o status das instâncias especificadas. Valores válidos: false (padrão): verifica a solicitação. Se a validação for bem-sucedida, a conexão inter-região é criada. true: verifica a solicitação, mas não executa a operação. A conexão inter-região não é criada mesmo após a aprovação na verificação. Com este valor, o sistema checa os parâmetros obrigatórios e a sintaxe da solicitação. Caso a pré-verificação falhe, uma mensagem de erro é retornada. Se a verificação for aprovada, o sistema retorna o ID da solicitação.
BandwidthType	String	No	BandwidthPackage	Método utilizado para alocar largura de banda à conexão inter-região. Valores válidos: BandwidthPackage: aloca largura de banda a partir de um plano de largura de banda. DataTransfer: utiliza largura de banda paga por transferência de dados.

Parâmetros de resposta

Parameter	Type	Example	Description
TransitRouterAttachmentId	String	tr-attach-nwkiqfvw22qesz****	ID da conexão inter-região.
RequestId	String	59422BF5-BAAD-4CFD-9019-9557BD3ACFA3	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateTransitRouterPeerAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&TransitRouterId=tr-bp1su1ytdxtataupl****
&RegionId=cn-hangzhou
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testdesc
&PeerTransitRouterId=tr-m5eq27g6bndum7e88****
&PeerTransitRouterRegionId=cn-qingdao
&AutoPublishRouteEnabled=false
&Bandwidth=2
&CenBandwidthPackageId=cenbwp-3xrxupouolw5ou****
&DryRun=false
&BandwidthType=BandwidthPackage
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateTransitRouterPeerAttachmentResponse>
    <TransitRouterAttachmentId>tr-attach-nwkiqfvw22qesz****</TransitRouterAttachmentId>
    <RequestId>59422BF5-BAAD-4CFD-9019-9557BD3ACFA3</RequestId>
</CreateTransitRouterPeerAttachmentResponse>

Formato JSON

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

{
  "TransitRouterAttachmentId" : "tr-attach-nwkiqfvw22qesz****",
  "RequestId" : "59422BF5-BAAD-4CFD-9019-9557BD3ACFA3"
}

Códigos de erro

HttpCode	Error code	Error message	Description
400	OperationUnsupported.TransitRouterRegionId	The specified TransitRouterRegion does not support the operation.	Mensagem de erro retornada porque a região especificada não suporta a operação.
400	NoPermission.AliyunServiceRolePolicyForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	Mensagem de erro retornada porque você não tem autorização para criar a função vinculada ao serviço AliyunServiceRolePolicyForCEN para o serviço cen.aliyuncs.com. É necessário obter a permissão ram:CreateServiceLinkedRole antes de executar a operação.
400	InvalidTransitRouterId.NotFound	TransitRouterId is not found.	Mensagem de erro retornada porque o ID do transit router é inválido.
400	IllegalParam.PeerTransitRouterId	PeerTransitRouterId is illegal.	Mensagem de erro retornada porque o ID do transit router par é inválido.
400	OperationUnsupported.TransitRouterId	TransitRouterId is unsupported.	Mensagem de erro retornada porque transit routers da Basic Edition não suportam a operação.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory.	Mensagem de erro retornada porque nenhum valor de largura de banda foi especificado.

Para obter uma lista de códigos de erro, visite o API Error Center.