All Products
Search

This Product

    NAT Gateway:CreateForwardEntry

    Document Center

    NAT Gateway:CreateForwardEntry

    Last Updated:Jun 12, 2026

    Memanggil operasi CreateForwardEntry untuk menambahkan entri DNAT ke tabel DNAT.

    Deskripsi operasi

    Setiap entri DNAT terdiri dari lima bagian: ExternalIp, ExternalPort, IpProtocol, InternalIp, dan InternalPort. Setelah Anda menambahkan entri DNAT, gerbang NAT meneruskan paket protokol yang ditentukan yang diterima pada ExternalIp:ExternalPort ke InternalIp:InternalPort, dan mengirimkan tanggapan kembali melalui entri rute yang sama.

    Sebelum Anda memanggil operasi ini untuk menambahkan entri DNAT, perhatikan hal-hal berikut:

    • CreateForwardEntry adalah operasi asinkron. Setelah Anda memanggil operasi ini, sistem mengembalikan ID entri DNAT, tetapi entri DNAT tidak ditambahkan pada pengatur waktu yang sama. Sistem menjalankan tugas penambahan di latar belakang. Anda dapat memanggil operasi DescribeForwardTableEntries untuk mengkueri status entri DNAT:

      • Jika entri DNAT berada dalam status Pending, entri DNAT sedang ditambahkan. Dalam hal ini, Anda hanya dapat mengkueri entri DNAT tetapi tidak dapat melakukan operasi lain.

      • Jika entri DNAT berada dalam status Available, entri DNAT telah ditambahkan.

    • Kombinasi parameter ExternalIp, ExternalPort, dan IpProtocol dari setiap entri DNAT harus unik. Oleh karena itu, Anda tidak dapat meneruskan paket dengan alamat IP sumber, port, dan protokol yang sama ke beberapa Instance ECS tujuan.

    • Kombinasi parameter InternalIp, InternalPort, dan IpProtocol dari setiap entri DNAT juga harus unik.

    • Alamat IP yang ditentukan oleh ExternalIp dan InternalIp dari setiap entri DNAT tidak boleh sama. Jika Anda memerlukan kedua alamat IP tersebut sama, hubungi manajer akun Anda.

    • Anda dapat menambahkan hingga 100 entri DNAT ke tabel DNAT.

    • Alamat IP (EIP yang digunakan oleh gerbang NAT Internet atau alamat IP NAT yang digunakan oleh gerbang NAT VPC) yang dikonfigurasi untuk pemetaan IP dalam entri DNAT tidak dapat digunakan oleh entri DNAT atau Entri SNAT lainnya.

    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 wilayah tempat gerbang NAT diterapkan.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    ForwardTableId

    string

    Yes

    ID tabel DNAT.

    ftb-bp1mbjubq34hlcqpa****
    ExternalIp

    string

    Yes

    • Saat Anda menambahkan entri DNAT ke gerbang NAT Internet, atur parameter ini ke elastic IP address (EIP) yang digunakan untuk akses Internet.

    • Saat Anda menambahkan entri DNAT ke gerbang NAT Virtual Private Cloud (VPC), atur parameter ini ke alamat IP NAT yang diakses oleh jaringan eksternal.

    116.28.XX.XX
    ExternalPort

    string

    Yes

    • Saat Anda menambahkan entri DNAT ke gerbang NAT Internet, parameter ini menentukan port eksternal atau range port yang digunakan untuk penerusan port.

      • Nilai valid: 1 hingga 65535.

      • Untuk menentukan range port, pisahkan port pertama dan port terakhir dengan garis miring (/), misalnya 10/20.

      • Jika Anda mengatur ExternalPort ke range port, Anda juga harus mengatur InternalPort ke range port, dan jumlah port yang ditentukan oleh kedua parameter harus sama. Misalnya, jika Anda mengatur ExternalPort ke 10/20, Anda harus mengatur InternalPort ke range port seperti 80/90.

    • Saat Anda menambahkan entri DNAT ke gerbang NAT VPC, parameter ini menentukan port tempat alamat IP NAT diakses oleh jaringan eksternal. Nilai valid: 1 hingga 65535.

    8080
    InternalIp

    string

    Yes

    • Saat Anda menambahkan entri DNAT ke gerbang NAT Internet, parameter ini menentukan alamat IP privat Instance Elastic Compute Service (ECS) yang perlu berkomunikasi dengan Internet. Alamat IP privat harus memenuhi persyaratan berikut:

      • Alamat IP privat harus berada dalam Blok CIDR VPC tempat gerbang NAT diterapkan.

      • Alamat IP privat harus digunakan oleh Instance ECS, dan Instance ECS tidak boleh dikaitkan dengan EIP. Jika tidak, entri DNAT tidak berlaku.

    • Saat Anda menambahkan entri DNAT ke gerbang NAT VPC, parameter ini menentukan alamat IP privat yang perlu berkomunikasi menggunakan aturan DNAT.

    192.168.XX.XX
    InternalPort

    string

    Yes

    • Saat Anda menambahkan entri DNAT ke gerbang NAT Internet, parameter ini menentukan port internal atau range port yang digunakan untuk penerusan port. Nilai valid: 1 hingga 65535.

    • Saat Anda menambahkan entri DNAT ke gerbang NAT VPC, parameter ini menentukan port Instance ECS tujuan yang akan dipetakan. Nilai valid: 1 hingga 65535.

    80
    IpProtocol

    string

    Yes

    Jenis protokol. Nilai valid:

    • TCP: meneruskan paket TCP.

    • UDP: meneruskan paket UDP.

    • Any: meneruskan paket dari semua protokol. Jika Anda mengatur IpProtocol ke Any, Anda juga harus mengatur ExternalPort dan InternalPort ke Any untuk menerapkan pemetaan IP DNAT.

    TCP
    ForwardEntryName

    string

    No

    Nama aturan DNAT.

    Nama harus memiliki panjang 2 hingga 128 karakter, dan dapat berisi huruf, angka, dan karakter Tionghoa. Nama harus diawali dengan huruf atau karakter Tionghoa, dan tidak dapat diawali dengan http:// atau https://.

    ForwardEntry-1
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

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

    Catatan

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

    0c593ea1-3bea-11e9-b96b-88e9fe6****
    PortBreak

    boolean

    No

    Apakah akan mengaktifkan pemetaan port. Nilai valid:

    • true: Mengaktifkan pemetaan port.

    • false (default): Menonaktifkan pemetaan port.

    Catatan

    Saat entri DNAT dan entri SNAT berbagi alamat IP publik yang sama, Anda harus mengatur PortBreak ke true jika ingin mengonfigurasi nomor port yang lebih besar dari 1024.

    false
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid:

    • true: Hanya menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk nilai parameter yang hilang, sintaks permintaan yang salah, dan batas layanan. Jika permintaan gagal dalam dry run, Paket error dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan DryRunOperation dikembalikan.

    • false (default): Menjalankan dry run dan mengirimkan permintaan aktual. Jika permintaan berhasil dalam dry run, kode status HTTP 2xx dikembalikan dan entri DNAT dibuat.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ForwardEntryId

    string

    ID entri DNAT.

    fwd-119smw5tkasdf****
    RequestId

    string

    ID permintaan.

    A4AEE536-A97A-40EB-9EBE-53A6948A6928

    Contoh

    Respons sukses

    JSONformat

    {
  "ForwardEntryId": "fwd-119smw5tkasdf****",
  "RequestId": "A4AEE536-A97A-40EB-9EBE-53A6948A6928"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 UnsupportedFeature.PrivateLinkEnabled The feature of PrivateLinkEnabled is not supported.
    400 UnsupportedFeature.PortSegment The feature of PortSegment is not supported.
    400 ExclusiveParam.%sAnd%s The param of %s and %s are mutually exclusive.
    400 DuplicatedParam.InternalPort The param of %s is duplicated.
    400 DuplicatedParam.ExternalPort The param of %s is duplicated.
    400 OperationFailed.AnyPortConfig Operation failed because any port correspondence any protocol
    400 OperationUnsupported.ForwardEntry Duplicated destination ip port is unsupported.
    400 InvalidIp.NotInNatgw The specified Ip not belong to natgateway.
    400 QuotaExceeded.ForwardEntry The quota of %s is exceeded, usage %s/%s.
    400 IncorrectStatus.NatIp The status of %s [%s] is incorrect.
    400 Forbidden.IpHasBeenUsedInSnat The source ip can't be used. Because it has been used in snat.
    400 InvalidExternalIp.Malformed The specified ExternalIp is not a valid IP address.
    400 InvalidInternalIp.Malformed The specified InternalIp is not a valid IP address.
    400 InvalidExternalPort.Malformed The specified ExternalPort is not a valid port.
    400 InvalidInternalPort.Malformed The specified InternalPort is not a valid port.
    400 Forbidden.DestnationIpOutOfVpcCIDR The specified Internal Ip is Out of VPC CIDR.
    400 Forbidden.DestinationIpOutOfVswitchCIDR The specified Internal Ip is Out of VSwitch CIDR.
    400 InvalidProtocal.ValueNotSupported The specified IpProtocol does not support.
    400 IncorretForwardEntryStatus Some Forward entry status blocked this operation..
    400 ForwardEntry.Duplicated The specified ExternalIp, IpProtocol, ExternalPort,InternalIp, InternalPort is duplicated
    400 Forbidden.ExternalIp.UsedInSnatTable The specified ExternalIp is already used in SnatTable
    400 Forbindden The specified Instance already bind eip
    400 Forbidden.InternalIpOutOfVpcCIDR The specified Internal Ip is Out of VPC CIDR.
    400 Invalid.natgwNotExist The specified natgateway not exist.
    400 MissingParameter Missing mandatory parameter
    400 AnyPort.PortMustBeZero any port port must be zero.
    400 InvalidParameter.Name.Malformed The specified Name is not valid.
    400 IncorrectStatus.ForwardEntry The status of %s [%s] is incorrect.
    400 Duplicated.DestinationPort The specified param DestinationPort is duplicated.
    400 OperationUnsupported.EipInBinding Create snat entry with eip in associating status is unsupported.
    400 QuotaExceeded.ForwardEntrySessionManytoOne The dnat session quota is exceed.
    400 TaskConflict The operation is too frequent, please wait a moment and try again.
    400 OperationFailed.DnatPortRangeLimit The maximum number of port ranges that can be specified is exceeded.
    400 IncorrectStatus.NATGW NATGW status is invalid.
    400 OperationFailed.ForwardEntryNotAllowSrcIpEqualDstIp The source IP of forward entry is not allowed to equal destination IP.
    500 System.Error ERROR SYSTEM ERROR.
    500 InternalError The request processing has failed due to some unknown error.
    404 ResourceNotFound.NatIp The specified resource of %s is not found.
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 InvalidForwardTableId.NotFound Specified forward table does not exist.
    404 InvalidExternalIp.NotFound Specified External Ip address does not found on the VRouter

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.