Partager via


Virtual Network Rules - Create Or Update

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

Exemple de requête

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

Exemple de réponse

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

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