Virtual Network Rules - Create Or Update

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2021-11-01

Tworzy lub aktualizuje istniejącą regułę sieci wirtualnej.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
virtualNetworkRuleName	path	True	string	Nazwa reguły sieci wirtualnej.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.virtualNetworkSubnetId	True	string	Identyfikator zasobu usługi ARM podsieci sieci wirtualnej.
properties.ignoreMissingVnetServiceEndpoint		boolean	Utwórz regułę zapory, zanim sieć wirtualna ma włączony punkt końcowy usługi sieci wirtualnej.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	VirtualNetworkRule	Pomyślnie zaktualizowano regułę sieci wirtualnej.
201 Created	VirtualNetworkRule	Pomyślnie utworzono regułę sieci wirtualnej.
202 Accepted		Zaakceptowano
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidResourceId — nieprawidłowy identyfikator zasobu. 400 NiezgodnośćSubscriptionWithUrl — podana subskrypcja nie jest zgodna z subskrypcją w adresie URL. 400 MismatchingResourceGroupNameWithUrl — podana nazwa grupy zasobów nie jest zgodna z nazwą w adresie URL. 400 NiezgodnośćServerNameWithUrl — podana nazwa serwera nie jest zgodna z nazwą w adresie URL. 400 NullVirtualNetworkRequest — żądanie Virtual Network ma wartość Null 400 NullVirtualNetworkRequestParameters — parametry żądania Virtual Network mają wartość Null 400 FirewallChangesDeniedBecausePublicEndpointDisabled — nie można utworzyć lub zmodyfikować reguł zapory, gdy dostęp do sieci publicznej dla serwera jest wyłączony. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest — Azure SQL Server Virtual Network Reguła napotkała błąd użytkownika 400 VirtualNetworkRuleWithFailoverGroupsNotSupported — reguły zapory sieci wirtualnej nie są obecnie obsługiwane na serwerach z grupami trybu failover skonfigurowanymi przy użyciu zasad automatycznego trybu failover. Skonfiguruj grupy trybu failover na serwerze przy użyciu ręcznych zasad trybu failover. 400 NullVirtualNetworkSubnetId — identyfikator podsieci Virtual Network ma wartość null 403 VirtualNetworkRuleAccessDenied — Azure SQL Server Virtual Network Reguła napotkała błąd uprawnień 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 VirtualNetworkRuleNotEnabled — funkcja Azure SQL Server Virtual Network Rule nie jest włączona 404 VirtualNetworkRuleResourceNotFound — Azure SQL Server Virtual Network Reguła napotkała błąd nie znaleziono zasobu 404 VirtualNetworkRuleSubscriptionNotFound — Azure SQL Server Virtual Network Identyfikator subskrypcji nie został znaleziony lub jest w stanie wyłączonym 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 OperationInterrupted — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i został automatycznie wycofany. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 504 VirtualNetworkRuleTimedOut — Azure SQL Server Virtual Network Reguła napotkała limit czasu

Przykłady

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Kod stanu:: 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"
  }
}

Kod stanu:: 202

Definicje

Nazwa	Opis
VirtualNetworkRule	Reguła sieci wirtualnej.
VirtualNetworkRuleState	stan reguły Virtual Network

VirtualNetworkRule

Reguła sieci wirtualnej.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.ignoreMissingVnetServiceEndpoint	boolean	Utwórz regułę zapory, zanim sieć wirtualna ma włączony punkt końcowy usługi sieci wirtualnej.
properties.state	VirtualNetworkRuleState	stan reguły Virtual Network
properties.virtualNetworkSubnetId	string	Identyfikator zasobu usługi ARM podsieci sieci wirtualnej.
type	string	Typ zasobu.

VirtualNetworkRuleState

stan reguły Virtual Network

Nazwa	Typ	Opis
Deleting	string
Failed	string
InProgress	string
Initializing	string
Ready	string
Unknown	string

Udostępnij za pośrednictwem