Inbound Rules - List By Nat Gateway

Layanan:: Azure Stack HCI

Versi API:: 2026-04-01-preview

Mencantumkan semua aturan masuk di gateway NAT yang ditentukan. Gunakan properti nextLink dalam respons untuk mendapatkan halaman berikutnya dari aturan masuk.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/natGateways/{natGatewayName}/inboundRules?api-version=2026-04-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
natGatewayName	path	True	string pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$	Nama gerbang nat
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	InboundRuleListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

ListInboundRulesByNatGateway

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/natGateways/test-nat-gw/inboundRules?api-version=2026-04-01-preview

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "name": "rdp-inbound-rule",
      "type": "Microsoft.AzureStackHCI/natGateways/inboundRules",
      "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/natGateways/test-nat-gw/inboundRules/rdp-inbound-rule",
      "extendedLocation": {
        "name": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
        "type": "CustomLocation"
      },
      "properties": {
        "protocol": "Tcp",
        "frontendPort": 3389,
        "backendPort": 3389,
        "backendIPConfiguration": {
          "resourceId": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/networkInterfaces/test-nic/ipConfigurations/ipconfig1"
        },
        "publicIPAddress": {
          "resourceId": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/publicIPAddresses/test-public-ip"
        },
        "provisioningState": "Succeeded",
        "status": {
          "provisioningStatus": {
            "operationId": "12345678-1234-1234-1234-123456789012",
            "status": "Succeeded"
          }
        }
      }
    },
    {
      "name": "ssh-inbound-rule",
      "type": "Microsoft.AzureStackHCI/natGateways/inboundRules",
      "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/natGateways/test-nat-gw/inboundRules/ssh-inbound-rule",
      "extendedLocation": {
        "name": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
        "type": "CustomLocation"
      },
      "properties": {
        "protocol": "Tcp",
        "frontendPort": 22,
        "backendPort": 22,
        "backendIPConfiguration": {
          "resourceId": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/networkInterfaces/test-nic-2/ipConfigurations/ipconfig1"
        },
        "publicIPAddress": {
          "resourceId": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/publicIPAddresses/test-public-ip"
        },
        "provisioningState": "Succeeded",
        "status": {
          "provisioningStatus": {
            "operationId": "87654321-4321-4321-4321-210987654321",
            "status": "Succeeded"
          }
        }
      }
    }
  ]
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
ExtendedLocation	Jenis kompleks lokasi yang diperluas.
ExtendedLocationTypes	Jenis extendedLocation.
InboundNATRuleProtocol	Protokol untuk aturan NAT masuk
InboundRule	Definisi sumber daya aturan masuk.
InboundRuleListResult	Respons operasi daftar InboundRule.
InboundRuleProperties	Properti aturan masuk - memperluas InboundNATRuleProperties dengan pelacakan status tambahan
InboundRuleStatus	Keadaan aturan masuk yang diamati
InboundRuleStatusProvisioningStatus	Status provisi Aturan Masuk
IPConfigurationArmReference	ID Sumber Daya Azure dari sumber daya IPConfiguration
ProvisioningStateEnum	Status provisi sumber daya.
PublicIPAddressArmReference	ID Sumber Daya Azure dari sumber daya IP Publik
Status	Status operasi yang dilakukan pada sumber daya [Berhasil, Gagal, InProgress]
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ExtendedLocation

Objek

Jenis kompleks lokasi yang diperluas.

Nama	Jenis	Deskripsi
name	string	Nama lokasi yang diperluas.
type	ExtendedLocationTypes	Jenis lokasi yang diperluas.

ExtendedLocationTypes

Enumerasi

Jenis extendedLocation.

Nilai	Deskripsi
CustomLocation	Jenis lokasi kustom yang diperluas

InboundNATRuleProtocol

Enumerasi

Protokol untuk aturan NAT masuk

Nilai	Deskripsi
Tcp	TCP - penyeimbangan beban hanya lalu lintas tcp
Udp	Udp - hanya menyeimbangkan beban lalu lintas UDP

InboundRule

Objek

Definisi sumber daya aturan masuk.

Nama	Jenis	Deskripsi
extendedLocation	ExtendedLocation	ExtendedLocation sumber daya.
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties	InboundRuleProperties	Properti khusus sumber daya untuk sumber daya ini.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

InboundRuleListResult

Objek

Respons operasi daftar InboundRule.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	InboundRule[]	Item InboundRule di halaman ini

InboundRuleProperties

Objek

Properti aturan masuk - memperluas InboundNATRuleProperties dengan pelacakan status tambahan

Nama	Jenis	Deskripsi
backendIPConfiguration	IPConfigurationArmReference	Konfigurasi IP untuk backend target.
backendPort	integer (int32)	backend Port untuk aturan masuk
frontendPort	integer (int32)	Port Frontend untuk aturan masuk
protocol	InboundNATRuleProtocol	Protokol untuk aturan NAT
provisioningState	ProvisioningStateEnum	Status provisi aturan masuk
publicIPAddress	PublicIPAddressArmReference	Alamat IP Publik untuk aturan NAT ini
status	InboundRuleStatus	Keadaan Aturan Masuk yang diamati

InboundRuleStatus

Objek

Keadaan aturan masuk yang diamati

Nama	Jenis	Deskripsi
errorCode	string	Kode kesalahan provisi InboundRule
errorMessage	string	Pesan kesalahan deskriptif
provisioningStatus	InboundRuleStatusProvisioningStatus	Status provisi InboundRule

InboundRuleStatusProvisioningStatus

Objek

Status provisi Aturan Masuk

Nama	Jenis	Deskripsi
operationId	string	ID operasi yang dilakukan pada aturan masuk
status	Status	Status operasi yang dilakukan pada aturan masuk [Berhasil, Gagal, Sedang Berlangsung]

IPConfigurationArmReference

Objek

ID Sumber Daya Azure dari sumber daya IPConfiguration

Nama	Jenis	Deskripsi
resourceId	string (arm-id)	ID Sumber Daya Azure dari sumber daya IPConfiguration

ProvisioningStateEnum

Enumerasi

Status provisi sumber daya.

Nilai	Deskripsi
Succeeded	Provisi telah berhasil
Failed	Provisi gagal
InProgress	Provisi sedang berlangsung
Accepted	Provisi telah diterima
Deleting	Penghapusan sumber daya sedang berlangsung
Canceled	Provisi telah dibatalkan

PublicIPAddressArmReference

Objek

ID Sumber Daya Azure dari sumber daya IP Publik

Nama	Jenis	Deskripsi
resourceId	string (arm-id)	ID Sumber Daya Azure dari sumber daya IP Publik

Status

Enumerasi

Status operasi yang dilakukan pada sumber daya [Berhasil, Gagal, InProgress]

Nilai	Deskripsi
Succeeded	Operasi berhasil
Failed	Operasi gagal
InProgress	Operasi sedang berlangsung

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Bagikan melalui

Inbound Rules - List By Nat Gateway

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

ListInboundRulesByNatGateway

Permintaan sampel

Respon sampel

Definisi

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

InboundNATRuleProtocol

InboundRule

InboundRuleListResult

InboundRuleProperties

InboundRuleStatus

InboundRuleStatusProvisioningStatus

IPConfigurationArmReference

ProvisioningStateEnum

PublicIPAddressArmReference

Status

systemData