Sdílet prostřednictvím

Firewall Rules - Create Or Update

  • Reference
Služba:
SQL Database
Verze rozhraní API:
2023-08-01

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=2023-08-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á obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo 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í to bý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í to bý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 bylo úspěšně aktualizováno.
201 Created

FirewallRule

Úspěšně se vytvořilo pravidlo brány firewall.
Other Status Codes

ErrorResponse

Chybové odpovědi: ***

  • 400 ManagedInstanceStoppingOrStopped – Konfliktní operace odeslaná, když je instance v zastaveném nebo zastaveném stavu

  • 400 ManagedInstanceStarting – Konfliktní operace odeslaná při spuštění instance

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

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

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

  • 400 NeshodaServerNameWithUrl – 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 brány firewall 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 – Nelze vytvořit nebo upravit pravidla brány firewall při zakázání veřejného síťového rozhraní pro server. Pokud chcete spravovat pravidla brány firewall na úrovni serveru nebo databáze, povolte veřejné síťové rozhraní.

  • 400 FirewallRuleNameInvalid – zadaný název pravidla brány firewall obsahuje speciální znaky.

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

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

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

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

  • 503 TooManyRequests – Požadavky nad rámec maximálních 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=2023-08-01

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

Ukázková odpověď

Stavový kód:
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"
  }
}
Stavový kód:
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

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=2023-08-01

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

Ukázková odpověď

Stavový kód:
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"
  }
}
Stavový kód:
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"
  }
}

Definice

Name Description
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě.
ErrorResponse

Chybová odpověď
FirewallRule

Pravidlo brány firewall serveru.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.
code

string

Kód chyby.
details

ErrorDetail[]

Podrobnosti o chybě.
message

string

Chybová zpráva.
target

string

Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

FirewallRule

Objekt

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í to bý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í to být formát IPv4. Pro všechny INTERNÍ IP adresy Azure použijte hodnotu 0.0.0.0.
type

string

Typ prostředku.