Virtual Network Rules - Create Or Update

Référence

Service:: SQL Database

API Version:: 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	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’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	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é sur le réseau virtuel.

Réponses

Nom	Type	Description
200 OK	VirtualNetworkRule	Mise à jour réussie d’une règle de réseau virtuel.
201 Created	VirtualNetworkRule	Une règle de réseau virtuel a été créée.
202 Accepted		Accepté
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 NullVirtualNetworkRequest - Réseau virtuel Request a la valeur Null 400 NullVirtualNetworkRequestParameters : les paramètres de requête Réseau virtuel ont la valeur 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 Réseau virtuel 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 Réseau virtuel est null 403 VirtualNetworkRuleAccessDenied : Azure SQL Server Réseau virtuel Rule a rencontré une erreur d’autorisations 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 : Azure SQL fonctionnalité de règle de Réseau virtuel server n’est pas activée 404 VirtualNetworkRuleResourceNotFound : Azure SQL Server Réseau virtuel Rule a rencontré une erreur de ressource introuvable 404 VirtualNetworkRuleSubscriptionNotFound : id d’abonnement Réseau virtuel server Azure SQL introuvable ou 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à du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 500 OperationTimedOut : l’opération a expiré et a été automatiquement restaurée. Réessayez l’opération. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 504 VirtualNetworkRuleTimedOut : Azure SQL Server Réseau virtuel Rule 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.core.util.Context;
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),
            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/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"
  }
}

Status code:: 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"
  }
}

Status code:: 202

Définitions

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

VirtualNetworkRule

Une règle de réseau virtuel.

Nom	Type	Description
id	string	ID de la 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é sur le réseau virtuel.
properties.state	VirtualNetworkRuleState	état de la règle Réseau virtuel
properties.virtualNetworkSubnetId	string	ID de ressource ARM du sous-réseau de réseau virtuel.
type	string	Type de ressource.

VirtualNetworkRuleState

état de la règle Réseau virtuel

Nom	Type	Description
Deleting	string
Failed	string
InProgress	string
Initializing	string
Ready	string
Unknown	string

Share via