Dns Forwarding Rulesets - List

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=2020-04-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2020-04-01-preview&$top={$top}

Parámetros de identificador URI

Name In Required Type Description
subscriptionId
path True
  • string

Identificador de la suscripción de destino.

api-version
query True
  • string

Versión de API que se usará para la 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

Name Type Description
200 OK

Lista de conjuntos de reglas de reenvío de DNS en la suscripción.

Other Status Codes

Respuesta predeterminada. Se deserializará según la definición de error.

Ejemplos

List DNS forwarding rulesets by subscription

Sample Request

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

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset",
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "tags": {
        "key1": "value1"
      },
      "systemData": {
        "createdByType": "Application",
        "createdAt": "2021-04-03T01:01:01.1075056Z",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2021-04-04T02:03:01.1974346Z"
      },
      "location": "westus2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "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"
      }
    },
    {
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset1",
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "tags": {
        "key1": "value1"
      },
      "systemData": {
        "createdByType": "Application",
        "createdAt": "2021-04-04T01:01:01.1075056Z",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2021-04-05T02:03:01.1974346Z"
      },
      "location": "westus2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "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"
      }
    }
  ],
  "nextLink": "https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/providers/Microsoft.Network/dnsForwardingRulesets?$skipToken=skipToken&api-version=2020-04-01-preview"
}

Definiciones

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 de DNS.

DnsForwardingRulesetListResult

Respuesta a una operación de enumeración en conjuntos de reglas de reenvío DNS.

ProvisioningState

Estado de aprovisionamiento actual del recurso.

SubResource

Referencia a otro recurso de ARM.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

CloudError

Mensaje de error

Name Type Description
error

Cuerpo del mensaje de error

CloudErrorBody

Cuerpo de un mensaje de error

Name Type Description
code
  • string

Código de error.

details

Información adicional de error

message
  • string

Descripción de lo que causó el error

target
  • string

Recurso de destino del mensaje de error

createdByType

Tipo de identidad que creó el recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DnsForwardingRuleset

Describe un conjunto de reglas de reenvío de DNS.

Name Type Description
etag
  • string

ETag del conjunto de reglas de reenvío dns.

id
  • string

Identificador de recurso completo del 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

Referencia a los puntos de conexión de salida 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

Estado de aprovisionamiento actual del conjunto de reglas de reenvío de 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

Metadatos relacionados con la creación y la última modificación del recurso.

tags
  • object

Etiquetas del recurso.

type
  • string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft. Storage/storageAccounts"

DnsForwardingRulesetListResult

Respuesta a una operación de enumeración en conjuntos de reglas de reenvío DNS.

Name Type Description
nextLink
  • string

Token de continuación de la página siguiente de resultados.

value

Enumeración de los conjuntos de reglas de reenvío de DNS.

ProvisioningState

Estado de aprovisionamiento actual del recurso.

Name Type Description
Canceled
  • string
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

SubResource

Referencia a otro recurso de ARM.

Name Type Description
id
  • string

Identificador del recurso.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name Type Description
createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

createdBy
  • string

Identidad que creó el recurso.

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.