Firewall Rules - Create Or Update

Ссылка

Служба:: SQL Database

Версия API:: 2023-08-01

Создает или обновляет правило брандмауэра.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/firewallRules/{firewallRuleName}?api-version=2023-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
firewallRuleName	path	True	string	Имя правила брандмауэра.
resourceGroupName	path	True	string	Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки, идентифицирующий подписку Azure.
api-version	query	True	string	Версия API, используемая для запроса.

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

Имя	Тип	Описание
name	string	Имя ресурса.
properties.endIpAddress	string	Конечный IP-адрес правила брандмауэра. Должен быть форматом IPv4. Должно быть больше или равно startIpAddress. Используйте значение 0.0.0.0 для всех ВНУТРЕННИх IP-адресов Azure.
properties.startIpAddress	string	Начальный IP-адрес правила брандмауэра. Должен быть форматом IPv4. Используйте значение 0.0.0.0 для всех ВНУТРЕННИх IP-адресов Azure.

Ответы

Имя	Тип	Описание
200 OK	FirewallRule	Успешно обновлено правило брандмауэра.
201 Created	FirewallRule	Успешно создано правило брандмауэра.
Other Status Codes	ErrorResponse	Ответы на ошибки: *** 400 ManagedInstanceStoppingOrStoppingOrStopped — конфликтующая операция, отправленная во время остановки или остановки экземпляра 400 ManagedInstanceStarting — конфликтующая операция, отправленная во время запуска экземпляра 400 InvalidResourceId — недопустимый идентификатор ресурса. 400 НесоответствиеSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе. 400 MismatchingResourceGroupNameWithUrl — предоставленное имя группы ресурсов не совпадает с именем в URL-адресе. 400 MismatchingServerNameWithUrl — предоставленное имя сервера не совпадает с именем в URL-адресе. 400 InvalidServerFirewallRuleResourceRequest — недопустимый запрос ресурса правила брандмауэра сервера. 400 InvalidServerFirewallRuleResourceParameters — недопустимый параметр правила брандмауэра сервера. 400 FirewallRuleNotIPv4Address — указанный адрес правила брандмауэра не является IPv4 400 TooManyFirewallRules — предоставленные правила брандмауэра превышены. 400 FirewallRuleInvalidRange — указанный диапазон правил брандмауэра недопустим. 400 FirewallRuleNameTooLong — предоставленное имя правила брандмауэра слишком длинное 400 FirewallRuleNameEmpty — предоставленное имя правила брандмауэра пусто 400 DenyPublicEndpointEnabled — не удается создать или изменить правила брандмауэра при отключении общедоступного сетевого интерфейса для сервера. Чтобы управлять правилами брандмауэра уровня сервера или базы данных, включите общедоступный сетевой интерфейс. 400 FirewallRuleNameInvalid — предоставленное имя правила брандмауэра содержит специальные символы. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Имя

Тип

Описание

200 OK

FirewallRule

Успешно обновлено правило брандмауэра.

201 Created

FirewallRule

Успешно создано правило брандмауэра.

Other Status Codes

ErrorResponse

Ответы на ошибки: ***

400 ManagedInstanceStoppingOrStoppingOrStopped — конфликтующая операция, отправленная во время остановки или остановки экземпляра
400 ManagedInstanceStarting — конфликтующая операция, отправленная во время запуска экземпляра
400 InvalidResourceId — недопустимый идентификатор ресурса.
400 НесоответствиеSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе.
400 MismatchingResourceGroupNameWithUrl — предоставленное имя группы ресурсов не совпадает с именем в URL-адресе.
400 MismatchingServerNameWithUrl — предоставленное имя сервера не совпадает с именем в URL-адресе.
400 InvalidServerFirewallRuleResourceRequest — недопустимый запрос ресурса правила брандмауэра сервера.
400 InvalidServerFirewallRuleResourceParameters — недопустимый параметр правила брандмауэра сервера.
400 FirewallRuleNotIPv4Address — указанный адрес правила брандмауэра не является IPv4
400 TooManyFirewallRules — предоставленные правила брандмауэра превышены.
400 FirewallRuleInvalidRange — указанный диапазон правил брандмауэра недопустим.
400 FirewallRuleNameTooLong — предоставленное имя правила брандмауэра слишком длинное
400 FirewallRuleNameEmpty — предоставленное имя правила брандмауэра пусто
400 DenyPublicEndpointEnabled — не удается создать или изменить правила брандмауэра при отключении общедоступного сетевого интерфейса для сервера. Чтобы управлять правилами брандмауэра уровня сервера или базы данных, включите общедоступный сетевой интерфейс.
400 FirewallRuleNameInvalid — предоставленное имя правила брандмауэра содержит специальные символы.
404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден
429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.
503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Примеры

Create a firewall rule max/min

Update a firewall rule max/min

Create a firewall rule max/min

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

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370?api-version=2023-08-01

{
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

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

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

Update a firewall rule max/min

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

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927?api-version=2023-08-01

{
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

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

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
FirewallRule	Правило брандмауэра сервера.

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

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

FirewallRule

Object

Правило брандмауэра сервера.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.endIpAddress	string	Конечный IP-адрес правила брандмауэра. Должен быть форматом IPv4. Должно быть больше или равно startIpAddress. Используйте значение 0.0.0.0 для всех ВНУТРЕННИх IP-адресов Azure.
properties.startIpAddress	string	Начальный IP-адрес правила брандмауэра. Должен быть форматом IPv4. Используйте значение 0.0.0.0 для всех ВНУТРЕННИх IP-адресов Azure.
type	string	Тип ресурса.

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

Firewall Rules - Create Or Update

Параметры URI

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

Ответы

Примеры

Create a firewall rule max/min

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

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

Update a firewall rule max/min

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

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

Определения

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FirewallRule

Дополнительные ресурсы