Freigeben über

Firewall Rules - Create Or Update

  • Referenz
Dienst:
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.

Beispiele

Create a firewall rule max/min
Update a firewall rule max/min

Create a firewall rule max/min

Beispielanforderung

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

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

Beispielanforderung

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

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-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}
Statuscode:
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.