Tüm Ürünler
Search
Belge Merkezi

:CreateTransitRouter

Son Güncelleme:Oct 01, 2026

Enterprise Edition geçiş yönlendiricisi oluşturur.

Kullanım notları

  • Enterprise Edition geçiş yönlendiricisi oluşturmak için CreateTransitRouter API işlemini çağırabilirsiniz. Enterprise Edition geçiş yönlendiricilerini destekleyen bölgeler hakkında daha fazla bilgi için bkz. CEN nedir?

  • CreateTransitRouter asenkron bir işlemdir. İstek gönderdiğinizde geçiş yönlendiricisinin kimliği döndürülür ancak işlem arka planda devam eder. Enterprise Edition geçiş yönlendiricisinin durumunu sorgulamak için ListTransitRouters API işlemini çağırabilirsiniz.

    • Bir Enterprise Edition geçiş yönlendiricisi Creating durumunda ise geçiş yönlendiricisi oluşturulma aşamasındadır. Bu durumda geçiş yönlendiricisini sorgulayabilir ancak başka işlem yapamazsınız.

    • Bir Enterprise Edition geçiş yönlendiricisi Active durumunda ise geçiş yönlendiricisi oluşturulmuştur.

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

Parameter Type Required Example Description
Action String Yes CreateTransitRouter

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

ClientToken String No 02fb3da4-130e-11e9-8e44-001****

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

Değerin tüm istekler arasında benzersiz olduğundan emin olmak kaydıyla değeri istemci tarafında üretebilirsiniz. Belirteç yalnızca ASCII karakterleri içerebilir.

Not Bu parametreyi belirtmezseniz sistem otomatik olarak RequestId değerini ClientToken olarak kullanır. Her API isteğinin RequestId değeri farklı olabilir.
CenId String Yes cen-j3jzhw1zpau2km****

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

RegionId String Yes cn-zhangjiakou

Enterprise Edition geçiş yönlendiricisinin dağıtıldığı bölgenin kimliği.

En güncel bölge listesini sorgulamak için DescribeChildInstanceRegions API işlemini çağırabilirsiniz.

TransitRouterName String No testname

Enterprise Edition geçiş yönlendiricisinin adı.

Ad 2 ila 128 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Ad bir harfle başlamalıdır ancak http:// veya https:// ile başlayamaz.

TransitRouterDescription String No testdesc

Enterprise Edition geçiş yönlendiricisinin açıklaması.

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

DryRun Boolean No false

İşlemi gerçekleştirmeden isteği kontrol edip etmeyeceğinizi belirtir. Kontrol edilen öğeler arasında izinler ve belirtilen cloud kaynaklarının durumu yer alır. Geçerli değerler:

  • false (varsayılan): İsteği gönderir. İstek kontrolden geçerse bir Enterprise Edition geçiş yönlendiricisi oluşturulur.
  • true: İsteği kontrol eder ancak Enterprise Edition geçiş yönlendiricisi oluşturmaz. Bu değeri kullandığınızda sistem gerekli parametrelerin girilip girilmediğini ve istek sözdiziminin geçerli olup olmadığını denetler. İstek kontrolden geçemezse bir hata mesajı döndürülür. İstek kontrolden geçerse DryRunOperation hata kodu döndürülür.
SupportMulticast Boolean No false

Enterprise Edition geçiş yönlendiricisi için çoklu yayın (multicast) özelliğini etkinleştirip etkinleştirmeyeceğinizi belirtir. Geçerli değerler:

  • false (varsayılan): hayır
  • true: evet

Çoklu yayın özelliği yalnızca belirli bölgelerde desteklenir. Çoklu yayını destekleyen bölgeleri sorgulamak için ListTransitRouterAvailableResource API işlemini çağırabilirsiniz.

TransitRouterCidrList Array No

Geçiş yönlendiricisinin CIDR blokları.

Tek seferde en fazla beş CIDR bloğu ekleyebilirsiniz. Geçiş yönlendiricilerinin CIDR blokları hakkında daha fazla bilgi için bkz. Geçiş yönlendiricilerinin CIDR blokları.

Not CIDR blokları yalnızca Enterprise Edition geçiş yönlendiricileri tarafından desteklenir.
Cidr String No 192.168.10.0/24

Geçiş yönlendiricisinin CIDR bloğu.

Name String No nametest

CIDR bloğunun adı.

Ad 1 ila 128 karakter uzunluğunda olmalıdır.

Description String No desctest

CIDR bloğunun açıklaması.

Açıklama 1 ila 256 karakter uzunluğunda olmalıdır.

PublishCidrRoute Boolean No true

Sistemin, geçiş yönlendiricisinin yönlendirme tablosuna CIDR bloğunu hedef alan rotayı otomatik olarak eklemesine izin verilip verilmeyeceğini belirtir.

  • true (varsayılan): evet.

    True değeri, özel bir VPN bağlantısı oluşturduktan ve bağlantı için rota öğrenmeyi etkinleştirdikten sonra sistemin, VPN bağlantısının bağlı olduğu geçiş yönlendiricisinin yönlendirme tablosuna otomatik olarak bir kara delik rotası eklediğini belirtir.

    Kara delik rotasının hedef CIDR bloğu, geçiş yönlendiricisinin CIDR bloğudur. Geçiş yönlendiricisinin CIDR bloğu, IPsec-VPN bağlantılarına ağ geçidi IP adreslerinin tahsis edildiği CIDR bloğunu ifade eder.

    Kara delik rotası yalnızca geçiş yönlendiricisine bağlı sanal sınır yönlendiricisinin (VBR) yönlendirme tablosuna duyurulur.

  • false: hayır.
Tag.N.Key String No tagtest

Etiket anahtarı.

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

En fazla 20 etiket anahtarı belirtebilirsiniz.

Tag.N.Value String No TagValue

Etiket değeri.

Etiket değeri 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

Parameter

Type

Example

Description

TransitRouterId

String

tr-uf6llz2286805i44g****

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

RequestId

String

404DA7EC-F495-44B5-B543-6EDCDF90F3D1

İsteğin kimliği.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateTransitRouter
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&RegionId=cn-zhangjiakou
&TransitRouterName=testname
&TransitRouterDescription=testdesc
&DryRun=false
&SupportMulticast=false
&TransitRouterCidrList=[{"Cidr":"192.168.10.0/24","Name":"nametest","Description":"desctest","PublishCidrRoute":true}]
&Tag=[{"Key":"tagtest","Value":"TagValue"}]
&Common request parameters

Başarılı yanıt örnekleri

XML formatı

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

<CreateTransitRouterResponse>
    <TransitRouterId>tr-uf6llz2286805i44g****</TransitRouterId>
    <RequestId>404DA7EC-F495-44B5-B543-6EDCDF90F3D1</RequestId>
</CreateTransitRouterResponse>

JSON formatı

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

{
  "TransitRouterId" : "tr-uf6llz2286805i44g****",
  "RequestId" : "404DA7EC-F495-44B5-B543-6EDCDF90F3D1"
}

Hata kodları

HttpCode

Error codes

Error message

Description

400

InstanceExist.TransitRouterInstance

The instance already exists.

Aynı kimliğe sahip bir geçiş yönlendiricisinin mevcut bölgede zaten bulunduğunu belirten hata mesajı. Geçiş yönlendiricisi kimlikleri aynı bölgede benzersiz olmalıdır.

400

Forbbiden.TransitRouterServiceNotOpen

The user has not open transit router service.

Geçiş yönlendiricisi hizmetinin etkinleştirilmediğini belirten hata mesajı. Hizmeti etkinleştirip tekrar deneyin.

400

IllegalParam.Region

The specified region is invalid.

Belirtilen bölgenin geçersiz olduğunu belirten hata mesajı.

Hata kodlarının listesi için API Hata Merkezi sayfasını ziyaret edin.