Delen via


Firewall Rules - Create Or Update

Hiermee maakt u een firewallregel of werkt u deze 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 hebben. Moet groter dan of gelijk zijn aan startIpAddress. Gebruik de waarde '0.0.0.0' voor alle interne IP-adressen van Azure.

properties.startIpAddress

string

Het ip-beginadres van de firewallregel. Moet de IPv4-indeling hebben. 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 Komt niet overeenSubscriptionWithUrl: het opgegeven abonnement komt niet overeen met het abonnement in de URL.

  • 400 Komt niet overeenResourceGroupNameWithUrl - De opgegeven naam van de resourcegroep komt niet overeen met de naam in de URL.

  • 400 MismatchingServerNameWithUrl - 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 voor 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 firewallregelbereik is ongeldig.

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

  • 400 FirewallRuleNameEmpty - De naam van de opgegeven 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 : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

  • 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.

  • 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan 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

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

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

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

Definities

FirewallRule

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 hebben. Moet groter dan of gelijk zijn aan startIpAddress. Gebruik de waarde '0.0.0.0' voor alle interne IP-adressen van Azure.

properties.startIpAddress

string

Het ip-beginadres van de firewallregel. Moet de IPv4-indeling hebben. Gebruik de waarde '0.0.0.0' voor alle interne IP-adressen van Azure.

type

string

Resourcetype.