Inbound Rules - List By Nat Gateway

Servizio:: Azure Stack HCI

Versione API:: 2026-04-01-preview

Elenca tutte le regole in entrata nel NAT gateway specificato. Usa la proprietà nextLink nella risposta per ottenere la pagina successiva delle regole in entrata.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
natGatewayName	path	True	string pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$	Nome del portale naturale
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	InboundRuleListResult	L'operazione di Azure è stata completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ListInboundRulesByNatGateway

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
          }
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedLocation	Tipo complesso della posizione estesa.
ExtendedLocationTypes	Tipo di extendedLocation.
InboundNATRuleProtocol	Protocollo per le regole NAT in entrata
InboundRule	La definizione della risorsa di regole in entrata.
InboundRuleListResult	La risposta di un'operazione di lista InboundRule.
InboundRuleProperties	Proprietà della regola in entrata - estende InboundNATRuleProperties con ulteriore tracciamento dello stato
InboundRuleStatus	La regola dello stato osservato dell'inbound
InboundRuleStatusProvisioningStatus	Stato di provisioning della Regola in Ingresso
IPConfigurationArmReference	L'ID di risorsa Azure di una risorsa IPConfiguration
ProvisioningStateEnum	Stato di provisioning della risorsa.
PublicIPAddressArmReference	L'ID della risorsa Azure di una risorsa IP pubblica
Status	Stato dell'operazione eseguita sulla risorsa [Succeeded, Failed, InProgress]
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocation

Oggetto

Tipo complesso della posizione estesa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationTypes	Tipo dell'ubicazione estesa.

ExtendedLocationTypes

Enumerazione

Tipo di extendedLocation.

Valore	Descrizione
CustomLocation	Tipo di percorso esteso personalizzato

InboundNATRuleProtocol

Enumerazione

Protocollo per le regole NAT in entrata

Valore	Descrizione
Tcp	TCP - traffico TCP solo per bilanciamento del carico
Udp	Udp - traffico UDP solo per bilanciare il carico

InboundRule

Oggetto

La definizione della risorsa di regole in entrata.

Nome	Tipo	Descrizione
extendedLocation	ExtendedLocation	ExtendedLocation della risorsa.
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties	InboundRuleProperties	Proprietà specifiche della risorsa.
systemData	systemData	Metadati di Azure Resource Manager contenenti informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

InboundRuleListResult

Oggetto

La risposta di un'operazione di lista InboundRule.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	InboundRule[]	Gli elementi InboundRule in questa pagina

InboundRuleProperties

Oggetto

Proprietà della regola in entrata - estende InboundNATRuleProperties con ulteriore tracciamento dello stato

Nome	Tipo	Descrizione
backendIPConfiguration	IPConfigurationArmReference	Configurazione IP per il backend target.
backendPort	integer (int32)	Porta backend per la regola in entrata
frontendPort	integer (int32)	Porta frontend per la regola in ingresso
protocol	InboundNATRuleProtocol	Protocollo per la regola NAT
provisioningState	ProvisioningStateEnum	Stato di provisioning della regola in entrata
publicIPAddress	PublicIPAddressArmReference	Indirizzo IP pubblico per questa regola NAT
status	InboundRuleStatus	Lo stato osservato della Regola Inbound

InboundRuleStatus

Oggetto

La regola dello stato osservato dell'inbound

Nome	Tipo	Descrizione
errorCode	string	Codice di errore per la provisioning InboundRule
errorMessage	string	Messaggio di errore descrittivo
provisioningStatus	InboundRuleStatusProvisioningStatus	Stato di provisioning InboundRule

InboundRuleStatusProvisioningStatus

Oggetto

Stato di provisioning della Regola in Ingresso

Nome	Tipo	Descrizione
operationId	string	L'ID dell'operazione eseguita sulla regola in entrata
status	Status	Stato dell'operazione eseguita sulla regola in ingresso [Riuscito, Fallito, In Progresso]

IPConfigurationArmReference

Oggetto

L'ID di risorsa Azure di una risorsa IPConfiguration

Nome	Tipo	Descrizione
resourceId	string (arm-id)	L'ID di risorsa Azure di una risorsa IPConfiguration

ProvisioningStateEnum

Enumerazione

Stato di provisioning della risorsa.

Valore	Descrizione
Succeeded	Provisioning completato
Failed	Provisioning non riuscito
InProgress	Il provisioning è in corso
Accepted	Il provisioning è stato accettato
Deleting	Eliminazione della risorsa in corso
Canceled	Il provisioning è stato annullato

PublicIPAddressArmReference

Oggetto

L'ID della risorsa Azure di una risorsa IP pubblica

Nome	Tipo	Descrizione
resourceId	string (arm-id)	L'ID della risorsa Azure di una risorsa IP pubblica

Status

Enumerazione

Stato dell'operazione eseguita sulla risorsa [Succeeded, Failed, InProgress]

Valore	Descrizione
Succeeded	Operazione riuscita
Failed	Operazione non riuscita
InProgress	L'operazione è in corso

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Inbound Rules - List By Nat Gateway

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

ListInboundRulesByNatGateway

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

InboundNATRuleProtocol

InboundRule

InboundRuleListResult

InboundRuleProperties

InboundRuleStatus

InboundRuleStatusProvisioningStatus

IPConfigurationArmReference

ProvisioningStateEnum

PublicIPAddressArmReference

Status

systemData