Private Zones - Get

Servicio:

DNS

Versión de la API:

2018-09-01

Obtiene una zona DNS privada. Recupera las propiedades de zona, pero no los vínculos de redes virtuales ni los conjuntos de registros dentro de la zona.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
privateZoneName	path	True	string	Nombre de la zona DNS privada (sin un punto de terminación).
resourceGroupName	path	True	string	Nombre del grupo de recursos.
subscriptionId	path	True	string	Obtiene las credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
api-version	query	True	string	Versión de api de cliente.

Respuestas

Nombre	Tipo	Description
200 OK	PrivateZone	Éxito.
Other Status Codes	CloudError	Respuesta predeterminada. Se deserializará según la definición de error.

Ejemplos

GET Private DNS Zone

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

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

Definiciones

Nombre	Description
CloudError	Respuesta de error del servicio.
CloudErrorBody	Respuesta de error del servicio.
PrivateZone	Describe una zona DNS privada.
ProvisioningState	Estado de aprovisionamiento del recurso. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.

CloudError

Object

Respuesta de error del servicio.

Nombre	Tipo	Description
error	CloudErrorBody	Cuerpo del error en la nube.

CloudErrorBody

Object

Respuesta de error del servicio.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	CloudErrorBody[]	Lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

PrivateZone

Object

Describe una zona DNS privada.

Nombre	Tipo	Description
etag	string	ETag de la zona.
id	string	Identificador de recurso completo para el recurso. Ejemplo: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}'.
location	string	Región de Azure donde reside el recurso
name	string	Nombre del recurso
properties.maxNumberOfRecordSets	integer (int64)	Número máximo de conjuntos de registros que se pueden crear en esta zona DNS privada. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.maxNumberOfVirtualNetworkLinks	integer (int64)	Número máximo de redes virtuales que se pueden vincular a esta zona DNS privada. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer (int64)	Número máximo de redes virtuales que se pueden vincular a esta zona DNS privada con el registro habilitado. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.numberOfRecordSets	integer (int64)	Número actual de conjuntos de registros en esta zona DNS privada. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.numberOfVirtualNetworkLinks	integer (int64)	Número actual de redes virtuales vinculadas a esta zona DNS privada. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.numberOfVirtualNetworkLinksWithRegistration	integer (int64)	Número actual de redes virtuales vinculadas a esta zona DNS privada con el registro habilitado. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento del recurso. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
tags	object	Etiquetas de recursos.
type	string	Tipo del recurso. Ejemplo: "Microsoft.Network/privateDnsZones".

ProvisioningState

Enumeración

Estado de aprovisionamiento del recurso. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating