Record Sets - Update

Servicio:: DNS

Versión de la API:: 2018-09-01

Actualiza un conjunto de registros dentro de una zona DNS privada.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}?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).
recordType	path	True	RecordType	Tipo de registro DNS en este conjunto de registros.
relativeRecordSetName	path	True	string	Nombre del conjunto de registros, en relación con el nombre de la zona.
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.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-Match		string	ETag del conjunto de registros. Omita este valor para sobrescribir siempre el conjunto de registros actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente los cambios simultáneos.

Cuerpo de la solicitud

Nombre	Tipo	Description
etag	string	ETag del conjunto de registros.
properties.aRecords	ARecord[]	Lista de registros A del conjunto de registros.
properties.aaaaRecords	AaaaRecord[]	Lista de registros AAAA en el conjunto de registros.
properties.cnameRecord	CnameRecord	Registro CNAME del conjunto de registros.
properties.metadata	object	Metadatos adjuntos al conjunto de registros.
properties.mxRecords	MxRecord[]	Lista de registros MX del conjunto de registros.
properties.ptrRecords	PtrRecord[]	Lista de registros PTR del conjunto de registros.
properties.soaRecord	SoaRecord	Registro SOA del conjunto de registros.
properties.srvRecords	SrvRecord[]	Lista de registros SRV del conjunto de registros.
properties.ttl	integer (int64)	TTL (período de vida) de los registros del conjunto de registros.
properties.txtRecords	TxtRecord[]	Lista de registros TXT del conjunto de registros.

Respuestas

Nombre	Tipo	Description
200 OK	RecordSet	El conjunto de registros se ha actualizado.
Other Status Codes	CloudError	Respuesta predeterminada. Se deserializará según la definición de error.

Ejemplos

PATCH Private DNS Zone A Record Set

PATCH Private DNS Zone AAAA Record Set

PATCH Private DNS Zone CNAME Record Set

PATCH Private DNS Zone MX Record Set

PATCH Private DNS Zone PTR Record Set

PATCH Private DNS Zone SOA Record Set

PATCH Private DNS Zone SRV Record Set

PATCH Private DNS Zone TXT Record Set

PATCH Private DNS Zone A Record Set

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recorda",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recorda",
  "type": "Microsoft.Network/privateDnsZones/A",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recorda.privatezone1.com.",
    "isAutoRegistered": false,
    "aRecords": [
      {
        "ipv4Address": "1.2.3.4"
      }
    ]
  }
}

PATCH Private DNS Zone AAAA Record Set

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordaaaa",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordaaaa",
  "type": "Microsoft.Network/privateDnsZones/AAAA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordaaaa.privatezone1.com.",
    "isAutoRegistered": false,
    "aaaaRecords": [
      {
        "ipv6Address": "::1"
      }
    ]
  }
}

PATCH Private DNS Zone CNAME Record Set

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/CNAME/recordcname",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordcname",
  "type": "Microsoft.Network/privateDnsZones/CNAME",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordcname.privatezone1.com.",
    "isAutoRegistered": false,
    "cnameRecord": {
      "cname": "contoso.com"
    }
  }
}

PATCH Private DNS Zone MX Record Set

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordmx",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordmx",
  "type": "Microsoft.Network/privateDnsZones/MX",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordmx.privatezone1.com.",
    "isAutoRegistered": false,
    "mxRecords": [
      {
        "preference": 0,
        "exchange": "mail.privatezone1.com"
      }
    ]
  }
}

PATCH Private DNS Zone PTR Record Set

Solicitud de ejemplo

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "1",
  "type": "Microsoft.Network/privateDnsZones/PTR",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "1.0.0.127.in-addr.arpa.",
    "isAutoRegistered": false,
    "ptrRecords": [
      {
        "ptrdname": "localhost"
      }
    ]
  }
}

PATCH Private DNS Zone SOA Record Set

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SOA/@",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "@",
  "type": "Microsoft.Network/privateDnsZones/SOA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "privatezone1.com.",
    "isAutoRegistered": false,
    "soaRecord": {
      "host": "azureprivatedns.net",
      "email": "azureprivatedns-hostmaster.microsoft.com",
      "serialNumber": 1,
      "refreshTime": 3600,
      "retryTime": 300,
      "expireTime": 2419200,
      "minimumTtl": 300
    }
  }
}

PATCH Private DNS Zone SRV Record Set

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SRV/recordsrv",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordsrv",
  "type": "Microsoft.Network/privateDnsZones/SRV",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordsrv.privatezone1.com.",
    "isAutoRegistered": false,
    "srvRecords": [
      {
        "priority": 0,
        "weight": 10,
        "port": 80,
        "target": "contoso.com"
      }
    ]
  }
}

PATCH Private DNS Zone TXT Record Set

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/TXT/recordtxt",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordtxt",
  "type": "Microsoft.Network/privateDnsZones/TXT",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordtxt.privatezone1.com.",
    "isAutoRegistered": false,
    "txtRecords": [
      {
        "value": [
          "string1",
          "string2"
        ]
      }
    ]
  }
}

Definiciones

Nombre	Description
AaaaRecord	Un registro AAAA.
ARecord	Un registro A.
CloudError	Respuesta de error del servicio.
CloudErrorBody	Respuesta de error del servicio.
CnameRecord	Un registro CNAME.
MxRecord	Un registro MX.
PtrRecord	Un registro PTR.
RecordSet	Describe un conjunto de registros DNS (una colección de registros DNS con el mismo nombre y tipo) en una zona DNS privada.
RecordType	Tipo de registro DNS en este conjunto de registros.
SoaRecord	Un registro SOA.
SrvRecord	Un registro SRV.
TxtRecord	Un registro TXT.

AaaaRecord

Object

Un registro AAAA.

Nombre	Tipo	Description
ipv6Address	string	Dirección IPv6 de este registro AAAA.

ARecord

Object

Un registro A.

Nombre	Tipo	Description
ipv4Address	string	Dirección IPv4 de este registro A.

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.

CnameRecord

Object

Un registro CNAME.

Nombre	Tipo	Description
cname	string	Nombre canónico de este registro CNAME.

MxRecord

Object

Un registro MX.

Nombre	Tipo	Description
exchange	string	Nombre de dominio del host de correo para este registro MX.
preference	integer (int32)	Valor de preferencia para este registro MX.

PtrRecord

Object

Un registro PTR.

Nombre	Tipo	Description
ptrdname	string	Nombre de dominio de destino PTR para este registro PTR.

RecordSet

Object

Describe un conjunto de registros DNS (una colección de registros DNS con el mismo nombre y tipo) en una zona DNS privada.

Nombre	Tipo	Description
etag	string	ETag del conjunto de registros.
id	string	Identificador del conjunto de registros.
name	string	Nombre del conjunto de registros.
properties.aRecords	ARecord[]	Lista de registros A del conjunto de registros.
properties.aaaaRecords	AaaaRecord[]	Lista de registros AAAA en el conjunto de registros.
properties.cnameRecord	CnameRecord	Registro CNAME del conjunto de registros.
properties.fqdn	string	Nombre de dominio completo del conjunto de registros.
properties.isAutoRegistered	boolean	¿El conjunto de registros se registra automáticamente en la zona DNS privada a través de un vínculo de red virtual?
properties.metadata	object	Metadatos adjuntos al conjunto de registros.
properties.mxRecords	MxRecord[]	Lista de registros MX del conjunto de registros.
properties.ptrRecords	PtrRecord[]	Lista de registros PTR del conjunto de registros.
properties.soaRecord	SoaRecord	Registro SOA del conjunto de registros.
properties.srvRecords	SrvRecord[]	Lista de registros SRV del conjunto de registros.
properties.ttl	integer (int64)	TTL (período de vida) de los registros del conjunto de registros.
properties.txtRecords	TxtRecord[]	Lista de registros TXT del conjunto de registros.
type	string	Tipo del conjunto de registros.

RecordType

Enumeración

Tipo de registro DNS en este conjunto de registros.

Valor	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

Un registro SOA.

Nombre	Tipo	Description
email	string	Contacto de correo electrónico para este registro SOA.
expireTime	integer (int64)	Hora de expiración de este registro SOA.
host	string	Nombre de dominio del servidor de nombres autoritativo para este registro SOA.
minimumTtl	integer (int64)	Valor mínimo de este registro SOA. Por convención, se usa para determinar la duración del almacenamiento en caché negativa.
refreshTime	integer (int64)	Valor de actualización de este registro SOA.
retryTime	integer (int64)	Tiempo de reintento para este registro SOA.
serialNumber	integer (int64)	Número de serie de este registro SOA.

SrvRecord

Object

Un registro SRV.

Nombre	Tipo	Description
port	integer (int32)	Valor de puerto para este registro SRV.
priority	integer (int32)	Valor de prioridad de este registro SRV.
target	string	Nombre de dominio de destino para este registro SRV.
weight	integer (int32)	Valor de peso de este registro SRV.

TxtRecord

Object

Un registro TXT.

Nombre	Tipo	Description
value	string[]	Valor de texto de este registro TXT.

Compartir a través de

Record Sets - Update

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Ejemplos

PATCH Private DNS Zone A Record Set

Solicitud de ejemplo

Respuesta de muestra

PATCH Private DNS Zone AAAA Record Set

Solicitud de ejemplo

Respuesta de muestra

PATCH Private DNS Zone CNAME Record Set

Solicitud de ejemplo

Respuesta de muestra

PATCH Private DNS Zone MX Record Set

Solicitud de ejemplo

Respuesta de muestra

PATCH Private DNS Zone PTR Record Set

Solicitud de ejemplo

Respuesta de muestra

PATCH Private DNS Zone SOA Record Set

Solicitud de ejemplo

Respuesta de muestra

PATCH Private DNS Zone SRV Record Set

Solicitud de ejemplo

Respuesta de muestra

PATCH Private DNS Zone TXT Record Set

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord