Inbound Rules - List By Nat Gateway

Služba:: Azure Stack HCI

Verze rozhraní API:: 2026-04-01-preview

Uvádí všechna příchozí pravidla ve specifikované NAT bráně. Použijte vlastnost nextLink v odpovědi pro získání další stránky příchozích pravidel.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
natGatewayName	path	True	string pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$	Název nat brány
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	InboundRuleListResult	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ListInboundRulesByNatGateway

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
          }
        }
      }
    }
  ]
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocation	Komplexní typ rozšířeného umístění.
ExtendedLocationTypes	Typ extendedLocation.
InboundNATRuleProtocol	Protokol pro příchozí NAT pravidla
InboundRule	Definice zdroje příchozího pravidla.
InboundRuleListResult	Odpověď operace InboundRule list.
InboundRuleProperties	Vlastnosti příchozího pravidla – rozšiřují InboundNATRuleProperties o další sledování stavu
InboundRuleStatus	Pozorované pravidlo stavu příchozího příchodu
InboundRuleStatusProvisioningStatus	Stav poskytování příchozího pravidla
IPConfigurationArmReference	Azure Resource ID IPConfiguration resource
ProvisioningStateEnum	Stav zřizování prostředku
PublicIPAddressArmReference	Azure Resource ID veřejného IP zdroje
Status	Stav operace prováděné s prostředkem [Úspěch, Selhání, InProgress]
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocation

Objekt

Komplexní typ rozšířeného umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	ExtendedLocationTypes	Typ rozšířeného umístění.

ExtendedLocationTypes

Výčet

Typ extendedLocation.

Hodnota	Description
CustomLocation	Vlastní rozšířený typ umístění

InboundNATRuleProtocol

Výčet

Protokol pro příchozí NAT pravidla

Hodnota	Description
Tcp	TCP – pouze load balance TCP provoz
Udp	UDP – UDP provoz pouze pro load balance

InboundRule

Objekt

Definice zdroje příchozího pravidla.

Name	Typ	Description
extendedLocation	ExtendedLocation	ExtendedLocation prostředku.
id	string (arm-id)	Plně kvalifikované ID prostředku pro daný prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties	InboundRuleProperties	Vlastnosti specifické pro prostředek pro tento prostředek.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

InboundRuleListResult

Objekt

Odpověď operace InboundRule list.

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	InboundRule[]	Položky InboundRule na této stránce

InboundRuleProperties

Objekt

Vlastnosti příchozího pravidla – rozšiřují InboundNATRuleProperties o další sledování stavu

Name	Typ	Description
backendIPConfiguration	IPConfigurationArmReference	IP konfigurace pro cílový backend.
backendPort	integer (int32)	Backend Port pro příchozí pravidlo
frontendPort	integer (int32)	Frontend Port pro příchozí pravidlo
protocol	InboundNATRuleProtocol	Protokol pro pravidlo NAT
provisioningState	ProvisioningStateEnum	Stav zajištění příchozího pravidla
publicIPAddress	PublicIPAddressArmReference	Veřejná IP adresa pro toto NAT pravidlo
status	InboundRuleStatus	Pozorovaný stav příchozího pravidla

InboundRuleStatus

Objekt

Pozorované pravidlo stavu příchozího příchodu

Name	Typ	Description
errorCode	string	Chybový kód pro poskytování příchozích pravidel
errorMessage	string	Popisná chybová zpráva
provisioningStatus	InboundRuleStatusProvisioningStatus	Stav poskytování příchozích pravidel

InboundRuleStatusProvisioningStatus

Objekt

Stav poskytování příchozího pravidla

Name	Typ	Description
operationId	string	ID operace provedené na příchozím pravidle
status	Status	Stav operace provedené na příchozím pravidle [Uspěl, Neuspěl, Průběh]

IPConfigurationArmReference

Objekt

Azure Resource ID IPConfiguration resource

Name	Typ	Description
resourceId	string (arm-id)	Azure Resource ID IPConfiguration resource

ProvisioningStateEnum

Výčet

Stav zřizování prostředku

Hodnota	Description
Succeeded	Zřizování bylo úspěšné.
Failed	Zřizování se nezdařilo.
InProgress	Probíhá zřizování.
Accepted	Zřizování bylo přijato.
Deleting	Probíhá odstranění prostředku.
Canceled	Zřizování bylo zrušeno.

PublicIPAddressArmReference

Objekt

Azure Resource ID veřejného IP zdroje

Name	Typ	Description
resourceId	string (arm-id)	Azure Resource ID veřejného IP zdroje

Status

Výčet

Stav operace prováděné s prostředkem [Úspěch, Selhání, InProgress]

Hodnota	Description
Succeeded	Operace byla úspěšná.
Failed	Operace selhala.
InProgress	Probíhá operace.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Inbound Rules - List By Nat Gateway

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

ListInboundRulesByNatGateway

Ukázkový požadavek

Ukázková odpověď

Definice

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

InboundNATRuleProtocol

InboundRule

InboundRuleListResult

InboundRuleProperties

InboundRuleStatus

InboundRuleStatusProvisioningStatus

IPConfigurationArmReference

ProvisioningStateEnum

PublicIPAddressArmReference

Status

systemData