Private Zones - Get

Service:

DNS

Version d'API:

2018-09-01

Obtient une zone DNS privée. Récupère les propriétés de zone, mais pas les liens de réseaux virtuels ou les jeux d’enregistrements dans la zone.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}?api-version=2018-09-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
privateZoneName	path	True	string	Nom de la zone DNS privée (sans point de fin).
resourceGroupName	path	True	string	Nom du groupe de ressources.
subscriptionId	path	True	string	Obtient les informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.
api-version	query	True	string	Version de l’API cliente.

Réponses

Nom	Type	Description
200 OK	PrivateZone	Succès.
Other Status Codes	CloudError	Réponse par défaut. Elle sera désérialisée conformément à la définition d’erreur.

Exemples

GET Private DNS Zone

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com?api-version=2018-09-01

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com",
  "name": "privatezone1.com",
  "type": "Microsoft.Network/privateDnsZones",
  "location": "global",
  "etag": "00000000-0000-0000-0000-000000000000",
  "properties": {
    "maxNumberOfRecordSets": 5000,
    "numberOfRecordSets": 1,
    "maxNumberOfVirtualNetworkLinks": 100,
    "numberOfVirtualNetworkLinks": 0,
    "maxNumberOfVirtualNetworkLinksWithRegistration": 50,
    "numberOfVirtualNetworkLinksWithRegistration": 0,
    "provisioningState": "Succeeded"
  },
  "tags": {
    "key1": "value1"
  }
}

Définitions

Nom	Description
CloudError	Réponse d’erreur du service.
CloudErrorBody	Réponse d’erreur du service.
PrivateZone	Décrit une zone DNS privée.
ProvisioningState	État d’approvisionnement de la ressource. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.

CloudError

Object

Réponse d’erreur du service.

Nom	Type	Description
error	CloudErrorBody	Corps de l’erreur cloud.

CloudErrorBody

Object

Réponse d’erreur du service.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details	CloudErrorBody[]	Liste des détails supplémentaires sur l’erreur.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target	string	Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

PrivateZone

Object

Décrit une zone DNS privée.

Nom	Type	Description
etag	string	ETag de la zone.
id	string	ID de ressource complet pour la ressource. Exemple : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName} ».
location	string	Région Azure où réside la ressource
name	string	Nom de la ressource
properties.maxNumberOfRecordSets	integer (int64)	Nombre maximal de jeux d’enregistrements qui peuvent être créés dans cette zone DNS privée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.
properties.maxNumberOfVirtualNetworkLinks	integer (int64)	Nombre maximal de réseaux virtuels pouvant être liés à cette zone DNS privée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer (int64)	Nombre maximal de réseaux virtuels pouvant être liés à cette zone DNS privée avec l’inscription activée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.
properties.numberOfRecordSets	integer (int64)	Nombre actuel de jeux d’enregistrements dans cette zone DNS privée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.
properties.numberOfVirtualNetworkLinks	integer (int64)	Nombre actuel de réseaux virtuels liés à cette zone DNS privée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.
properties.numberOfVirtualNetworkLinksWithRegistration	integer (int64)	Nombre actuel de réseaux virtuels liés à cette zone DNS privée avec inscription activée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.
properties.provisioningState	ProvisioningState	État d’approvisionnement de la ressource. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.
tags	object	Balises de ressource.
type	string	Type de la ressource. Exemple : « Microsoft.Network/privateDnsZones ».

ProvisioningState

Énumération

État d’approvisionnement de la ressource. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur est ignorée.

Valeur	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating