Virtual Network Rules - Create Or Update

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Создает или обновляет существующее правило виртуальной сети.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
serverName	path	True	string	Имени сервера.
subscriptionId	path	True	string	Идентификатор подписки, идентифицирующий подписку Azure.
virtualNetworkRuleName	path	True	string	Имя правила виртуальной сети.
api-version	query	True	string	Версия API, используемая для запроса.

Текст запроса

Имя	Обязательно	Тип	Описание
properties.virtualNetworkSubnetId	True	string (arm-id)	Идентификатор ресурса ARM подсети виртуальной сети.
properties.ignoreMissingVnetServiceEndpoint		boolean	Создайте правило брандмауэра до включения конечной точки службы виртуальной сети.

Ответы

Имя	Тип	Описание
200 OK	VirtualNetworkRule	Успешно обновлено правило виртуальной сети.
201 Created	VirtualNetworkRule	Успешно создано правило виртуальной сети.
202 Accepted		Принято
Other Status Codes		Ответы на ошибки: *** 400 InvalidResourceId — недопустимый идентификатор ресурса. 400 НесоответствиеSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе. 400 MismatchingResourceGroupNameWithUrl — предоставленное имя группы ресурсов не совпадает с именем в URL-адресе. 400 MismatchingServerNameWithUrl — предоставленное имя сервера не совпадает с именем в URL-адресе. 400 NullVirtualNetworkRequest — запрос виртуальной сети имеет значение NULL 400 NullVirtualNetworkRequestParameters — параметры запроса виртуальной сети имеют значение NULL 400 FirewallChangesDeniedBecausePublicEndpointDisabled — не удается создать или изменить правила брандмауэра при отключении доступа к общедоступной сети для сервера. (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access) 400 VirtualNetworkRuleBadRequest — правило виртуальной сети SQL Server Azure столкнулось с ошибкой пользователя. 400 VirtualNetworkRuleWithFailoverGroupsNotSupported . Правила брандмауэра виртуальной сети в настоящее время не поддерживаются на серверах с группами отработки отказа, настроенными с политикой автоматической отработки отказа. Настройте группы отработки отказа на сервере с помощью политики отработки отказа вручную. 400 NullVirtualNetworkSubnetId — идентификатор подсети виртуальной сети имеет значение NULL 403 VirtualNetworkRuleAccessDenied — возникла ошибка разрешений в правиле виртуальной сети SQL Server. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 VirtualNetworkRuleNotEnabled — функция правила виртуальной сети SQL Server Azure не включена. 404 VirtualNetworkRuleResourceNotFound — правило виртуальной сети SQL Server Azure обнаружило ошибку, не найденную ошибку. 404 VirtualNetworkRuleSubscriptionNotFound — идентификатор подписки виртуальной сети AZURE SQL Server не найден или отключен. 404 OperationIdNotFound — операция с идентификатором не существует. 409 OperationCancelled — операция отменена пользователем. 409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 504 VirtualNetworkRuleTimedOut — правило виртуальной сети SQL Server Azure обнаружило время ожидания

Примеры

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

Пример ответа

Код состояния:: 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"
  }
}

Код состояния:: 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"
  }
}

Код состояния:: 202

Определения

Имя	Описание
VirtualNetworkRule	Правило виртуальной сети.
VirtualNetworkRuleState	Состояние правила виртуальной сети

VirtualNetworkRule

Object

Правило виртуальной сети.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.ignoreMissingVnetServiceEndpoint	boolean	Создайте правило брандмауэра до включения конечной точки службы виртуальной сети.
properties.state	VirtualNetworkRuleState	Состояние правила виртуальной сети
properties.virtualNetworkSubnetId	string (arm-id)	Идентификатор ресурса ARM подсети виртуальной сети.
type	string	Тип ресурса.

VirtualNetworkRuleState

Перечисление

Состояние правила виртуальной сети

Значение	Описание
Deleting
Failed
InProgress
Initializing
Ready
Unknown

Поделиться через