IP Firewall ll Rules - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Creates or updates an IPv6 firewall rule.

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

URI Parameters

Name	In	Required	Type	Description
firewallRuleName	path	True	string	The name of the firewall rule.
resourceGroupName	path	True	string	The name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal.
serverName	path	True	string	The name of the server.
subscriptionId	path	True	string	The subscription ID that identifies an Azure subscription.
api-version	query	True	string	The API version to use for the request.

Request Body

Name	Type	Description
name	string	Resource name.
properties.endIPv6Address	string	The end IP address of the firewall rule. Must be IPv6 format. Must be greater than or equal to startIpAddress.
properties.startIPv6Address	string	The start IP address of the firewall rule. Must be IPv6 format.

Responses

Name	Type	Description
200 OK	IPv6FirewallRule	Successfully updated the IPv6 firewall rule.
201 Created	IPv6FirewallRule	Successfully created the IPv6 firewall rule.
Other Status Codes		*** Error Responses: *** 400 InvalidResourceId - Invalid resource identifier. 400 MismatchingSubscriptionWithUrl - The provided subscription did not match the subscription in the Url. 400 MismatchingResourceGroupNameWithUrl - The provided resource group name did not match the name in the Url. 400 MismatchingServerNameWithUrl - The provided server name did not match the name in the Url. 400 InvalidIPv6ServerFirewallRuleResourceRequest - The IPv6 server firewall rule resource request is invalid. 400 InvalidIPv6ServerFirewallRuleResourceParameters - The IPv6 server firewall rule resource parameter is invalid. 400 DenyPublicEndpointEnabled - Unable to create or modify firewall rules when public network interface for the server is disabled. To manage server or database level firewall rules, please enable the public network interface. 400 IPv6FirewallRuleNameEmpty - The provided IPv6 firewall rule name is empty 400 FirewallRuleNotIPv6Address - The provided firewall rule address is not IPv6 400 IPv6FirewallRuleNameTooLong - The provided IPv6 firewall rule name is too long 400 IPv6FirewallRuleInvalidRange - The specified IPv6 firewall rule range is invalid. 400 TooManyIPv6FirewallRules - The provided IPv6 firewall rules are over the limit. 400 IPv6EndpointDisabled - The IPv6 endpoint is disabled. 404 SubscriptionDoesNotHaveServer - The requested server was not found 404 ServerNotInSubscriptionResourceGroup - Specified server does not exist in the specified resource group and subscription.

Examples

Create an IPv6 firewall rule max/min

Update an IPv6 firewall rule max/min

Create an IPv6 firewall rule max/min

Sample request

HTTP

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

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

Java

import com.azure.resourcemanager.sql.fluent.models.IPv6FirewallRuleInner;

/**
 * Samples for IPv6FirewallRules CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/IPv6FirewallRuleCreate.json
     */
    /**
     * Sample code: Create an IPv6 firewall rule max/min.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAnIPv6FirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getIPv6FirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-5370",
            new IPv6FirewallRuleInner().withStartIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0003")
                .withEndIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0003"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:

200

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

Status code:

201

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

HTTP

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

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

Java

import com.azure.resourcemanager.sql.fluent.models.IPv6FirewallRuleInner;

/**
 * Samples for IPv6FirewallRules CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/IPv6FirewallRuleUpdate.json
     */
    /**
     * Sample code: Update an IPv6 firewall rule max/min.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAnIPv6FirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getIPv6FirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-3927",
            new IPv6FirewallRuleInner().withStartIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0001")
                .withEndIPv6Address("0000:0000:0000:0000:0000:ffff:0000:0001"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:

200

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

Status code:

201

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

Definitions

IPv6FirewallRule

An IPv6 server firewall rule.

Name	Type	Description
id	string	Resource ID.
name	string	Resource name.
properties.endIPv6Address	string	The end IP address of the firewall rule. Must be IPv6 format. Must be greater than or equal to startIpAddress.
properties.startIPv6Address	string	The start IP address of the firewall rule. Must be IPv6 format.
type	string	Resource type.