다음을 통해 공유

Firewall Rules - Create Or Update

  • 참조
서비스:
SQL Database
API 버전:
2023-08-01

방화벽 규칙을 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/firewallRules/{firewallRuleName}?api-version=2023-08-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
firewallRuleName
 path True

string

방화벽 규칙의 이름입니다.
resourceGroupName
 path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName
 path True

string

서버의 이름입니다.
subscriptionId
 path True

string

Azure 구독을 식별하는 구독 ID입니다.
api-version
 query True

string

요청에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
name

string

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

string

방화벽 규칙의 끝 IP 주소입니다. IPv4 형식이어야 합니다. startIpAddress보다 크거나 같아야 합니다. 모든 Azure 내부 IP 주소에 값 '0.0.0.0'을 사용합니다.
properties.startIpAddress

string

방화벽 규칙의 시작 IP 주소입니다. IPv4 형식이어야 합니다. 모든 Azure 내부 IP 주소에 값 '0.0.0.0'을 사용합니다.

응답

Name 형식 Description
200 OK

FirewallRule

방화벽 규칙을 업데이트했습니다.
201 Created

FirewallRule

방화벽 규칙을 만들었습니다.
Other Status Codes

ErrorResponse

오류 응답: ***

  • 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업

  • 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업

  • 400 InvalidResourceId - 잘못된 리소스 식별자입니다.

  • 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다.

  • 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다.

  • 400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다.

  • 400 InvalidServerFirewallRuleResourceRequest - 서버 방화벽 규칙 리소스 요청이 잘못되었습니다.

  • 400 InvalidServerFirewallRuleResourceParameters - 서버 방화벽 규칙 리소스 매개 변수가 잘못되었습니다.

  • 400 FirewallRuleNotIPv4Address - 제공된 방화벽 규칙 주소가 IPv4가 아닙니다.

  • 400 TooManyFirewallRules - 제공된 방화벽 규칙이 제한을 초과합니다.

  • 400 FirewallRuleInvalidRange - 지정된 방화벽 규칙 범위가 잘못되었습니다.

  • 400 FirewallRuleNameTooLong - 제공된 방화벽 규칙 이름이 너무 깁니다.

  • 400 FirewallRuleNameEmpty - 제공된 방화벽 규칙 이름이 비어 있습니다.

  • 400 DenyPublicEndpointEnabled - 서버에 대한 공용 네트워크 인터페이스를 사용하지 않도록 설정하면 방화벽 규칙을 만들거나 수정할 수 없습니다. 서버 또는 데이터베이스 수준 방화벽 규칙을 관리하려면 공용 네트워크 인터페이스를 사용하도록 설정하세요.

  • 400 FirewallRuleNameInvalid - 제공된 방화벽 규칙 이름에 특수 문자가 포함됩니다.

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

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

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Create a firewall rule max/min
Update a firewall rule max/min

Create a firewall rule max/min

샘플 요청

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370?api-version=2023-08-01

{
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}
상태 코드:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "properties": {
    "startIpAddress": "0.0.0.3",
    "endIpAddress": "0.0.0.3"
  }
}

Update a firewall rule max/min

샘플 요청

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927?api-version=2023-08-01

{
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}
상태 코드:
201 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/firewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/firewallRules",
  "properties": {
    "startIpAddress": "0.0.0.1",
    "endIpAddress": "0.0.0.1"
  }
}

정의

Name Description
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
FirewallRule

서버 방화벽 규칙입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

Object

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

FirewallRule

Object

서버 방화벽 규칙입니다.

Name 형식 Description
id

string

리소스 ID입니다.
name

string

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

string

방화벽 규칙의 끝 IP 주소입니다. IPv4 형식이어야 합니다. startIpAddress보다 크거나 같아야 합니다. 모든 Azure 내부 IP 주소에 값 '0.0.0.0'을 사용합니다.
properties.startIpAddress

string

방화벽 규칙의 시작 IP 주소입니다. IPv4 형식이어야 합니다. 모든 Azure 내부 IP 주소에 값 '0.0.0.0'을 사용합니다.
type

string

리소스 종류입니다.