Udostępnij za pośrednictwem

Firewall Rules - Replace

  • Odwołanie
Usługa:
SQL Database
Wersja interfejsu API:
2021-11-01

Zastępuje wszystkie reguły zapory na serwerze.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
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
values

FirewallRule[]

Reguła zapory serwera.

Odpowiedzi

Nazwa Typ Opis
200 OK

FirewallRule

Pomyślnie zaktualizowano reguły zapory.
202 Accepted

Tworzenie lub aktualizowanie reguł zapory serwera jest w toku.
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.

  • 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.

  • 409 OperationCancelled — operacja została anulowana przez użytkownika.

  • 409 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.

  • 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.

  • 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.

  • 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji.

  • 503 TooManyRequests — żą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

Replace firewall rules

Przykładowe żądanie

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

{
  "values": [
    {
      "name": "firewallrulecrudtest-5370 ",
      "properties": {
        "startIpAddress": "0.0.0.0",
        "endIpAddress": "100.0.0.0"
      }
    }
  ]
}

Przykładowa odpowiedź

Kod stanu:
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"
  }
}
Kod stanu:
202

Definicje

Nazwa Opis
FirewallRule

Reguła zapory serwera.
FirewallRuleList

Lista reguł zapory serwera.

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.

FirewallRuleList

Lista reguł zapory serwera.

Nazwa Typ Opis
values

FirewallRule[]

Reguła zapory serwera.