Record Sets - Update

Служба:: DNS

Версия API:: 2018-09-01

Обновляет набор записей в частной зоне DNS.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
privateZoneName	path	True	string	Имя частной зоны DNS (без конечной точки).
recordType	path	True	RecordType	Тип записи DNS в этом наборе записей.
relativeRecordSetName	path	True	string	Имя набора записей относительно имени зоны.
resourceGroupName	path	True	string	Имя группы ресурсов.
subscriptionId	path	True	string	Получает учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.
api-version	query	True	string	Версия клиентского API.

Заголовок запроса

Имя	Обязательно	Тип	Описание
If-Match		string	ETag набора записей. Опустите это значение, чтобы всегда перезаписать текущий набор записей. Укажите последнее значение ETag, чтобы предотвратить случайное перезапись одновременных изменений.

Текст запроса

Имя	Тип	Описание
etag	string	ETag набора записей.
properties.aRecords	ARecord[]	Список записей A в наборе записей.
properties.aaaaRecords	AaaaRecord[]	Список записей AAAA в наборе записей.
properties.cnameRecord	CnameRecord	Запись CNAME в наборе записей.
properties.metadata	object	Метаданные, подключенные к набору записей.
properties.mxRecords	MxRecord[]	Список записей MX в наборе записей.
properties.ptrRecords	PtrRecord[]	Список записей PTR в наборе записей.
properties.soaRecord	SoaRecord	Запись SOA в наборе записей.
properties.srvRecords	SrvRecord[]	Список записей SRV в наборе записей.
properties.ttl	integer (int64)	TTL (время в реальном времени) записей в наборе записей.
properties.txtRecords	TxtRecord[]	Список записей TXT в наборе записей.

Ответы

Имя	Тип	Описание
200 OK	RecordSet	Набор записей обновлен.
Other Status Codes	CloudError	Ответ по умолчанию. Она будет десериализирована согласно определению ошибки.

Примеры

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

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
        ]
      }
    ]
  }
}

Определения

Имя	Описание
AaaaRecord	Запись AAAA.
ARecord	Запись A.
CloudError	Ответ на ошибку службы.
CloudErrorBody	Ответ на ошибку службы.
CnameRecord	Запись CNAME.
MxRecord	Запись MX.
PtrRecord	Запись PTR.
RecordSet	Описывает набор записей DNS (коллекцию записей DNS с тем же именем и типом) в частной зоне DNS.
RecordType	Тип записи DNS в этом наборе записей.
SoaRecord	Запись SOA.
SrvRecord	Запись SRV.
TxtRecord	Запись TXT.

AaaaRecord

Object

Запись AAAA.

Имя	Тип	Описание
ipv6Address	string	IPv6-адрес этой записи AAAA.

ARecord

Object

Запись A.

Имя	Тип	Описание
ipv4Address	string	Адрес IPv4 этой записи A.

CloudError

Object

Ответ на ошибку службы.

Имя	Тип	Описание
error	CloudErrorBody	Текст ошибки облака.

CloudErrorBody

Object

Ответ на ошибку службы.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

CnameRecord

Object

Запись CNAME.

Имя	Тип	Описание
cname	string	Каноническое имя этой записи CNAME.

MxRecord

Object

Запись MX.

Имя	Тип	Описание
exchange	string	Доменное имя узла почты для этой записи MX.
preference	integer (int32)	Значение предпочтения для этой записи MX.

PtrRecord

Object

Запись PTR.

Имя	Тип	Описание
ptrdname	string	Целевое доменное имя PTR для этой записи PTR.

RecordSet

Object

Описывает набор записей DNS (коллекцию записей DNS с тем же именем и типом) в частной зоне DNS.

Имя	Тип	Описание
etag	string	ETag набора записей.
id	string	Идентификатор набора записей.
name	string	Имя набора записей.
properties.aRecords	ARecord[]	Список записей A в наборе записей.
properties.aaaaRecords	AaaaRecord[]	Список записей AAAA в наборе записей.
properties.cnameRecord	CnameRecord	Запись CNAME в наборе записей.
properties.fqdn	string	Полное доменное имя набора записей.
properties.isAutoRegistered	boolean	Автоматически ли зарегистрирован набор записей в частной зоне DNS через ссылку виртуальной сети?
properties.metadata	object	Метаданные, подключенные к набору записей.
properties.mxRecords	MxRecord[]	Список записей MX в наборе записей.
properties.ptrRecords	PtrRecord[]	Список записей PTR в наборе записей.
properties.soaRecord	SoaRecord	Запись SOA в наборе записей.
properties.srvRecords	SrvRecord[]	Список записей SRV в наборе записей.
properties.ttl	integer (int64)	TTL (время в реальном времени) записей в наборе записей.
properties.txtRecords	TxtRecord[]	Список записей TXT в наборе записей.
type	string	Тип набора записей.

RecordType

Перечисление

Тип записи DNS в этом наборе записей.

Значение	Описание
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

Запись SOA.

Имя	Тип	Описание
email	string	Контакт электронной почты для этой записи SOA.
expireTime	integer (int64)	Срок действия этой записи SOA.
host	string	Доменное имя доверенного сервера имен для этой записи SOA.
minimumTtl	integer (int64)	Минимальное значение для этой записи SOA. По соглашению используется для определения отрицательной длительности кэширования.
refreshTime	integer (int64)	Значение обновления для этой записи SOA.
retryTime	integer (int64)	Время повтора для этой записи SOA.
serialNumber	integer (int64)	Серийный номер для этой записи SOA.

SrvRecord

Object

Запись SRV.

Имя	Тип	Описание
port	integer (int32)	Значение порта для этой записи SRV.
priority	integer (int32)	Значение приоритета для этой записи SRV.
target	string	Целевое доменное имя для этой записи SRV.
weight	integer (int32)	Значение веса для этой записи SRV.

TxtRecord

Object

Запись TXT.

Имя	Тип	Описание
value	string[]	Текстовое значение этой записи TXT.

Поделиться через

Record Sets - Update

Параметры URI

Заголовок запроса

Текст запроса

Ответы

Примеры

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

Образец запроса

Пример ответа

Определения

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord