Firewall Rules - Create Or Update

  • Odwołanie
Service:
SQL Database
API Version:
2021-11-01

Tworzy lub aktualizuje regułę zapory.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
firewallRuleName
 path True

string

Nazwa reguły zapory.
resourceGroupName
 path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
serverName
 path True

string

Nazwa serwera.
subscriptionId
 path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version
 query True

string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa Typ Opis
name

string

Nazwa zasobu.
properties.endIpAddress

string

Końcowy adres IP reguły zapory. Musi być formatem IPv4. Musi być większa lub równa startIpAddress. Użyj wartości "0.0.0.0".0" dla wszystkich wewnętrznych adresów IP platformy Azure.
properties.startIpAddress

string

Początkowy adres IP reguły zapory. Musi być formatem IPv4. Użyj wartości "0.0.0.0".0" dla wszystkich wewnętrznych adresów IP platformy Azure.

Odpowiedzi

Nazwa Typ Opis
200 OK

FirewallRule

Pomyślnie zaktualizowano regułę zapory.
201 Created

FirewallRule

Pomyślnie utworzono regułę zapory.
Other Status Codes

Odpowiedzi na błędy: ***

  • 400 InvalidResourceId — nieprawidłowy identyfikator zasobu.

  • 400 NiezgodnośćSubscriptionWithUrl — podana subskrypcja nie jest zgodna z subskrypcją w adresie URL.

  • 400 MismatchingResourceGroupNameWithUrl — podana nazwa grupy zasobów nie jest zgodna z nazwą w adresie URL.

  • 400 NiezgodnośćServerNameWithUrl — podana nazwa serwera nie jest zgodna z nazwą w adresie URL.

  • 400 InvalidServerFirewallRuleResourceRequest — żądanie zasobu reguły zapory serwera jest nieprawidłowe.

  • 400 InvalidServerFirewallRuleResourceParameters — parametr zasobu reguły zapory serwera jest nieprawidłowy.

  • 400 FirewallRuleNotIPv4Address — podany adres reguły zapory nie jest IPv4

  • 400 TooManyFirewallRules — podane reguły zapory przekraczają limit.

  • 400 FirewallRuleInvalidRange — określony zakres reguł zapory jest nieprawidłowy.

  • 400 FirewallRuleNameTooLong — podana nazwa reguły zapory jest za długa

  • 400 FirewallRuleNameEmpty — podana nazwa reguły zapory jest pusta

  • 400 DenyPublicEndpointEnabled — nie można utworzyć lub zmodyfikować reguł zapory, gdy publiczny interfejs sieciowy serwera jest wyłączony. Aby zarządzać regułami zapory na poziomie serwera lub bazy danych, włącz publiczny interfejs sieciowy.

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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

Definicje

FirewallRule

Reguła zapory serwera.

Nazwa Typ Opis
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu.
properties.endIpAddress

string

Końcowy adres IP reguły zapory. Musi być formatem IPv4. Musi być większa lub równa startIpAddress. Użyj wartości "0.0.0.0".0" dla wszystkich wewnętrznych adresów IP platformy Azure.
properties.startIpAddress

string

Początkowy adres IP reguły zapory. Musi być formatem IPv4. Użyj wartości "0.0.0.0".0" dla wszystkich wewnętrznych adresów IP platformy Azure.
type

string

Typ zasobu.