Private Zones - List By Resource Group

Referencia

Service:: DNS

API Version:: 2018-09-01

Listas las zonas DNS privado dentro de un grupo de recursos.

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

With optional parameters:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos.
subscriptionId	path	True	string	Obtiene las credenciales de suscripción que identifican a la suscripción de Microsoft Azure de forma única. El identificador de suscripción forma parte del URI para cada llamada al servicio.
api-version	query	True	string	Versión de api de cliente.
$top	query		integer int32	Número máximo de conjuntos de registros que se van a devolver. Si no se especifica, devuelve hasta 100 conjuntos de registros.

Respuestas

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

Ejemplos

GET Private DNS Zone by Resource Group

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "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"
      }
    },
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone2.com",
      "name": "privatezone2.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"
      }
    }
  ]
}

Definiciones

Nombre	Description
CloudError	Respuesta de error del servicio.
CloudErrorBody	Respuesta de error del servicio.
PrivateZone	Describe una zona DNS privado.
PrivateZoneListResult	Respuesta a una operación de lista de zonas de DNS privado.
ProvisioningState	Estado de aprovisionamiento del recurso. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.

CloudError

Respuesta de error del servicio.

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

CloudErrorBody

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 su presentación en una interfaz de usuario.
target	string	Destino del error determinado. Por ejemplo, el nombre de la propiedad en error.

PrivateZone

Describe una zona DNS privado.

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	Número máximo de conjuntos de registros que se pueden crear en esta zona DNS privado. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.maxNumberOfVirtualNetworkLinks	integer	Número máximo de redes virtuales que se pueden vincular a esta zona de DNS privado. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer	Número máximo de redes virtuales que se pueden vincular a esta zona de DNS privado con el registro habilitado. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.numberOfRecordSets	integer	Número actual de conjuntos de registros en esta zona de DNS privado. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.numberOfVirtualNetworkLinks	integer	Número actual de redes virtuales vinculadas a esta zona DNS privado. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.numberOfVirtualNetworkLinksWithRegistration	integer	Número actual de redes virtuales vinculadas a esta zona de DNS privado 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 del recurso.
type	string	Tipo de recurso. Ejemplo: "Microsoft.Network/privateDnsZones".

PrivateZoneListResult

Respuesta a una operación de lista de zonas de DNS privado.

Nombre	Tipo	Description
nextLink	string	Token de continuación de la página siguiente de resultados.
value	PrivateZone[]	Información sobre las zonas de DNS privado.

ProvisioningState

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

Nombre	Tipo	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

Share via