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アプリケーションファイアウォールポリシーリンク |
フロントエンドエンドポイント更新パラメータ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アプリケーションファイアウォールポリシーリンク |
フロントエンドエンドポイント更新パラメータ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 Azure |
このテンプレートは、顧客が管理する証明書を使用して Front Door を使用してカスタム ドメインをオンボードし、セキュリティで保護します |
Front Door を使用してカスタム ドメインとマネージド証明書を追加する AzureDeploy to Azure |
このテンプレートは、Front Door を使用してカスタム ドメインのオンボードとセキュリティ保護を行います |
Front Door ホスト名のセッション アフィニティを構成 AzureDeploy to Azure |
このテンプレートは、Front Door を更新してフロントエンド ホストのセッション アフィニティを有効にすることで、同じユーザー セッションから同じバックエンドに後続のトラフィックを送信します。 |
Front Door でバックエンドの正常性プローブを 制御する AzureDeploy to Azure |
このテンプレートは、プローブ パスとプローブの送信間隔を設定することで、Front Door を更新して正常性プローブの設定を変更します。 |
基本的な Front Door を作成する AzureDeploy to Azure |
このテンプレートでは、1 つのバックエンドで基本的な Front Door 構成を作成します。 |
HTTP から HTTPS へのリダイレクトを使用して Front Door を作成 AzureDeploy to Azure |
このテンプレートは、HTTP から HTTPS へのリダイレクト用の Front Door 構成を作成します。 |
複数のバックエンドとバックエンド プールを含む Front Door を作成する AzureDeploy to Azure |
このテンプレートでは、バックエンド プール内の複数のバックエンド用に構成された負荷分散と、URL パスに基づくバックエンド プール間で負荷分散が構成された Front Door が作成されます。 |
Azure API Management の前に Azure Front Door を作成する AzureDeploy to Azure |
このサンプルでは、Azure API Management の前でグローバル ロード バランサーとして Azure Front Door を使用する方法を示します。 |
構成 を使用して Front Door Active-Standby 作成する AzureDeploy to Azure |
このテンプレートは、Active-Standby アプリケーション トポロジの優先順位ベースのルーティングを示す Front Door を作成します。 |
特定のルートに対してキャッシュを有効にして Front Door を作成 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アプリケーションファイアウォールポリシーリンク |
フロントエンドエンドポイント更新パラメータ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。 | 糸 |