Dns Forwarding Rulesets - List

Servicio:: DNS

Versión de la API:: 2025-05-01

Enumera los conjuntos de reglas de reenvío de DNS en todos los grupos de recursos de una suscripción.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2025-05-01

Con parámetros opcionales:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2025-05-01&$top={$top}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
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 la API que se va a usar para esta operación.
$top	query		integer (int32)	El número máximo de resultados que se devolverán. Si no se especifica, devuelve hasta 100 resultados.

Respuestas

Nombre	Tipo	Description
200 OK	DnsForwardingRulesetListResult	La operación de Azure se completó correctamente.
Other Status Codes	CloudError	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

List DNS forwarding rulesets by subscription

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2025-05-01

Respuesta de muestra

status code:: 200

{
  "nextLink": "https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/providers/Microsoft.Network/dnsForwardingRulesets?$skipToken=skipToken&api-version=2025-05-01",
  "value": [
    {
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "etag": "00000000-0000-0000-0000-000000000000",
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset",
      "location": "westus2",
      "properties": {
        "dnsResolverOutboundEndpoints": [
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint0"
          },
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "a7e1a32c-498c-401c-a805-5bc3518257b8"
      },
      "systemData": {
        "createdAt": "2021-04-03T01:01:01.1075056Z",
        "createdByType": "Application",
        "lastModifiedAt": "2021-04-04T02:03:01.1974346Z",
        "lastModifiedByType": "Application"
      },
      "tags": {
        "key1": "value1"
      }
    },
    {
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "etag": "00000000-0000-0000-0000-000000000000",
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset1",
      "location": "westus2",
      "properties": {
        "dnsResolverOutboundEndpoints": [
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint2"
          },
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint3"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "a7e1a32c-498c-401c-a805-5bc3518257b8"
      },
      "systemData": {
        "createdAt": "2021-04-04T01:01:01.1075056Z",
        "createdByType": "Application",
        "lastModifiedAt": "2021-04-05T02:03:01.1974346Z",
        "lastModifiedByType": "Application"
      },
      "tags": {
        "key1": "value1"
      }
    }
  ]
}

Definiciones

Nombre	Description
CloudError	Mensaje de error
CloudErrorBody	Cuerpo de un mensaje de error
createdByType	Tipo de identidad que creó el recurso.
DnsForwardingRuleset	Describe un conjunto de reglas de reenvío DNS.
DnsForwardingRulesetListResult	Respuesta de una operación de lista DnsForwardingRuleset.
ProvisioningState	El estado de aprovisionamiento actual del recurso.
SubResource	Referencia a otro recurso de ARM.
systemData	Metadatos relativos a la creación y última modificación del recurso.

CloudError

Object

Mensaje de error

Nombre	Tipo	Description
error	CloudErrorBody	Cuerpo del mensaje de error

CloudErrorBody

Object

Cuerpo de un mensaje de error

Nombre	Tipo	Description
code	string	El código de error
details	CloudErrorBody[]	Información adicional de error
message	string	Descripción de lo que provocó el error
target	string	Recurso de destino del mensaje de error

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Object

Describe un conjunto de reglas de reenvío DNS.

Nombre	Tipo	Description
etag	string	"Si se proporciona etag en el cuerpo de la respuesta, también se puede proporcionar como un encabezado según la convención etag normal. Las etiquetas de entidad se usan para comparar dos o más entidades del mismo recurso solicitado. HTTP / 1.1 usa etiquetas de entidad en los campos de encabezado etag (sección 14.19), If-Match (sección 14.24), If-None-Match (sección 14.26) y If-Range (sección 14.27)").
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.dnsResolverOutboundEndpoints	SubResource[]	Referencia a los puntos de conexión salientes de la resolución DNS que se usan para enrutar las consultas DNS que coinciden con las reglas de reenvío del conjunto de reglas a los servidores DNS de destino.
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento actual del conjunto de reglas de reenvío DNS. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.resourceGuid	string	ResourceGuid para el conjunto de reglas de reenvío DNS.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DnsForwardingRulesetListResult

Object

Respuesta de una operación de lista DnsForwardingRuleset.

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

ProvisioningState

Enumeración

El estado de aprovisionamiento actual del recurso.

Valor	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Object

Referencia a otro recurso de ARM.

Nombre	Tipo	Description
id	string	Identificador de recurso.

systemData

Object

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)	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

Dns Forwarding Rulesets - List

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

List DNS forwarding rulesets by subscription

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CloudError

CloudErrorBody

createdByType

DnsForwardingRuleset

DnsForwardingRulesetListResult

ProvisioningState

SubResource

systemData