Dela via

Firewall Rules - Create Or Update

  • Referens
Tjänst:
SQL Database
API-version:
2021-11-01

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

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

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.