Virtual Network Rules - Create Or Update

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Vytvoří nebo aktualizuje existující pravidlo virtuální sítě.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
virtualNetworkRuleName	path	True	string	Název pravidla virtuální sítě.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
properties.virtualNetworkSubnetId	True	string	ID prostředku ARM podsítě virtuální sítě
properties.ignoreMissingVnetServiceEndpoint		boolean	Vytvořte pravidlo brány firewall předtím, než má virtuální síť povolený koncový bod služby virtuální sítě.

Odpovědi

Name	Typ	Description
200 OK	VirtualNetworkRule	Pravidlo virtuální sítě se úspěšně aktualizovalo.
201 Created	VirtualNetworkRule	Pravidlo virtuální sítě se úspěšně vytvořilo.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 InvalidResourceId – neplatný identifikátor prostředku. 400 NeshodaSubscriptionWithUrl – zadané předplatné neodpovídá předplatnému v adrese URL. 400 NeshodaResourceGroupNameWithUrl – zadaný název skupiny prostředků neodpovídá názvu v adrese URL. 400 NeshodaServerNameWithUrl – zadaný název serveru neodpovídá názvu v adrese URL. 400 NullVirtualNetworkRequest – Virtual Network Požadavek má hodnotu Null. 400 NullVirtualNetworkRequestParameters – Virtual Network Parametry požadavku mají hodnotu Null. 400 FirewallChangesDeniedBecausePublicEndpointDisabled – Nelze vytvořit nebo upravit pravidla brány firewall, pokud je pro server zakázán veřejný síťový přístup. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest – Azure SQL Server Virtual Network Rule zjistil chybu uživatele 400 VirtualNetworkRuleWithFailoverGroupsNotSupported – Na serverech se skupinami převzetí služeb při selhání nakonfigurovanými pomocí zásad automatického převzetí služeb při selhání se v současné době nepodporují pravidla brány firewall virtuální sítě. Nakonfigurujte skupiny převzetí služeb při selhání na serveru pomocí zásad ručního převzetí služeb při selhání. 400 NullVirtualNetworkSubnetId – ID podsítě Virtual Network má hodnotu null. 403 VirtualNetworkRuleAccessDenied – Azure SQL Server Virtual Network Pravidlo zjistilo oprávnění 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 VirtualNetworkRuleNotEnabled – Azure SQL Server Virtual Network funkce pravidla není povolená 404 VirtualNetworkRuleResourceNotFound – Azure SQL Server Virtual Network Pravidlo zjistilo chybu prostředek nenalezeno 404 VirtualNetworkRuleSubscriptionNotFound – Azure SQL Server Virtual Network ID předplatného se nenašlo nebo je ve stavu zakázáno 404 OperationIdNotFound – operace s ID neexistuje. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 504 VirtualNetworkRuleTimedOut – Azure SQL Server Virtual Network Rule zjistil časový limit

Příklady

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 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"
  }
}

Stavový kód:: 202

Definice

Name	Description
VirtualNetworkRule	Pravidlo virtuální sítě.
VirtualNetworkRuleState	Virtual Network stav pravidla

VirtualNetworkRule

Pravidlo virtuální sítě.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.ignoreMissingVnetServiceEndpoint	boolean	Vytvořte pravidlo brány firewall předtím, než má virtuální síť povolený koncový bod služby virtuální sítě.
properties.state	VirtualNetworkRuleState	Virtual Network stav pravidla
properties.virtualNetworkSubnetId	string	ID prostředku ARM podsítě virtuální sítě
type	string	Typ prostředku.

VirtualNetworkRuleState

Virtual Network stav pravidla

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

Sdílet prostřednictvím