Private Zones - Get

Référence

Service:: DNS

Version d'API:: 2018-09-01

Obtient une zone DNS privé. Récupère les propriétés de zone, mais pas les liens de réseaux virtuels ou les jeux d’enregistrements au sein de 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é (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 l'abonnement Microsoft Azure de manière unique. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.
api-version	query	True	string	Version de l’API cliente.

Réponses

Nom	Type	Description
200 OK	PrivateZone	Réussite.
Other Status Codes	CloudError	Réponse par défaut. Il sera désérialisé 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é.
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 sera ignorée.

CloudError

Réponse d’erreur du service.

Nom	Type	Description
error	CloudErrorBody	Corps d’erreur cloud.

CloudErrorBody

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 programmation.
details	CloudErrorBody[]	Liste de 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

Décrit une zone DNS privé.

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	Nombre maximal de jeux d’enregistrements pouvant être créés dans cette zone DNS privé. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur sera ignorée.
properties.maxNumberOfVirtualNetworkLinks	integer	Nombre maximal de réseaux virtuels pouvant être liés à cette zone DNS privé. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur sera ignorée.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer	Nombre maximal de réseaux virtuels pouvant être liés à cette zone DNS privé avec l’inscription activée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur sera ignorée.
properties.numberOfRecordSets	integer	Nombre actuel de jeux d’enregistrements dans cette zone DNS privé. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur sera ignorée.
properties.numberOfVirtualNetworkLinks	integer	Nombre actuel de réseaux virtuels liés à cette zone DNS privé. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur sera ignorée.
properties.numberOfVirtualNetworkLinksWithRegistration	integer	Le nombre actuel de réseaux virtuels liés à cette zone DNS privé avec l’inscription activée. Il s’agit d’une propriété en lecture seule et toute tentative de définition de cette valeur sera 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 sera ignorée.
tags	object	Balises de ressource.
type	string	Type de la ressource. Exemple : « Microsoft.Network/privateDnsZones ».

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

Nom	Type	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

Partager via