All Products
Search

This Product

    VPN Gateway:CreateVcoRouteEntry

    Document Center

    VPN Gateway:CreateVcoRouteEntry

    Last Updated:Jun 12, 2026

    Memanggil operasi CreateVcoRouteEntry untuk menambahkan entri rute tujuan ke koneksi IPsec.

    Deskripsi operasi

    • Koneksi IPsec harus sudah dikaitkan dengan instans transit router. Untuk informasi lebih lanjut, lihat CreateTransitRouterVpnAttachment.

    • Rute tujuan yang blok CIDR tujuannya adalah 0.0.0.0/0 tidak dapat ditambahkan.

    • Jangan menambahkan rute tujuan yang blok CIDR tujuannya adalah 100.64.0.0/10, subnet dari 100.64.0.0/10, atau berisi blok CIDR 100.64.0.0/10. Entri rute semacam itu menyebabkan konsol gagal menampilkan status koneksi IPsec atau menyebabkan negosiasi koneksi IPsec gagal.

    • CreateVcoRouteEntry adalah operasi asinkron. Setelah sistem mengembalikan ID instans, entri rute tujuan belum berhasil dibuat, dan tugas pembuatan masih berlangsung di latar belakang. Anda dapat memanggil DescribeVpnConnection untuk mengkueri status pembuatan entri rute tujuan:

      • Ketika koneksi IPsec berada dalam status updating, entri rute tujuan sedang dibuat.

      • Ketika koneksi IPsec berada dalam status attached, entri rute tujuan telah dibuat.

    • CreateVcoRouteEntry tidak mendukung pembuatan entri rute tujuan secara bersamaan di bawah koneksi IPsec yang sama.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region tempat koneksi IPsec berada.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID region.

    cn-hangzhou
    VpnConnectionId

    string

    Yes

    ID koneksi IPsec.

    vco-p0w2jpkhi2eeop6q6****
    RouteDest

    string

    Yes

    Blok CIDR tujuan dari entri rute tujuan.

    192.168.10.0/24
    Weight

    integer

    Yes

    Bobot entri rute tujuan. Nilai yang valid:

    • 0: menunjukkan prioritas rendah.

    • 100: menunjukkan prioritas tinggi.

    100
    NextHop

    string

    Yes

    Hop berikutnya dari entri rute tujuan.

    vco-p0w2jpkhi2eeop6q6****
    Description

    string

    No

    Deskripsi entri rute tujuan.

    desctest
    OverlayMode

    string

    No

    Protokol tunneling. Hanya Ipsec (default) yang didukung, yang menunjukkan protokol tunneling IPsec.

    Ipsec
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

    123e4567-e89b-12d3-a456-4266****
    DryRun

    boolean

    No

    Menentukan apakah hanya melakukan pengecekan awal pada permintaan. Nilai yang valid:

    • true: mengirim permintaan pengecekan awal dan tidak membuat rute. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batasan layanan. Jika permintaan gagal pengecekan awal, kesalahan terkait akan dikembalikan. Jika permintaan lulus pengecekan awal, kode kesalahan DryRunOperation akan dikembalikan.

    • false (default): mengirim permintaan normal. Jika permintaan lulus pengecekan awal, kode status HTTP 2xx akan dikembalikan dan operasi dilakukan.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Hasil yang dikembalikan.

    VpnConnectionId

    string

    ID koneksi IPsec.

    vco-p0w2jpkhi2eeop6q6****
    RouteDest

    string

    Blok CIDR tujuan dari entri rute tujuan.

    192.168.10.0/24
    NextHop

    string

    Hop berikutnya dari entri rute tujuan.

    vco-p0w2jpkhi2eeop6q6****
    Weight

    integer

    Bobot entri rute tujuan.

    • 0: menunjukkan prioritas rendah.

    • 100: menunjukkan prioritas tinggi.

    100
    OverlayMode

    string

    Protokol tunneling.

    Hanya Ipsec yang didukung, yang menunjukkan protokol tunneling IPsec.

    Ipsec
    State

    string

    Status publikasi dari entri rute tujuan.

    Hanya published yang didukung, yang menunjukkan bahwa entri rute saat ini telah dipublikasikan ke instans transit router.

    published
    CreateTime

    integer

    Stempel waktu saat entri rute tujuan dibuat. Satuan: milidetik.

    Stempel waktu dalam format Unix timestamp dan mewakili jumlah total detik yang telah berlalu sejak 00:00:00 (GMT) tanggal 1 Januari 1970 hingga waktu entri rute tujuan dibuat.

    1658387202664
    RequestId

    string

    ID permintaan.

    CFC4D13B-E680-3985-95B1-87AA155481DF
    Description

    string

    Deskripsi entri rute tujuan.

    desctest

    Contoh

    Respons sukses

    JSONformat

    {
  "VpnConnectionId": "vco-p0w2jpkhi2eeop6q6****",
  "RouteDest": "192.168.10.0/24",
  "NextHop": "vco-p0w2jpkhi2eeop6q6****",
  "Weight": 100,
  "OverlayMode": "Ipsec",
  "State": "published",
  "CreateTime": 1658387202664,
  "RequestId": "CFC4D13B-E680-3985-95B1-87AA155481DF",
  "Description": "desctest"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Resource.QuotaFull The quota of resource is full
    400 VpnConnection.Configuring The specified service is configuring.
    400 VpnConnection.FinancialLocked The specified service is financial locked.
    400 VpnRouteEntry.AlreadyExists The specified route entry is already exist.
    400 VpnRouteEntry.Conflict The specified route entry has conflict.
    400 VpnRouteEntry.ConflictSSL The specified route entry has conflict with SSL client.
    400 VpnRouteEntry.BackupRoute Validate backup route entry failed.
    400 InvalidNextHop.NotFound The specified NextHop does not exist.
    400 IllegalParam.RouteDest The specified RouteDest is invalid
    400 OperationFailed.InvalidCidrBlock Operation failed because the specified network block is invalid.
    400 QuotaExceeded.VpnRouteEntry The number of route entries to the VPN gateway in the VPC routing table has reached the quota limit.
    400 TaskConflict The operation is too frequent, please wait a moment and try again.
    400 Resource.PbrRouteQuotaFull The quota of Policy-based route is full.
    400 CreatePbrRoutesQuotaFull.QuotaFull The number of policy routes exceeds the quota limit.
    400 CreateDbrRoutesQuotaFull.QuotaFull The number of created destination routes exceeds the quota limit.
    400 DryRunOperation Request validation has been passed with DryRun flag set.
    403 Forbbiden.SubUser User not authorized to operate on the specified resource.
    403 Forbidden User not authorized to operate on the specified resource.
    404 InvalidVpnConnectionInstanceId.NotFound The specified vpn connection instance id does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.