Freigeben über


Private Zones - Update

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

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

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