Freigeben über

IP Firewall ll Rules - Create Or Update

  • Referenz
Dienst:
SQL Database
API-Version:
2021-11-01

Erstellt oder aktualisiert eine IPv6-Firewallregel.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/ipv6FirewallRules/{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.endIPv6Address

string

Die End-IP-Adresse der Firewallregel. Muss im IPv6-Format vorliegen. Muss größer oder gleich startIpAddress sein.
properties.startIPv6Address

string

Die Start-IP-Adresse der Firewallregel. Muss im IPv6-Format vorliegen.

Antworten

Name Typ Beschreibung
200 OK

IPv6FirewallRule

Die IPv6-Firewallregel wurde erfolgreich aktualisiert.
201 Created

IPv6FirewallRule

Die IPv6-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 InvalidIPv6ServerFirewallRuleResourceRequest: Die Ressourcenanforderung für die IPv6-Serverfirewallregel ist ungültig.

  • 400 InvalidIPv6ServerFirewallRuleResourceParameters: Der Ressourcenparameter der IPv6-Serverfirewallregel ist ungültig.

  • 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 IPv6FirewallRuleNameEmpty: Der angegebene Name der IPv6-Firewallregel ist leer.

  • 400 FirewallRuleNotIPv6Address: Die angegebene Firewallregeladresse ist nicht IPv6.

  • 400 IPv6FirewallRuleNameTooLong: Der angegebene Name der IPv6-Firewallregel ist zu lang

  • 400 IPv6FirewallRuleInvalidRange: Der angegebene IPv6-Firewallregelbereich ist ungültig.

  • 400 TooManyIPv6FirewallRules: Die bereitgestellten IPv6-Firewallregeln überschreiten den Grenzwert.

  • 400 IPv6EndpointDisabled: Der IPv6-Endpunkt ist deaktiviert.

  • 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 an IPv6 firewall rule max/min
Update an IPv6 firewall rule max/min

Create an IPv6 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/ipv6FirewallRules/firewallrulecrudtest-5370?api-version=2021-11-01

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}
Statuscode:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Update an IPv6 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/ipv6FirewallRules/firewallrulecrudtest-3927?api-version=2021-11-01

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}
Statuscode:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

Definitionen

IPv6FirewallRule

Eine IPv6-Serverfirewallregel.

Name Typ Beschreibung
id

string

Ressourcen-ID
name

string

Name der Ressource.
properties.endIPv6Address

string

Die End-IP-Adresse der Firewallregel. Muss im IPv6-Format vorliegen. Muss größer oder gleich startIpAddress sein.
properties.startIPv6Address

string

Die Start-IP-Adresse der Firewallregel. Muss im IPv6-Format vorliegen.
type

string

Der Ressourcentyp.