次の方法で共有

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

名前 / 必須 型 説明
firewallRuleName
 path True

string

ファイアウォール規則の名前。
resourceGroupName
 path True

string

リソースを含むリソース グループの名前。 この値は、Azure Resource Manager 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

ErrorResponse

エラー応答: ***

  • 400 ManagedInstanceStoppingOrStopped - インスタンスが停止/停止状態にある間に送信された操作の競合

  • 400 ManagedInstanceStarting - インスタンスが開始状態の間に送信された操作の競合

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

  • 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

要求のサンプル

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

要求のサンプル

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

定義

名前 説明
ErrorAdditionalInfo

リソース管理エラーの追加情報。
ErrorDetail

エラーの詳細。
ErrorResponse

エラー応答
FirewallRule

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

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

FirewallRule

Object

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

名前 型 説明
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

リソースの種類。