Partager via

Firewall Rules - Create Or Update

  • Référence
Service:
SQL Database
Version d'API:
2023-08-01

Crée ou met à jour une règle de pare-feu.

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

Paramètres URI

Nom Dans Obligatoire Type Description
firewallRuleName
 path True

string

Nom de la règle de pare-feu.
resourceGroupName
 path True

string

Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName
 path True

string

Nom du serveur.
subscriptionId
 path True

string

ID d’abonnement qui identifie un abonnement Azure.
api-version
 query True

string

Version de l’API à utiliser pour la requête.

Corps de la demande

Nom Type Description
name

string

Nom de la ressource.
properties.endIpAddress

string

Adresse IP de fin de la règle de pare-feu. Doit être au format IPv4. Doit être supérieur ou égal à startIpAddress. Utilisez la valeur « 0.0.0.0.0 » pour toutes les adresses IP internes Azure.
properties.startIpAddress

string

Adresse IP de début de la règle de pare-feu. Doit être au format IPv4. Utilisez la valeur « 0.0.0.0.0 » pour toutes les adresses IP internes Azure.

Réponses

Nom Type Description
200 OK

FirewallRule

Mise à jour réussie de la règle de pare-feu.
201 Created

FirewallRule

Création réussie de la règle de pare-feu.
Other Status Codes

ErrorResponse

Réponses d’erreur : ***

  • 400 ManagedInstanceStoppingOrStopped : opération en conflit envoyée pendant l’arrêt/l’état arrêté de l’instance

  • 400 ManagedInstanceStarting - Opération en conflit envoyée pendant que l’instance est à l’état de démarrage

  • 400 InvalidResourceId - Identificateur de ressource non valide.

  • 400 IncompatibilitéSubscriptionWithUrl : l’abonnement fourni ne correspondait pas à l’abonnement dans l’URL.

  • 400 Incompatibilité deResourceGroupNameWithUrl : le nom du groupe de ressources fourni ne correspond pas au nom dans l’URL.

  • 400 Incompatibilité deServerNameWithUrl : le nom de serveur fourni ne correspond pas au nom dans l’URL.

  • 400 InvalidServerFirewallRuleResourceRequest : la demande de ressource de règle de pare-feu de serveur n’est pas valide.

  • 400 InvalidServerFirewallRuleResourceParameters : le paramètre de ressource de règle de pare-feu de serveur n’est pas valide.

  • 400 FirewallRuleNotIPv4Address : l’adresse de règle de pare-feu fournie n’est pas IPv4

  • 400 TooManyFirewallRules : les règles de pare-feu fournies dépassent la limite.

  • 400 FirewallRuleInvalidRange : la plage de règles de pare-feu spécifiée n’est pas valide.

  • 400 FirewallRuleNameTooLong - Le nom de règle de pare-feu fourni est trop long

  • 400 FirewallRuleNameEmpty : le nom de règle de pare-feu fourni est vide

  • 400 DenyPublicEndpointEnabled : impossible de créer ou de modifier des règles de pare-feu lorsque l’interface réseau publique du serveur est désactivée. Pour gérer les règles de pare-feu au niveau du serveur ou de la base de données, activez l’interface réseau publique.

  • 400 FirewallRuleNameInvalid : le nom de règle de pare-feu fourni contient des caractères spéciaux.

  • 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable

  • 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

Exemples

Create a firewall rule max/min
Update a firewall rule max/min

Create a firewall rule max/min

Exemple de requête

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=2023-08-01

{
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

Exemple de réponse

Code d’état:
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"
  }
}
Code d’état:
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

Exemple de requête

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=2023-08-01

{
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

Exemple de réponse

Code d’état:
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"
  }
}
Code d’état:
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"
  }
}

Définitions

Nom Description
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
FirewallRule

Règle de pare-feu de serveur.

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d’erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

FirewallRule

Object

Règle de pare-feu de serveur.

Nom Type Description
id

string

ID de ressource.
name

string

Nom de la ressource.
properties.endIpAddress

string

Adresse IP de fin de la règle de pare-feu. Doit être au format IPv4. Doit être supérieur ou égal à startIpAddress. Utilisez la valeur « 0.0.0.0.0 » pour toutes les adresses IP internes Azure.
properties.startIpAddress

string

Adresse IP de début de la règle de pare-feu. Doit être au format IPv4. Utilisez la valeur « 0.0.0.0.0 » pour toutes les adresses IP internes Azure.
type

string

Type de ressource.