Share via

Firewall Rules - Replace

  • Referenz
Service:
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

Sample Request

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

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:
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.