Firewall Rules - Create Or Update

Référence

Service:: SQL Database

API Version:: 2021-11-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=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.

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

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleCreate.json
     */
    /**
     * Sample code: Create a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-5370",
            new FirewallRuleInner().withStartIpAddress("0.0.0.3").withEndIpAddress("0.0.0.3"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

HTTP
Java

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleUpdate.json
     */
    /**
     * Sample code: Update a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-3927",
            new FirewallRuleInner().withStartIpAddress("0.0.0.1").withEndIpAddress("0.0.0.1"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

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.

Firewall Rules - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Create a firewall rule max/min

Sample Request

Sample Response

Update a firewall rule max/min

Sample Request

Sample Response

Définitions

FirewallRule

Ressources supplémentaires