次の方法で共有


マイクロソフトネットワーク フロントドア 2019-04-01

Bicep リソース定義

frontDoors リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの 参照してください。

リソースの形式

Microsoft.Network/frontDoors リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Network/frontDoors@2019-04-01' = {
  location: 'string'
  name: 'string'
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              weight: int
            }
          ]
          healthProbeSettings: {
            id: 'string'
          }
          loadBalancingSettings: {
            id: 'string'
          }
        }
      }
    ]
    backendPoolsSettings: {
      enforceCertificateNameCheck: 'string'
    }
    enabledState: 'string'
    friendlyName: 'string'
    frontendEndpoints: [
      {
        id: 'string'
        name: 'string'
        properties: {
          hostName: 'string'
          sessionAffinityEnabledState: 'string'
          sessionAffinityTtlSeconds: int
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
    healthProbeSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          intervalInSeconds: int
          path: 'string'
          protocol: 'string'
        }
      }
    ]
    loadBalancingSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          additionalLatencyMilliseconds: int
          sampleSize: int
          successfulSamplesRequired: int
        }
      }
    ]
    routingRules: [
      {
        id: 'string'
        name: 'string'
        properties: {
          acceptedProtocols: [
            'string'
          ]
          enabledState: 'string'
          frontendEndpoints: [
            {
              id: 'string'
            }
          ]
          patternsToMatch: [
            'string'
          ]
          routeConfiguration: {
            @odata.type: 'string'
            // For remaining properties, see RouteConfiguration objects
          }
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

RouteConfiguration オブジェクト

オブジェクトの型を指定するには、@odata.type プロパティを設定します。

#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationの場合は、次の値を使用します。

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
  backendPool: {
    id: 'string'
  }
  cacheConfiguration: {
    dynamicCompression: 'string'
    queryParameterStripDirective: 'string'
  }
  customForwardingPath: 'string'
  forwardingProtocol: 'string'
}

#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfigurationの場合は、次を使用します。

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
  customFragment: 'string'
  customHost: 'string'
  customPath: 'string'
  customQueryString: 'string'
  redirectProtocol: 'string'
  redirectType: 'string'
}

プロパティ値

マイクロソフトネットワーク/フロントドア

名前 形容 価値
場所 リソースの場所。
名前 リソース名

制約:
最小長 = 5
最大長 = 64
パターン = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (必須)
プロパティ Front Door Load Balancer のプロパティ フロントドアプロパティ
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート タグを参照してください

バックエンド

名前 形容 価値
住所 バックエンドの場所 (IP アドレスまたは FQDN)
バックエンドホストヘッダー バックエンドに送信されるホスト ヘッダーとして使用する値。 空白または未指定の場合、これは既定で受信ホストに設定されます。
enabledState(有効状態) このバックエンドの使用を有効にするかどうか。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
httpポート(httpPort) HTTP TCP ポート番号。 1 から 65535 の間である必要があります。 int

制約:
最小値 = 1
最大値 = 65535
httpsポート(httpsPort) HTTPS TCP ポート番号。 1 から 65535 の間である必要があります。 int

制約:
最小値 = 1
最大値 = 65535
優先権 負荷分散に使用する優先順位。 優先順位の低いバックエンドが正常な場合、より高い優先順位は負荷分散には使用されません。 int

制約:
最小値 = 1
最大値 = 5
重量 負荷分散を目的としたこのエンドポイントの重み。 int

制約:
最小値 = 1
最大値 = 1000

バックエンドプール

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ Front Door バックエンド プールのプロパティ バックエンドプールプロパティ

バックエンドプールプロパティ

名前 形容 価値
バックエンド このプールのバックエンドのセット バックエンド[]
healthProbeSettings (英語) バックエンド プールの L7 正常性プローブの設定 SubResource
loadBalancing設定 バックエンド プールの負荷分散設定 SubResource

バックエンドプール設定

名前 形容 価値
enforceCertificateNameCheck (英語) すべてのバックエンド プールに対する HTTPS 要求に証明書名のチェックを適用するかどうか。 HTTPS 以外の要求には影響しません。 「無効」
「有効」

キャッシュコンフィギュレーション

名前 形容 価値
動的圧縮 キャッシュされたコンテンツに動的圧縮を使用するかどうか 「無効」
「有効」
queryParameterStripディレクティブ キャッシュ キーを形成するときの URL クエリ用語の処理。 「ストリップオール」
「ストリップなし」

フォワーディングコンフィギュレーション

名前 形容 価値
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (必須)
バックエンドプール この規則のルーティング先となる BackendPool への参照。 SubResource
cacheConfigurationの この規則に関連付けられているキャッシュ構成。 キャッシュコンフィギュレーション
カスタムフォワーディングパス この規則に一致するリソース パスを書き換えるために使用されるカスタム パス。 受信パスを使用するには、空のままにします。
転送プロトコル この規則は、トラフィックをバックエンドに転送するときに使用するプロトコルです。 「HttpOnly」
「HttpsOnly」
「マッチリクエスト」

フロントドアプロパティ

名前 形容 価値
バックエンドプール ルーティング規則で使用できるバックエンド プール。 バックエンドプール[]
バックエンドプール設定 すべての backendPools の設定 バックエンドプール設定
enabledState(有効状態) Front Door ロード バランサーの操作状態。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
フレンドリーネーム frontDoor のフレンドリ名
フロントエンドエンドポイント ルーティング規則で使用できるフロントエンド エンドポイント。 フロントエンドエンドポイント[]
healthProbeSettings (英語) この Front Door インスタンスに関連付けられている正常性プローブの設定。 HealthProbeSettingsモデル[]
loadBalancing設定 この Front Door インスタンスに関連付けられている負荷分散設定。 LoadBalancingSettingsモデル[]
ルーティングルール この Front Door に関連付けられているルーティング規則。 ルーティングルール[]

フロントエンドエンドポイント

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ フロントエンド エンドポイントのプロパティ フロントエンドエンドポイントプロパティ

フロントエンドエンドポイントプロパティ

名前 形容 価値
ホスト名 frontendEndpoint のホスト名。 ドメイン名である必要があります。
セッションアフィニティ・ このホストでセッション アフィニティを許可するかどうか。 有効なオプションは 'Enabled' または 'Disabled' です 「無効」
「有効」
セッションアフィニティTtlSeconds 未使用。 このフィールドは無視されます。 セッション アフィニティに使用する TTL (該当する場合)。 整数 (int)
webApplicationFirewallポリシーリンク 各ホストの Web アプリケーション ファイアウォール ポリシーを定義します (該当する場合) フロントエンドエンドポイント更新パラメータWebアプリケーションファイアウォールポリシーリンク
名前 形容 価値
身分証明書 リソース ID。

HealthProbeSettingsモデル

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ 正常性プローブ設定のプロパティ HealthProbeSettingsProperties

HealthProbeSettingsプロパティ

名前 形容 価値
秒単位の間隔 正常性プローブ間の秒数。 整数 (int)
パス 正常性プローブに使用するパス。 既定値は /
議定書 このプローブに使用するプロトコル スキーム 'http'
「https」

LoadBalancingSettingsモデル

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ 負荷分散設定のプロパティ LoadBalancingSettingsProperties

LoadBalancingSettingsプロパティ

名前 形容 価値
additionalLatencyMilliseconds (英語) プローブが最も短い待機時間バケットに分類されるまでの追加の待機時間 (ミリ秒単位) 整数 (int)
サンプルサイズ 負荷分散の決定に考慮するサンプルの数 整数 (int)
successfulSamplesRequired (成功サンプル必須) 成功する必要があるサンプル期間内のサンプルの数 整数 (int)

リダイレクト構成

名前 形容 価値
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (必須)
カスタムフラグメント リダイレクト URL に追加するフラグメント。 フラグメントは、#の後に来る URL の一部です。 #を含めないでください。
カスタムホスト リダイレクトするホスト。 受信ホストを宛先ホストとして使用するには、空のままにします。
カスタムパス リダイレクトする完全なパス。 パスを空にすることはできず、/で始まる必要があります。 受信パスを宛先パスとして使用するには、空のままにします。
カスタムクエリ文字列 リダイレクト URL に配置するクエリ文字列のセット。 この値を設定すると、既存のクエリ文字列が置き換えられます。受信クエリ文字列を保持するには、空のままにします。 クエリ文字列は、<キー>=<値> 形式である必要があります。 最初の ? & は自動的に追加されるので、それらを前面に含めないでくださいが、&で複数のクエリ文字列を区切ります。
redirectプロトコル トラフィックがリダイレクトされる宛先のプロトコル 「HttpOnly」
「HttpsOnly」
「マッチリクエスト」
redirectType (リダイレクトタイプ) トラフィックをリダイレクトするときにルールが使用するリダイレクトの種類。 「見つかりました」
「移動した」
「パーマネントリダイレクト」
「一時的なリダイレクト」

リソースタグ

名前 形容 価値

ルートコンフィギュレーション

名前 形容 価値
@odata.type ForwardingConfiguration の種類として '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'設定します。 RedirectConfiguration の種類として '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'設定します。 '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (必須)

ルーティングルール

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ Front Door ルーティング規則のプロパティ RoutingRuleProperties

ルーティングルールプロパティ

名前 形容 価値
acceptedプロトコル この規則に一致するプロトコル スキーム 次のいずれかを含む文字列配列:
'http'
「https」
enabledState(有効状態) この規則の使用を有効にするかどうかを指定します。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
フロントエンドエンドポイント この規則に関連付けられているフロントエンド エンドポイント サブリソース[]
patternsToMatch (パターン・ツー・マッチ) ルールのルート パターン。 文字列[]
routeConfigurationの ルーティング構成への参照。 ルートコンフィギュレーション

サブリソース

名前 形容 価値
身分証明書 リソース ID。

使用例

Azure 検証済みモジュール

次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。

モジュール 形容
Azure Front Door Azure Front Door 用 AVM リソース モジュール

Azure クイック スタートのサンプル

Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル 形容
Front Door を使用してカスタム ドメインとカスタム証明書を追加する このテンプレートは、顧客が管理する証明書を使用して Front Door を使用してカスタム ドメインをオンボードし、セキュリティで保護します
Front Door を使用してカスタム ドメインとマネージド証明書を追加する このテンプレートは、Front Door を使用してカスタム ドメインのオンボードとセキュリティ保護を行います
Front Door でバックエンドの正常性プローブを 制御する このテンプレートは、プローブ パスとプローブの送信間隔を設定することで、Front Door を更新して正常性プローブの設定を変更します。
基本的な Front Door を作成する このテンプレートでは、1 つのバックエンドで基本的な Front Door 構成を作成します。
HTTP から HTTPS へのリダイレクトを使用して Front Door を作成 このテンプレートは、HTTP から HTTPS へのリダイレクト用の Front Door 構成を作成します。

ARM テンプレート リソース定義

frontDoors リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの 参照してください。

リソースの形式

Microsoft.Network/frontDoors リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2019-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "backendPools": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "backends": [
            {
              "address": "string",
              "backendHostHeader": "string",
              "enabledState": "string",
              "httpPort": "int",
              "httpsPort": "int",
              "priority": "int",
              "weight": "int"
            }
          ],
          "healthProbeSettings": {
            "id": "string"
          },
          "loadBalancingSettings": {
            "id": "string"
          }
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "string"
    },
    "enabledState": "string",
    "friendlyName": "string",
    "frontendEndpoints": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "hostName": "string",
          "sessionAffinityEnabledState": "string",
          "sessionAffinityTtlSeconds": "int",
          "webApplicationFirewallPolicyLink": {
            "id": "string"
          }
        }
      }
    ],
    "healthProbeSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "intervalInSeconds": "int",
          "path": "string",
          "protocol": "string"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "additionalLatencyMilliseconds": "int",
          "sampleSize": "int",
          "successfulSamplesRequired": "int"
        }
      }
    ],
    "routingRules": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "acceptedProtocols": [ "string" ],
          "enabledState": "string",
          "frontendEndpoints": [
            {
              "id": "string"
            }
          ],
          "patternsToMatch": [ "string" ],
          "routeConfiguration": {
            "@odata.type": "string"
            // For remaining properties, see RouteConfiguration objects
          }
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

RouteConfiguration オブジェクト

オブジェクトの型を指定するには、@odata.type プロパティを設定します。

#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationの場合は、次の値を使用します。

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
  "backendPool": {
    "id": "string"
  },
  "cacheConfiguration": {
    "dynamicCompression": "string",
    "queryParameterStripDirective": "string"
  },
  "customForwardingPath": "string",
  "forwardingProtocol": "string"
}

#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfigurationの場合は、次を使用します。

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
  "customFragment": "string",
  "customHost": "string",
  "customPath": "string",
  "customQueryString": "string",
  "redirectProtocol": "string",
  "redirectType": "string"
}

プロパティ値

マイクロソフトネットワーク/フロントドア

名前 形容 価値
apiVersion (英語) API のバージョン '2019-04-01'
場所 リソースの場所。
名前 リソース名

制約:
最小長 = 5
最大長 = 64
パターン = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (必須)
プロパティ Front Door Load Balancer のプロパティ フロントドアプロパティ
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート タグを参照してください
種類 リソースの種類 「Microsoft.Network/frontDoors」

バックエンド

名前 形容 価値
住所 バックエンドの場所 (IP アドレスまたは FQDN)
バックエンドホストヘッダー バックエンドに送信されるホスト ヘッダーとして使用する値。 空白または未指定の場合、これは既定で受信ホストに設定されます。
enabledState(有効状態) このバックエンドの使用を有効にするかどうか。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
httpポート(httpPort) HTTP TCP ポート番号。 1 から 65535 の間である必要があります。 int

制約:
最小値 = 1
最大値 = 65535
httpsポート(httpsPort) HTTPS TCP ポート番号。 1 から 65535 の間である必要があります。 int

制約:
最小値 = 1
最大値 = 65535
優先権 負荷分散に使用する優先順位。 優先順位の低いバックエンドが正常な場合、より高い優先順位は負荷分散には使用されません。 int

制約:
最小値 = 1
最大値 = 5
重量 負荷分散を目的としたこのエンドポイントの重み。 int

制約:
最小値 = 1
最大値 = 1000

バックエンドプール

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ Front Door バックエンド プールのプロパティ バックエンドプールプロパティ

バックエンドプールプロパティ

名前 形容 価値
バックエンド このプールのバックエンドのセット バックエンド[]
healthProbeSettings (英語) バックエンド プールの L7 正常性プローブの設定 SubResource
loadBalancing設定 バックエンド プールの負荷分散設定 SubResource

バックエンドプール設定

名前 形容 価値
enforceCertificateNameCheck (英語) すべてのバックエンド プールに対する HTTPS 要求に証明書名のチェックを適用するかどうか。 HTTPS 以外の要求には影響しません。 「無効」
「有効」

キャッシュコンフィギュレーション

名前 形容 価値
動的圧縮 キャッシュされたコンテンツに動的圧縮を使用するかどうか 「無効」
「有効」
queryParameterStripディレクティブ キャッシュ キーを形成するときの URL クエリ用語の処理。 「ストリップオール」
「ストリップなし」

フォワーディングコンフィギュレーション

名前 形容 価値
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (必須)
バックエンドプール この規則のルーティング先となる BackendPool への参照。 SubResource
cacheConfigurationの この規則に関連付けられているキャッシュ構成。 キャッシュコンフィギュレーション
カスタムフォワーディングパス この規則に一致するリソース パスを書き換えるために使用されるカスタム パス。 受信パスを使用するには、空のままにします。
転送プロトコル この規則は、トラフィックをバックエンドに転送するときに使用するプロトコルです。 「HttpOnly」
「HttpsOnly」
「マッチリクエスト」

フロントドアプロパティ

名前 形容 価値
バックエンドプール ルーティング規則で使用できるバックエンド プール。 バックエンドプール[]
バックエンドプール設定 すべての backendPools の設定 バックエンドプール設定
enabledState(有効状態) Front Door ロード バランサーの操作状態。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
フレンドリーネーム frontDoor のフレンドリ名
フロントエンドエンドポイント ルーティング規則で使用できるフロントエンド エンドポイント。 フロントエンドエンドポイント[]
healthProbeSettings (英語) この Front Door インスタンスに関連付けられている正常性プローブの設定。 HealthProbeSettingsモデル[]
loadBalancing設定 この Front Door インスタンスに関連付けられている負荷分散設定。 LoadBalancingSettingsモデル[]
ルーティングルール この Front Door に関連付けられているルーティング規則。 ルーティングルール[]

フロントエンドエンドポイント

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ フロントエンド エンドポイントのプロパティ フロントエンドエンドポイントプロパティ

フロントエンドエンドポイントプロパティ

名前 形容 価値
ホスト名 frontendEndpoint のホスト名。 ドメイン名である必要があります。
セッションアフィニティ・ このホストでセッション アフィニティを許可するかどうか。 有効なオプションは 'Enabled' または 'Disabled' です 「無効」
「有効」
セッションアフィニティTtlSeconds 未使用。 このフィールドは無視されます。 セッション アフィニティに使用する TTL (該当する場合)。 整数 (int)
webApplicationFirewallポリシーリンク 各ホストの Web アプリケーション ファイアウォール ポリシーを定義します (該当する場合) フロントエンドエンドポイント更新パラメータWebアプリケーションファイアウォールポリシーリンク
名前 形容 価値
身分証明書 リソース ID。

HealthProbeSettingsモデル

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ 正常性プローブ設定のプロパティ HealthProbeSettingsProperties

HealthProbeSettingsプロパティ

名前 形容 価値
秒単位の間隔 正常性プローブ間の秒数。 整数 (int)
パス 正常性プローブに使用するパス。 既定値は /
議定書 このプローブに使用するプロトコル スキーム 'http'
「https」

LoadBalancingSettingsモデル

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ 負荷分散設定のプロパティ LoadBalancingSettingsProperties

LoadBalancingSettingsプロパティ

名前 形容 価値
additionalLatencyMilliseconds (英語) プローブが最も短い待機時間バケットに分類されるまでの追加の待機時間 (ミリ秒単位) 整数 (int)
サンプルサイズ 負荷分散の決定に考慮するサンプルの数 整数 (int)
successfulSamplesRequired (成功サンプル必須) 成功する必要があるサンプル期間内のサンプルの数 整数 (int)

リダイレクト構成

名前 形容 価値
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (必須)
カスタムフラグメント リダイレクト URL に追加するフラグメント。 フラグメントは、#の後に来る URL の一部です。 #を含めないでください。
カスタムホスト リダイレクトするホスト。 受信ホストを宛先ホストとして使用するには、空のままにします。
カスタムパス リダイレクトする完全なパス。 パスを空にすることはできず、/で始まる必要があります。 受信パスを宛先パスとして使用するには、空のままにします。
カスタムクエリ文字列 リダイレクト URL に配置するクエリ文字列のセット。 この値を設定すると、既存のクエリ文字列が置き換えられます。受信クエリ文字列を保持するには、空のままにします。 クエリ文字列は、<キー>=<値> 形式である必要があります。 最初の ? & は自動的に追加されるので、それらを前面に含めないでくださいが、&で複数のクエリ文字列を区切ります。
redirectプロトコル トラフィックがリダイレクトされる宛先のプロトコル 「HttpOnly」
「HttpsOnly」
「マッチリクエスト」
redirectType (リダイレクトタイプ) トラフィックをリダイレクトするときにルールが使用するリダイレクトの種類。 「見つかりました」
「移動した」
「パーマネントリダイレクト」
「一時的なリダイレクト」

リソースタグ

名前 形容 価値

ルートコンフィギュレーション

名前 形容 価値
@odata.type ForwardingConfiguration の種類として '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'設定します。 RedirectConfiguration の種類として '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'設定します。 '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (必須)

ルーティングルール

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ Front Door ルーティング規則のプロパティ RoutingRuleProperties

ルーティングルールプロパティ

名前 形容 価値
acceptedプロトコル この規則に一致するプロトコル スキーム 次のいずれかを含む文字列配列:
'http'
「https」
enabledState(有効状態) この規則の使用を有効にするかどうかを指定します。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
フロントエンドエンドポイント この規則に関連付けられているフロントエンド エンドポイント サブリソース[]
patternsToMatch (パターン・ツー・マッチ) ルールのルート パターン。 文字列[]
routeConfigurationの ルーティング構成への参照。 ルートコンフィギュレーション

サブリソース

名前 形容 価値
身分証明書 リソース ID。

使用例

Azure クイック スタート テンプレート

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

テンプレート 形容
Front Door を使用してカスタム ドメインとカスタム証明書を追加する

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートは、顧客が管理する証明書を使用して Front Door を使用してカスタム ドメインをオンボードし、セキュリティで保護します
Front Door を使用してカスタム ドメインとマネージド証明書を追加する

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートは、Front Door を使用してカスタム ドメインのオンボードとセキュリティ保護を行います
Front Door ホスト名のセッション アフィニティを構成

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートは、Front Door を更新してフロントエンド ホストのセッション アフィニティを有効にすることで、同じユーザー セッションから同じバックエンドに後続のトラフィックを送信します。
Front Door でバックエンドの正常性プローブを 制御する

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートは、プローブ パスとプローブの送信間隔を設定することで、Front Door を更新して正常性プローブの設定を変更します。
基本的な Front Door を作成する

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートでは、1 つのバックエンドで基本的な Front Door 構成を作成します。
HTTP から HTTPS へのリダイレクトを使用して Front Door を作成

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートは、HTTP から HTTPS へのリダイレクト用の Front Door 構成を作成します。
複数のバックエンドとバックエンド プールを含む Front Door を作成する

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートでは、バックエンド プール内の複数のバックエンド用に構成された負荷分散と、URL パスに基づくバックエンド プール間で負荷分散が構成された Front Door が作成されます。
Azure API Management の前に Azure Front Door を作成する

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このサンプルでは、Azure API Management の前でグローバル ロード バランサーとして Azure Front Door を使用する方法を示します。
構成 を使用して Front Door Active-Standby 作成する

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートは、Active-Standby アプリケーション トポロジの優先順位ベースのルーティングを示す Front Door を作成します。
特定のルートに対してキャッシュを有効にして Front Door を作成

AzureDeploy to AzureDeploy to AzureDeploy to Azureにデプロイする
このテンプレートは、定義されたルーティング構成に対してキャッシュが有効になっている Front Door を作成するため、ワークロードの静的資産をキャッシュします。

Terraform (AzAPI プロバイダー) リソース定義

frontDoors リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの 参照してください。

リソースの形式

Microsoft.Network/frontDoors リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2019-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      backendPools = [
        {
          id = "string"
          name = "string"
          properties = {
            backends = [
              {
                address = "string"
                backendHostHeader = "string"
                enabledState = "string"
                httpPort = int
                httpsPort = int
                priority = int
                weight = int
              }
            ]
            healthProbeSettings = {
              id = "string"
            }
            loadBalancingSettings = {
              id = "string"
            }
          }
        }
      ]
      backendPoolsSettings = {
        enforceCertificateNameCheck = "string"
      }
      enabledState = "string"
      friendlyName = "string"
      frontendEndpoints = [
        {
          id = "string"
          name = "string"
          properties = {
            hostName = "string"
            sessionAffinityEnabledState = "string"
            sessionAffinityTtlSeconds = int
            webApplicationFirewallPolicyLink = {
              id = "string"
            }
          }
        }
      ]
      healthProbeSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            intervalInSeconds = int
            path = "string"
            protocol = "string"
          }
        }
      ]
      loadBalancingSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            additionalLatencyMilliseconds = int
            sampleSize = int
            successfulSamplesRequired = int
          }
        }
      ]
      routingRules = [
        {
          id = "string"
          name = "string"
          properties = {
            acceptedProtocols = [
              "string"
            ]
            enabledState = "string"
            frontendEndpoints = [
              {
                id = "string"
              }
            ]
            patternsToMatch = [
              "string"
            ]
            routeConfiguration = {
              @odata.type = "string"
              // For remaining properties, see RouteConfiguration objects
            }
          }
        }
      ]
    }
  }
}

RouteConfiguration オブジェクト

オブジェクトの型を指定するには、@odata.type プロパティを設定します。

#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationの場合は、次の値を使用します。

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
  backendPool = {
    id = "string"
  }
  cacheConfiguration = {
    dynamicCompression = "string"
    queryParameterStripDirective = "string"
  }
  customForwardingPath = "string"
  forwardingProtocol = "string"
}

#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfigurationの場合は、次を使用します。

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration"
  customFragment = "string"
  customHost = "string"
  customPath = "string"
  customQueryString = "string"
  redirectProtocol = "string"
  redirectType = "string"
}

プロパティ値

マイクロソフトネットワーク/フロントドア

名前 形容 価値
場所 リソースの場所。
名前 リソース名

制約:
最小長 = 5
最大長 = 64
パターン = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (必須)
プロパティ Front Door Load Balancer のプロパティ フロントドアプロパティ
タグ リソース タグ タグ名と値のディクショナリ。
種類 リソースの種類 「Microsoft.Network/frontDoors@2019-04-01」

バックエンド

名前 形容 価値
住所 バックエンドの場所 (IP アドレスまたは FQDN)
バックエンドホストヘッダー バックエンドに送信されるホスト ヘッダーとして使用する値。 空白または未指定の場合、これは既定で受信ホストに設定されます。
enabledState(有効状態) このバックエンドの使用を有効にするかどうか。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
httpポート(httpPort) HTTP TCP ポート番号。 1 から 65535 の間である必要があります。 int

制約:
最小値 = 1
最大値 = 65535
httpsポート(httpsPort) HTTPS TCP ポート番号。 1 から 65535 の間である必要があります。 int

制約:
最小値 = 1
最大値 = 65535
優先権 負荷分散に使用する優先順位。 優先順位の低いバックエンドが正常な場合、より高い優先順位は負荷分散には使用されません。 int

制約:
最小値 = 1
最大値 = 5
重量 負荷分散を目的としたこのエンドポイントの重み。 int

制約:
最小値 = 1
最大値 = 1000

バックエンドプール

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ Front Door バックエンド プールのプロパティ バックエンドプールプロパティ

バックエンドプールプロパティ

名前 形容 価値
バックエンド このプールのバックエンドのセット バックエンド[]
healthProbeSettings (英語) バックエンド プールの L7 正常性プローブの設定 SubResource
loadBalancing設定 バックエンド プールの負荷分散設定 SubResource

バックエンドプール設定

名前 形容 価値
enforceCertificateNameCheck (英語) すべてのバックエンド プールに対する HTTPS 要求に証明書名のチェックを適用するかどうか。 HTTPS 以外の要求には影響しません。 「無効」
「有効」

キャッシュコンフィギュレーション

名前 形容 価値
動的圧縮 キャッシュされたコンテンツに動的圧縮を使用するかどうか 「無効」
「有効」
queryParameterStripディレクティブ キャッシュ キーを形成するときの URL クエリ用語の処理。 「ストリップオール」
「ストリップなし」

フォワーディングコンフィギュレーション

名前 形容 価値
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (必須)
バックエンドプール この規則のルーティング先となる BackendPool への参照。 SubResource
cacheConfigurationの この規則に関連付けられているキャッシュ構成。 キャッシュコンフィギュレーション
カスタムフォワーディングパス この規則に一致するリソース パスを書き換えるために使用されるカスタム パス。 受信パスを使用するには、空のままにします。
転送プロトコル この規則は、トラフィックをバックエンドに転送するときに使用するプロトコルです。 「HttpOnly」
「HttpsOnly」
「マッチリクエスト」

フロントドアプロパティ

名前 形容 価値
バックエンドプール ルーティング規則で使用できるバックエンド プール。 バックエンドプール[]
バックエンドプール設定 すべての backendPools の設定 バックエンドプール設定
enabledState(有効状態) Front Door ロード バランサーの操作状態。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
フレンドリーネーム frontDoor のフレンドリ名
フロントエンドエンドポイント ルーティング規則で使用できるフロントエンド エンドポイント。 フロントエンドエンドポイント[]
healthProbeSettings (英語) この Front Door インスタンスに関連付けられている正常性プローブの設定。 HealthProbeSettingsモデル[]
loadBalancing設定 この Front Door インスタンスに関連付けられている負荷分散設定。 LoadBalancingSettingsモデル[]
ルーティングルール この Front Door に関連付けられているルーティング規則。 ルーティングルール[]

フロントエンドエンドポイント

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ フロントエンド エンドポイントのプロパティ フロントエンドエンドポイントプロパティ

フロントエンドエンドポイントプロパティ

名前 形容 価値
ホスト名 frontendEndpoint のホスト名。 ドメイン名である必要があります。
セッションアフィニティ・ このホストでセッション アフィニティを許可するかどうか。 有効なオプションは 'Enabled' または 'Disabled' です 「無効」
「有効」
セッションアフィニティTtlSeconds 未使用。 このフィールドは無視されます。 セッション アフィニティに使用する TTL (該当する場合)。 整数 (int)
webApplicationFirewallポリシーリンク 各ホストの Web アプリケーション ファイアウォール ポリシーを定義します (該当する場合) フロントエンドエンドポイント更新パラメータWebアプリケーションファイアウォールポリシーリンク
名前 形容 価値
身分証明書 リソース ID。

HealthProbeSettingsモデル

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ 正常性プローブ設定のプロパティ HealthProbeSettingsProperties

HealthProbeSettingsプロパティ

名前 形容 価値
秒単位の間隔 正常性プローブ間の秒数。 整数 (int)
パス 正常性プローブに使用するパス。 既定値は /
議定書 このプローブに使用するプロトコル スキーム 'http'
「https」

LoadBalancingSettingsモデル

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ 負荷分散設定のプロパティ LoadBalancingSettingsProperties

LoadBalancingSettingsプロパティ

名前 形容 価値
additionalLatencyMilliseconds (英語) プローブが最も短い待機時間バケットに分類されるまでの追加の待機時間 (ミリ秒単位) 整数 (int)
サンプルサイズ 負荷分散の決定に考慮するサンプルの数 整数 (int)
successfulSamplesRequired (成功サンプル必須) 成功する必要があるサンプル期間内のサンプルの数 整数 (int)

リダイレクト構成

名前 形容 価値
@odata.type '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (必須)
カスタムフラグメント リダイレクト URL に追加するフラグメント。 フラグメントは、#の後に来る URL の一部です。 #を含めないでください。
カスタムホスト リダイレクトするホスト。 受信ホストを宛先ホストとして使用するには、空のままにします。
カスタムパス リダイレクトする完全なパス。 パスを空にすることはできず、/で始まる必要があります。 受信パスを宛先パスとして使用するには、空のままにします。
カスタムクエリ文字列 リダイレクト URL に配置するクエリ文字列のセット。 この値を設定すると、既存のクエリ文字列が置き換えられます。受信クエリ文字列を保持するには、空のままにします。 クエリ文字列は、<キー>=<値> 形式である必要があります。 最初の ? & は自動的に追加されるので、それらを前面に含めないでくださいが、&で複数のクエリ文字列を区切ります。
redirectプロトコル トラフィックがリダイレクトされる宛先のプロトコル 「HttpOnly」
「HttpsOnly」
「マッチリクエスト」
redirectType (リダイレクトタイプ) トラフィックをリダイレクトするときにルールが使用するリダイレクトの種類。 「見つかりました」
「移動した」
「パーマネントリダイレクト」
「一時的なリダイレクト」

リソースタグ

名前 形容 価値

ルートコンフィギュレーション

名前 形容 価値
@odata.type ForwardingConfiguration の種類として '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'設定します。 RedirectConfiguration の種類として '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'設定します。 '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
'#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration' (必須)

ルーティングルール

名前 形容 価値
身分証明書 リソース ID。
名前 リソース名。
プロパティ Front Door ルーティング規則のプロパティ RoutingRuleProperties

ルーティングルールプロパティ

名前 形容 価値
acceptedプロトコル この規則に一致するプロトコル スキーム 次のいずれかを含む文字列配列:
'http'
「https」
enabledState(有効状態) この規則の使用を有効にするかどうかを指定します。 許可される値は 'Enabled' または 'Disabled' です 「無効」
「有効」
フロントエンドエンドポイント この規則に関連付けられているフロントエンド エンドポイント サブリソース[]
patternsToMatch (パターン・ツー・マッチ) ルールのルート パターン。 文字列[]
routeConfigurationの ルーティング構成への参照。 ルートコンフィギュレーション

サブリソース

名前 形容 価値
身分証明書 リソース ID。