Partager via


Firewall Rules - Create Or Update

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=2021-11-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

Le nom du serveur

subscriptionId
path True

string

L’ID d’abonnement d’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 » 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 » 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

La règle de pare-feu a été créée.

Other Status Codes

Réponses d’erreur : ***

  • 400 InvalidResourceId - Identificateur de ressource non valide.

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

  • 400 MismatchingResourceGroupNameWithUrl : le nom du groupe de ressources fourni ne correspond pas au nom de l’URL.

  • 400 IncompatibilitéserverNameWithUrl : le nom du 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.

  • 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable

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

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles.

  • 503 TooManyRequests : demandes au-delà du nombre maximal de demandes 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=2021-11-01

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

Exemple de réponse

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

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

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

Exemple de réponse

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

Définitions

FirewallRule

Règle de pare-feu de serveur.

Nom Type Description
id

string

ID de la 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 » 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 » pour toutes les adresses IP internes Azure.

type

string

Type de ressource.