IP Firewall ll Rules - Create Or Update

Référence

Service:: SQL Database

Version d'API:: 2021-11-01

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/ipv6FirewallRules/{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.endIPv6Address	string	Adresse IP de fin de la règle de pare-feu. Doit être au format IPv6. Doit être supérieur ou égal à startIpAddress.
properties.startIPv6Address	string	Adresse IP de début de la règle de pare-feu. Doit être au format IPv6.

Réponses

Nom	Type	Description
200 OK	IPv6FirewallRule	Mise à jour réussie de la règle de pare-feu IPv6.
201 Created	IPv6FirewallRule	La règle de pare-feu IPv6 a été créée.
Other Status Codes		Réponses d’erreur : *** 400 InvalidResourceId : identificateur de ressource non valide. 400 MismatchingSubscriptionWithUrl : l’abonnement fourni ne correspond pas à l’abonnement dans l’URL. 400 Non correspondanceResourceGroupNameWithUrl : le nom du groupe de ressources fourni ne correspond pas au nom dans l’URL. 400 MismatchingServerNameWithUrl : le nom du serveur fourni ne correspond pas au nom dans l’URL. 400 InvalidIPv6ServerFirewallRuleResourceRequest : la demande de ressource de règle de pare-feu de serveur IPv6 n’est pas valide. 400 InvalidIPv6ServerFirewallRuleResourceParameters : le paramètre de ressource de règle de pare-feu de serveur IPv6 n’est pas valide. 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 IPv6FirewallRuleNameEmpty : le nom de règle de pare-feu IPv6 fourni est vide 400 FirewallRuleNotIPv6Address : l’adresse de règle de pare-feu fournie n’est pas IPv6 400 IPv6FirewallRuleNameTooLong : le nom de règle de pare-feu IPv6 fourni est trop long 400 IPv6FirewallRuleInvalidRange : la plage de règles de pare-feu IPv6 spécifiée n’est pas valide. 400 TooManyIPv6FirewallRules : les règles de pare-feu IPv6 fournies dépassent la limite. 400 IPv6EndpointDisabled : le point de terminaison IPv6 est désactivé. 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.

Nom

Type

Description

200 OK

IPv6FirewallRule

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

201 Created

IPv6FirewallRule

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

Other Status Codes

Réponses d’erreur : ***

400 InvalidResourceId : identificateur de ressource non valide.
400 MismatchingSubscriptionWithUrl : l’abonnement fourni ne correspond pas à l’abonnement dans l’URL.
400 Non correspondanceResourceGroupNameWithUrl : le nom du groupe de ressources fourni ne correspond pas au nom dans l’URL.
400 MismatchingServerNameWithUrl : le nom du serveur fourni ne correspond pas au nom dans l’URL.
400 InvalidIPv6ServerFirewallRuleResourceRequest : la demande de ressource de règle de pare-feu de serveur IPv6 n’est pas valide.
400 InvalidIPv6ServerFirewallRuleResourceParameters : le paramètre de ressource de règle de pare-feu de serveur IPv6 n’est pas valide.
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 IPv6FirewallRuleNameEmpty : le nom de règle de pare-feu IPv6 fourni est vide
400 FirewallRuleNotIPv6Address : l’adresse de règle de pare-feu fournie n’est pas IPv6
400 IPv6FirewallRuleNameTooLong : le nom de règle de pare-feu IPv6 fourni est trop long
400 IPv6FirewallRuleInvalidRange : la plage de règles de pare-feu IPv6 spécifiée n’est pas valide.
400 TooManyIPv6FirewallRules : les règles de pare-feu IPv6 fournies dépassent la limite.
400 IPv6EndpointDisabled : le point de terminaison IPv6 est désactivé.
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.

Exemples

Create an IPv6 firewall rule max/min

Update an IPv6 firewall rule max/min

Create an IPv6 firewall rule max/min

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

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}


import com.azure.resourcemanager.sql.fluent.models.IPv6FirewallRuleInner;

/**
 * Samples for IPv6FirewallRules CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/IPv6FirewallRuleCreate.json
     */
    /**
     * Sample code: Create an IPv6 firewall rule max/min.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAnIPv6FirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getIPv6FirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-5370",
            new IPv6FirewallRuleInner().withStartIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0003")
                .withEndIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0003"),
            com.azure.core.util.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

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Code d’état:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Update an IPv6 firewall rule max/min

Exemple de requête

HTTP
Java

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

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}


import com.azure.resourcemanager.sql.fluent.models.IPv6FirewallRuleInner;

/**
 * Samples for IPv6FirewallRules CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/IPv6FirewallRuleUpdate.json
     */
    /**
     * Sample code: Update an IPv6 firewall rule max/min.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAnIPv6FirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getIPv6FirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-3927",
            new IPv6FirewallRuleInner().withStartIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0001")
                .withEndIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0001"),
            com.azure.core.util.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

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

Code d’état:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

Définitions

IPv6FirewallRule

Object

Règle de pare-feu de serveur IPv6.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.endIPv6Address	string	Adresse IP de fin de la règle de pare-feu. Doit être au format IPv6. Doit être supérieur ou égal à startIpAddress.
properties.startIPv6Address	string	Adresse IP de début de la règle de pare-feu. Doit être au format IPv6.
type	string	Type de ressource.

Partager via

IP Firewall ll Rules - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Create an IPv6 firewall rule max/min

Exemple de requête

Exemple de réponse

Update an IPv6 firewall rule max/min

Exemple de requête

Exemple de réponse

Définitions

IPv6FirewallRule

Ressources supplémentaires