Virtual Network Rules - Create Or Update

Referens

Service:: SQL Database

API Version:: 2021-11-01

Skapar eller uppdaterar en befintlig regel för virtuellt nätverk.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
virtualNetworkRuleName	path	True	string	Namnet på regeln för virtuellt nätverk.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
properties.virtualNetworkSubnetId	True	string	ARM-resurs-ID för det virtuella nätverkets undernät.
properties.ignoreMissingVnetServiceEndpoint		boolean	Skapa brandväggsregel innan VNet-tjänstslutpunkten är aktiverad för det virtuella nätverket.

Svar

Name	Typ	Description
200 OK	VirtualNetworkRule	En regel för virtuellt nätverk har uppdaterats.
201 Created	VirtualNetworkRule	En regel för virtuellt nätverk har skapats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 InvalidResourceId – Ogiltig resursidentifierare. 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en. 400 MismatchingResourceGroupNameWithUrl – Det angivna resursgruppsnamnet matchade inte namnet i URL:en. 400 MismatchingServerNameWithUrl – det angivna servernamnet matchade inte namnet i URL:en. 400 NullVirtualNetworkRequest – Virtual Network begäran är null 400 NullVirtualNetworkRequestParameters – Virtual Network parametrar för begäran är null 400 FirewallChangesDeniedBecausePublicEndpointDisabled – Det går inte att skapa eller ändra brandväggsregler när offentlig nätverksåtkomst för servern är inaktiverad. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest – Azure SQL Server Virtual Network-regeln påträffade ett användarfel 400 VirtualNetworkRuleWithFailoverGroupsNotSupported – Brandväggsregler för virtuella nätverk stöds för närvarande inte på servrar med redundansgrupper som konfigurerats med en princip för automatisk redundans. Konfigurera redundansgrupperna på servern med en manuell redundansprincip. 400 NullVirtualNetworkSubnetId – Virtual Network undernäts-ID är null 403 VirtualNetworkRuleAccessDenied – behörighetsfel påträffades för Azure SQL Server Virtual Network regel 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 VirtualNetworkRuleNotEnabled – funktionen Azure SQL Server Virtual Network Rule är inte aktiverad 404 VirtualNetworkRuleResourceNotFound – Azure SQL Server Virtual Network-regeln påträffade ett resursfel som inte hittades 404 VirtualNetworkRuleSubscriptionNotFound – Azure SQL Server Virtual Network Prenumerations-ID hittades inte eller är i inaktiverat tillstånd 404 OperationIdNotFound – åtgärden med ID finns inte. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 OperationInterrupted – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 504 VirtualNetworkRuleTimedOut – Azure SQL Server Virtual Network regel påträffade en tidsgräns

Exempel

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

Definitioner

Name	Description
VirtualNetworkRule	En regel för virtuellt nätverk.
VirtualNetworkRuleState	Virtual Network regeltillstånd

VirtualNetworkRule

En regel för virtuellt nätverk.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.ignoreMissingVnetServiceEndpoint	boolean	Skapa brandväggsregel innan VNet-tjänstslutpunkten är aktiverad för det virtuella nätverket.
properties.state	VirtualNetworkRuleState	Virtual Network regeltillstånd
properties.virtualNetworkSubnetId	string	ARM-resurs-ID för det virtuella nätverkets undernät.
type	string	Resurstyp.

VirtualNetworkRuleState

Virtual Network regeltillstånd

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