Dns Forwarding Rulesets - List

Lista as regras de encaminhamento de DNS em todos os grupos de recursos de uma subscrição.

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 do URI

Name In Required Type Description
subscriptionId
path True
  • string

A identificação da assinatura do alvo.

api-version
query True
  • string

A versão API a ser utilizada para esta operação.

$top
query
  • integer
int32

O número máximo de resultados para devolver. Se não for especificado, retorna até 100 resultados.

Respostas

Name Type Description
200 OK

Lista de regras de encaminhamento de DNS na subscrição.

Other Status Codes

Resposta predefinida. Será deseralizado de acordo com a definição de Erro.

Exemplos

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"
}

Definições

CloudError

Uma mensagem de erro

CloudErrorBody

O corpo de uma mensagem de erro

createdByType

O tipo de identidade que criou o recurso.

DnsForwardingRuleset

Descreve um regulamento de reencaminhamento de DNS.

DnsForwardingRulesetListResult

A resposta a uma operação de enumeração nas regras de encaminhamento do DNS.

ProvisioningState

O estado atual de aprovisionamento do recurso.

SubResource

Referência a outro recurso ARM.

systemData

Metadados relativos à criação e última modificação do recurso.

CloudError

Uma mensagem de erro

Name Type Description
error

O corpo da mensagem de erro

CloudErrorBody

O corpo de uma mensagem de erro

Name Type Description
code
  • string

O código de erro

details

Informações extra de erro

message
  • string

Uma descrição do que causou o erro

target
  • string

O recurso alvo da mensagem de erro

createdByType

O tipo de identidade que criou o recurso.

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

DnsForwardingRuleset

Descreve um regulamento de reencaminhamento de DNS.

Name Type Description
etag
  • string

ETag do regulamento de reencaminhamento do DNS.

id
  • string

ID de recursos totalmente qualificado para o recurso. Ex - /subscrições/{subscriçãoD}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

A geolocalização onde o recurso vive

name
  • string

O nome do recurso

properties.dnsResolverOutboundEndpoints

A referência aos pontos finais de saída do DNS que são utilizados para encaminhar consultas de DNS que correspondem às regras de encaminhamento no ruleset para os servidores DNS alvo.

properties.provisioningState

O estado atual de provisionamento do DNS reencaminhamento de regras. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.

properties.resourceGuid
  • string

O recursoGuid para o conjunto de regras de encaminhamento do DNS.

systemData

Metadados relativos à criação e última modificação do recurso.

tags
  • object

Etiquetas de recursos.

type
  • string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft." Armazenamento/armazenamentoCotalhos"

DnsForwardingRulesetListResult

A resposta a uma operação de enumeração nas regras de encaminhamento do DNS.

Name Type Description
nextLink
  • string

O sinal de continuação para a próxima página de resultados.

value

Enumeração das regras de encaminhamento do DNS.

ProvisioningState

O estado atual de aprovisionamento do recurso.

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

SubResource

Referência a outro recurso ARM.

Name Type Description
id
  • string

Identificação de recursos.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Type Description
createdAt
  • string

O calendário da criação de recursos (UTC).

createdBy
  • string

A identidade que criou o recurso.

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt
  • string

O tempotampesso da última modificação de recursos (UTC)

lastModifiedBy
  • string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

O tipo de identidade que modificou o recurso pela última vez.