Virtual Network Rules - Create Or Update

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Erstellt oder aktualisiert eine vorhandene Regel für virtuelle Netzwerke.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
virtualNetworkRuleName	path	True	string	Der Name der Regel für virtuelle Netzwerke.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.virtualNetworkSubnetId	True	string	Die ARM-Ressourcen-ID des Subnetzes des virtuellen Netzwerks.
properties.ignoreMissingVnetServiceEndpoint		boolean	Erstellen Sie eine Firewallregel, bevor für das virtuelle Netzwerk der VNET-Dienstendpunkt aktiviert ist.

Antworten

Name	Typ	Beschreibung
200 OK	VirtualNetworkRule	Eine Regel für virtuelle Netzwerke wurde erfolgreich aktualisiert.
201 Created	VirtualNetworkRule	Eine Regel für virtuelle Netzwerke wurde erfolgreich erstellt.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 InvalidResourceId: Ungültiger Ressourcenbezeichner. 400 MismatchingSubscriptionWithUrl: Das bereitgestellte Abonnement stimmte nicht mit dem Abonnement in der URL überein. 400 MismatchingResourceGroupNameWithUrl: Der angegebene Ressourcengruppenname stimmte nicht mit dem Namen in der URL überein. 400 MismatchingServerNameWithUrl: Der angegebene Servername stimmte nicht mit dem Namen in der URL überein. 400 NullVirtualNetworkRequest – Virtual Network Anforderung ist NULL 400 NullVirtualNetworkRequestParameters: Virtual Network Anforderungsparameter sind NULL 400 FirewallChangesDeniedBecausePublicEndpointDisabled: Firewallregeln können nicht erstellt oder geändert werden, wenn der öffentliche Netzwerkzugriff für den Server deaktiviert ist. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest– Azure SQL Server Virtual Network Regel ist ein Benutzerfehler aufgetreten 400 VirtualNetworkRuleWithFailoverGroupsNotSupported: Firewallregeln für virtuelle Netzwerke werden derzeit nicht auf Servern mit Failovergruppen unterstützt, die mit einer automatischen Failoverrichtlinie konfiguriert sind. Konfigurieren Sie die Failovergruppen auf dem Server mit einer manuellen Failoverrichtlinie. 400 NullVirtualNetworkSubnetId: Die Virtual Network Subnetz-ID ist NULL 403 VirtualNetworkRuleAccessDenied: Berechtigungsfehler Azure SQL Server Virtual Network Regel 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 VirtualNetworkRuleNotEnabled– Azure SQL Server Virtual Network Rule-Feature ist nicht aktiviert 404 VirtualNetworkRuleResourceNotFound: Azure SQL Server Virtual Network Rule hat einen Fehler "Ressource nicht gefunden" gefunden 404 VirtualNetworkRuleSubscriptionNotFound: Azure SQL Server Virtual Network Abonnement-ID nicht gefunden oder befindet sich im deaktivierten Zustand 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 504 VirtualNetworkRuleTimedOut: Azure SQL Server Virtual Network Regel ein Timeout gefunden

Beispiele

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

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Statuscode:: 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"
  }
}

Statuscode:: 202

Definitionen

Name	Beschreibung
VirtualNetworkRule	Eine Regel für virtuelle Netzwerke.
VirtualNetworkRuleState	Virtual Network Regelzustand

VirtualNetworkRule

Eine Regel für virtuelle Netzwerke.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.ignoreMissingVnetServiceEndpoint	boolean	Erstellen Sie eine Firewallregel, bevor für das virtuelle Netzwerk der VNET-Dienstendpunkt aktiviert ist.
properties.state	VirtualNetworkRuleState	Virtual Network Regelzustand
properties.virtualNetworkSubnetId	string	Die ARM-Ressourcen-ID des Subnetzes des virtuellen Netzwerks.
type	string	Der Ressourcentyp.

VirtualNetworkRuleState

Virtual Network Regelzustand

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

Freigeben über