Share via

Virtual Network Rules - Create Or Update

  • リファレンス
Service:
SQL Database
API Version:
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

リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。
serverName
 path True

string

サーバーの名前。
subscriptionId
 path True

string

Azure サブスクリプションを識別するサブスクリプション ID。
virtualNetworkRuleName
 path True

string

仮想ネットワーク規則の名前。
api-version
 query True

string

要求で使用する API のバージョン。

要求本文

名前 必須 型 説明
properties.virtualNetworkSubnetId True

string

仮想ネットワーク サブネットの ARM リソース ID。
properties.ignoreMissingVnetServiceEndpoint

boolean

仮想ネットワークで vnet サービス エンドポイントが有効になる前に、ファイアウォール規則を作成します。

応答

名前 型 説明
200 OK

VirtualNetworkRule

仮想ネットワーク規則が正常に更新されました。
201 Created

VirtualNetworkRule

仮想ネットワーク規則が正常に作成されました。
202 Accepted

同意
Other Status Codes

エラー応答: ***

  • 400 InvalidResourceId - リソース識別子が無効です。

  • 400 MismatchingSubscriptionWithUrl - 指定されたサブスクリプションが URL 内のサブスクリプションと一致しませんでした。

  • 400 MismatchingResourceGroupNameWithUrl - 指定されたリソース グループ名が URL の名前と一致しませんでした。

  • 400 MismatchingServerNameWithUrl - 指定されたサーバー名が URL の名前と一致しませんでした。

  • 400 NullVirtualNetworkRequest - Virtual Network要求が Null です

  • 400 NullVirtualNetworkRequestParameters - Virtual Network要求パラメーターが Null です

  • 400 FirewallChangesDeniedBecausePublicEndpointDisabled - サーバーのパブリック ネットワーク アクセスが無効になっていると、ファイアウォール規則を作成または変更できません。 (https://docs.microsoft.com/en-us/azure/azure-sql/database/connectivity-settings#deny-public-network-access)

  • 400 VirtualNetworkRuleBadRequest - Azure SQL Server Virtual Network ルールでユーザー エラーが発生しました

  • 400 VirtualNetworkRuleWithFailoverGroupsNotSupported - 自動フェールオーバー ポリシーで構成されたフェールオーバー グループを持つサーバーでは、仮想ネットワーク ファイアウォール規則は現在サポートされていません。 手動フェールオーバー ポリシーを使用して、サーバー上のフェールオーバー グループを構成してください。

  • 400 NullVirtualNetworkSubnetId - Virtual Network サブネット ID が null です

  • 403 VirtualNetworkRuleAccessDenied - Azure SQL Server Virtual Network ルールでアクセス許可エラーが発生しました

  • 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした

  • 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。

  • 404 VirtualNetworkRuleNotEnabled - Azure SQL Server Virtual Network ルール機能が有効になっていません

  • 404 VirtualNetworkRuleResourceNotFound - Azure SQL Server Virtual Network ルールでリソースが見つかりませんエラーが発生しました

  • 404 VirtualNetworkRuleSubscriptionNotFound - Azure SQL Server Virtual Network サブスクリプション ID が見つからないか、無効な状態です

  • 404 OperationIdNotFound - Id を持つ操作が存在しません。

  • 409 OperationCancelled - 操作がユーザーによって取り消されました。

  • 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。

  • 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

  • 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

  • 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。 操作をやり直してください。

  • 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

  • 504 VirtualNetworkRuleTimedOut - Azure SQL Server Virtual Network ルールでタイムアウトが発生しました

例

Create or update a virtual network rule

Sample Request

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

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

定義

名前 説明
VirtualNetworkRule

仮想ネットワーク規則。
VirtualNetworkRuleState

Virtual Network ルールの状態

VirtualNetworkRule

仮想ネットワーク規則。

名前 型 説明
id

string

リソースの ID
name

string

リソース名。
properties.ignoreMissingVnetServiceEndpoint

boolean

仮想ネットワークで vnet サービス エンドポイントが有効になる前に、ファイアウォール規則を作成します。
properties.state

VirtualNetworkRuleState

Virtual Network ルールの状態
properties.virtualNetworkSubnetId

string

仮想ネットワーク サブネットの ARM リソース ID。
type

string

リソースの種類。

VirtualNetworkRuleState

Virtual Network ルールの状態

名前 型 説明
Deleting

string

Failed

string

InProgress

string

Initializing

string

Ready

string

Unknown

string