Private Zones - Get

Referenz

Dienst:: DNS

API-Version:: 2018-09-01

Ruft eine Privates DNS Zone ab. Ruft die Zoneneigenschaften ab, aber nicht die Verbindungen zu virtuellen Netzwerken oder die Datensatzsätze innerhalb der Zone.

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

Antworten

Name	Typ	Beschreibung
200 OK	PrivateZone	Erfolg.
Other Status Codes	CloudError	Standardantwort. Es wird gemäß der Fehlerdefinition deserialisiert.

Beispiele

GET Private DNS Zone

Beispielanforderung

HTTP

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

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": {
    "key1": "value1"
  }
}

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, der für die Anzeige in einer Benutzeroberfläche geeignet sein soll.
target	string	Das Ziel des jeweiligen Fehlers. Beispiel: Der Name der -Eigenschaft im Fehler.

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 virtueller Netzwerke, 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 virtueller Netzwerke, die mit dieser Privates DNS Zone verknüpft werden können, wenn die Registrierung aktiviert ist. 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 virtueller 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 virtueller Netzwerke, die mit dieser Privates DNS Zone verknüpft sind, wobei die Registrierung aktiviert ist. 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

Freigeben über