Firewall Rules - Create Or Update

Referenz

Service:: SQL Database

API Version:: 2021-11-01

Erstellt oder aktualisiert eine Firewallregel.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
firewallRuleName	path	True	string	Der Name der Firewallregel.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
name	string	Name der Ressource.
properties.endIpAddress	string	Die End-IP-Adresse der Firewallregel. Muss im IPv4-Format vorliegen. Muss größer oder gleich startIpAddress sein. Verwenden Sie den Wert "0.0.0.0" für alle internen Azure-IP-Adressen.
properties.startIpAddress	string	Die Start-IP-Adresse der Firewallregel. Muss im IPv4-Format vorliegen. Verwenden Sie den Wert "0.0.0.0" für alle internen Azure-IP-Adressen.

Antworten

Name	Typ	Beschreibung
200 OK	FirewallRule	Die Firewallregel wurde erfolgreich aktualisiert.
201 Created	FirewallRule	Die Firewallregel wurde erfolgreich erstellt.
Other Status Codes		Fehlerantworten: *** 400 InvalidResourceId: Ungültiger Ressourcenbezeichner. 400 MismatchingSubscriptionWithUrl: Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein. 400 MismatchingResourceGroupNameWithUrl: Der angegebene Ressourcengruppenname stimmte nicht mit dem Namen in der URL überein. 400 MismatchingServerNameWithUrl: Der angegebene Servername stimmte nicht mit dem Namen in der URL überein. 400 InvalidServerFirewallRuleResourceRequest: Die Ressourcenanforderung der Serverfirewallregel ist ungültig. 400 InvalidServerFirewallRuleResourceParameters: Der Ressourcenparameter der Serverfirewallregel ist ungültig. 400 FirewallRuleNotIPv4Address: Die angegebene Firewallregeladresse ist nicht IPv4. 400 TooManyFirewallRules: Die bereitgestellten Firewallregeln überschreiten den Grenzwert. 400 FirewallRuleInvalidRange: Der angegebene Firewallregelbereich ist ungültig. 400 FirewallRuleNameTooLong: Der name der angegebenen Firewallregel ist zu lang. 400 FirewallRuleNameEmpty : Der name der angegebenen Firewallregel ist leer. 400 DenyPublicEndpointEnabled: Firewallregeln können nicht erstellt oder geändert werden, wenn die öffentliche Netzwerkschnittstelle für den Server deaktiviert ist. Um Firewallregeln auf Server- oder Datenbankebene zu verwalten, aktivieren Sie die öffentliche Netzwerkschnittstelle. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Name

Typ

Beschreibung

200 OK

FirewallRule

Die Firewallregel wurde erfolgreich aktualisiert.

201 Created

FirewallRule

Die Firewallregel wurde erfolgreich erstellt.

Other Status Codes

Fehlerantworten: ***

400 InvalidResourceId: Ungültiger Ressourcenbezeichner.
400 MismatchingSubscriptionWithUrl: Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein.
400 MismatchingResourceGroupNameWithUrl: Der angegebene Ressourcengruppenname stimmte nicht mit dem Namen in der URL überein.
400 MismatchingServerNameWithUrl: Der angegebene Servername stimmte nicht mit dem Namen in der URL überein.
400 InvalidServerFirewallRuleResourceRequest: Die Ressourcenanforderung der Serverfirewallregel ist ungültig.
400 InvalidServerFirewallRuleResourceParameters: Der Ressourcenparameter der Serverfirewallregel ist ungültig.
400 FirewallRuleNotIPv4Address: Die angegebene Firewallregeladresse ist nicht IPv4.
400 TooManyFirewallRules: Die bereitgestellten Firewallregeln überschreiten den Grenzwert.
400 FirewallRuleInvalidRange: Der angegebene Firewallregelbereich ist ungültig.
400 FirewallRuleNameTooLong: Der name der angegebenen Firewallregel ist zu lang.
400 FirewallRuleNameEmpty : Der name der angegebenen Firewallregel ist leer.
400 DenyPublicEndpointEnabled: Firewallregeln können nicht erstellt oder geändert werden, wenn die öffentliche Netzwerkschnittstelle für den Server deaktiviert ist. Um Firewallregeln auf Server- oder Datenbankebene zu verwalten, aktivieren Sie die öffentliche Netzwerkschnittstelle.
404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden.
404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.
429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.
429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.
503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Create a firewall rule max/min

Update a firewall rule max/min

Create a firewall rule max/min

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


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
Java

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


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

Definitionen

FirewallRule

Eine Serverfirewallregel.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.endIpAddress	string	Die End-IP-Adresse der Firewallregel. Muss im IPv4-Format vorliegen. Muss größer oder gleich startIpAddress sein. Verwenden Sie den Wert "0.0.0.0" für alle internen Azure-IP-Adressen.
properties.startIpAddress	string	Die Start-IP-Adresse der Firewallregel. Muss im IPv4-Format vorliegen. Verwenden Sie den Wert "0.0.0.0" für alle internen Azure-IP-Adressen.
type	string	Der Ressourcentyp.

Firewall Rules - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Beispiele

Create a firewall rule max/min

Sample Request

Sample Response

Update a firewall rule max/min

Sample Request

Sample Response

Definitionen

FirewallRule

Zusätzliche Ressourcen