All Products
Search
Document Center

Virtual Private Cloud:AssociateRouteTableWithGateway

Last Updated:Jul 16, 2026

Mengaitkan tabel rute gerbang dengan instans gerbang IPv4 atau gerbang IPv6 dalam VPC 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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vpc:AssociateRouteTableWithGateway

create

*Ipv4Gateway

acs:vpc:{#regionId}:{#accountId}:ipv4gateway/{#ipv4gatewayId}

*RouteTable

acs:vpc:{#regionId}:{#accountId}:routetable/{#routetableId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID wilayah dari tabel rute gerbang dan instans gerbang IPv4 yang akan dikaitkan.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

ap-southeast-6

RouteTableId

string

Yes

ID tabel rute gerbang yang akan dikaitkan.

vtb-5ts0ohchwkp3dydt2****

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Klien menghasilkan nilai ini. Nilai harus unik di antara berbagai permintaan dan tidak boleh melebihi 64 karakter ASCII.

Catatan

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

123e4567-e89b-12d3-a456-426655440000

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run tanpa mengaitkan tabel rute gerbang dengan instans gerbang IPv4. Sistem memeriksa parameter wajib, format permintaan, dan batas layanan. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

  • false (default): Menjalankan dry run dan mengirimkan permintaan. Jika pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan tabel rute gerbang dikaitkan dengan instans gerbang IPv4.

false

GatewayId

string

Yes

ID instans gerbang IPv4 yang akan dikaitkan.

Instans gerbang IPv4 yang akan dikaitkan harus berada dalam status Activated.

ipv4gw-5tsnc6s4ogsedtp3k****

GatewayType

string

No

Tipe instans gerbang yang akan dikaitkan.

Ipv4Gateway

RegionId

string

Yes

ID wilayah tempat tabel rute gerbang dan instans gerbang IPv4 yang akan dikaitkan berada.

Anda dapat memperoleh ID wilayah dengan memanggil operasi DescribeRegions.

ap-southeast-6

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

F89C2176-8F10-55EF-90CF-CF99D1E3F816

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F89C2176-8F10-55EF-90CF-CF99D1E3F816"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 ResourceNotFound.Ipv4Gateway The specified resource ipv4Gateway is not found. Instans gerbang IPv4 yang ditentukan tidak ada.
400 IncorrectStatus.Ipv4Gateway The status of %s [%s] is incorrect. Gerbang IPv4 yang ditentukan berada dalam status transisi. Coba lagi nanti.
400 ResourceAlreadyAssociated.Ipv4Gateway The specified resource %s is already associated. Gerbang IPv4 yang ditentukan sudah diasosiasikan.
400 ResourceNotFound.GatewayRouteTable The specified resource GatewayRouteTable is not found. Tabel rute gerbang yang ditentukan tidak dapat ditemukan.
400 IncorrectStatus.GatewayRouteTable The status of %s [%s] is incorrect. Instans tabel rute gerbang yang ditentukan berada dalam status transisi. Coba lagi nanti.
400 ResourceAlreadyAssociated.GatewayRouteTable The specified resource %s is already associated. Tabel rute gerbang yang ditentukan sudah diasosiasikan dengan instans gerbang dengan tipe yang sama.
400 OperationDenied.Ipv4GatewayNotActive The operation is not allowed because of ipv4Gateway [%s] is not active. Operasi tidak diizinkan karena gerbang IPv4 yang ditentukan tidak diaktifkan.
400 OperationDenied.RouteTableTypeIncorrect The operation is not allowed because of routeTableType is incorrect. Instans tabel rute gerbang yang ditentukan bukan tabel rute gerbang perbatasan. Periksa apakah input Anda benar.
400 ResourceNotFound.RouteTable The specified resource gatewayRouteTable is not found. Tabel rute gerbang tidak ada.
400 OperationDenied.GatewayAndTableNotInOneVpc The operation is not allowed because of GatewayAndTableNotInOneVpc. Tabel rute gerbang dan instans gerbang yang ditentukan tidak berada di VPC yang sama. Periksa apakah input Anda benar.
400 IncorrectStatus.RouteTable The status of the specified route table is incorrect.
400 IllegalParam.GatewayType The param of %s is illegal. GatewayType yang ditentukan tidak valid.
400 UnsupportedFeature.Ipv6GatewayRouteTable The feature of %s is not supported. Tabel rute gerbang yang ditentukan tidak mendukung pengikatan ke instans gerbang ini.
400 OperationDenied.IngressRoutingNotSupportAnycast The operation is not allowed because ingress routing not support anycast. Operasi gagal karena terdapat elastic IP address Anycast di VPC yang ditentukan.
400 OperationDenied.ExistPublicIpv6IpInVpc Operation denied because IPV6 public ip exists in VPC. Operasi gagal karena terdapat alamat IPv6 publik di VPC.
400 ResourceNotFound.Ipv6Gateway The specified resource of IPv6 Gateway is not found. Instans gerbang IPv6 yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.