Firewall Rules - Create Or Update

Skapar eller uppdaterar en brandväggsregel.

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

URI-parametrar

Name I Obligatorisk Typ Description
firewallRuleName
path True

string

Namnet på brandväggsregeln.

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

Begärandetext

Name Typ Description
name

string

Resursnamn.

properties.endIpAddress

string

Brandväggsregelns slut-IP-adress. Måste vara IPv4-format. Måste vara större än eller lika med startIpAddress. Använd värdet "0.0.0.0" för alla Azure-interna IP-adresser.

properties.startIpAddress

string

Brandväggsregelns start-IP-adress. Måste vara IPv4-format. Använd värdet "0.0.0.0" för alla Azure-interna IP-adresser.

Svar

Name Typ Description
200 OK

FirewallRule

Brandväggsregeln har uppdaterats.

201 Created

FirewallRule

Brandväggsregeln har skapats.

Other Status Codes

Felsvar: ***

  • 400 InvalidResourceId – Ogiltig resursidentifierare.

  • 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en.

  • 400 MismatchingResourceGroupNameWithUrl – Det angivna resursgruppsnamnet matchade inte namnet i URL:en.

  • 400 MismatchingServerNameWithUrl – det angivna servernamnet matchade inte namnet i URL:en.

  • 400 InvalidServerFirewallRuleResourceRequest – resursbegäran för serverbrandväggsregeln är ogiltig.

  • 400 InvalidServerFirewallRuleResourceParameters – resursparametern för serverbrandväggsregeln är ogiltig.

  • 400 FirewallRuleNotIPv4Address – den angivna brandväggsregeladressen är inte IPv4

  • 400 TooManyFirewallRules – de angivna brandväggsreglerna överskrider gränsen.

  • 400 FirewallRuleInvalidRange – det angivna brandväggsregelintervallet är ogiltigt.

  • 400 FirewallRuleNameTooLong – det angivna brandväggsregelnamnet är för långt

  • 400 FirewallRuleNameEmpty – det angivna brandväggsregelnamnet är tomt

  • 400 DenyPublicEndpointEnabled – Det går inte att skapa eller ändra brandväggsregler när det offentliga nätverksgränssnittet för servern är inaktiverat. Om du vill hantera brandväggsregler på server- eller databasnivå aktiverar du det offentliga nätverksgränssnittet.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

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-11-01

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

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

Definitioner

FirewallRule

En brandväggsregel för servern.

Name Typ Description
id

string

Resurs-ID.

name

string

Resursnamn.

properties.endIpAddress

string

Brandväggsregelns slut-IP-adress. Måste vara IPv4-format. Måste vara större än eller lika med startIpAddress. Använd värdet "0.0.0.0" för alla Azure-interna IP-adresser.

properties.startIpAddress

string

Brandväggsregelns start-IP-adress. Måste vara IPv4-format. Använd värdet "0.0.0.0" för alla Azure-interna IP-adresser.

type

string

Resurstyp.