Partager via


Dns Forwarding Rulesets - List

Listes ensembles de règles de transfert DNS dans tous les groupes de ressources d’un abonnement.

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}

Paramètres URI

Nom Dans Obligatoire Type Description
subscriptionId
path True

string

ID de l’abonnement cible.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

$top
query

integer

int32

Le nombre maximal de résultats à renvoyer. S’il n’est pas spécifié, retourne jusqu’à 100 résultats.

Réponses

Nom Type Description
200 OK

DnsForwardingRulesetListResult

Liste des ensembles de règles de transfert DNS dans l’abonnement.

Other Status Codes

CloudError

Réponse par défaut. Il sera désérialisé conformément à la définition d’erreur.

Exemples

List DNS forwarding rulesets by subscription

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
CloudError

Message d’erreur

CloudErrorBody

Corps d’un message d’erreur

createdByType

Type d’identité qui a créé la ressource.

DnsForwardingRuleset

Décrit un ensemble de règles de transfert DNS.

DnsForwardingRulesetListResult

Réponse à une opération d’énumération sur les ensembles de règles de transfert DNS.

ProvisioningState

État d’approvisionnement actuel de la ressource.

SubResource

Référence à une autre ressource ARM.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

CloudError

Message d’erreur

Nom Type Description
error

CloudErrorBody

Corps du message d’erreur

CloudErrorBody

Corps d’un message d’erreur

Nom Type Description
code

string

Le code d'erreur

details

CloudErrorBody[]

Informations supplémentaires sur l’erreur

message

string

Description de la cause de l’erreur

target

string

Ressource cible du message d’erreur

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

DnsForwardingRuleset

Décrit un ensemble de règles de transfert DNS.

Nom Type Description
etag

string

ETag de l’ensemble de règles de transfert DNS.

id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Emplacement géographique où réside la ressource

name

string

nom de la ressource.

properties.dnsResolverOutboundEndpoints

SubResource[]

Référence aux points de terminaison sortants du programme de résolution DNS utilisés pour acheminer les requêtes DNS correspondant aux règles de transfert dans l’ensemble de règles vers les serveurs DNS cibles.

properties.provisioningState

ProvisioningState

État d’approvisionnement actuel de l’ensemble de règles de transfert DNS. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur sera ignorée.

properties.resourceGuid

string

ResourceGuid pour l’ensemble de règles de transfert DNS.

systemData

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

DnsForwardingRulesetListResult

Réponse à une opération d’énumération sur les ensembles de règles de transfert DNS.

Nom Type Description
nextLink

string

Jeton de continuation pour la page de résultats suivante.

value

DnsForwardingRuleset[]

Énumération des ensembles de règles de transfert DNS.

ProvisioningState

État d’approvisionnement actuel de la ressource.

Nom Type Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

SubResource

Référence à une autre ressource ARM.

Nom Type Description
id

string

ID de la ressource

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.