Virtual Network Rules - Create Or Update

Başvuru

Service:: SQL Database

API Version:: 2021-11-01

Mevcut bir sanal ağ kuralı oluşturur veya güncelleştirir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
virtualNetworkRuleName	path	True	string	Sanal ağ kuralının adı.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
properties.virtualNetworkSubnetId	True	string	Sanal ağ alt ağının ARM kaynak kimliği.
properties.ignoreMissingVnetServiceEndpoint		boolean	Sanal ağda sanal ağ hizmet uç noktası etkinleştirilmeden önce güvenlik duvarı kuralı oluşturun.

Yanıtlar

Name	Tür	Description
200 OK	VirtualNetworkRule	Bir sanal ağ kuralı başarıyla güncelleştirildi.
201 Created	VirtualNetworkRule	Bir sanal ağ kuralı başarıyla oluşturuldu.
202 Accepted		Kabul edildi
Other Status Codes		Hata Yanıtları: ** 400 InvalidResourceId - Geçersiz kaynak tanımlayıcısı. 400 MismatchingSubscriptionWithUrl - Sağlanan abonelik Url'deki abonelikle eşleşmedi. 400 MismatchingResourceGroupNameWithUrl - Sağlanan kaynak grubu adı Url'deki adla eşleşmedi. 400 MismatchingServerNameWithUrl - Sağlanan sunucu adı Url'deki adla eşleşmedi. 400 NullVirtualNetworkRequest - Sanal Ağ İsteği Null 400 NullVirtualNetworkRequestParameters - Sanal Ağ İstek Parametreleri Null 400 FirewallChangesDeniedBecausePublicEndpointDisabled - Sunucu için genel ağ erişimi devre dışı bırakıldığında güvenlik duvarı kuralları oluşturulamıyor veya değiştirilemiyor. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest - Azure SQL Server Sanal Ağ Kuralı kullanıcı hatasıyla karşılaştı 400 VirtualNetworkRuleWithFailoverGroupsNotSupported - Sanal ağ güvenlik duvarı kuralları şu anda otomatik yük devretme ilkesiyle yapılandırılmış yük devretme gruplarına sahip sunucularda desteklenmemektedir. Lütfen sunucudaki yük devretme gruplarını el ile yük devretme ilkesiyle yapılandırın. 400 NullVirtualNetworkSubnetId - Sanal Ağ Alt Ağ Kimliği null 403 VirtualNetworkRuleAccessDenied - Azure SQL Server Sanal Ağ Kuralı izinlerle karşılaştı hatası 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 VirtualNetworkRuleNotEnabled - Azure SQL Server Sanal Ağ Kuralı özelliği etkin değil 404 VirtualNetworkRuleResourceNotFound - Azure SQL Server Sanal Ağ Kuralı kaynak bulunamadı hatasıyla karşılaştı 404 VirtualNetworkRuleSubscriptionNotFound - Azure SQL Server Sanal Ağ Abonelik kimliği bulunamadı veya devre dışı durumda 404 OperationIdNotFound - Kimliği olan işlem yok. 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi. 409 İşlem Kesildi - Aynı kaynakta başka bir işlem tarafından kesintiye uğradığından kaynak üzerindeki işlem tamamlanamadı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 504 VirtualNetworkRuleTimedOut - Azure SQL Server Sanal Ağ Kuralı zaman aşımıyla karşılaştı

Örnekler

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

Tanımlar

Name	Description
VirtualNetworkRule	Bir sanal ağ kuralı.
VirtualNetworkRuleState	kural durumunu Sanal Ağ

VirtualNetworkRule

Bir sanal ağ kuralı.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.ignoreMissingVnetServiceEndpoint	boolean	Sanal ağda sanal ağ hizmet uç noktası etkinleştirilmeden önce güvenlik duvarı kuralı oluşturun.
properties.state	VirtualNetworkRuleState	kural durumunu Sanal Ağ
properties.virtualNetworkSubnetId	string	Sanal ağ alt ağının ARM kaynak kimliği.
type	string	Kaynak türü.

VirtualNetworkRuleState

kural durumunu Sanal Ağ

Name	Tür	Description
Deleting	string
Failed	string
InProgress	string
Initializing	string
Ready	string
Unknown	string