Firewall Rules - Create Or Update

Service:

SQL Database

API Version:

2021-11-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=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

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleCreate.json
     */
    /**
     * Sample code: Create a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-5370",
            new FirewallRuleInner().withStartIpAddress("0.0.0.3").withEndIpAddress("0.0.0.3"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

HTTP

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleUpdate.json
     */
    /**
     * Sample code: Update a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-3927",
            new FirewallRuleInner().withStartIpAddress("0.0.0.1").withEndIpAddress("0.0.0.1"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

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.