Virtual Network Rules - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria ou atualiza uma regra de rede 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 do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
virtualNetworkRuleName	path	True	string	O nome da regra de rede virtual.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
properties.virtualNetworkSubnetId	True	string	O ID de recurso do ARM da sub-rede da rede virtual.
properties.ignoreMissingVnetServiceEndpoint		boolean	Crie uma regra de firewall antes de a rede virtual ter o ponto final de serviço da vnet ativado.

Respostas

Name	Tipo	Description
200 OK	VirtualNetworkRule	Uma regra de rede virtual foi atualizada com êxito.
201 Created	VirtualNetworkRule	Uma regra de rede virtual foi criada com êxito.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 InvalidResourceId – identificador de recurso inválido. 400 MismatchingSubscriptionWithUrl – a subscrição fornecida não correspondeu à subscrição no URL. 400 MismatchingResourceGroupNameWithUrl – o nome do grupo de recursos fornecido não corresponde ao nome no URL. 400 MismatchingServerNameWithUrl – o nome do servidor fornecido não corresponde ao nome no URL. 400 NullVirtualNetworkRequest - Rede Virtual Request is Null 400 NullVirtualNetworkRequestParameters - Rede Virtual Parâmetros de Pedido são Nulos 400 FirewallChangesDeniedBecausePublicEndpointDisabled – não é possível criar ou modificar regras de firewall quando o acesso à rede pública para o servidor está desativado. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest - SQL do Azure Server Rede Virtual Rule detetou um erro de utilizador 400 VirtualNetworkRuleWithFailoverGroupsNotSupported – as regras de firewall de rede virtual não são atualmente suportadas em servidores com grupos de ativação pós-falha configurados com a política de ativação pós-falha automática. Configure os grupos de ativação pós-falha no servidor com a política de ativação pós-falha manual. 400 NullVirtualNetworkSubnetId - O ID da Sub-rede do Rede Virtual é nulo 403 VirtualNetworkRuleAccessDenied - SQL do Azure Server Rede Virtual Rule encontrou o erro de permissões 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados. 404 VirtualNetworkRuleNotEnabled – a funcionalidade regra de Rede Virtual do servidor do SQL do Azure não está ativada 404 VirtualNetworkRuleResourceNotFound – SQL do Azure Server Rede Virtual Rule encontrou um erro de recurso não encontrado 404 VirtualNetworkRuleSubscriptionNotFound – O ID da Subscrição do Rede Virtual do Servidor do SQL do Azure não foi encontrado ou está no estado desativado 404 OperationIdNotFound – a operação com o ID não existe. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 504 VirtualNetworkRuleTimedOut – SQL do Azure Server Rede Virtual Rule encontrou um tempo limite

Exemplos

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Código de estado:: 202

Definições

Name	Description
VirtualNetworkRule	Uma regra de rede virtual.
VirtualNetworkRuleState	Estado da Regra de Rede Virtual

VirtualNetworkRule

Uma regra de rede virtual.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.ignoreMissingVnetServiceEndpoint	boolean	Crie uma regra de firewall antes de a rede virtual ter o ponto final de serviço da vnet ativado.
properties.state	VirtualNetworkRuleState	Estado da Regra de Rede Virtual
properties.virtualNetworkSubnetId	string	O ID de recurso do ARM da sub-rede da rede virtual.
type	string	Tipo de recurso.

VirtualNetworkRuleState

Estado da Regra de Rede Virtual

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

Partilhar via