Microsoft.Web ホスティング環境 2024-11-01

2025-06-10

Bicep リソース定義

hostingEnvironments リソースの種類は、次を対象とする操作と共にデプロイできます。

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

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

リソースの形式

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

resource symbolicname 'Microsoft.Web/hostingEnvironments@2024-11-01' = {
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    clusterSettings: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    customDnsSuffixConfiguration: {
      kind: 'string'
      properties: {
        certificateUrl: 'string'
        dnsSuffix: 'string'
        keyVaultReferenceIdentity: 'string'
      }
    }
    dedicatedHostCount: int
    dnsSuffix: 'string'
    frontEndScaleFactor: int
    internalLoadBalancingMode: 'string'
    ipsslAddressCount: int
    multiSize: 'string'
    networkingConfiguration: {
      kind: 'string'
      properties: {
        allowNewPrivateEndpointConnections: bool
        ftpEnabled: bool
        inboundIpAddressOverride: 'string'
        remoteDebugEnabled: bool
      }
    }
    upgradePreference: 'string'
    userWhitelistedIpRanges: [
      'string'
    ]
    virtualNetwork: {
      id: 'string'
      subnet: 'string'
    }
    zoneRedundant: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.Web/ホスティング環境

名前	説明	価値
種類	リソースの種類。リソースがアプリの場合は、サポートされている種類の値の詳細については、https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference を参照してください。	ひも
ロケーション	リソースの場所。	string (必須)
名前	リソース名	string (必須)
プロパティ	コアリソースのプロパティ	AppServiceEnvironment (英語)
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

AppServiceEnvironment (英語)

名前	説明	価値
cluster設定	App Service Environment の動作を変更するためのカスタム設定。	名前値ペア[]
customDnsSuffixConfiguration	ASEv3 のカスタムドメインサフィックス構成の完全なビュー。	CustomDnsSuffixConfiguration の
専用ホストカウント	専用ホスト数	整数 (int)
dnsサフィックス	App Service Environment の DNS サフィックス。	ひも
frontEndScaleFactor	フロントエンドの倍率。	整数 (int)
内部ロードバランスモード	App Service Environment の仮想ネットワーク内で内部的に提供するエンドポイントを指定します。	「なし」「パブリッシング」「ウェブ」 'Web,Publishing'
ipsslアドレスカウント	App Service Environment 用に予約されている IP SSL アドレスの数。	整数 (int)
マルチサイズ	フロントエンド VM のサイズ ("Medium"、"Large" など)。	ひも
ネットワーク設定 {{ねーる:せってい	ASE のネットワーク構成の完全なビュー。	AseV3NetworkingConfiguration (英語)
アップグレードプリファレンス	アップグレードの基本設定	「早い」「遅れた」「マニュアル」「なし」
userWhitelistedIpRanges(英語)	ASE db でホワイトリストに登録する IP 範囲をユーザーが追加しました	文字列[]
バーチャルネットワーク	仮想ネットワークの説明。	VirtualNetworkProfile (必須)
ゾーン冗長	この App Service Environment がゾーン冗長であるかどうか。	ブール (bool)

AseV3NetworkingConfiguration (英語)

名前	説明	価値
種類	リソースの種類。	ひも
プロパティ	AseV3NetworkingConfiguration リソース固有のプロパティ	aseV3NetworkingConfigurationProperties の

AseV3NetworkingConfigurationProperties の略

名前	説明	価値
allowNewPrivateEndpointConnections (英語)	ASE での新しいプライベートエンドポイント接続の作成を有効または無効にするプロパティ	ブール (bool)
ftpEnabledの	ASEV3 で FTP を有効または無効にするプロパティ	ブール (bool)
inboundIpAddressOverride(英語)	顧客が指定した受信 IP アドレス。 Ase create でのみ設定できます。	ひも
リモートデバッグ有効	ASEV3 でリモートデバッグを有効または無効にするプロパティ	ブール (bool)

CustomDnsSuffixConfiguration (カスタムDnsサフィックス構成)

名前	説明	価値
種類	リソースの種類。	ひも
プロパティ	CustomDnsSuffixConfiguration リソース固有のプロパティ	CustomDnsSuffixConfigurationProperties の

CustomDnsSuffixConfigurationProperties (カスタムDnsサフィックス構成プロパティ)

名前	説明	価値
証明書URL	カスタムドメインサフィックスを持つサイトの既定の SSL/TLS 証明書として使用する必要がある Azure Key Vault 証明書シークレットを参照する URL。	ひも
dnsサフィックス	ASE に展開されているすべてのサイトに使用する既定のカスタムドメインサフィックス。	ひも
keyVault参照アイデンティティ	キーコンテナー証明書参照の解決に使用するユーザー割り当て ID。指定しない場合は、システム割り当て ASE ID が使用可能な場合に使用されます。	ひも

名前値ペア

名前	説明	価値
名前	ペア名。	ひも
価値	ペア値。	ひも

リソースタグ

名前	説明	価値

VirtualNetworkProfile(バーチャルネットワークプロファイル)

名前	説明	価値
身分証明書	仮想ネットワークのリソース ID。	string (必須)
サブネット	仮想ネットワーク内のサブネット。	ひも

使用例

Azure 検証済みモジュール

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

モジュール	説明
App Service Environment の	App Service Environment 用 AVM リソースモジュール

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

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

Bicep ファイル	説明
ホスティングプランと Azure WebApp を使用した App Service Environment の	プライベートに使用できる既存の仮想ネットワークに ILB アドレスを持つ App Service Environment v2 を作成します。 App Service Environment には、ホスティングプランと Azure Web アプリが含まれます
App Service Environment v2 を作成する	仮想ネットワークに App Service Environment v2 を作成します
asEv3 で AppServicePlan と App を作成する	ASEv3 で AppServicePlan とアプリを作成する

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

hostingEnvironments リソースの種類は、次を対象とする操作と共にデプロイできます。

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

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

リソースの形式

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

{
  "type": "Microsoft.Web/hostingEnvironments",
  "apiVersion": "2024-11-01",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {
    "clusterSettings": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "customDnsSuffixConfiguration": {
      "kind": "string",
      "properties": {
        "certificateUrl": "string",
        "dnsSuffix": "string",
        "keyVaultReferenceIdentity": "string"
      }
    },
    "dedicatedHostCount": "int",
    "dnsSuffix": "string",
    "frontEndScaleFactor": "int",
    "internalLoadBalancingMode": "string",
    "ipsslAddressCount": "int",
    "multiSize": "string",
    "networkingConfiguration": {
      "kind": "string",
      "properties": {
        "allowNewPrivateEndpointConnections": "bool",
        "ftpEnabled": "bool",
        "inboundIpAddressOverride": "string",
        "remoteDebugEnabled": "bool"
      }
    },
    "upgradePreference": "string",
    "userWhitelistedIpRanges": [ "string" ],
    "virtualNetwork": {
      "id": "string",
      "subnet": "string"
    },
    "zoneRedundant": "bool"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.Web/ホスティング環境

名前	説明	価値
apiVersion (英語)	API のバージョン	'2024-11-01'
種類	リソースの種類。リソースがアプリの場合は、サポートされている種類の値の詳細については、https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference を参照してください。	ひも
ロケーション	リソースの場所。	string (必須)
名前	リソース名	string (必須)
プロパティ	コアリソースのプロパティ	AppServiceEnvironment (英語)
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください
種類	リソースの種類	「Microsoft.Web/hostingEnvironments」

AppServiceEnvironment (英語)

名前	説明	価値
cluster設定	App Service Environment の動作を変更するためのカスタム設定。	名前値ペア[]
customDnsSuffixConfiguration	ASEv3 のカスタムドメインサフィックス構成の完全なビュー。	CustomDnsSuffixConfiguration の
専用ホストカウント	専用ホスト数	整数 (int)
dnsサフィックス	App Service Environment の DNS サフィックス。	ひも
frontEndScaleFactor	フロントエンドの倍率。	整数 (int)
内部ロードバランスモード	App Service Environment の仮想ネットワーク内で内部的に提供するエンドポイントを指定します。	「なし」「パブリッシング」「ウェブ」 'Web,Publishing'
ipsslアドレスカウント	App Service Environment 用に予約されている IP SSL アドレスの数。	整数 (int)
マルチサイズ	フロントエンド VM のサイズ ("Medium"、"Large" など)。	ひも
ネットワーク設定 {{ねーる:せってい	ASE のネットワーク構成の完全なビュー。	AseV3NetworkingConfiguration (英語)
アップグレードプリファレンス	アップグレードの基本設定	「早い」「遅れた」「マニュアル」「なし」
userWhitelistedIpRanges(英語)	ASE db でホワイトリストに登録する IP 範囲をユーザーが追加しました	文字列[]
バーチャルネットワーク	仮想ネットワークの説明。	VirtualNetworkProfile (必須)
ゾーン冗長	この App Service Environment がゾーン冗長であるかどうか。	ブール (bool)

AseV3NetworkingConfiguration (英語)

名前	説明	価値
種類	リソースの種類。	ひも
プロパティ	AseV3NetworkingConfiguration リソース固有のプロパティ	aseV3NetworkingConfigurationProperties の

AseV3NetworkingConfigurationProperties の略

名前	説明	価値
allowNewPrivateEndpointConnections (英語)	ASE での新しいプライベートエンドポイント接続の作成を有効または無効にするプロパティ	ブール (bool)
ftpEnabledの	ASEV3 で FTP を有効または無効にするプロパティ	ブール (bool)
inboundIpAddressOverride(英語)	顧客が指定した受信 IP アドレス。 Ase create でのみ設定できます。	ひも
リモートデバッグ有効	ASEV3 でリモートデバッグを有効または無効にするプロパティ	ブール (bool)

CustomDnsSuffixConfiguration (カスタムDnsサフィックス構成)

名前	説明	価値
種類	リソースの種類。	ひも
プロパティ	CustomDnsSuffixConfiguration リソース固有のプロパティ	CustomDnsSuffixConfigurationProperties の

CustomDnsSuffixConfigurationProperties (カスタムDnsサフィックス構成プロパティ)

名前	説明	価値
証明書URL	カスタムドメインサフィックスを持つサイトの既定の SSL/TLS 証明書として使用する必要がある Azure Key Vault 証明書シークレットを参照する URL。	ひも
dnsサフィックス	ASE に展開されているすべてのサイトに使用する既定のカスタムドメインサフィックス。	ひも
keyVault参照アイデンティティ	キーコンテナー証明書参照の解決に使用するユーザー割り当て ID。指定しない場合は、システム割り当て ASE ID が使用可能な場合に使用されます。	ひも

名前値ペア

名前	説明	価値
名前	ペア名。	ひも
価値	ペア値。	ひも

リソースタグ

名前	説明	価値

VirtualNetworkProfile(バーチャルネットワークプロファイル)

名前	説明	価値
身分証明書	仮想ネットワークのリソース ID。	string (必須)
サブネット	仮想ネットワーク内のサブネット。	ひも

使用例

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

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

テンプレート	説明
Azure SQL バックエンドを使用した App Service Environment の	このテンプレートは、プライベート/分離環境で通常使用される関連リソースと共に、Azure SQL バックエンドとプライベートエンドポイントを含む App Service Environment を作成します。
ホスティングプランと Azure WebApp を使用した App Service Environment の	プライベートに使用できる既存の仮想ネットワークに ILB アドレスを持つ App Service Environment v2 を作成します。 App Service Environment には、ホスティングプランと Azure Web アプリが含まれます
App Service Environment を作成する	仮想ネットワークに App Service Environment を作成します
App Service Environment v2 を作成する	仮想ネットワークに App Service Environment v2 を作成します
asEv3 で AppServicePlan と App を作成する	ASEv3 で AppServicePlan とアプリを作成する
ILB アドレスを使用して App Service Environment v2 を作成する	プライベート内部ロードバランサーアドレスを使用して、仮想ネットワークに App Service Environment v2 を作成します
ILB アドレスを使用して App Service Environment を作成する	プライベート内部ロードバランサーアドレスを使用して、仮想ネットワークに App Service Environment を作成します
追加された Web アプリを使用して Azure App Service 環境を作成	仮想ネットワークサブネット内に Azure App Service Environment を作成します。このテンプレートでは、App Service Environment 内に Azure Web アプリも追加されます。 PixelPin の Callum Brankin によって作成されたテンプレート
Azure Firewall を使用した ILB App Service Environment の	Azure Firewall 統合を使用して App Service 環境をデプロイする方法を示す Resource Manager テンプレートとパラメーター
ILB ASE または ILB ASE v2 の SSL 証明書をする	ILB ASE または ILB ASE v2 の既定の SSL 証明書を構成します

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

hostingEnvironments リソースの種類は、次を対象とする操作と共にデプロイできます。

リソース・グループ

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/hostingEnvironments@2024-11-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      clusterSettings = [
        {
          name = "string"
          value = "string"
        }
      ]
      customDnsSuffixConfiguration = {
        kind = "string"
        properties = {
          certificateUrl = "string"
          dnsSuffix = "string"
          keyVaultReferenceIdentity = "string"
        }
      }
      dedicatedHostCount = int
      dnsSuffix = "string"
      frontEndScaleFactor = int
      internalLoadBalancingMode = "string"
      ipsslAddressCount = int
      multiSize = "string"
      networkingConfiguration = {
        kind = "string"
        properties = {
          allowNewPrivateEndpointConnections = bool
          ftpEnabled = bool
          inboundIpAddressOverride = "string"
          remoteDebugEnabled = bool
        }
      }
      upgradePreference = "string"
      userWhitelistedIpRanges = [
        "string"
      ]
      virtualNetwork = {
        id = "string"
        subnet = "string"
      }
      zoneRedundant = bool
    }
  }
}

プロパティ値

Microsoft.Web/ホスティング環境

名前	説明	価値
種類	リソースの種類。リソースがアプリの場合は、サポートされている種類の値の詳細については、https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference を参照してください。	ひも
ロケーション	リソースの場所。	string (必須)
名前	リソース名	string (必須)
プロパティ	コアリソースのプロパティ	AppServiceEnvironment (英語)
タグ	リソースタグ	タグ名と値のディクショナリ。
種類	リソースの種類	"マイクロソフト.Web/hostingEnvironments@2024-11-01"

AppServiceEnvironment (英語)

名前	説明	価値
cluster設定	App Service Environment の動作を変更するためのカスタム設定。	名前値ペア[]
customDnsSuffixConfiguration	ASEv3 のカスタムドメインサフィックス構成の完全なビュー。	CustomDnsSuffixConfiguration の
専用ホストカウント	専用ホスト数	整数 (int)
dnsサフィックス	App Service Environment の DNS サフィックス。	ひも
frontEndScaleFactor	フロントエンドの倍率。	整数 (int)
内部ロードバランスモード	App Service Environment の仮想ネットワーク内で内部的に提供するエンドポイントを指定します。	「なし」「パブリッシング」「ウェブ」 'Web,Publishing'
ipsslアドレスカウント	App Service Environment 用に予約されている IP SSL アドレスの数。	整数 (int)
マルチサイズ	フロントエンド VM のサイズ ("Medium"、"Large" など)。	ひも
ネットワーク設定 {{ねーる:せってい	ASE のネットワーク構成の完全なビュー。	AseV3NetworkingConfiguration (英語)
アップグレードプリファレンス	アップグレードの基本設定	「早い」「遅れた」「マニュアル」「なし」
userWhitelistedIpRanges(英語)	ASE db でホワイトリストに登録する IP 範囲をユーザーが追加しました	文字列[]
バーチャルネットワーク	仮想ネットワークの説明。	VirtualNetworkProfile (必須)
ゾーン冗長	この App Service Environment がゾーン冗長であるかどうか。	ブール (bool)

AseV3NetworkingConfiguration (英語)

名前	説明	価値
種類	リソースの種類。	ひも
プロパティ	AseV3NetworkingConfiguration リソース固有のプロパティ	aseV3NetworkingConfigurationProperties の

AseV3NetworkingConfigurationProperties の略

名前	説明	価値
allowNewPrivateEndpointConnections (英語)	ASE での新しいプライベートエンドポイント接続の作成を有効または無効にするプロパティ	ブール (bool)
ftpEnabledの	ASEV3 で FTP を有効または無効にするプロパティ	ブール (bool)
inboundIpAddressOverride(英語)	顧客が指定した受信 IP アドレス。 Ase create でのみ設定できます。	ひも
リモートデバッグ有効	ASEV3 でリモートデバッグを有効または無効にするプロパティ	ブール (bool)

CustomDnsSuffixConfiguration (カスタムDnsサフィックス構成)

名前	説明	価値
種類	リソースの種類。	ひも
プロパティ	CustomDnsSuffixConfiguration リソース固有のプロパティ	CustomDnsSuffixConfigurationProperties の

CustomDnsSuffixConfigurationProperties (カスタムDnsサフィックス構成プロパティ)

名前	説明	価値
証明書URL	カスタムドメインサフィックスを持つサイトの既定の SSL/TLS 証明書として使用する必要がある Azure Key Vault 証明書シークレットを参照する URL。	ひも
dnsサフィックス	ASE に展開されているすべてのサイトに使用する既定のカスタムドメインサフィックス。	ひも
keyVault参照アイデンティティ	キーコンテナー証明書参照の解決に使用するユーザー割り当て ID。指定しない場合は、システム割り当て ASE ID が使用可能な場合に使用されます。	ひも

名前値ペア

名前	説明	価値
名前	ペア名。	ひも
価値	ペア値。	ひも

リソースタグ

名前	説明	価値

VirtualNetworkProfile(バーチャルネットワークプロファイル)

名前	説明	価値
身分証明書	仮想ネットワークのリソース ID。	string (必須)
サブネット	仮想ネットワーク内のサブネット。	ひも

使用例

Azure 検証済みモジュール

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

モジュール	説明
App Service Environment の	App Service Environment 用 AVM リソースモジュール

次の方法で共有

Microsoft.Web ホスティング環境 2024-11-01

Bicep リソース定義

リソースの形式

プロパティ値

Microsoft.Web/ホスティング環境

AppServiceEnvironment (英語)

AseV3NetworkingConfiguration (英語)

AseV3NetworkingConfigurationProperties の略

CustomDnsSuffixConfiguration (カスタムDnsサフィックス構成)

CustomDnsSuffixConfigurationProperties (カスタムDnsサフィックス構成プロパティ)

名前値ペア

リソースタグ

VirtualNetworkProfile(バーチャルネットワークプロファイル)

使用例

Azure 検証済みモジュール

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

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

リソースの形式

プロパティ値

Microsoft.Web/ホスティング環境

AppServiceEnvironment (英語)

AseV3NetworkingConfiguration (英語)

AseV3NetworkingConfigurationProperties の略

CustomDnsSuffixConfiguration (カスタムDnsサフィックス構成)

CustomDnsSuffixConfigurationProperties (カスタムDnsサフィックス構成プロパティ)

名前値ペア

リソースタグ

VirtualNetworkProfile(バーチャルネットワークプロファイル)

使用例

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

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

リソースの形式

プロパティ値

Microsoft.Web/ホスティング環境

AppServiceEnvironment (英語)

AseV3NetworkingConfiguration (英語)

AseV3NetworkingConfigurationProperties の略

CustomDnsSuffixConfiguration (カスタムDnsサフィックス構成)

CustomDnsSuffixConfigurationProperties (カスタムDnsサフィックス構成プロパティ)

名前値ペア

リソースタグ

VirtualNetworkProfile(バーチャルネットワークプロファイル)

使用例

Azure 検証済みモジュール

フィードバック

その他のリソース

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

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

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