Firewall Rules - Create Or Update

Erstellt oder aktualisiert eine Firewallregel.

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

URI-Parameter

Name In Required Type Description
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

Der 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 Type Description
name
  • string

Name der Ressource.

properties.endIpAddress
  • string

Die End-IP-Adresse der Firewallregel. Muss das IPv4-Format aufweisen. Muss größer oder gleich startIpAddress sein. Verwenden Sie für alle internen Azure-IP-Adressen den Wert "0.0.0.0".

properties.startIpAddress
  • string

Die Start-IP-Adresse der Firewallregel. Muss das IPv4-Format aufweisen. Verwenden Sie für alle internen Azure-IP-Adressen den Wert "0.0.0.0".

Antworten

Name Type Description
200 OK

Die Firewallregel wurde erfolgreich aktualisiert.

201 Created

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 TooManyFirewallRules: Die bereitgestellten Firewallregeln überschreiten den Grenzwert.

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

  • 400 FirewallRuleInvalidRange: Der angegebene Firewallregelbereich ist ungültig.

  • 400 FirewallRuleNameTooLong: Der angegebene Firewallregelname ist zu lang.

  • 400 FirewallRuleNameEmpty: Der angegebene Firewallregelname ist leer.

  • 400 FirewallRuleNotIPv4Address: Die angegebene Firewallregeladresse ist nicht IPv4.

  • 404 SubscriptionDoesNotHaveServer : Der angeforderte Server wurde nicht gefunden.

  • 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

Beispiele

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

Create a firewall rule max/min

Sample Request

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-02-01-preview
{
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

Sample Response

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

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-02-01-preview
{
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

Sample Response

{
  "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"
  }
}
{
  "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 Type Description
id
  • string

Ressourcen-ID

name
  • string

Name der Ressource.

properties.endIpAddress
  • string

Die End-IP-Adresse der Firewallregel. Muss das IPv4-Format aufweisen. Muss größer oder gleich startIpAddress sein. Verwenden Sie für alle internen Azure-IP-Adressen den Wert "0.0.0.0".

properties.startIpAddress
  • string

Die Start-IP-Adresse der Firewallregel. Muss das IPv4-Format aufweisen. Verwenden Sie für alle internen Azure-IP-Adressen den Wert "0.0.0.0".

type
  • string

Der Ressourcentyp.