Private Zones - Update

Service:

DNS

API Version:

2018-09-01

Novedades una zona de DNS privado. No modifica los vínculos de red virtual ni los registros DNS dentro de la zona.

PATCH 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 de DNS privado (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 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.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-Match		string	ETag de la zona DNS privado. Omita este valor para sobrescribir siempre la zona actual. Especifique el último valor de ETag visto para evitar que se sobrescriban accidentalmente los cambios simultáneos.

Cuerpo de la solicitud

Nombre	Tipo	Description
etag	string	ETag de la zona.
location	string	Región de Azure donde reside el recurso
tags	object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
200 OK	PrivateZone	Se ha actualizado la zona DNS privado.
202 Accepted		Se ha aceptado la operación de actualización de zona DNS privado y se completará de forma asincrónica.
Other Status Codes	CloudError	Respuesta predeterminada. Se deserializará según la definición de error.

Ejemplos

PATCH Private DNS Zone

Sample Request

HTTP

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

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

Sample Response

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": {
    "key2": "value2"
  }
}

Status code:

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

Definiciones

Nombre	Description
CloudError	Respuesta de error del servicio.
CloudErrorBody	Respuesta de error del servicio.
PrivateZone	Describe una zona 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 mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. 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 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 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 que están 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".

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