Virtual Network Rules - Create Or Update

Service:: SQL Database

Version d'API:: 2021-11-01

Crée ou met à jour une règle de réseau virtuel existante.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/virtualNetworkRules/{virtualNetworkRuleName}?api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
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.
virtualNetworkRuleName	path	True	string	Nom de la règle de réseau virtuel.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.virtualNetworkSubnetId	True	string (arm-id)	ID de ressource ARM du sous-réseau de réseau virtuel.
properties.ignoreMissingVnetServiceEndpoint		boolean	Créez une règle de pare-feu avant que le point de terminaison de service de réseau virtuel soit activé.

Réponses

Nom	Type	Description
200 OK	VirtualNetworkRule	Mise à jour réussie d’une règle de réseau virtuel.
201 Created	VirtualNetworkRule	Création réussie d’une règle de réseau virtuel.
202 Accepted		Accepté
Other Status Codes		Réponses d’erreur : *** 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 NullVirtualNetworkRequest - La demande de réseau virtuel est Null 400 NullVirtualNetworkRequestParameters - Les paramètres de requête de réseau virtuel sont Null 400 FirewallChangesDeniedBecausePublicEndpointDisabled - Impossible de créer ou de modifier des règles de pare-feu lorsque l’accès au réseau public pour le serveur est désactivé. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest - Azure SQL Server Virtual Network Rule a rencontré une erreur utilisateur 400 VirtualNetworkRuleWithFailoverGroupsNotSupported : les règles de pare-feu de réseau virtuel ne sont actuellement pas prises en charge sur les serveurs avec des groupes de basculement configurés avec une stratégie de basculement automatique. Configurez les groupes de basculement sur le serveur avec une stratégie de basculement manuelle. 400 NullVirtualNetworkSubnetId - L’ID de sous-réseau de réseau virtuel est null 403 VirtualNetworkRuleAccessDenied - Une règle de réseau virtuel Azure SQL Server a rencontré une erreur d’autorisation 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. 404 VirtualNetworkRuleNotEnabled - La fonctionnalité règle de réseau virtuel Azure SQL Server n’est pas activée 404 VirtualNetworkRuleResourceNotFound - Une règle de réseau virtuel Azure SQL Server a rencontré une erreur de ressource introuvable 404 VirtualNetworkRuleSubscriptionNotFound - ID d’abonnement au réseau virtuel Azure SQL Server introuvable ou est désactivé 404 OperationIdNotFound : l’opération avec ID n’existe pas. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération. 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 504 VirtualNetworkRuleTimedOut - Une règle de réseau virtuel Azure SQL Server a rencontré un délai d’expiration

Exemples

Create or update a virtual network rule

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/vnet-test-svr/virtualNetworkRules/vnet-firewall-rule?api-version=2021-11-01

{
  "properties": {
    "ignoreMissingVnetServiceEndpoint": false,
    "virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Network/virtualNetworks/testvnet/subnets/testsubnet"
  }
}


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

/**
 * Samples for VirtualNetworkRules CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/VirtualNetworkRulesCreateOrUpdate.
     * json
     */
    /**
     * Sample code: Create or update a virtual network rule.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateAVirtualNetworkRule(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getVirtualNetworkRules().createOrUpdate("Default", "vnet-test-svr",
            "vnet-firewall-rule",
            new VirtualNetworkRuleInner().withVirtualNetworkSubnetId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Network/virtualNetworks/testvnet/subnets/testsubnet")
                .withIgnoreMissingVnetServiceEndpoint(false),
            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/Default/providers/Microsoft.Sql/servers/vnet-test-svr/virtualNetworkRules/vnet-firewall-rule",
  "name": "vnet-firewall-rule",
  "type": "Microsoft.Sql/servers/virtualNetworkRules",
  "properties": {
    "ignoreMissingVnetServiceEndpoint": false,
    "virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Network/virtualNetworks/testvnet/subnets/testsubnet"
  }
}

Code d’état:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/vnet-test-svr/virtualNetworkRules/vnet-firewall-rule",
  "name": "vnet-firewall-rule",
  "type": "Microsoft.Sql/servers/virtualNetworkRules",
  "properties": {
    "ignoreMissingVnetServiceEndpoint": false,
    "virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Network/virtualNetworks/testvnet/subnets/testsubnet"
  }
}

Code d’état:: 202

Définitions

Nom	Description
VirtualNetworkRule	Règle de réseau virtuel.
VirtualNetworkRuleState	État de la règle de réseau virtuel

VirtualNetworkRule

Object

Règle de réseau virtuel.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.ignoreMissingVnetServiceEndpoint	boolean	Créez une règle de pare-feu avant que le point de terminaison de service de réseau virtuel soit activé.
properties.state	VirtualNetworkRuleState	État de la règle de réseau virtuel
properties.virtualNetworkSubnetId	string (arm-id)	ID de ressource ARM du sous-réseau de réseau virtuel.
type	string	Type de ressource.

VirtualNetworkRuleState

Énumération

État de la règle de réseau virtuel

Valeur	Description
Deleting
Failed
InProgress
Initializing
Ready
Unknown

Partager via