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 參數

名稱	位於	必要	類型	Description
firewallRuleName	path	True	string	防火牆規則的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure Resource Manager API 或入口網站取得此值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	類型	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』。

回應

名稱	類型	Description
200 OK	FirewallRule	已成功更新防火牆規則。
201 Created	FirewallRule	已成功建立防火牆規則。
Other Status Codes	ErrorResponse	錯誤回應： *** 400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業 400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業 400 InvalidResourceId - 無效的資源識別碼。 400 MismatchingSubscriptionWithUrl - 提供的訂用帳戶不符合 Url 中的訂用帳戶。 400 不符ResourceGroupNameWithUrl - 提供的資源組名不符合 Url 中的名稱。 400 不相符ServerNameWithUrl - 提供的伺服器名稱不符合 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 - 超出可用資源可處理之最大要求的要求。

名稱

類型

Description

200 OK

FirewallRule

已成功更新防火牆規則。

201 Created

FirewallRule

已成功建立防火牆規則。

Other Status Codes

ErrorResponse

錯誤回應： ***

400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業
400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業
400 InvalidResourceId - 無效的資源識別碼。
400 MismatchingSubscriptionWithUrl - 提供的訂用帳戶不符合 Url 中的訂用帳戶。
400 不符ResourceGroupNameWithUrl - 提供的資源組名不符合 Url 中的名稱。
400 不相符ServerNameWithUrl - 提供的伺服器名稱不符合 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

範例要求

HTTP

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

範例要求

HTTP

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

定義

名稱	Description
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
FirewallRule	伺服器防火牆規則。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

FirewallRule

Object

伺服器防火牆規則。

名稱	類型	Description
id	string	資源標識碼。
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	資源類型。

共用方式為

Firewall Rules - Create Or Update

URI 參數

要求本文

回應

範例

Create a firewall rule max/min

範例要求

範例回覆

Update a firewall rule max/min

範例要求

範例回覆

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FirewallRule

其他資源