Inbound Rules - List By Nat Gateway

Servicio:: Azure Stack HCI

Versión de la API:: 2026-04-01-preview

Lista todas las reglas entrantes en la pasarela NAT especificada. Usa la propiedad nextLink en la respuesta para obtener la siguiente página de reglas entrantes.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
natGatewayName	path	True	string pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$	Nombre de la puerta natural
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	InboundRuleListResult	La operación de Azure se completó correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

ListInboundRulesByNatGateway

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
          }
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ExtendedLocation	Tipo complejo de la ubicación extendida.
ExtendedLocationTypes	Tipo de extendedLocation.
InboundNATRuleProtocol	Protocolo para reglas NAT entrantes
InboundRule	La definición de recurso de reglas entrantes.
InboundRuleListResult	La respuesta de una operación de lista InboundRule.
InboundRuleProperties	Propiedades de la regla de entrada - extiende InboundNATRuleProperties con seguimiento de estado adicional
InboundRuleStatus	La regla del estado observado del inbound
InboundRuleStatusProvisioningStatus	Estado de aprovisionamiento de la Regla de Entrada
IPConfigurationArmReference	El ID de recurso Azure de un recurso IPConfiguration
ProvisioningStateEnum	Estado de aprovisionamiento del recurso.
PublicIPAddressArmReference	El ID de recurso de Azure de un recurso IP público
Status	Estado de la operación realizada en el recurso [Succeeded, Failed, InProgress]
systemData	Metadatos relativos a la creación y última modificación del recurso.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ExtendedLocation

Objeto

Tipo complejo de la ubicación extendida.

Nombre	Tipo	Description
name	string	Nombre de la ubicación extendida.
type	ExtendedLocationTypes	El tipo de la ubicación extendida.

ExtendedLocationTypes

Enumeración

Tipo de extendedLocation.

Valor	Description
CustomLocation	Tipo de ubicación extendida personalizada

InboundNATRuleProtocol

Enumeración

Protocolo para reglas NAT entrantes

Valor	Description
Tcp	TCP - tráfico TCP solo para balance de carga
Udp	Udp - solo tráfico UDP con balance de carga

InboundRule

Objeto

La definición de recurso de reglas entrantes.

Nombre	Tipo	Description
extendedLocation	ExtendedLocation	ExtendedLocation del recurso.
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties	InboundRuleProperties	Propiedades específicas del recurso para este recurso.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

InboundRuleListResult

Objeto

La respuesta de una operación de lista InboundRule.

Nombre	Tipo	Description
nextLink	string (uri)	El enlace a la siguiente página de artículos
value	InboundRule[]	Los elementos de InboundRule en esta página

InboundRuleProperties

Objeto

Propiedades de la regla de entrada - extiende InboundNATRuleProperties con seguimiento de estado adicional

Nombre	Tipo	Description
backendIPConfiguration	IPConfigurationArmReference	Configuración IP para el backend objetivo.
backendPort	integer (int32)	Puerto backend para la regla de entrada
frontendPort	integer (int32)	Puerto frontal para la regla de entrada
protocol	InboundNATRuleProtocol	Protocolo para la regla NAT
provisioningState	ProvisioningStateEnum	Estado de provisionamiento de la regla de entrada
publicIPAddress	PublicIPAddressArmReference	Dirección IP pública para esta regla NAT
status	InboundRuleStatus	El estado observado de la Regla de Entrada

InboundRuleStatus

Objeto

La regla del estado observado del inbound

Nombre	Tipo	Description
errorCode	string	Código de error de provisión de InboundRule
errorMessage	string	Mensaje de error descriptivo
provisioningStatus	InboundRuleStatusProvisioningStatus	Estado de provisión de InboundRule

InboundRuleStatusProvisioningStatus

Objeto

Estado de aprovisionamiento de la Regla de Entrada

Nombre	Tipo	Description
operationId	string	El ID de la operación realizada sobre la regla de entrada
status	Status	Estado de la operación realizada en la regla de entrada [Éxito, Fallido, En progreso]

IPConfigurationArmReference

Objeto

El ID de recurso Azure de un recurso IPConfiguration

Nombre	Tipo	Description
resourceId	string (arm-id)	El ID de recurso Azure de un recurso IPConfiguration

ProvisioningStateEnum

Enumeración

Estado de aprovisionamiento del recurso.

Valor	Description
Succeeded	El aprovisionamiento se ha realizado correctamente
Failed	Error en el aprovisionamiento
InProgress	El aprovisionamiento está en curso
Accepted	Se ha aceptado el aprovisionamiento
Deleting	La eliminación del recurso está en curso
Canceled	Se ha cancelado el aprovisionamiento

PublicIPAddressArmReference

Objeto

El ID de recurso de Azure de un recurso IP público

Nombre	Tipo	Description
resourceId	string (arm-id)	El ID de recurso de Azure de un recurso IP público

Status

Enumeración

Estado de la operación realizada en el recurso [Succeeded, Failed, InProgress]

Valor	Description
Succeeded	Operación correcta
Failed	Error en la operación
InProgress	La operación está en curso

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	La marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Inbound Rules - List By Nat Gateway

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

ListInboundRulesByNatGateway

Solicitud de ejemplo

Respuesta de muestra

Definiciones

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

InboundNATRuleProtocol

InboundRule

InboundRuleListResult

InboundRuleProperties

InboundRuleStatus

InboundRuleStatusProvisioningStatus

IPConfigurationArmReference

ProvisioningStateEnum

PublicIPAddressArmReference

Status

systemData