Firewall Rules - Replace

Szolgáltatás:: SQL Database

API-verzió:: 2023-08-01

A kiszolgáló összes tűzfalszabályát lecseréli.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
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
values	FirewallRule[]	Kiszolgálói tűzfalszabály.

Válaszok

Name	Típus	Description
200 OK	FirewallRule	Sikeresen frissítette a tűzfalszabályokat.
202 Accepted		A kiszolgálói tűzfalszabályok létrehozása vagy frissítése folyamatban van.
Other Status Codes	ErrorResponse	Hibaválaszok: *** 400 ManagedInstanceStoppingOrStopped – Ütköző művelet van elküldve, miközben a példány leáll/leállított állapotban van 400 ManagedInstanceStarting – Ütköző művelet küldve, miközben a példány kezdő állapotban van 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 az URL-címben megadott névvel. 400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett 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ásparamé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. 400 FirewallRuleNameInvalid – A megadott tűzfalszabály neve speciális karaktereket tartalmaz. 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és -előfizetésben. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson lévő művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel. 503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések. 503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Name

Típus

Description

200 OK

FirewallRule

Sikeresen frissítette a tűzfalszabályokat.

202 Accepted

A kiszolgálói tűzfalszabályok létrehozása vagy frissítése folyamatban van.

Other Status Codes

ErrorResponse

Hibaválaszok: ***

400 ManagedInstanceStoppingOrStopped – Ütköző művelet van elküldve, miközben a példány leáll/leállított állapotban van
400 ManagedInstanceStarting – Ütköző művelet küldve, miközben a példány kezdő állapotban van
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 az URL-címben megadott névvel.
400 MismatchingServerNameWithUrl – A megadott kiszolgálónév nem egyezett 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ásparamé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.
400 FirewallRuleNameInvalid – A megadott tűzfalszabály neve speciális karaktereket tartalmaz.
404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és -előfizetésben.
404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található
404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik.
409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető.
409 OperationCancelled – A felhasználó megszakította a műveletet.
409 OperationInterrupted – Az erőforráson lévő művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson.
429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.
429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése.
429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése.
429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.
500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel.
503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.
503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

Replace firewall rules

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules?api-version=2023-08-01

{
  "values": [
    {
      "name": "firewallrulecrudtest-5370 ",
      "properties": {
        "startIpAddress": "0.0.0.0",
        "endIpAddress": "100.0.0.0"
      }
    }
  ]
}

Mintaválasz

Állapotkód:: 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"
  }
}

Állapotkód:: 202

Definíciók

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
FirewallRule	Kiszolgálói tűzfalszabály.
FirewallRuleList	A kiszolgálói tűzfalszabályok listája.

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

FirewallRule

Objektum

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ás típusa.

FirewallRuleList

Objektum

A kiszolgálói tűzfalszabályok listája.

Name	Típus	Description
values	FirewallRule[]	Kiszolgálói tűzfalszabály.

Megosztás a következőn keresztül:

Firewall Rules - Replace

URI-paraméterek

Kérelem törzse

Válaszok

Példák

Replace firewall rules

Mintakérelem

Mintaválasz

Definíciók

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FirewallRule

FirewallRuleList