다음을 통해 공유

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 매개 변수

Name In(다음 안에) 필수 형식 Description
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 버전입니다.

요청 본문

Name 필수 형식 Description
properties.virtualNetworkSubnetId True

string

가상 네트워크 서브넷의 ARM 리소스 ID입니다.
properties.ignoreMissingVnetServiceEndpoint

boolean

가상 네트워크에 vnet 서비스 엔드포인트가 활성화되기 전에 방화벽 규칙을 만듭니다.

응답

Name 형식 Description
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 서버 Virtual Network 규칙에서 사용자 오류가 발생했습니다.

  • 400 VirtualNetworkRuleWithFailoverGroupsNotSupported - 가상 네트워크 방화벽 규칙은 현재 자동 장애 조치(failover) 정책으로 구성된 장애 조치(failover) 그룹이 있는 서버에서 지원되지 않습니다. 수동 장애 조치(failover) 정책을 사용하여 서버에서 장애 조치(failover) 그룹을 구성하세요.

  • 400 NullVirtualNetworkSubnetId - Virtual Network 서브넷 ID가 null입니다.

  • 403 VirtualNetworkRuleAccessDenied - Azure SQL 서버 Virtual Network 규칙에서 사용 권한 오류가 발생했습니다.

  • 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.

  • 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

  • 404 VirtualNetworkRuleNotEnabled - Azure SQL 서버 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

샘플 요청

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

샘플 응답

상태 코드:
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

정의

Name Description
VirtualNetworkRule

가상 네트워크 규칙입니다.
VirtualNetworkRuleState

Virtual Network 규칙 상태

VirtualNetworkRule

가상 네트워크 규칙입니다.

Name 형식 Description
id

string

리소스 ID입니다.
name

string

리소스 이름입니다.
properties.ignoreMissingVnetServiceEndpoint

boolean

가상 네트워크에 vnet 서비스 엔드포인트가 활성화되기 전에 방화벽 규칙을 만듭니다.
properties.state

VirtualNetworkRuleState

Virtual Network 규칙 상태
properties.virtualNetworkSubnetId

string

가상 네트워크 서브넷의 ARM 리소스 ID입니다.
type

string

리소스 종류.

VirtualNetworkRuleState

Virtual Network 규칙 상태

Name 형식 Description
Deleting

string

Failed

string

InProgress

string

Initializing

string

Ready

string

Unknown

string