All Products
Search

This Product

    NAT Gateway:ListNatIps

    Document Center

    NAT Gateway:ListNatIps

    Last Updated:Jun 12, 2026

    Mengkueri daftar alamat IP NAT dengan memanggil operasi ListNatIps.

    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 instans gerbang NAT tempat alamat IP NAT yang akan dikueri berada.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    eu-central-1
    NatGatewayId

    string

    Yes

    ID instans gerbang NAT tempat alamat IP NAT yang akan dikueri berada.

    ngw-gw8v16wgvtq26vh59****
    NatIpCidr

    string

    No

    Blok CIDR tempat alamat IP NAT yang akan dikueri berada.

    192.168.0.0/24
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run. Nilai valid:

    • true: Menjalankan dry run dan tidak mengkueri daftar alamat IP NAT. Sistem memeriksa parameter wajib, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, Paket dikembalikan. Jika permintaan berhasil dalam dry run, kode kesalahan DryRunOperation dikembalikan.

    • false (default): Menjalankan dry run dan mengirimkan permintaan. Jika permintaan berhasil dalam dry run, kode status HTTP 2xx dikembalikan dan operasi dijalankan.

    false
    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 dan tidak boleh melebihi 64 karakter.

    Catatan

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

    5A2CFF0E-5718-45B5-9D4D-70B3FF3898
    NatIpStatus

    string

    No

    Status alamat IP NAT yang akan dikueri. Nilai valid:

    • Available: tersedia.

    • Deleting: sedang dihapus.

    • Creating: sedang dibuat.

    Available
    NextToken

    string

    No

    Token yang digunakan untuk kueri berikutnya. Nilai valid:

    • Jika ini adalah kueri pertama Anda atau tidak ada kueri berikutnya yang akan dikirim, biarkan parameter ini kosong.

    • Jika kueri berikutnya akan dikirim, tetapkan nilai ke nilai NextToken yang dikembalikan dari pemanggilan terakhir.

    FFmyTO70tTpLG6I3FmYAXGKPd****f84eb48b699f0a4883
    MaxResults

    string

    No

    Jumlah entri yang dikembalikan pada setiap halaman. Nilai valid: 1 hingga 100. Nilai default: 20.

    20
    NatIpName

    array

    No

    Nama alamat IP NAT yang akan dikueri. Nilai valid N: 1 hingga 20.

    test

    string

    No

    Nama alamat IP NAT yang akan dikueri. Nilai valid N: 1 hingga 20.

    test
    NatIpIds

    array

    No

    ID instans alamat IP NAT yang akan dikueri. Nilai valid N: 1 hingga 20.

    vpcnatip-gw8a863sut1zijxh0****

    string

    No

    ID instans alamat IP NAT yang akan dikueri. Nilai valid N: 1 hingga 20.

    vpcnatcidr-gw8ov42ei6xh1jys2****
    RegionId

    string

    Yes

    The region ID of the NAT gateway instance to which the NAT IP addresses to be queried belong.

    You can call the DescribeRegions operation to query the region ID.

    eu-central-1
    IpOrigin

    string

    No

    Enumerasi atribut sumber alamat IP NAT yang akan dikueri. Nilai valid:

    • prefix: Alamat IP NAT yang termasuk dalam awalan IP.

    • cidr: Alamat IP NAT terisolasi yang tidak termasuk dalam awalan IP apa pun.

    • empty: Mengkueri semua alamat IP NAT.

    cidr
    Ipv4Prefix

    string

    No

    Blok CIDR awalan IP yang akan dikueri.

    192.168.0.0/28

    Elemen respons

    Element

    Type

    Description

    Example

    object

    NextToken

    string

    Token yang digunakan untuk kueri berikutnya. Nilai valid:

    • Jika NextToken kosong, tidak ada kueri berikutnya yang akan dikirim.

    • Jika nilai NextToken dikembalikan, nilai tersebut menunjukkan token yang digunakan untuk kueri berikutnya.

    FFmyTO70tTpLG6I3FmYAXGKPd****
    RequestId

    string

    ID permintaan.

    7E78CEEA-BF8F-44D1-9DCD-D9141135B71E
    TotalCount

    string

    Jumlah alamat IP NAT yang dikembalikan.

    1
    NatIps

    array<object>

    Daftar alamat IP NAT.

    object

    IsDefault

    boolean

    Apakah alamat IP NAT merupakan alamat IP NAT default. Nilai valid:

    • true: ya.

    • false: tidak.

    true
    NatIp

    string

    Alamat IP NAT yang dikueri.

    192.168.0.126
    Ipv4Prefix

    string

    Blok CIDR awalan IP tempat alamat IP NAT yang dikueri berada.

    192.168.0.0/28
    NatIpCidr

    string

    Blok CIDR tempat alamat IP NAT yang dikueri berada.

    192.168.0.0/24
    NatIpId

    string

    ID instans alamat IP NAT yang dikueri.

    vpcnatip-gw8a863sut1zijxh0****
    NatIpDescription

    string

    Deskripsi alamat IP NAT yang dikueri.

    default
    NatGatewayId

    string

    ID instans gerbang NAT VPC tempat alamat IP NAT yang dikueri berada.

    ngw-gw8v16wgvtq26vh59****
    NatIpName

    string

    Nama alamat IP NAT yang dikueri.

    default
    NatIpStatus

    string

    Status alamat IP NAT yang dikueri. Nilai valid:

    • Available: tersedia.

    • Deleted: dihapus.

    • Deleting: sedang dihapus.

    • Creating: sedang dibuat.

    • Associated: terkait dengan entri SNAT Entri DNAT.

    • Associating: sedang dikaitkan dengan entri SNAT Entri DNAT.

    Available

    Contoh

    Respons sukses

    JSONformat

    {
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "7E78CEEA-BF8F-44D1-9DCD-D9141135B71E",
  "TotalCount": "1",
  "NatIps": [
    {
      "IsDefault": true,
      "NatIp": "192.168.0.126",
      "Ipv4Prefix": "192.168.0.0/28",
      "NatIpCidr": "192.168.0.0/24",
      "NatIpId": "vpcnatip-gw8a863sut1zijxh0****",
      "NatIpDescription": "default",
      "NatGatewayId": "ngw-gw8v16wgvtq26vh59****",
      "NatIpName": "default",
      "NatIpStatus": "Available"
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.