Private Zones - Update

Service:

DNS

Version d'API:

2018-09-01

Mises à jour une zone DNS privé. Ne modifie pas les liens de réseau virtuel ou les enregistrements DNS au sein de la zone.

PATCH 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.

En-tête de la demande

Nom	Obligatoire	Type	Description
If-Match		string	ETag de la zone DNS privé. Omettez cette valeur pour toujours remplacer la zone active. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

Corps de la demande

Nom	Type	Description
etag	string	ETag de la zone.
location	string	Région Azure où réside la ressource
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	PrivateZone	La zone DNS privé a été mise à jour.
202 Accepted		L’opération de mise à jour de zone DNS privé a été acceptée et se termine de manière asynchrone.
Other Status Codes	CloudError	Réponse par défaut. Il sera désérialisé conformément à la définition d’erreur.

Exemples

PATCH Private DNS Zone

Exemple de requête

HTTP

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

{
  "tags": {
    "key2": "value2"
  }
}

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": {
    "key2": "value2"
  }
}

Code d’état:

202

Location: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationResults/asyncOperationId?api-version=2018-09-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationStatuses/asyncOperationId?api-version=2018-09-01
Retry-After: 60

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 de l’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 des détails supplémentaires sur l’erreur.
message	string	Message décrivant l’erreur, destiné à être affiché dans une interface utilisateur.
target	string	Cible de l’erreur particulière. Par exemple, le nom de la propriété dans l’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	Nombre actuel de réseaux virtuels liés à cette zone DNS privé avec 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