Virtual Network Rules - Create Or Update

Referensi

Service:: SQL Database

API Version:: 2021-11-01

Membuat atau memperbarui aturan jaringan virtual yang ada.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
serverName	path	True	string	Nama server.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
virtualNetworkRuleName	path	True	string	Nama aturan jaringan virtual.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
properties.virtualNetworkSubnetId	True	string	Id sumber daya ARM dari subnet jaringan virtual.
properties.ignoreMissingVnetServiceEndpoint		boolean	Buat aturan firewall sebelum jaringan virtual mengaktifkan titik akhir layanan vnet.

Respons

Nama	Jenis	Deskripsi
200 OK	VirtualNetworkRule	Berhasil memperbarui aturan jaringan virtual.
201 Created	VirtualNetworkRule	Berhasil membuat aturan jaringan virtual.
202 Accepted		Diterima
Other Status Codes		Respons Kesalahan: *** 400 InvalidResourceId - Pengidentifikasi sumber daya tidak valid. 400 MismatchingSubscriptionWithUrl - Langganan yang disediakan tidak cocok dengan langganan di Url. 400 MismatchingResourceGroupNameWithUrl - Nama grup sumber daya yang disediakan tidak cocok dengan nama di Url. 400 MismatchingServerNameWithUrl - Nama server yang disediakan tidak cocok dengan nama di Url. 400 NullVirtualNetworkRequest - Permintaan Virtual Network Null 400 NullVirtualNetworkRequestParameters - Parameter Permintaan Virtual Network Null 400 FirewallChangesDeniedBecausePublicEndpointDisabled - Tidak dapat membuat atau mengubah aturan firewall saat akses jaringan publik untuk server dinonaktifkan. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest - Aturan Virtual Network Server Azure SQL mengalami kesalahan pengguna 400 VirtualNetworkRuleWithFailoverGroupsNotSupported - Aturan firewall jaringan virtual saat ini tidak didukung di server dengan grup failover yang dikonfigurasi dengan kebijakan failover otomatis. Konfigurasikan grup failover pada server dengan kebijakan failover manual. 400 NullVirtualNetworkSubnetId - Id Subnet Virtual Network null 403 VirtualNetworkRuleAccessDenied - Aturan Virtual Network Server Azure SQL mengalami kesalahan izin 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 VirtualNetworkRuleNotEnabled - fitur Aturan Virtual Network Server Azure SQL tidak diaktifkan 404 VirtualNetworkRuleResourceNotFound - Aturan Virtual Network Server Azure SQL mengalami kesalahan sumber daya yang tidak ditemukan 404 VirtualNetworkRuleSubscriptionNotFound - id Langganan Virtual Network Server Azure SQL tidak ditemukan atau dalam status dinonaktifkan 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 504 VirtualNetworkRuleTimedOut - Aturan Virtual Network Server Azure SQL mengalami waktu habis

Contoh

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

Definisi

Nama	Deskripsi
VirtualNetworkRule	Aturan jaringan virtual.
VirtualNetworkRuleState	Status Aturan Virtual Network

VirtualNetworkRule

Aturan jaringan virtual.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.ignoreMissingVnetServiceEndpoint	boolean	Buat aturan firewall sebelum jaringan virtual mengaktifkan titik akhir layanan vnet.
properties.state	VirtualNetworkRuleState	Status Aturan Virtual Network
properties.virtualNetworkSubnetId	string	Id sumber daya ARM dari subnet jaringan virtual.
type	string	Jenis sumber daya

VirtualNetworkRuleState

Status Aturan Virtual Network

Nama	Jenis	Deskripsi
Deleting	string
Failed	string
InProgress	string
Initializing	string
Ready	string
Unknown	string