Private Zones - Update

Dienst:

DNS

API-Version:

2018-09-01

Updates eine Privates DNS Zone. Ändert keine virtuellen Netzwerkverbindungen oder DNS-Einträge innerhalb der Zone.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
privateZoneName	path	True	string	Der Name der Privates DNS Zone (ohne abschlussenden Punkt).
resourceGroupName	path	True	string	Der Name der Ressourcengruppe.
subscriptionId	path	True	string	Ruft die Abonnementanmeldeinformationen ab, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
If-Match		string	Das ETag der Privates DNS Zone. Lassen Sie diesen Wert aus, um die aktuelle Zone immer zu überschreiben. Geben Sie den zuletzt angezeigten ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

Anforderungstext

Name	Typ	Beschreibung
etag	string	Das ETag der Zone.
location	string	Die Azure-Region, in der sich die Ressource befindet
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	PrivateZone	Die Privates DNS Zone wurde aktualisiert.
202 Accepted		Der Privates DNS Zonenaktualisierungsvorgang wurde akzeptiert und wird asynchron abgeschlossen.
Other Status Codes	CloudError	Standardantwort. Es wird gemäß der Fehlerdefinition deserialisiert.

Beispiele

PATCH Private DNS Zone

Beispielanforderung

HTTP

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

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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

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

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort vom Dienst.
CloudErrorBody	Eine Fehlerantwort vom Dienst.
PrivateZone	Beschreibt eine Privates DNS Zone.
ProvisioningState	Der Bereitstellungsstatus der Ressource. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.

CloudError

Eine Fehlerantwort vom Dienst.

Name	Typ	Beschreibung
error	CloudErrorBody	Cloudfehlertext.

CloudErrorBody

Eine Fehlerantwort vom Dienst.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden.
details	CloudErrorBody[]	Eine Liste mit zusätzlichen Details zum Fehler.
message	string	Eine Meldung, die den Fehler beschreibt, die für die Anzeige in einer Benutzeroberfläche geeignet sein soll.
target	string	Das Ziel des bestimmten Fehlers. Beispiel: Der Name der -Eigenschaft, die einen Fehler aufweist.

PrivateZone

Beschreibt eine Privates DNS Zone.

Name	Typ	Beschreibung
etag	string	Das ETag der Zone.
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}'.
location	string	Die Azure-Region, in der sich die Ressource befindet
name	string	Der Name der Ressource
properties.maxNumberOfRecordSets	integer	Die maximale Anzahl von Datensatzsätzen, die in dieser Privates DNS Zone erstellt werden können. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
properties.maxNumberOfVirtualNetworkLinks	integer	Die maximale Anzahl von virtuellen Netzwerken, die mit dieser Privates DNS Zone verknüpft werden können. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer	Die maximale Anzahl von virtuellen Netzwerken, die mit dieser Privates DNS Zone mit aktivierter Registrierung verknüpft werden können. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
properties.numberOfRecordSets	integer	Die aktuelle Anzahl von Datensatzsätzen in dieser Privates DNS Zone. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
properties.numberOfVirtualNetworkLinks	integer	Die aktuelle Anzahl der virtuellen Netzwerke, die mit dieser Privates DNS Zone verknüpft sind. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
properties.numberOfVirtualNetworkLinksWithRegistration	integer	Die aktuelle Anzahl der virtuellen Netzwerke, die mit dieser Privates DNS Zone mit aktivierter Registrierung verknüpft sind. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
properties.provisioningState	ProvisioningState	Der Bereitstellungsstatus der Ressource. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Beispiel: "Microsoft.Network/privateDnsZones".

ProvisioningState

Der Bereitstellungsstatus der Ressource. Dies ist eine schreibgeschützte Eigenschaft, und jeder Versuch, diesen Wert festzulegen, wird ignoriert.

Name	Typ	Beschreibung
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string