Firewall 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}/firewallRules/{firewallRuleName}?api-version=2021-11-01

URI 參數

名稱 位於 必要 類型 Description
firewallRuleName
 path True

string

防火牆規則的名稱。
resourceGroupName
 path True

string

包含資源的資源群組名稱。 您可以從 Azure 資源管理員 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

錯誤回應： ≦

  • 400 InvalidResourceId - 無效的資源識別碼。

  • 400 不符SubscriptionWithUrl - 提供的訂用帳戶不符合 URL 中的訂用帳戶。

  • 400 不符ResourceGroupNameWithUrl - 提供的資源組名與 URL 中的名稱不符。

  • 400 不相符ServerNameWithUrl - 提供的伺服器名稱與 URL 中的名稱不符。

  • 400 InvalidServerFirewallRuleResourceRequest - 伺服器防火牆規則資源要求無效。

  • 400 InvalidServerFirewallRuleResourceParameters - 伺服器防火牆規則資源參數無效。

  • 400 FirewallRuleNotIPv4Address - 提供的防火牆規則位址不是 IPv4

  • 400 TooManyFirewallRules - 提供的防火牆規則超過限制。

  • 400 FirewallRuleInvalidRange - 指定的防火牆規則範圍無效。

  • 400 FirewallRuleNameTooLong - 提供的防火牆規則名稱太長

  • 400 FirewallRuleNameEmpty - 提供的防火牆規則名稱是空的

  • 400 DenyPublicEndpointEnabled - 停用伺服器的公用網路介面時，無法建立或修改防火牆規則。 若要管理伺服器或資料庫層級防火牆規則，請啟用公用網路介面。

  • 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。

  • 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。

  • 429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。

  • 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

範例

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

Create a firewall rule max/min

Sample Request

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=2021-11-01

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

Sample Response

Status code:
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"
  }
}
Status code:
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

Sample Request

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=2021-11-01

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

Sample Response

Status code:
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"
  }
}
Status code:
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"
  }
}

定義

FirewallRule

伺服器防火牆規則。

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

資源類型。