你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

IP Firewall ll Rules - Create Or Update

创建或更新 IPv6 防火墙规则。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/ipv6FirewallRules/{firewallRuleName}?api-version=2022-02-01-preview

URI 参数

Name In Required Type Description
firewallRuleName
path True
  • string

防火墙规则的名称。

resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Type Description
name
  • string

资源名称。

properties.endIPv6Address
  • string

防火墙规则的结束 IP 地址。 必须是 IPv6 格式。 必须大于或等于 startIpAddress。

properties.startIPv6Address
  • string

防火墙规则的起始 IP 地址。 必须是 IPv6 格式。

响应

Name Type Description
200 OK

已成功更新 IPv6 防火墙规则。

201 Created

已成功创建 IPv6 防火墙规则。

Other Status Codes

错误响应: ***

  • 400 InvalidResourceId - 资源标识符无效。

  • 400 不匹配SubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。

  • 400 不匹配ResourceGroupNameWithUrl - 提供的资源组名称与 URL 中的名称不匹配。

  • 400 不匹配ServerNameWithUrl - 提供的服务器名称与 URL 中的名称不匹配。

  • 400 InvalidIPv6ServerFirewallRuleResourceRequest - IPv6 服务器防火墙规则资源请求无效。

  • 400 InvalidIPv6ServerFirewallRuleResourceParameters - IPv6 服务器防火墙规则资源参数无效。

  • 400 DenyPublicEndpointEnabled - 禁用服务器的公共网络接口时无法创建或修改防火墙规则。 若要管理服务器或数据库级防火墙规则,请启用公共网络接口。

  • 400 IPv6FirewallRuleNameEmpty - 提供的 IPv6 防火墙规则名称为空

  • 400 FirewallRuleNotIPv6Address - 提供的防火墙规则地址不是 IPv6

  • 400 IPv6FirewallRuleNameTooLong - 提供的 IPv6 防火墙规则名称太长

  • 400 IPv6FirewallRuleInvalidRange - 指定的 IPv6 防火墙规则范围无效。

  • 400 TooManyIPv6FirewallRules - 提供的 IPv6 防火墙规则超出限制。

  • 400 IPv6EndpointDisabled - IPv6 终结点已禁用。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

示例

Create an IPv6 firewall rule max/min
Update an IPv6 firewall rule max/min

Create an IPv6 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/ipv6FirewallRules/firewallrulecrudtest-5370?api-version=2022-02-01-preview

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-5370",
  "name": "firewallrulecrudtest-5370",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0003"
  }
}

Update an IPv6 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/ipv6FirewallRules/firewallrulecrudtest-3927?api-version=2022-02-01-preview

{
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/firewallrulecrudtest-12/providers/Microsoft.Sql/servers/firewallrulecrudtest-6285/ipv6FirewallRules/firewallrulecrudtest-3927",
  "name": "firewallrulecrudtest-3927",
  "type": "Microsoft.Sql/servers/ipv6FirewallRules",
  "properties": {
    "startIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001",
    "endIPv6Address": "0000:0000:0000:0000:0000:ffff:0000:0001"
  }
}

定义

IPv6 FirewallRule

IPv6 服务器防火墙规则。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.endIPv6Address
  • string

防火墙规则的结束 IP 地址。 必须是 IPv6 格式。 必须大于或等于 startIpAddress。

properties.startIPv6Address
  • string

防火墙规则的起始 IP 地址。 必须是 IPv6 格式。

type
  • string

资源类型。