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 パラメーター

名前	/	必須	型	説明
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	string	リソース名。
properties.endIpAddress	string	ファイアウォール規則の終了 IP アドレス。 IPv4 形式である必要があります。 startIpAddress 以上である必要があります。すべての Azure 内部 IP アドレスに値 '0.0.0.0' を使用します。
properties.startIpAddress	string	ファイアウォール規則の開始 IP アドレス。 IPv4 形式である必要があります。すべての Azure 内部 IP アドレスに値 '0.0.0.0' を使用します。

応答

名前	型	説明
200 OK	FirewallRule	ファイアウォール規則が正常に更新されました。
201 Created	FirewallRule	ファイアウォール規則が正常に作成されました。
Other Status Codes		エラー応答: *** 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 - サーバーのパブリックネットワークインターフェイスが無効になっている場合、ファイアウォール規則を作成または変更できません。サーバーレベルまたはデータベースレベルのファイアウォール規則を管理するには、パブリックネットワークインターフェイスを有効にしてください。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

名前

型

説明

200 OK

FirewallRule

ファイアウォール規則が正常に更新されました。

201 Created

FirewallRule

ファイアウォール規則が正常に作成されました。

Other Status Codes

エラー応答: ***

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 - サーバーのパブリックネットワークインターフェイスが無効になっている場合、ファイアウォール規則を作成または変更できません。サーバーレベルまたはデータベースレベルのファイアウォール規則を管理するには、パブリックネットワークインターフェイスを有効にしてください。
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

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleCreate.json
     */
    /**
     * Sample code: Create a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-5370",
            new FirewallRuleInner().withStartIpAddress("0.0.0.3").withEndIpAddress("0.0.0.3"), 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/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

HTTP
Java

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.FirewallRuleInner;

/** Samples for FirewallRules CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/FirewallRuleUpdate.json
     */
    /**
     * Sample code: Update a firewall rule max/min.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateAFirewallRuleMaxMin(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getFirewallRules().createOrUpdateWithResponse(
            "firewallrulecrudtest-12", "firewallrulecrudtest-6285", "firewallrulecrudtest-3927",
            new FirewallRuleInner().withStartIpAddress("0.0.0.1").withEndIpAddress("0.0.0.1"), 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/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

サーバーファイアウォール規則。

名前	型	説明
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	リソースの種類。

Firewall Rules - Create Or Update

URI パラメーター

要求本文

応答

例

Create a firewall rule max/min

Sample Request

Sample Response

Update a firewall rule max/min

Sample Request

Sample Response

定義

FirewallRule

その他のリソース