Private Zones - Update

Служба:

DNS

Версия API:

2018-09-01

Обновления зону Частная зона DNS. Не изменяет каналы виртуальной сети или записи DNS в пределах зоны.

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

Параметры URI

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

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

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

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

Имя	Тип	Описание
etag	string	ETag зоны.
location	string	Регион Azure, в котором находится ресурс
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	PrivateZone	Зона Частная зона DNS обновлена.
202 Accepted		Операция обновления зоны Частная зона DNS была принята и будет завершена асинхронно.
Other Status Codes	CloudError	Ответ по умолчанию. Он будет десериализоваться согласно определению Error.

Примеры

PATCH Private DNS Zone

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

HTTP

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

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

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

Код состояния:

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

Код состояния:

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

Определения

Имя	Описание
CloudError	Ответ об ошибке от службы.
CloudErrorBody	Ответ об ошибке от службы.
PrivateZone	Описывает зону Частная зона DNS.
ProvisioningState	Состояние подготовки ресурса. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.

CloudError

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

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

CloudErrorBody

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

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

PrivateZone

Описывает зону Частная зона DNS.

Имя	Тип	Описание
etag	string	ETag зоны.
id	string	Полный идентификатор ресурса для ресурса. Пример — "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}".
location	string	Регион Azure, в котором находится ресурс
name	string	Имя ресурса.
properties.maxNumberOfRecordSets	integer	Максимальное количество наборов записей, которые можно создать в этой Частная зона DNS зоне. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.
properties.maxNumberOfVirtualNetworkLinks	integer	Максимальное количество виртуальных сетей, которые можно связать с этой Частная зона DNS зоне. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer	Максимальное количество виртуальных сетей, которые можно связать с этой Частная зона DNS зоне с включенной регистрацией. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.
properties.numberOfRecordSets	integer	Текущее количество наборов записей в этой Частная зона DNS зоне. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.
properties.numberOfVirtualNetworkLinks	integer	Текущее количество виртуальных сетей, связанных с этой зоной Частная зона DNS. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.
properties.numberOfVirtualNetworkLinksWithRegistration	integer	Текущее количество виртуальных сетей, связанных с этой Частная зона DNS зоне с включенной регистрацией. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.
properties.provisioningState	ProvisioningState	Состояние подготовки ресурса. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Пример — Microsoft.Network/privateDnsZones.

ProvisioningState

Состояние подготовки ресурса. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.

Имя	Тип	Описание
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string