Firewall Rules - Create Or Update

  • Referencia
Service:
SQL Database
API Version:
2021-11-01

Tűzfalszabályt hoz létre vagy frissít.

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

URI-paraméterek

Name In Kötelező Típus Description
firewallRuleName
 path True

string

A tűzfalszabály neve.
resourceGroupName
 path True

string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName
 path True

string

A kiszolgáló neve.
subscriptionId
 path True

string

Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version
 query True

string

A kéréshez használni kívánt API-verzió.

Kérelem törzse

Name Típus Description
name

string

Erőforrás neve.
properties.endIpAddress

string

A tűzfalszabály záró IP-címe. IPv4 formátumúnak kell lennie. A startIpAddress értéknél nagyobbnak vagy egyenlőnek kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.
properties.startIpAddress

string

A tűzfalszabály kezdő IP-címe. IPv4 formátumúnak kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.

Válaszok

Name Típus Description
200 OK

FirewallRule

A tűzfalszabály frissítése sikerült.
201 Created

FirewallRule

A tűzfalszabály létrehozása sikerült.
Other Status Codes

Hibaválaszok: ***

  • 400 InvalidResourceId – Érvénytelen erőforrás-azonosító.

  • 400 MismatchingSubscriptionWithUrl – A megadott előfizetés nem egyezett meg az URL-címben szereplő előfizetéssel.

  • 400 MismatchingResourceGroupNameWithUrl – A megadott erőforráscsoport neve nem egyezett meg az URL-címben megadott névvel.

  • 400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett meg az URL-címben megadott névvel.

  • 400 InvalidServerFirewallRuleResourceRequest – A kiszolgálói tűzfalszabály erőforrás-kérése érvénytelen.

  • 400 InvalidServerFirewallRuleResourceParameters – A kiszolgálói tűzfalszabály erőforrás-paramétere érvénytelen.

  • 400 FirewallRuleNotIPv4Address – A megadott tűzfalszabály-cím nem IPv4

  • 400 TooManyFirewallRules – A megadott tűzfalszabályok túllépik a korlátot.

  • 400 FirewallRuleInvalidRange – A megadott tűzfalszabály-tartomány érvénytelen.

  • 400 FirewallRuleNameTooLong – A megadott tűzfalszabály neve túl hosszú

  • 400 FirewallRuleNameEmpty – A megadott tűzfalszabály neve üres

  • 400 DenyPublicEndpointEnabled – Nem lehet tűzfalszabályokat létrehozni vagy módosítani, ha a kiszolgáló nyilvános hálózati adaptere le van tiltva. A kiszolgáló- vagy adatbázisszintű tűzfalszabályok kezeléséhez engedélyezze a nyilvános hálózati adaptert.

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

  • 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

  • 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

  • 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

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

Status code:
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"
  }
}
Status code:
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

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

Status code:
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"
  }
}
Status code:
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"
  }
}

Definíciók

FirewallRule

Kiszolgálói tűzfalszabály.

Name Típus Description
id

string

Erőforrás-azonosító.
name

string

Erőforrás neve.
properties.endIpAddress

string

A tűzfalszabály záró IP-címe. IPv4 formátumúnak kell lennie. A startIpAddress értéknél nagyobbnak vagy egyenlőnek kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.
properties.startIpAddress

string

A tűzfalszabály kezdő IP-címe. IPv4 formátumúnak kell lennie. Használja a "0.0.0.0" értéket az összes Azure-belső IP-címhez.
type

string

Erőforrástípus.