Virtual Network Rules - Create Or Update

Referencia

Service:: SQL Database

API Version:: 2021-11-01

Crea o actualiza una regla de red virtual existente.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
virtualNetworkRuleName	path	True	string	Nombre de la regla de red virtual.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.virtualNetworkSubnetId	True	string	Identificador de recurso de ARM de la subred de red virtual.
properties.ignoreMissingVnetServiceEndpoint		boolean	Cree una regla de firewall antes de que la red virtual tenga habilitado el punto de conexión de servicio de red virtual.

Respuestas

Nombre	Tipo	Description
200 OK	VirtualNetworkRule	Se actualizó correctamente una regla de red virtual.
201 Created	VirtualNetworkRule	Se ha creado correctamente una regla de red virtual.
202 Accepted		Aceptado
Other Status Codes		Respuestas de error: *** 400 InvalidResourceId: identificador de recurso no válido. 400 Error de coincidenciaSubscriptionWithUrl: la suscripción proporcionada no coincide con la suscripción en la dirección URL. 400 No coincidentesResourceGroupNameWithUrl: el nombre del grupo de recursos proporcionado no coincide con el nombre de la dirección URL. 400 No coincidentesServerNameWithUrl: el nombre del servidor proporcionado no coincide con el nombre de la dirección URL. 400 NullVirtualNetworkRequest: Virtual Network Solicitud es Null 400 NullVirtualNetworkRequestParameters: Virtual Network parámetros de solicitud son NULL 400 FirewallChangesDeniedBecausePublicEndpointDisabled: no se pueden crear o modificar reglas de firewall cuando el acceso a la red pública para el servidor está deshabilitado. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest: Azure SQL regla de Virtual Network server encontró un error de usuario 400 VirtualNetworkRuleWithFailoverGroupsNotSupported: las reglas de firewall de red virtual no se admiten actualmente en servidores con grupos de conmutación por error configurados con la directiva de conmutación automática por error. Configure los grupos de conmutación por error en el servidor con la directiva de conmutación por error manual. 400 NullVirtualNetworkSubnetId: el identificador de subred de Virtual Network es null 403 VirtualNetworkRuleAccessDenied: Azure SQL Server Virtual Network regla encontró el error de permisos 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 VirtualNetworkRuleNotEnabled: la característica Azure SQL Server Virtual Network Regla no está habilitada 404 VirtualNetworkRuleResourceNotFound: Azure SQL Server Virtual Network Regla encontró un error de recurso no encontrado 404 VirtualNetworkRuleSubscriptionNotFound: Azure SQL Server Virtual Network identificador de suscripción no encontrado o está en estado deshabilitado 404 OperationIdNotFound: la operación con id. no existe. 409 OperationCancelled: el usuario ha cancelado la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 504 VirtualNetworkRuleTimedOut: Azure SQL server Virtual Network regla encontró un tiempo de espera

Ejemplos

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

Definiciones

Nombre	Description
VirtualNetworkRule	Una regla de red virtual.
VirtualNetworkRuleState	estado de regla de Virtual Network

VirtualNetworkRule

Una regla de red virtual.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.ignoreMissingVnetServiceEndpoint	boolean	Cree una regla de firewall antes de que la red virtual tenga habilitado el punto de conexión de servicio de red virtual.
properties.state	VirtualNetworkRuleState	estado de regla de Virtual Network
properties.virtualNetworkSubnetId	string	Identificador de recurso de ARM de la subred de red virtual.
type	string	Tipo de recurso.

VirtualNetworkRuleState

estado de regla de Virtual Network

Nombre	Tipo	Description
Deleting	string
Failed	string
InProgress	string
Initializing	string
Ready	string
Unknown	string

Share via