Dns Forwarding Rulesets - List

Elenca i set di regole di inoltro DNS in tutti i gruppi di risorse di una sottoscrizione.

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}

Parametri dell'URI

Name In Required Type Description
subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

$top
query
  • integer
int32

Il numero massimo di risultati da restituire. Se non specificato, restituisce fino a 100 risultati.

Risposte

Name Type Description
200 OK

Elenco dei set di regole di inoltro DNS nella sottoscrizione.

Other Status Codes

Risposta predefinita. Verrà deserializzato in base alla definizione di errore.

Esempio

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

Definizioni

CloudError

Messaggio di errore

CloudErrorBody

Corpo di un messaggio di errore

createdByType

Tipo di identità che ha creato la risorsa.

DnsForwardingRuleset

Descrive un set di regole di inoltro DNS.

DnsForwardingRulesetListResult

Risposta a un'operazione di enumerazione nei set di regole di inoltro DNS.

ProvisioningState

Stato di provisioning corrente della risorsa.

SubResource

Riferimento a un'altra risorsa arm.

systemData

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

CloudError

Messaggio di errore

Name Type Description
error

Corpo del messaggio di errore

CloudErrorBody

Corpo di un messaggio di errore

Name Type Description
code
  • string

Il codice di errore

details

Informazioni aggiuntive sull'errore

message
  • string

Descrizione di ciò che ha causato l'errore

target
  • string

Risorsa di destinazione del messaggio di errore

createdByType

Tipo di identità che ha creato la risorsa.

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

DnsForwardingRuleset

Descrive un set di regole di inoltro DNS.

Name Type Description
etag
  • string

ETag del set di regole di inoltro DNS.

id
  • string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Posizione geografica in cui vive la risorsa

name
  • string

nome della risorsa.

properties.dnsResolverOutboundEndpoints

Riferimento agli endpoint in uscita del resolver DNS usati per indirizzare le query DNS corrispondenti alle regole di inoltro nel set di regole ai server DNS di destinazione.

properties.provisioningState

Stato di provisioning corrente del set di regole di inoltro DNS. Si tratta di una proprietà di sola lettura e qualsiasi tentativo di impostare questo valore verrà ignorato.

properties.resourceGuid
  • string

ResourceGuid per il set di regole di inoltro DNS.

systemData

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

tags
  • object

Tag di risorse.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft. Archiviazione/storageAccounts"

DnsForwardingRulesetListResult

Risposta a un'operazione di enumerazione nei set di regole di inoltro DNS.

Name Type Description
nextLink
  • string

Token di continuazione per la pagina successiva dei risultati.

value

Enumerazione dei set di regole di inoltro DNS.

ProvisioningState

Stato di provisioning corrente della risorsa.

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

SubResource

Riferimento a un'altra risorsa arm.

Name Type Description
id
  • string

ID risorsa.

systemData

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

Name Type Description
createdAt
  • string

Timestamp della creazione di risorse (UTC).

createdBy
  • string

Identità che ha creato la risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt
  • string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy
  • string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

Tipo di identità che ha modificato l'ultima risorsa.