Udostępnij za pośrednictwem


Firewall Rules - Create Or Update

Tworzy lub aktualizuje regułę zapory.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/firewallRules/{firewallRuleName}?api-version=2023-08-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 usługi Azure Resource Manager 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 mieć format IPv4. Wartość musi być większa lub równa wartości 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 mieć format 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

ErrorResponse

Odpowiedzi na błędy: ***

  • 400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania

  • 400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym

  • 400 InvalidResourceId — nieprawidłowy identyfikator zasobu.

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

  • 400 NiezgodnośćResourceGroupNameWithUrl — 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 adresem IPv4

  • 400 TooManyFirewallRules — podane reguły zapory przekracza 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 dla serwera jest wyłączony. Aby zarządzać regułami zapory na poziomie serwera lub bazy danych, włącz publiczny interfejs sieciowy.

  • 400 FirewallRuleNameInvalid — podana nazwa reguły zapory zawiera znaki specjalne.

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

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, 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.

  • 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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Nazwa Opis
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

FirewallRule

Reguła zapory serwera.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

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 mieć format IPv4. Wartość musi być większa lub równa wartości 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 mieć format IPv4. Użyj wartości "0.0.0.0.0" dla wszystkich wewnętrznych adresów IP platformy Azure.

type

string

Typ zasobu.