Sdílet prostřednictvím


Firewall Rules - Create Or Update

Vytvoří nebo aktualizuje pravidlo brány firewall.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
firewallRuleName
path True

string

Název pravidla brány firewall.

resourceGroupName
path True

string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.

serverName
path True

string

Název serveru.

subscriptionId
path True

string

ID předplatného, které identifikuje předplatné Azure.

api-version
query True

string

Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name Typ Description
name

string

Název prostředku.

properties.endIpAddress

string

Koncová IP adresa pravidla brány firewall. Musí mít formát IPv4. Musí být větší než nebo rovno startIpAddress. Pro všechny interní IP adresy Azure použijte hodnotu 0.0.0.0.

properties.startIpAddress

string

Počáteční IP adresa pravidla brány firewall. Musí mít formát IPv4. Pro všechny interní IP adresy Azure použijte hodnotu 0.0.0.0.

Odpovědi

Name Typ Description
200 OK

FirewallRule

Pravidlo brány firewall se úspěšně aktualizovalo.

201 Created

FirewallRule

Pravidlo brány firewall se úspěšně vytvořilo.

Other Status Codes

Chybové odpovědi: ***

  • 400 InvalidResourceId – neplatný identifikátor prostředku.

  • 400 MismatchingSubscriptionWithUrl – zadané předplatné neodpovídá předplatnému v adrese URL.

  • 400 MismatchingResourceGroupNameWithUrl – Zadaný název skupiny prostředků neodpovídá názvu v adrese URL.

  • 400 MismatchingServerNameWithUrl – zadaný název serveru neodpovídá názvu v adrese URL.

  • 400 InvalidServerFirewallRuleResourceRequest – požadavek na prostředek pravidla brány firewall serveru je neplatný.

  • 400 InvalidServerFirewallRuleResourceParameters – parametr prostředku pravidla brány firewall serveru je neplatný.

  • 400 FirewallRuleNotIPv4Address – zadaná adresa pravidla brány firewall není IPv4.

  • 400 TooManyFirewallRules – zadaná pravidla firewallu překročila limit.

  • 400 FirewallRuleInvalidRange – zadaný rozsah pravidel brány firewall je neplatný.

  • 400 FirewallRuleNameTooLong – zadaný název pravidla brány firewall je příliš dlouhý.

  • 400 FirewallRuleNameEmpty – zadaný název pravidla brány firewall je prázdný.

  • 400 DenyPublicEndpointEnabled – Nejde vytvořit nebo upravit pravidla brány firewall, pokud je veřejné síťové rozhraní pro server zakázané. Pokud chcete spravovat pravidla brány firewall na úrovni serveru nebo databáze, povolte veřejné síťové rozhraní.

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel.

  • 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje.

  • 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

  • 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

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

Create a firewall rule max/min

Ukázkový požadavek

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

Ukázková odpověď

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

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

FirewallRule

Pravidlo brány firewall serveru.

Name Typ Description
id

string

ID prostředku.

name

string

Název prostředku.

properties.endIpAddress

string

Koncová IP adresa pravidla brány firewall. Musí mít formát IPv4. Musí být větší než nebo rovno startIpAddress. Pro všechny interní IP adresy Azure použijte hodnotu 0.0.0.0.

properties.startIpAddress

string

Počáteční IP adresa pravidla brány firewall. Musí mít formát IPv4. Pro všechny interní IP adresy Azure použijte hodnotu 0.0.0.0.

type

string

Typ prostředku.