All Products
Search

This Product

    NAT Gateway:ModifyForwardEntry

    Document Center

    NAT Gateway:ModifyForwardEntry

    Last Updated:Jun 19, 2026

    Mengubah entri DNAT tertentu.

    Deskripsi operasi

    • ModifyForwardEntry adalah operasi asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID permintaan, tetapi entri DNAT belum diubah. Tugas modifikasi berjalan di latar belakang. Anda dapat memanggil DescribeForwardTableEntries untuk mengkueri status entri DNAT:

      • Jika entri DNAT berada dalam status Pending, entri DNAT sedang diubah. Dalam status ini, Anda hanya dapat melakukan operasi kueri.

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

    • ModifyForwardEntry tidak mendukung modifikasi konkuren pada entri DNAT dalam tabel DNAT 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:ModifyForwardEntry

    update

    *ForwardTable

    acs:vpc:{#regionId}:{#accountId}:forwardtable/{#ForwardTableId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ForwardTableId

    string

    Yes

    ID tabel DNAT tempat entri DNAT berada.

    ftb-8vbx8xu2lqj9qb334****
    ForwardEntryId

    string

    Yes

    ID entri DNAT yang akan diubah.

    fwd-8vbn3bc8roygjp0gy****
    ExternalIp

    string

    No

    • Jika Anda mengubah entri DNAT dari Gateway NAT Internet, parameter ini menentukan alamat IP publik yang digunakan untuk menyediakan akses jaringan publik.

    • Jika Anda mengubah entri DNAT dari Gateway NAT VPC, parameter ini menentukan alamat IP NAT yang diakses oleh jaringan eksternal.

    116.85.XX.XX
    ExternalPort

    string

    No

    • Jika Anda mengubah entri DNAT dari Gateway NAT Internet, parameter ini menentukan Port eksternal atau range port yang digunakan untuk penerusan port dalam entri DNAT.

      • Range port harus berada dalam 1 hingga 65535.

      • Untuk menentukan range port, pisahkan Port awal dan Port akhir dengan garis miring (/), seperti 10/20.

      • Jika Anda mengubah ExternalPort dan InternalPort sekaligus, dan ExternalPort diatur ke range port, InternalPort juga harus diatur ke range port dengan jumlah Port yang sama. Misalnya, jika ExternalPort diatur ke 10/20, InternalPort harus diatur ke 80/90.

    • Jika Anda mengubah entri DNAT dari Gateway NAT VPC, parameter ini menentukan Port yang diakses oleh jaringan eksternal. Nilai valid: 1 hingga 65535.

    80
    InternalIp

    string

    No

    • Jika Anda mengubah entri DNAT dari Gateway NAT Internet, parameter ini menentukan alamat IP privat dari Instance ECS yang berkomunikasi dengan Internet melalui entri DNAT.

    • Jika Anda mengubah entri DNAT dari Gateway NAT VPC, parameter ini menentukan alamat IP privat yang perlu berkomunikasi melalui aturan DNAT.

    10.0.0.78
    InternalPort

    string

    No

    • Jika Anda mengubah entri DNAT dari Gateway NAT Internet, parameter ini menentukan Port internal atau range port yang digunakan untuk penerusan port dalam entri DNAT. Nilai valid: 1 hingga 65535.

    • Jika Anda mengubah entri DNAT dari Gateway NAT VPC, parameter ini menentukan Port dari Instance ECS tujuan yang akan dipetakan. Nilai valid: 1 hingga 65535.

    80
    IpProtocol

    string

    No

    Jenis protokol. Nilai valid:

    • TCP: meneruskan paket TCP.

    • UDP: meneruskan paket UDP.

    • Any: meneruskan paket dari semua protokol.

    TCP
    ForwardEntryName

    string

    No

    Nama baru entri DNAT.

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

    test
    RegionId

    string

    Yes

    ID wilayah Gateway NAT.

    Anda dapat memanggil DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat 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-426655440000
    PortBreak

    boolean

    No

    Apakah akan mengaktifkan port breaking. Nilai valid:

    • true: Mengaktifkan port breaking.

    • false: Tidak mengaktifkan port breaking. Jika entri DNAT dan entri SNAT menggunakan alamat IP publik yang sama dan Anda ingin mengonfigurasi nomor port yang lebih besar dari 1024, atur PortBreak ke true.

    false
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run. Nilai valid:

    • true: menjalankan dry run tanpa mengubah entri DNAT. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, Paket kesalahan akan dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan DryRunOperation akan dikembalikan.

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

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ID permintaan.

    RequestId

    string

    ID permintaan.

    2315DEB7-5E92-423A-91F7-4C1EC9AD97C3

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 UnsupportedFeature.PortSegment The feature of PortSegment is not supported.
    400 ExclusiveParam.%sAnd%s The param of %s and %s are mutually exclusive. 参数 %s 和 %s 相互排斥。
    400 InvalidIp.NotInNatgw The specified Ip not belong to natgateway.
    400 DuplicatedParam.InternalPort The param of %s is duplicated. InternalPort参数重复或已被占用
    400 DuplicatedParam.ExternalPort The param of %s is duplicated. DNAT公网端口%s已被重复占用。
    400 OperationFailed.AnyPortConfig Operation failed because any port correspondence any protocol 操作失败. 与其他条目有冲突, 存在任何端口或任何协议类型.
    400 OperationUnsupported.ForwardEntry Duplicated destination ip port is unsupported. 不支持重复的目标IP端口。
    400 IncorrectStatus.NatIp The status of %s [%s] is incorrect. NatIp当前状态不正确。
    400 Forbidden.IpHasBeenUsedInSnat The source ip can't be used. Because it has been used in snat.
    400 IncorrectStatus.ForwardEntry The status of %s [%s] is incorrect. 要删除的DNAT条目实例状态不对
    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 Destination Ip is Out of VPC CIDR.
    400 InvalidProtocal.ValueNotSupported The specified IpProtocol does not support.
    400 IncorretForwardEntryStatus Some Forward entry status blocked this operation..
    400 QuotaExceeded Forward entry quota exceeded in this route table. 同一个路由表中自定义路由条目不能超过200条，可以在配额管理页面申请调整数量。
    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 Forbidden.Already.Bounded The specified instance already bounded
    400 InvalidIp.NotFound The specified ip does not exist.
    400 InvalidParameter.Name.Malformed The specified Name is not valid.
    400 IncorretStatus.ForwardEntry The Specified forwardEntry is not stable status, can not operation
    400 IllegalParam.AnyPortNotZero Any port port must be zero. 参数非法，DNAT转发协议为Any时，源端口和目标端口必须为0
    400 Duplicated.DestinationPort The specified param DestinationPort is duplicated.
    400 InvalidForwardEntryId.NotFound Specified forward entry ID does not exist
    400 OperationUnsupported.EipInBinding Create snat entry with eip in associating status is unsupported. 创建snat不可以使用绑定中的eip
    400 QuotaExceeded.ForwardEntrySessionManytoOne The dnat session quota is exceed. dnat session 多对一的配额超限。
    400 OperationFailed.ForwardEntryNotAllowSrcIpEqualDstIp The source IP of forward entry is not allowed to equal destination IP. DNAT条目不允许公网IP地址等于私网IP地址
    404 ResourceNotFound.NatIp The specified resource of %s is not found.
    404 ResourceNotFound.ForwardEntry The specified resource of %s is not found. 找不到指定的%s资源。
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 InvalidForwardEntryId.NotFound Specified forward entry ID does not exist
    404 InvalidExternalIp.NotFound Specified External Ip address does not found on the VRouter
    404 InvalidForwardTableId.NotFound Specified forward table does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.