Tüm Ürünler
Search
Belge Merkezi

:CreateTransitRouterVpcAttachment

Son Güncelleme:Oct 01, 2026

Enterprise Edition geçiş yönlendiricisinde bir sanal özel bulut (VPC) bağlantısı oluşturur.

Kullanım notları

  • Enterprise Edition geçiş yönlendiricisinde VPC bağlantısı oluşturmak için aşağıdaki yöntemleri kullanabilirsiniz:

    • VPC bağlantısı oluşturmak istediğiniz bölgede zaten bir Enterprise Edition geçiş yönlendiricisi varsa VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId ve TransitRouterId parametrelerini belirtin.

    • VPC bağlantısı oluşturmak istediğiniz bölgede henüz bir Enterprise Edition geçiş yönlendiricisi yoksa VpcId, ZoneMappings.N.VSwitchId, ZoneMappings.N.ZoneId, CenId ve RegionId parametrelerini belirtin. VPC bağlantısını oluşturduğunuzda sistem, belirtilen bölgede otomatik olarak bir Enterprise Edition geçiş yönlendiricisi oluşturur.

  • CreateTransitRouterVpcAttachment asenkron bir işlemdir. İsteği gönderdikten sonra VPC bağlantı kimliği döndürülür ancak işlem arka planda devam eder. Bir VPC bağlantısının durumunu sorgulamak için ListTransitRouterVpcAttachments API çağrısını yapabilirsiniz.

    • Bir VPC Attaching durumundaysa VPC bağlantısı oluşturulma aşamasındadır. Bağlantıyı sorgulayabilir ancak başka işlemler gerçekleştiremezsiniz.

    • Bir VPC bağlantısı Attached durumundaysa bağlantı başarıyla oluşturulmuştur.

  • Varsayılan olarak geçiş yönlendirici yönlendirme tabloları ile VPC bağlantıları arasında rota öğrenme ve ilişkili yönlendirme devre dışı bırakılır.

Ön koşullar

Bu API çağrısını yapmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet CreateTransitRouterVpcAttachment

Gerçekleştirmek istediğiniz işlem. Değeri CreateTransitRouterVpcAttachment olarak ayarlayın.

ClientToken String Hayır 02fb3da4-130e-11e9-8e44-001****

İsteğin yinelenebilirliğini (idempotence) sağlamak için kullanılan istemci belirtecidir.

Değeri istemci tarafında üretebilirsiniz ancak tüm istekler arasında benzersiz olduğundan emin olmalısınız. ClientToken yalnızca ASCII karakterleri içerebilir.

Not Bu parametreyi belirtmezseniz ClientToken değeri RequestId olarak ayarlanır. RequestId değeri her API isteğinde farklı olabilir.
CenId String Hayır cen-j3jzhw1zpau2km****

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

TransitRouterId String Hayır tr-bp1su1ytdxtataupl****

Enterprise Edition geçiş yönlendiricisinin kimliğidir.

RegionId String Hayır cn-hangzhou

VPC'nin dağıtıldığı bölgenin kimliğidir.

En güncel bölge listesini sorgulamak için DescribeChildInstanceRegions API çağrısını yapabilirsiniz.

TransitRouterAttachmentName String Hayır testname

VPC bağlantısının adıdır.

Ad 2 ila 128 karakter uzunluğunda olmalı; harf, rakam, alt çizgi (_) ve tire (-) içerebilir. Ad bir harfle başlamalıdır.

TransitRouterAttachmentDescription String Hayır testname

VPC bağlantısının açıklamasıdır.

Açıklama 2 ila 256 karakter uzunluğunda olmalıdır. Açıklama bir harfle başlamalı ancak http:// veya https:// ile başlayamaz.

VpcId String Evet vpc-bp1kbjcre9vtsebo1****

VPC'nin kimliğidir.

VpcOwnerId Long Hayır 1250123456123456

VPC'nin ait olduğu Alibaba Cloud hesabının kimliğidir. Varsayılan değer mevcut Alibaba Cloud hesabınızın kimliğidir.

Not Başka bir hesaba ait bir ağ örneğine bağlanmak istiyorsanız bu parametre zorunludur.
ChargeType String Hayır POSTPAY

Faturalandırma yöntemidir. Varsayılan değer: POSTPAY (kullandıkça öde).

DryRun Boolean Hayır false

İsteğin çalıştırılıp çalıştırılmayacağını belirtir. Sistem izinleri ve belirtilen örneklerin durumunu kontrol eder. Varsayılan değerler:

  • false (varsayılan): İsteği gönderir. Ön kontrol başarılı olursa VPC bağlantısı oluşturulur.
  • true: Ön kontrol isteği gönderir ancak VPC bağlantısı oluşturmaz. Bu değeri kullandığınızda sistem gerekli parametrelerin girilip girilmediğini ve istek sözdiziminin geçerli olup olmadığını kontrol eder. Kontrol başarısız olursa bir hata mesajı döndürülür. Kontrol başarılı olursa DryRunOperation hata kodu döndürülür.
ZoneMappings.N.VSwitchId String Evet vsw-bp1a214sbus8z3b54****

Enterprise Edition geçiş yönlendiricileri tarafından desteklenen bir alanda dağıtılan bir vSwitch seçin.

Her çağrıda en fazla 10 alan için vSwitch belirtebilirsiniz.

ZoneMappings.N.ZoneId String Evet cn-hangzhou-h

Enterprise Edition geçiş yönlendiricileri tarafından desteklenen alanın kimliğidir.

Alan kimliklerini sorgulamak için DescribeZones API çağrısını yapabilirsiniz.

Her çağrıda en fazla 10 alan belirtebilirsiniz.

Tag.N.Key String Hayır tagtest

Kaynakların etiket anahtarlarıdır.

Etiket anahtarları boş olamaz. Uzunluk en fazla 64 karakter olabilir ve acs: veya aliyun ile başlayamaz. http:// veya https:// içeremez.

En fazla 20 etiket anahtarı belirtebilirsiniz.

Tag.N.Value String Hayır tagtest

Kaynakların etiket değerleridir.

Etiket değerleri 0 ila 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. http:// veya https:// içeremez.

Her etiket anahtarının benzersiz bir etiket değeri vardır. Her çağrıda en fazla 20 etiket değeri belirtebilirsiniz.

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

TransitRouterAttachmentId

String

tr-attach-ia340z7xis7t5s****

VPC bağlantısının kimliğidir.

RequestId

String

C087A369-82B9-43EF-91F4-4B63A9C6E6B6

İsteğin kimliğidir.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateTransitRouterVpcAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&TransitRouterId=tr-bp1su1ytdxtataupl****
&RegionId=cn-hangzhou
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testname
&VpcId=vpc-bp1kbjcre9vtsebo1****
&VpcOwnerId=1250123456123456
&ChargeType=POSTPAY
&DryRun=false
&ZoneMappings=[{"VSwitchId":"vsw-bp1a214sbus8z3b54****","ZoneId":"cn-hangzhou-h"}]
&Tag=[{"Key":"tagtest","Value":"tagtest"}]
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<CreateTransitRouterVpcAttachmentResponse>
    <TransitRouterAttachmentId>tr-attach-ia340z7xis7t5s****</TransitRouterAttachmentId>
    <RequestId>C087A369-82B9-43EF-91F4-4B63A9C6E6B6</RequestId>
</CreateTransitRouterVpcAttachmentResponse>

JSON biçimi

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

{
  "TransitRouterAttachmentId" : "tr-attach-ia340z7xis7t5s****",
  "RequestId" : "C087A369-82B9-43EF-91F4-4B63A9C6E6B6"
}

Hata kodları

Http Kodu

Hata kodu

Hata mesajı

Açıklama

400

OperationUnsupported.TransitRouterRegionId

The specified TransitRouterRegion does not support the operation.

Belirtilen bölge bu işlemi desteklemiyor.

400

NoPermission.AliyunServiceRoleForCEN

You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.

cen.aliyuncs.com hizmeti için AliyunServiceRoleForCEN hizmete bağlı rolünü oluşturma izniniz yok. İşlemi gerçekleştirmek için ram:CreateServiceLinkedRole iznine sahip olmalısınız.

400

MissingParam.CenIdOrRegionId

Either CenId or RegionId must be specified.

CenId veya RegionId parametresi belirtilmemiş.

400

IllegalParam.ZoneId

The specified ZoneId is illegal.

Belirtilen alan geçersiz.

400

IllegalParam.ChargeType

The specified ChargeType is illegal.

Belirtilen faturalandırma yöntemi geçersiz.

400

InvalidTransitRouterId.NotFound

The specified TransitRouterId is not found.

Belirtilen geçiş yönlendiricisi bulunamadı.

400

IncorrectStatus.Attachment

The resource is not in a valid state for the attachment operation.

Ağ örneği işlenirken bu işleme izin verilmez. Lütfen daha sonra tekrar deneyin.

400

IncorrectStatus.Vpc

The resource is not in a valid state for the attachment operation.

Ağ örneği işlenirken bu işleme izin verilmez. Lütfen daha sonra tekrar deneyin.

400

Forbbiden.TransitRouterServiceNotOpen

The user has not open transit router service.

Geçiş yönlendirici özelliği etkinleştirilmemiş. Özelliği etkinleştirip tekrar deneyin.

400

OperationUnsupported.TransitRouterType

The specified TransitRouterType does not support the operation.

Belirtilen geçiş yönlendirici türü bu işlemi desteklemiyor.

400

InvalidCenId.NotFound

CenId is not found.

Belirtilen CEN örneği bulunamadı.

400

IllegalParam.VSwitchId

VSwitchId is illegal.

VSwitchId parametresi geçersiz bir değere sahip.

400

IncorrectStatus.TransitRouterInstance

The status of TransitRouter is incorrect.

Geçiş yönlendiricisi geçersiz bir durumda.

400

OperationUnsupported.CenFullLevel

CEN full level does not support TransitRouter

Full türündeki CEN örnekleri Enterprise Edition geçiş yönlendiricilerini desteklemez.

Hata kodlarının listesi için bkz. Hizmet hata kodları.