Firewall Rules - Replace

Dienst:

SQL Database

API-Version:

2021-11-01

Ersetzt alle Firewallregeln auf dem Server.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
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
values	FirewallRule[]	Eine Serverfirewallregel.

Antworten

Name	Typ	Beschreibung
200 OK	FirewallRule	Die Firewallregeln wurden erfolgreich aktualisiert.
202 Accepted		Das Erstellen oder Aktualisieren der Serverfirewallregeln wird ausgeführt.
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. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 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. 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. 500 OperationTimedOut: Timeout des Vorgangs und automatisches Rollback. Wiederholen Sie den Vorgang. 503 TooManyRequests: 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

Replace firewall rules

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules?api-version=2021-11-01

{
  "values": [
    {
      "name": "firewallrulecrudtest-5370 ",
      "properties": {
        "startIpAddress": "0.0.0.0",
        "endIpAddress": "100.0.0.0"
      }
    }
  ]
}

Java

import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;
import com.azure.resourcemanager.sql.models.FirewallRuleList;
import java.util.Arrays;

/**
 * Samples for FirewallRules Replace.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleReplace.json
     */
    /**
     * Sample code: Replace firewall rules.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void replaceFirewallRules(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().replaceWithResponse("firewallrulecrudtest-12",
            "firewallrulecrudtest-6285",
            new FirewallRuleList().withValues(Arrays.asList(new FirewallRuleInner()
                .withName("firewallrulecrudtest-5370 ").withStartIpAddress("0.0.0.0").withEndIpAddress("100.0.0.0"))),
            com.azure.core.util.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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

202

Definitionen

Name	Beschreibung
FirewallRule	Eine Serverfirewallregel.
FirewallRuleList	Eine Liste der Serverfirewallregeln.

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.

FirewallRuleList

Eine Liste der Serverfirewallregeln.

Name	Typ	Beschreibung
values	FirewallRule[]	Eine Serverfirewallregel.