Delen via

Firewall Rules - Create Or Update

  • Referentie
Service:
SQL Database
API-versie:
2021-11-01

Hiermee maakt of werkt u een firewallregel bij.

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

URI-parameters

Name In Vereist Type Description
firewallRuleName
 path True

string

De naam van de firewallregel.
resourceGroupName
 path True

string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName
 path True

string

De naam van de server.
subscriptionId
 path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version
 query True

string

De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name Type Description
name

string

Resourcenaam.
properties.endIpAddress

string

Het eind-IP-adres van de firewallregel. Moet de IPv4-indeling zijn. Moet groter zijn dan of gelijk zijn aan startIpAddress. Gebruik de waarde 0.0.0.0 voor alle interne IP-adressen van Azure.
properties.startIpAddress

string

Het begin-IP-adres van de firewallregel. Moet de IPv4-indeling zijn. Gebruik de waarde 0.0.0.0 voor alle interne IP-adressen van Azure.

Antwoorden

Name Type Description
200 OK

FirewallRule

De firewallregel is bijgewerkt.
201 Created

FirewallRule

De firewallregel is gemaakt.
Other Status Codes

Foutreacties: ***

  • 400 InvalidResourceId - Ongeldige resource-id.

  • 400 Niet-overeenkomendeSubscriptionWithUrl : het opgegeven abonnement komt niet overeen met het abonnement in de URL.

  • 400 Komt niet overeen metResourceGroupNameWithUrl: de opgegeven resourcegroepnaam komt niet overeen met de naam in de URL.

  • 400 Niet-overeenkomendeServerNameWithUrl : de opgegeven servernaam komt niet overeen met de naam in de URL.

  • 400 InvalidServerFirewallRuleResourceRequest : de resourceaanvraag voor de serverfirewallregel is ongeldig.

  • 400 InvalidServerFirewallRuleResourceParameters - De resourceparameter van de serverfirewallregel is ongeldig.

  • 400 FirewallRuleNotIPv4Address - Het opgegeven adres van de firewallregel is niet IPv4

  • 400 TooManyFirewallRules : de opgegeven firewallregels overschrijden de limiet.

  • 400 FirewallRuleInvalidRange : het opgegeven bereik van de firewallregel is ongeldig.

  • 400 FirewallRuleNameTooLong - De opgegeven naam van de firewallregel is te lang

  • 400 FirewallRuleNameEmpty: de opgegeven naam van de firewallregel is leeg

  • 400 DenyPublicEndpointEnabled: kan geen firewallregels maken of wijzigen wanneer de openbare netwerkinterface voor de server is uitgeschakeld. Als u firewallregels op server- of databaseniveau wilt beheren, schakelt u de openbare netwerkinterface in.

  • 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden

  • 404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.

Voorbeelden

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

Create a firewall rule max/min

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

FirewallRule

Object

Een serverfirewallregel.

Name Type Description
id

string

Resource-id.
name

string

Resourcenaam.
properties.endIpAddress

string

Het eind-IP-adres van de firewallregel. Moet de IPv4-indeling zijn. Moet groter zijn dan of gelijk zijn aan startIpAddress. Gebruik de waarde 0.0.0.0 voor alle interne IP-adressen van Azure.
properties.startIpAddress

string

Het begin-IP-adres van de firewallregel. Moet de IPv4-indeling zijn. Gebruik de waarde 0.0.0.0 voor alle interne IP-adressen van Azure.
type

string

Resourcetype.