Dns Forwarding Rulesets - List

Répertorie les 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

Name In Required 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

Name Type Description
200 OK

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

Other Status Codes

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

Exemples

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

Définitions

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

Name Type Description
error

Corps du message d’erreur

CloudErrorBody

Corps d’un message d’erreur

Name Type Description
code
  • string

Le code d'erreur

details

Informations supplémentaires sur les erreurs

message
  • string

Description de ce qui a provoqué l’erreur

target
  • string

Ressource cible du message d’erreur

createdByType

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

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

DnsForwardingRuleset

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

Name 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

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 aux serveurs DNS cibles.

properties.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 est ignorée.

properties.resourceGuid
  • string

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

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. Stockage/storageAccounts »

DnsForwardingRulesetListResult

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

Name Type Description
nextLink
  • string

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

value

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

ProvisioningState

État d’approvisionnement actuel de la ressource.

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

SubResource

Référence à une autre ressource ARM.

Name Type Description
id
  • string

ID de la ressource

systemData

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

Name Type Description
createdAt
  • string

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

createdBy
  • string

Identité qui a créé la ressource.

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

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