Inbound Rules - List By Nat Gateway

Usługa:: Azure Stack HCI

Wersja interfejsu API:: 2026-04-01-preview

Lista wszystkich reguł przychodzących w określonej bramie NAT. Użyj właściwości nextLink w odpowiedzi, aby uzyskać następną stronę reguł przychodzących.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
natGatewayName	path	True	string pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$	Nazwa bramy narodowej
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	InboundRuleListResult	Operacja platformy Azure została zakończona pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ListInboundRulesByNatGateway

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
          }
        }
      }
    }
  ]
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExtendedLocation	Typ złożony lokalizacji rozszerzonej.
ExtendedLocationTypes	Typ extendedLocation.
InboundNATRuleProtocol	Protokół dla reguł NAT przychodzących
InboundRule	Definicja zasobu reguły wejściowej.
InboundRuleListResult	Odpowiedź operacji listy InboundRule.
InboundRuleProperties	Właściwości reguł przychodzących – rozszerzają InboundNATRuleProperties o dodatkowe śledzenie statusu
InboundRuleStatus	Zaobserwowany stan reguły przychodzącej
InboundRuleStatusProvisioningStatus	Status udostępniania reguły przychodzącej
IPConfigurationArmReference	Identyfikator Azure Resource of an IPConfiguration resource
ProvisioningStateEnum	Stan aprowizacji zasobu.
PublicIPAddressArmReference	Identyfikator Azure Resource of a Public IP resource
Status	Stan operacji wykonanej na zasobie [Powodzenie, Niepowodzenie, InProgress]
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Błąd dodatkowe informacje.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocation

Objekt

Typ złożony lokalizacji rozszerzonej.

Nazwa	Typ	Opis
name	string	Nazwa lokalizacji rozszerzonej.
type	ExtendedLocationTypes	Typ lokalizacji rozszerzonej.

ExtendedLocationTypes

Wyliczenie

Typ extendedLocation.

Wartość	Opis
CustomLocation	Niestandardowy typ lokalizacji rozszerzonej

InboundNATRuleProtocol

Wyliczenie

Protokół dla reguł NAT przychodzących

Wartość	Opis
Tcp	TCP – ruch TCP tylko do równoważenia obciążenia
Udp	UDP – ruch UDP tylko do równoważenia obciążenia

InboundRule

Objekt

Definicja zasobu reguły wejściowej.

Nazwa	Typ	Opis
extendedLocation	ExtendedLocation	ExtendedLocation zasobu.
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties	InboundRuleProperties	Właściwości specyficzne dla zasobu dla tego zasobu.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

InboundRuleListResult

Objekt

Odpowiedź operacji listy InboundRule.

Nazwa	Typ	Opis
nextLink	string (uri)	Link do następnej strony elementów
value	InboundRule[]	Elementy InboundRule na tej stronie

InboundRuleProperties

Objekt

Właściwości reguł przychodzących – rozszerzają InboundNATRuleProperties o dodatkowe śledzenie statusu

Nazwa	Typ	Opis
backendIPConfiguration	IPConfigurationArmReference	Konfiguracja IP dla docelowego backendu.
backendPort	integer (int32)	Port backend dla reguły przychodzącej
frontendPort	integer (int32)	Frontend Port dla reguły przychodzej
protocol	InboundNATRuleProtocol	Protokół dla reguły NAT
provisioningState	ProvisioningStateEnum	Stan dostarczania reguły przychodzącej
publicIPAddress	PublicIPAddressArmReference	Publiczny adres IP dla tej reguły NAT
status	InboundRuleStatus	Obserwowany stan reguły przychodzącej

InboundRuleStatus

Objekt

Zaobserwowany stan reguły przychodzącej

Nazwa	Typ	Opis
errorCode	string	Kod błędu wprowadzania reguł przychodzących
errorMessage	string	Opisowy komunikat o błędzie
provisioningStatus	InboundRuleStatusProvisioningStatus	Status provisioningu InboundRule

InboundRuleStatusProvisioningStatus

Objekt

Status udostępniania reguły przychodzącej

Nazwa	Typ	Opis
operationId	string	ID operacji wykonanej na regułzie przychodzącej
status	Status	Status operacji wykonanej na regułzie przychodzącej [Sukces, Niepowodzenie, ToKTok]

IPConfigurationArmReference

Objekt

Identyfikator Azure Resource of an IPConfiguration resource

Nazwa	Typ	Opis
resourceId	string (arm-id)	Identyfikator Azure Resource of an IPConfiguration resource

ProvisioningStateEnum

Wyliczenie

Stan aprowizacji zasobu.

Wartość	Opis
Succeeded	Inicjowanie obsługi administracyjnej zakończyło się pomyślnie
Failed	Inicjowanie obsługi administracyjnej nie powiodło się
InProgress	Inicjowanie obsługi administracyjnej jest w toku
Accepted	Aprowizacja została zaakceptowana
Deleting	Usuwanie zasobu jest w toku
Canceled	Aprowizacja została anulowana

PublicIPAddressArmReference

Objekt

Identyfikator Azure Resource of a Public IP resource

Nazwa	Typ	Opis
resourceId	string (arm-id)	Identyfikator Azure Resource of a Public IP resource

Status

Wyliczenie

Stan operacji wykonanej na zasobie [Powodzenie, Niepowodzenie, InProgress]

Wartość	Opis
Succeeded	Operacja powiodła się
Failed	Operacja nie powiodła się
InProgress	Operacja jest w toku

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem

Inbound Rules - List By Nat Gateway

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

ListInboundRulesByNatGateway

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

InboundNATRuleProtocol

InboundRule

InboundRuleListResult

InboundRuleProperties

InboundRuleStatus

InboundRuleStatusProvisioningStatus

IPConfigurationArmReference

ProvisioningStateEnum

PublicIPAddressArmReference

Status

systemData