Virtual Network Rules - Create Or Update

Referência

Service:: SQL Database

API Version:: 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 de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
virtualNetworkRuleName	path	True	string	O nome da regra de rede virtual.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
properties.virtualNetworkSubnetId	True	string	A ID de recurso do ARM da sub-rede de rede virtual.
properties.ignoreMissingVnetServiceEndpoint		boolean	Crie uma regra de firewall antes que a rede virtual tenha o ponto de extremidade de serviço de vnet habilitado.

Respostas

Nome	Tipo	Description
200 OK	VirtualNetworkRule	Uma regra de rede virtual foi atualizada com êxito.
201 Created	VirtualNetworkRule	Criou com êxito uma regra de rede virtual.
202 Accepted		Aceito
Other Status Codes		Respostas de erro: *** 400 InvalidResourceId – Identificador de recurso inválido. 400 MismatchingSubscriptionWithUrl – A assinatura fornecida não correspondeu à assinatura na URL. 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondeu ao nome na URL. 400 MismatchingServerNameWithUrl – O nome do servidor fornecido não correspondeu ao nome na URL. 400 NullVirtualNetworkRequest - Rede Virtual Request é Null 400 NullVirtualNetworkRequestParameters – Rede Virtual parâmetros de solicitação são nulos 400 FirewallChangesDeniedBecausePublicEndpointDisabled – Não é possível criar ou modificar regras de firewall quando o acesso à rede pública para o servidor estiver desabilitado. (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 encontrou um erro de usuário 400 VirtualNetworkRuleWithFailoverGroupsNotSupported – Atualmente, não há suporte para regras de firewall de rede virtual em servidores com grupos de failover configurados com a política de failover automática. Configure os grupos de failover no servidor com a política de failover manual. 400 NullVirtualNetworkSubnetId - A ID da sub-rede Rede Virtual é nula 403 VirtualNetworkRuleAccessDenied – erro de permissões de regra de Rede Virtual de servidor SQL do Azure encontrada 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 VirtualNetworkRuleNotEnabled – o recurso regra de Rede Virtual do servidor SQL do Azure não está habilitado 404 VirtualNetworkRuleResourceNotFound - SQL do Azure Server Rede Virtual Rule encontrou um erro de recurso não encontrado 404 VirtualNetworkRuleSubscriptionNotFound – SQL do Azure id de assinatura do servidor Rede Virtual não encontrado ou está no estado desabilitado 404 OperationIdNotFound – A operação com id não existe. 409 OperationCancelled – A operação foi cancelada pelo usuário. 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas 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.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

Definições

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

VirtualNetworkRule

Uma regra de rede virtual.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.ignoreMissingVnetServiceEndpoint	boolean	Crie uma regra de firewall antes que a rede virtual tenha o ponto de extremidade de serviço de vnet habilitado.
properties.state	VirtualNetworkRuleState	Estado da Regra Rede Virtual
properties.virtualNetworkSubnetId	string	A ID de recurso do ARM da sub-rede de rede virtual.
type	string	Tipo de recurso.

VirtualNetworkRuleState

Estado da Regra Rede Virtual

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