Record Sets - Update

Service:: DNS

Version d'API:: 2018-09-01

Met à jour un jeu d’enregistrements dans une zone DNS privée.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
privateZoneName	path	True	string	Nom de la zone DNS privée (sans point de fin).
recordType	path	True	RecordType	Type d’enregistrement DNS dans ce jeu d’enregistrements.
relativeRecordSetName	path	True	string	Nom du jeu d’enregistrements, par rapport au nom de la zone.
resourceGroupName	path	True	string	Nom du groupe de ressources.
subscriptionId	path	True	string	Obtient les informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.
api-version	query	True	string	Version de l’API cliente.

En-tête de la demande

Nom	Obligatoire	Type	Description
If-Match		string	ETag du jeu d’enregistrements. Omettez cette valeur pour toujours remplacer le jeu d’enregistrements actif. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

Corps de la demande

Nom	Type	Description
etag	string	ETag du jeu d’enregistrements.
properties.aRecords	ARecord[]	Liste des enregistrements A dans le jeu d’enregistrements.
properties.aaaaRecords	AaaaRecord[]	Liste des enregistrements AAAA dans le jeu d’enregistrements.
properties.cnameRecord	CnameRecord	Enregistrement CNAME dans le jeu d’enregistrements.
properties.metadata	object	Métadonnées jointes au jeu d’enregistrements.
properties.mxRecords	MxRecord[]	Liste des enregistrements MX dans le jeu d’enregistrements.
properties.ptrRecords	PtrRecord[]	Liste des enregistrements PTR dans le jeu d’enregistrements.
properties.soaRecord	SoaRecord	Enregistrement SOA dans le jeu d’enregistrements.
properties.srvRecords	SrvRecord[]	Liste des enregistrements SRV dans le jeu d’enregistrements.
properties.ttl	integer (int64)	Durée de vie (durée de vie) des enregistrements dans le jeu d’enregistrements.
properties.txtRecords	TxtRecord[]	Liste des enregistrements TXT dans le jeu d’enregistrements.

Réponses

Nom	Type	Description
200 OK	RecordSet	Le jeu d’enregistrements a été mis à jour.
Other Status Codes	CloudError	Réponse par défaut. Elle sera désérialisée conformément à la définition d’erreur.

Exemples

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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
        ]
      }
    ]
  }
}

Définitions

Nom	Description
AaaaRecord	Enregistrement AAAA.
ARecord	Enregistrement A.
CloudError	Réponse d’erreur du service.
CloudErrorBody	Réponse d’erreur du service.
CnameRecord	Enregistrement CNAME.
MxRecord	Enregistrement MX.
PtrRecord	Enregistrement PTR.
RecordSet	Décrit un jeu d’enregistrements DNS (collection d’enregistrements DNS portant le même nom et le même type) dans une zone DNS privée.
RecordType	Type d’enregistrement DNS dans ce jeu d’enregistrements.
SoaRecord	Enregistrement SOA.
SrvRecord	Enregistrement SRV.
TxtRecord	Enregistrement TXT.

AaaaRecord

Object

Enregistrement AAAA.

Nom	Type	Description
ipv6Address	string	Adresse IPv6 de cet enregistrement AAAA.

ARecord

Object

Enregistrement A.

Nom	Type	Description
ipv4Address	string	Adresse IPv4 de cet enregistrement A.

CloudError

Object

Réponse d’erreur du service.

Nom	Type	Description
error	CloudErrorBody	Corps de l’erreur cloud.

CloudErrorBody

Object

Réponse d’erreur du service.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details	CloudErrorBody[]	Liste des détails supplémentaires sur l’erreur.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target	string	Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

CnameRecord

Object

Enregistrement CNAME.

Nom	Type	Description
cname	string	Nom canonique de cet enregistrement CNAME.

MxRecord

Object

Enregistrement MX.

Nom	Type	Description
exchange	string	Nom de domaine de l’hôte de messagerie pour cet enregistrement MX.
preference	integer (int32)	Valeur de préférence pour cet enregistrement MX.

PtrRecord

Object

Enregistrement PTR.

Nom	Type	Description
ptrdname	string	Nom de domaine cible PTR pour cet enregistrement PTR.

RecordSet

Object

Décrit un jeu d’enregistrements DNS (collection d’enregistrements DNS portant le même nom et le même type) dans une zone DNS privée.

Nom	Type	Description
etag	string	ETag du jeu d’enregistrements.
id	string	ID du jeu d’enregistrements.
name	string	Nom du jeu d’enregistrements.
properties.aRecords	ARecord[]	Liste des enregistrements A dans le jeu d’enregistrements.
properties.aaaaRecords	AaaaRecord[]	Liste des enregistrements AAAA dans le jeu d’enregistrements.
properties.cnameRecord	CnameRecord	Enregistrement CNAME dans le jeu d’enregistrements.
properties.fqdn	string	Nom de domaine complet du jeu d’enregistrements.
properties.isAutoRegistered	boolean	Le jeu d’enregistrements est-il inscrit automatiquement dans la zone DNS privée via une liaison de réseau virtuel ?
properties.metadata	object	Métadonnées jointes au jeu d’enregistrements.
properties.mxRecords	MxRecord[]	Liste des enregistrements MX dans le jeu d’enregistrements.
properties.ptrRecords	PtrRecord[]	Liste des enregistrements PTR dans le jeu d’enregistrements.
properties.soaRecord	SoaRecord	Enregistrement SOA dans le jeu d’enregistrements.
properties.srvRecords	SrvRecord[]	Liste des enregistrements SRV dans le jeu d’enregistrements.
properties.ttl	integer (int64)	Durée de vie (durée de vie) des enregistrements dans le jeu d’enregistrements.
properties.txtRecords	TxtRecord[]	Liste des enregistrements TXT dans le jeu d’enregistrements.
type	string	Type du jeu d’enregistrements.

RecordType

Énumération

Type d’enregistrement DNS dans ce jeu d’enregistrements.

Valeur	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

Enregistrement SOA.

Nom	Type	Description
email	string	Contact électronique pour cet enregistrement SOA.
expireTime	integer (int64)	Heure d’expiration de cet enregistrement SOA.
host	string	Nom de domaine du serveur de noms faisant autorité pour cet enregistrement SOA.
minimumTtl	integer (int64)	Valeur minimale pour cet enregistrement SOA. Par convention, il est utilisé pour déterminer la durée de mise en cache négative.
refreshTime	integer (int64)	Valeur d’actualisation de cet enregistrement SOA.
retryTime	integer (int64)	Temps de nouvelle tentative pour cet enregistrement SOA.
serialNumber	integer (int64)	Numéro de série de cet enregistrement SOA.

SrvRecord

Object

Enregistrement SRV.

Nom	Type	Description
port	integer (int32)	Valeur de port pour cet enregistrement SRV.
priority	integer (int32)	Valeur de priorité pour cet enregistrement SRV.
target	string	Nom de domaine cible pour cet enregistrement SRV.
weight	integer (int32)	Valeur de poids pour cet enregistrement SRV.

TxtRecord

Object

Enregistrement TXT.

Nom	Type	Description
value	string[]	Valeur de texte de cet enregistrement TXT.

Partager via

Record Sets - Update

Paramètres URI

En-tête de la demande

Corps de la demande

Réponses

Exemples

PATCH Private DNS Zone A Record Set

Exemple de requête

Exemple de réponse

PATCH Private DNS Zone AAAA Record Set

Exemple de requête

Exemple de réponse

PATCH Private DNS Zone CNAME Record Set

Exemple de requête

Exemple de réponse

PATCH Private DNS Zone MX Record Set

Exemple de requête

Exemple de réponse

PATCH Private DNS Zone PTR Record Set

Exemple de requête

Exemple de réponse

PATCH Private DNS Zone SOA Record Set

Exemple de requête

Exemple de réponse

PATCH Private DNS Zone SRV Record Set

Exemple de requête

Exemple de réponse

PATCH Private DNS Zone TXT Record Set

Exemple de requête

Exemple de réponse

Définitions

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord