Firewall Rules - Create Or Update

  • Ссылка
Service:
SQL Database
API Version:
2021-11-01

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

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

Параметры URI

Имя В Обязательно Тип Описание
firewallRuleName
 path True

string

Имя правила брандмауэра.
resourceGroupName
 path True

string

Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
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

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

  • 400 InvalidResourceId — недопустимый идентификатор ресурса.

  • 400 MismatchingSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе.

  • 400 MismatchingResourceGroupNameWithUrl — предоставленное имя группы ресурсов не совпадает с именем в URL-адресе.

  • 400 MismatchingServerNameWithUrl — предоставленное имя сервера не совпадает с именем в URL-адресе.

  • 400 InvalidServerFirewallRuleResourceRequest — недопустимый запрос ресурса правила брандмауэра сервера.

  • 400 InvalidServerFirewallRuleResourceParameters — недопустимый параметр ресурса правила брандмауэра сервера.

  • 400 FirewallRuleNotIPv4Address — указанный адрес правила брандмауэра не является IPv4

  • 400 TooManyFirewallRules — предоставленные правила брандмауэра превышены.

  • 400 FirewallRuleInvalidRange — указанный диапазон правил брандмауэра недопустим.

  • 400 FirewallRuleNameTooLong — слишком длинное имя предоставленного правила брандмауэра

  • 400 FirewallRuleNameEmpty — предоставленное имя правила брандмауэра пустое.

  • 400 DenyPublicEndpointEnabled — не удается создать или изменить правила брандмауэра, если общедоступный сетевой интерфейс для сервера отключен. Чтобы управлять правилами брандмауэра на уровне сервера или базы данных, включите общедоступный сетевой интерфейс.

  • 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден

  • 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

  • 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами.

  • 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

  • 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Create a firewall rule max/min
Update a firewall rule max/min

Create a firewall rule max/min

Sample Request

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=2021-11-01

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

Sample Response

Status code:
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"
  }
}
Status code:
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

Sample Request

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=2021-11-01

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

Sample Response

Status code:
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"
  }
}
Status code:
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"
  }
}

Определения

FirewallRule

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

Имя Тип Описание
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

Тип ресурса.