Tüm Ürünler
Search

Bu Ürün

    :CreateTransitRouterPeerAttachment

    Belge Merkezi

    :CreateTransitRouterPeerAttachment

    Son Güncelleme:Sep 29, 2026

    Ağ örnekleri (VPC'ler, VBR'ler ve IPsec bağlantıları) bir geçiş yönlendiricisine bağlandıktan sonra, farklı bölgelerdeki ağ örnekleri arasında iletişimi etkinleştirmek için geçiş yönlendiricileri arasında bölgeler arası bir bağlantı oluşturmanız gerekir. Enterprise Edition geçiş yönlendirici örneği için bölgeler arası bir bağlantı oluşturmak amacıyla CreateTransitRouterPeerAttachment işlemini çağırabilirsiniz.

    Operation description

    • Enterprise Edition geçiş yönlendiricileri aşağıdaki iki bant genişliği tahsis yöntemini destekler:

      • Bant genişliği paketinden tahsis:

        Bu yöntemi kullanmak için önce bir bant genişliği paketi satın almalı ve bant genişliği paketinden bölgeler arası bağlantıya bant genişliği tahsis etmelisiniz. Bant genişliği paketi satın alma hakkında daha fazla bilgi için CreateCenBandwidthPackage sayfasına bakın.\n - Veri aktarımına göre ödeme:

        Bu yöntemi kullanmak için bölgeler arası bağlantı için bir bant genişliği sınırı belirlemeniz gerekir. Sistem, bölgeler arası bağlantının gerçek trafiğine göre sizden ücret alır. Faturalandırma hakkında daha fazla bilgi için Bölgeler arası veri aktarımı sayfasına bakın.

    • CreateTransitRouterPeerAttachment eşzamansız bir işlemdir. Bir istek gönderdikten sonra sistem bir bölgeler arası bağlantı kimliği döndürür, ancak bölgeler arası bağlantı henüz oluşturulmamıştır. Oluşturma görevi arka planda çalışmaya devam eder. Bölgeler arası bağlantının durumunu sorgulamak için ListTransitRouterPeerAttachments işlemini çağırabilirsiniz.

      • Bölgeler arası bağlantı Attaching durumundaysa, bölgeler arası bağlantı oluşturuluyor demektir. Bu durumda, yalnızca bölgeler arası bağlantıyı sorgulayabilir, üzerinde başka işlem gerçekleştiremezsiniz.\n - Bölgeler arası bağlantı Attached durumundaysa, bölgeler arası bağlantı oluşturulmuş demektir.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    cen:CreateTransitRouterPeerAttachment

    create

    CenInstance

    acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

    TransitRouter

    acs:cen:*:{#accountId}:centransitrouter/{#TransitRouterId}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ClientToken

    string

    No

    İsteğin idempotansını sağlamak için kullanılan istemci belirteci.

    Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. İstemci belirteci yalnızca ASCII karakterleri içerebilir.

    Not

    Bu parametreyi belirtmezseniz, sistem otomatik olarak API isteğinin RequestId değerini ClientToken olarak kullanır. RequestId her API isteği için farklı olabilir.

    02fb3da4-130e-11e9-8e44-001****
    CenId

    string

    No

    Cloud Enterprise Network (CEN) örneğinin kimliği.

    cen-j3jzhw1zpau2km****
    TransitRouterId

    string

    No

    Yerel Enterprise Edition geçiş yönlendirici örneğinin kimliği.

    tr-bp1su1ytdxtataupl****
    RegionId

    string

    No

    Yerel Enterprise Edition geçiş yönlendirici örneğinin bölge kimliği.

    Bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

    cn-hangzhou
    TransitRouterAttachmentName

    string

    No

    Bölgeler arası bağlantının adı.

    Ad boş olabilir veya 1 ila 128 karakter uzunluğunda olabilir ve http:// veya https:// ile başlayamaz.

    testname
    TransitRouterAttachmentDescription

    string

    No

    Bölgeler arası bağlantının açıklaması.

    Açıklama boş olabilir veya 1 ila 256 karakter uzunluğunda olabilir ve http:// veya https:// ile başlayamaz.

    testdesc
    PeerTransitRouterId

    string

    Yes

    Karşı taraf geçiş yönlendirici örneğinin kimliği.

    tr-m5eq27g6bndum7e88****
    PeerTransitRouterRegionId

    string

    No

    Karşı taraf geçiş yönlendirici örneğinin bölge kimliği.

    cn-qingdao
    AutoPublishRouteEnabled

    boolean

    No

    Enterprise Edition geçiş yönlendiricisinin bölgeler arası bağlantının rotalarını karşı taraf bölgeye otomatik olarak duyurmasına izin verilip verilmeyeceğini belirtir.

    • false (varsayılan): hayır.

    • true: evet.

    false
    Bandwidth

    integer

    No

    Bölgeler arası bağlantının bant genişliği değeri. Birim: Mbit/s.

    • BandwidthType değeri BandwidthPackage olarak ayarlanmışsa, bu parametre bölgeler arası bağlantı tarafından kullanılabilecek bant genişliğini belirtir.

    • BandwidthType değeri DataTransfer olarak ayarlanmışsa, bu parametre bölgeler arası bağlantının bant genişliği sınırını belirtir.

    2
    CenBandwidthPackageId

    string

    No

    Bölgeler arası bağlantıyla ilişkilendirilecek bant genişliği paketinin kimliği.

    Not

    BandwidthType değeri DataTransfer olarak ayarlanmışsa, bu parametreyi yapılandırmanıza gerek yoktur.

    cenbwp-3xrxupouolw5ou****
    DryRun

    boolean

    No

    İzin ve örnek durumu doğrulaması dahil olmak üzere deneme çalıştırması (dry run) yapılıp yapılmayacağını belirtir. Geçerli değerler:

    • false (varsayılan): normal bir istek gönderir. İstek doğrulamayı geçerse bölgeler arası bağlantı oluşturulur.

    • true: bir kontrol isteği gönderir. Yalnızca doğrulama gerçekleştirilir. Bölgeler arası bağlantı oluşturulmaz. Sistem gerekli parametrelerin belirtilip belirtilmediğini kontrol eder ve istek biçimini doğrular. Kontrol başarısız olursa ilgili hata döndürülür. Kontrol başarılı olursa ilgili istek kimliği döndürülür.

    false
    BandwidthType

    string

    No

    Bölgeler arası bağlantının bant genişliği tahsis yöntemi. Geçerli değerler:

    • BandwidthPackage: bir bant genişliği paketinden bant genişliği tahsis eder.

    • DataTransfer: bölgeler arası bağlantıya bant genişliği tahsis etmez. Sistem gerçek trafiğe göre ücretlendirme yapar.

    BandwidthPackage
    Tag

    array<object>

    No

    Etiket bilgileri.

    Tek seferde en fazla 20 etiket belirtebilirsiniz.

    object

    No

    Key

    string

    No

    Kaynağın etiket anahtarı.

    Belirtildiğinde, etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 64 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. http:// veya https:// içeremez.

    Tek seferde en fazla 20 etiket anahtarı belirtebilirsiniz.

    tag_A1
    Value

    string

    No

    Kaynağın etiket değeri.

    Belirtildiğinde, etiket değeri boş olamaz. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. http:// veya https:// içeremez.

    Her etiket anahtarı bir etiket değerine karşılık gelir. Tek seferde en fazla 20 etiket değeri belirtebilirsiniz.

    value_A1
    DefaultLinkType

    string

    No

    Varsayılan bağlantı türü.

    Geçerli değerler: Platinum ve Gold. Varsayılan değer: Gold.

    Bağlantı türü, yalnızca bant genişliği tahsis yöntemi veri aktarımına göre ödeme olduğunda Platinum olarak ayarlanabilir.

    Gold

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt parametreleri.

    TransitRouterAttachmentId

    string

    Bölgeler arası bağlantının kimliği.

    tr-attach-nwkiqfvw22qesz****
    RequestId

    string

    İstek kimliği.

    59422BF5-BAAD-4CFD-9019-9557BD3ACFA3

    Examples

    Success response

    JSON format

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

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation.
    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.
    400 InvalidTransitRouterId.NotFound TransitRouterId is not found.
    400 IllegalParam.PeerTransitRouterId PeerTransitRouterId is illegal.
    400 OperationUnsupported.TransitRouterId TransitRouterId is unsupported.
    400 MissingParam.Bandwidth The parameter Bandwidth is mandatory.
    400 IllegalParam.Bandwidth Bandwidth is illegal.
    400 Forbbiden.TransitRouterServiceNotOpen The user has not open transit router service.
    400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation.
    400 OperationUnsupported.BandwidthType The specified BandwidthType does not support the operation.
    400 InvalidCenId.NotFound CenId is not found.
    400 IllegalParam.BandwidthType BandwidthType is illegal.
    400 MissingParam.CenIdOrRegionId Either CenId or RegionId must be specified.
    400 OperationUnsupported.BandwidthHS This bandwidth limit can only be set in China-AsiaPacific-HS
    400 OperationUnsupported.CenFullLevel CEN full level does not support TransitRouter
    400 OperationUnsupported.CloudDataTransferService CCN region not support cloud data transfer service.
    400 InvalidPeerTransitRouterId.NotFound The specified PeerTransitRouterId is not found.
    400 IllegalParam.RegionId RegionId is illegal.
    400 IllegalParam.PeerRegionId PeerRegionId is illegal.
    400 IllegalParam.TransitRouterRegionId TransitRouterRegionId is illegal.
    400 InvalidOperation.CenInstanceStatus The CEN instance is not in a valid state for the operation.
    400 IncorrectStatus.TransitRouter The status of TransitRouter is incorrect.
    400 InvalidOperation.BwpNotAssociated Operation is invalid because a bandwidth package corresponding to the geographic span is not associated.
    400 InvalidOperation.BwpBusinessStatus The CBN bandwidth package is not in a valid business state for the operation.
    400 IllegalParam.CenBandwidthPackageId Parameter CenBandwidthPackageId is illegal.
    400 InvalidOperation.BwpBandwidthExceeded Operation is invalid because the total bandwidth limit has exceeded that of the bandwidth package.
    400 ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold DataTransfer only support Platinum and Gold.
    400 ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold Cen bandwidthPackage only support Gold.
    400 ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version.
    400 OperationNotAllowed.DefaultLinkTypeOnlySupportGold Operation is not allowed because this user can only set default link type to Gold.
    400 OperationInvalid.UserCanNotBuyCrossBorderBwp According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation.
    400 OperationInvalid.IdentityRegistrationStatusNotSupport Real name registration of enterprises required.
    400 InvalidOperation.OnlyOneRegionSupportIpv6 Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all.
    400 InvalidOperation Operation is invalid.
    400 Forbidden.ResourceOwnerTransitRouterServiceExpired The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again.
    400 Forbidden.TransitRouterServiceExpired The transit router service is out of service.
    400 OperationUnsupported.RegionId The specified RegionId does not support the operation.
    400 QuotaExceeded.Bandwidth Bandwidth quota exceeded.
    400 InvalidParameter Invalid parameter.
    400 Unauthorized The AccessKeyId is unauthorized.
    400 InvalidParameter.PeerTransitRouterId The specified parameter PeerTransitRouterId is invalid.
    400 InvalidParameter.ResourceType The specified parameter ResourceType is invalid.
    400 ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version.
    400 ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver Cen bandwidthPackage only support UnderlaySilver.
    400 OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver This user can only set the default link type to UnderlaySilver.
    400 OperationFailed.ValidateVbrInstanceFailedForLowLatencyCircuit Operation failed when validate VBR instance for Low Latency Circuit.
    400 InvalidParameter.TagValue The specified parameter TagValue is invalid.
    400 InvalidParameter.CenBandwidthPackageId The specified parameter CenBandwidthPackageId is invalid.
    400 InvalidParameter.CenId The specified parameter CenId is invalid.
    400 InvalidParameter.TransitRouterId The specified parameter TransitRouterId is invalid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.