Hébergement Microsoft.WebEnvironments 2020-10-01

Article
09/01/2023

Définition de ressource Bicep

Le type de ressource hostingEnvironments peut être déployé avec des opérations qui ciblent :

Groupes de ressources - Voir commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Web/hostingEnvironments, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Web/hostingEnvironments@2020-10-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  properties: {
    apiManagementAccountId: 'string'
    clusterSettings: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    dnsSuffix: 'string'
    dynamicCacheEnabled: bool
    frontEndScaleFactor: int
    hasLinuxWorkers: bool
    internalLoadBalancingMode: 'string'
    ipsslAddressCount: int
    location: 'string'
    multiRoleCount: int
    multiSize: 'string'
    name: 'string'
    networkAccessControlList: [
      {
        action: 'string'
        description: 'string'
        order: int
        remoteSubnet: 'string'
      }
    ]
    sslCertKeyVaultId: 'string'
    sslCertKeyVaultSecretName: 'string'
    suspended: bool
    userWhitelistedIpRanges: [
      'string'
    ]
    virtualNetwork: {
      id: 'string'
      subnet: 'string'
    }
    vnetName: 'string'
    vnetResourceGroupName: 'string'
    vnetSubnetName: 'string'
    workerPools: [
      {
        computeMode: 'string'
        workerCount: int
        workerSize: 'string'
        workerSizeId: int
      }
    ]
  }
}

Valeurs de propriétés

hostingEnvironments

Nom	Description	Valeur
name	Nom de la ressource	chaîne (obligatoire)
location	Emplacement de la ressource.	chaîne (obligatoire)
tags	Balises de ressource.	Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
kind	Type de ressource.	string
properties	Propriétés de la ressource principale	AppServiceEnvironment

AppServiceEnvironment

Nom	Description	Valeur
apiManagementAccountId	Gestion des API compte associé au App Service Environment.	string
clusterSettings	Paramètres personnalisés pour modifier le comportement du App Service Environment.	NameValuePair[]
dnsSuffix	Suffixe DNS du App Service Environment.	string
dynamicCacheEnabled	True/false indiquant si le App Service Environment est suspendu. L’environnement peut être suspendu, par exemple, lorsque le point de terminaison de gestion n’est plus disponible (probablement parce que le groupe de sécurité réseau a bloqué le trafic entrant).	bool
frontEndScaleFactor	Facteur de mise à l’échelle pour les serveurs frontaux.	int
hasLinuxWorkers	Indicateur qui indique si un ASE a des workers linux ou non	bool
internalLoadBalancingMode	Spécifie les points de terminaison à servir en interne dans le Réseau virtuel pour le App Service Environment.	'None' 'Publication' 'Web' « Web,Publication »
ipsslAddressCount	Nombre d’adresses IP SSL réservées pour le App Service Environment.	int
location	Emplacement du App Service Environment, par exemple « USA Ouest ».	chaîne (obligatoire)
multiRoleCount	Nombre d’instances front-end.	int
multiSize	Taille de la machine virtuelle frontale, par exemple « Moyenne », « Grande ».	string
name	Nom du App Service Environment.	chaîne (obligatoire)
networkAccessControlList	Liste de contrôle d’accès pour contrôler le trafic vers le App Service Environment.	NetworkAccessControlEntry[]
sslCertKeyVaultId	ID Key Vault pour ILB App Service Environment certificat SSL par défaut	string
sslCertKeyVaultSecretName	nom secret Key Vault pour ILB App Service Environment certificat SSL par défaut	string
interrompu	`true`si le App Service Environment est suspendu ; sinon, `false`. L’environnement peut être suspendu, par exemple lorsque le point de terminaison de gestion n’est plus disponible (probablement parce que le groupe de sécurité réseau a bloqué le trafic entrant).	bool
userWhitelistedIpRanges	L’utilisateur a ajouté la liste des plages d’adresses IP autorisées sur la base de données ASE	string[]
virtualNetwork	Description du Réseau virtuel.	VirtualNetworkProfile (obligatoire)
vnetName	Nom du Réseau virtuel pour le App Service Environment.	string
vnetResourceGroupName	Groupe de ressources du Réseau virtuel.	string
vnetSubnetName	Sous-réseau du Réseau virtuel.	string
workerPools	Description des pools de workers avec des ID de taille de worker, des tailles de machine virtuelle et le nombre de workers dans chaque pool.	WorkerPool[] (obligatoire)

NameValuePair

Nom	Description	Valeur
name	Nom de la paire.	string
value	Valeur de paire.	string

NetworkAccessControlEntry

Nom	Description	Valeur
action	Objet Action.	'Deny' 'Permit'
description	Description de l’entrée de contrôle d’accès réseau.	string
order	Ordre de priorité.	int
remoteSubnet	Sous-réseau distant.	string

VirtualNetworkProfile

Nom	Description	Valeur
id	ID de ressource du Réseau virtuel.	string
sous-réseau	Sous-réseau dans le Réseau virtuel.	string

WorkerPool

Nom	Description	Valeur
computeMode	Hébergement d’applications partagée ou dédiée.	'Dedicated' 'Dynamic' 'Partagé'
workerCount	Nombre d’instances dans le pool de workers.	int
workerSize	Taille de machine virtuelle des instances du pool de workers.	string
workerSizeId	ID de taille de worker pour le référencement de ce pool de workers.	int

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
App Service Environment ILB avec Pare-feu Azure	Resource Manager modèles et paramètres illustrant comment déployer App Service environnement avec l’intégration Pare-feu Azure
App Service Environment avec Azure SQL back-end	Ce modèle crée une App Service Environment avec un back-end Azure SQL ainsi que des points de terminaison privés, ainsi que des ressources associées généralement utilisées dans un environnement privé/isolé.
App Service Environment avec le plan d’hébergement et Azure WebApp	Crée une App Service Environment v2 avec une adresse ILB dans un réseau virtuel existant qui sera disponible en privé. Le App Service Environment contient un plan d’hébergement et une application web Azure
Créer Azure App Service environnement avec une application web ajoutée	Crée un environnement Azure App Service dans un sous-réseau Réseau virtuel. Ce modèle ajoute également une application web Azure dans le App Service Environment. Modèle créé à l’origine par Callum Brankin de PixelPin
Créer un App Service Environment	Crée un App Service Environment dans votre réseau virtuel
Certificat SSL pour un ASE ILB ou un ASE ILB v2	Configurer le certificat SSL par défaut pour un ASE ILB ou un ASE ILB v2
Créer App Service Environment avec une adresse ILB	Crée une App Service Environment dans votre réseau virtuel avec une adresse d’équilibreur de charge interne privée
Créer un App Service Environment v2	Crée un App Service Environment v2 dans votre réseau virtuel
Créer un environnement App Service v2 avec une adresse ILB	Crée une App Service Environment v2 dans votre réseau virtuel avec une adresse d’équilibreur de charge interne privée
Créer un AppServicePlan et une application dans un ASEv3	Créer un AppServicePlan et une application dans un ASEv3

Définition de ressources de modèle ARM

Le type de ressource hostingEnvironments peut être déployé avec des opérations qui ciblent :

Groupes de ressources - Voir commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Web/hostingEnvironments, ajoutez le JSON suivant à votre modèle.

{
  "type": "Microsoft.Web/hostingEnvironments",
  "apiVersion": "2020-10-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "properties": {
    "apiManagementAccountId": "string",
    "clusterSettings": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "dnsSuffix": "string",
    "dynamicCacheEnabled": "bool",
    "frontEndScaleFactor": "int",
    "hasLinuxWorkers": "bool",
    "internalLoadBalancingMode": "string",
    "ipsslAddressCount": "int",
    "location": "string",
    "multiRoleCount": "int",
    "multiSize": "string",
    "name": "string",
    "networkAccessControlList": [
      {
        "action": "string",
        "description": "string",
        "order": "int",
        "remoteSubnet": "string"
      }
    ],
    "sslCertKeyVaultId": "string",
    "sslCertKeyVaultSecretName": "string",
    "suspended": "bool",
    "userWhitelistedIpRanges": [ "string" ],
    "virtualNetwork": {
      "id": "string",
      "subnet": "string"
    },
    "vnetName": "string",
    "vnetResourceGroupName": "string",
    "vnetSubnetName": "string",
    "workerPools": [
      {
        "computeMode": "string",
        "workerCount": "int",
        "workerSize": "string",
        "workerSizeId": "int"
      }
    ]
  }
}

Valeurs de propriétés

hostingEnvironments

Nom	Description	Valeur
type	Type de ressource	« Microsoft.Web/hostingEnvironments »
apiVersion	Version de l’API de ressource	'2020-10-01'
name	Nom de la ressource	chaîne (obligatoire)
location	Emplacement de la ressource.	chaîne (obligatoire)
tags	Balises de ressource.	Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
kind	Type de ressource.	string
properties	Propriétés de la ressource principale	AppServiceEnvironment

AppServiceEnvironment

Nom	Description	Valeur
apiManagementAccountId	Gestion des API compte associé au App Service Environment.	string
clusterSettings	Paramètres personnalisés pour modifier le comportement du App Service Environment.	NameValuePair[]
dnsSuffix	Suffixe DNS du App Service Environment.	string
dynamicCacheEnabled	True/false indiquant si le App Service Environment est suspendu. L’environnement peut être suspendu, par exemple, lorsque le point de terminaison de gestion n’est plus disponible (probablement parce que le groupe de sécurité réseau a bloqué le trafic entrant).	bool
frontEndScaleFactor	Facteur de mise à l’échelle pour les serveurs frontaux.	int
hasLinuxWorkers	Indicateur qui indique si un ASE a des workers linux ou non	bool
internalLoadBalancingMode	Spécifie les points de terminaison à servir en interne dans le Réseau virtuel pour le App Service Environment.	'None' 'Publication' 'Web' « Web,Publication »
ipsslAddressCount	Nombre d’adresses IP SSL réservées pour le App Service Environment.	int
location	Emplacement du App Service Environment, par exemple « USA Ouest ».	chaîne (obligatoire)
multiRoleCount	Nombre d’instances front-end.	int
multiSize	Taille de la machine virtuelle frontale, par exemple « Moyenne », « Grande ».	string
name	Nom du App Service Environment.	chaîne (obligatoire)
networkAccessControlList	Liste de contrôle d’accès pour contrôler le trafic vers le App Service Environment.	NetworkAccessControlEntry[]
sslCertKeyVaultId	ID Key Vault pour ILB App Service Environment certificat SSL par défaut	string
sslCertKeyVaultSecretName	nom secret Key Vault pour ILB App Service Environment certificat SSL par défaut	string
interrompu	`true`si le App Service Environment est suspendu ; sinon, `false`. L’environnement peut être suspendu, par exemple lorsque le point de terminaison de gestion n’est plus disponible (probablement parce que le groupe de sécurité réseau a bloqué le trafic entrant).	bool
userWhitelistedIpRanges	L’utilisateur a ajouté la liste des plages d’adresses IP autorisées sur la base de données ASE	string[]
virtualNetwork	Description du Réseau virtuel.	VirtualNetworkProfile (obligatoire)
vnetName	Nom du Réseau virtuel pour le App Service Environment.	string
vnetResourceGroupName	Groupe de ressources du Réseau virtuel.	string
vnetSubnetName	Sous-réseau du Réseau virtuel.	string
workerPools	Description des pools de workers avec des ID de taille de worker, des tailles de machine virtuelle et le nombre de workers dans chaque pool.	WorkerPool[] (obligatoire)

NameValuePair

Nom	Description	Valeur
name	Nom de la paire.	string
value	Valeur de paire.	string

NetworkAccessControlEntry

Nom	Description	Valeur
action	Objet Action.	'Deny' 'Permit'
description	Description de l’entrée de contrôle d’accès réseau.	string
order	Ordre de priorité.	int
remoteSubnet	Sous-réseau distant.	string

VirtualNetworkProfile

Nom	Description	Valeur
id	ID de ressource du Réseau virtuel.	string
sous-réseau	Sous-réseau dans le Réseau virtuel.	string

WorkerPool

Nom	Description	Valeur
computeMode	Hébergement d’applications partagée ou dédiée.	'Dedicated' 'Dynamic' 'Partagé'
workerCount	Nombre d’instances dans le pool de workers.	int
workerSize	Taille de machine virtuelle des instances du pool de workers.	string
workerSizeId	ID de taille de worker pour le référencement de ce pool de workers.	int

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
App Service Environment ILB avec Pare-feu Azure	Resource Manager modèles et paramètres illustrant comment déployer App Service environnement avec l’intégration Pare-feu Azure
App Service Environment avec Azure SQL back-end	Ce modèle crée une App Service Environment avec un back-end Azure SQL ainsi que des points de terminaison privés, ainsi que des ressources associées généralement utilisées dans un environnement privé/isolé.
App Service Environment avec le plan d’hébergement et Azure WebApp	Crée une App Service Environment v2 avec une adresse ILB dans un réseau virtuel existant qui sera disponible en privé. Le App Service Environment contient un plan d’hébergement et une application web Azure
Créer Azure App Service environnement avec une application web ajoutée	Crée un environnement Azure App Service dans un sous-réseau Réseau virtuel. Ce modèle ajoute également une application web Azure dans le App Service Environment. Modèle créé à l’origine par Callum Brankin de PixelPin
Créer un App Service Environment	Crée un App Service Environment dans votre réseau virtuel
Certificat SSL pour un ASE ILB ou un ASE ILB v2	Configurer le certificat SSL par défaut pour un ASE ILB ou un ASE ILB v2
Créer App Service Environment avec une adresse ILB	Crée une App Service Environment dans votre réseau virtuel avec une adresse d’équilibreur de charge interne privée
Créer un App Service Environment v2	Crée un App Service Environment v2 dans votre réseau virtuel
Créer un environnement App Service v2 avec une adresse ILB	Crée une App Service Environment v2 dans votre réseau virtuel avec une adresse d’équilibreur de charge interne privée
Créer un AppServicePlan et une application dans un ASEv3	Créer un AppServicePlan et une application dans un ASEv3

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource hostingEnvironments peut être déployé avec des opérations qui ciblent :

Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Web/hostingEnvironments, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/hostingEnvironments@2020-10-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      apiManagementAccountId = "string"
      clusterSettings = [
        {
          name = "string"
          value = "string"
        }
      ]
      dnsSuffix = "string"
      dynamicCacheEnabled = bool
      frontEndScaleFactor = int
      hasLinuxWorkers = bool
      internalLoadBalancingMode = "string"
      ipsslAddressCount = int
      location = "string"
      multiRoleCount = int
      multiSize = "string"
      name = "string"
      networkAccessControlList = [
        {
          action = "string"
          description = "string"
          order = int
          remoteSubnet = "string"
        }
      ]
      sslCertKeyVaultId = "string"
      sslCertKeyVaultSecretName = "string"
      suspended = bool
      userWhitelistedIpRanges = [
        "string"
      ]
      virtualNetwork = {
        id = "string"
        subnet = "string"
      }
      vnetName = "string"
      vnetResourceGroupName = "string"
      vnetSubnetName = "string"
      workerPools = [
        {
          computeMode = "string"
          workerCount = int
          workerSize = "string"
          workerSizeId = int
        }
      ]
    }
    kind = "string"
  })
}

Valeurs de propriétés

hostingEnvironments

Nom	Description	Valeur
type	Type de ressource	« Microsoft.Web/hostingEnvironments@2020-10-01 »
name	Nom de la ressource	chaîne (obligatoire)
location	Emplacement de la ressource.	chaîne (obligatoire)
parent_id	Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources.	chaîne (obligatoire)
tags	Balises de ressource.	Dictionnaire de noms et de valeurs d’étiquettes.
kind	Type de ressource.	string
properties	Propriétés de la ressource principale	AppServiceEnvironment

AppServiceEnvironment

Nom	Description	Valeur
apiManagementAccountId	Gestion des API compte associé au App Service Environment.	string
clusterSettings	Paramètres personnalisés pour modifier le comportement du App Service Environment.	NameValuePair[]
dnsSuffix	Suffixe DNS du App Service Environment.	string
dynamicCacheEnabled	True/false indiquant si le App Service Environment est suspendu. L’environnement peut être suspendu, par exemple, lorsque le point de terminaison de gestion n’est plus disponible (probablement parce que le groupe de sécurité réseau a bloqué le trafic entrant).	bool
frontEndScaleFactor	Facteur de mise à l’échelle pour les serveurs frontaux.	int
hasLinuxWorkers	Indicateur qui indique si un ASE a des workers linux ou non	bool
internalLoadBalancingMode	Spécifie les points de terminaison à servir en interne dans le Réseau virtuel pour le App Service Environment.	"None" « Publication » "Web" « Web, Publication »
ipsslAddressCount	Nombre d’adresses IP SSL réservées pour le App Service Environment.	int
location	Emplacement du App Service Environment, par exemple « USA Ouest ».	chaîne (obligatoire)
multiRoleCount	Nombre d’instances front-end.	int
multiSize	Taille de la machine virtuelle frontale, par exemple « Moyenne », « Grande ».	string
name	Nom du App Service Environment.	chaîne (obligatoire)
networkAccessControlList	Liste de contrôle d’accès pour contrôler le trafic vers le App Service Environment.	NetworkAccessControlEntry[]
sslCertKeyVaultId	ID Key Vault pour ILB App Service Environment certificat SSL par défaut	string
sslCertKeyVaultSecretName	nom secret Key Vault pour ILB App Service Environment certificat SSL par défaut	string
interrompu	`true`si le App Service Environment est suspendu ; sinon, `false`. L’environnement peut être suspendu, par exemple lorsque le point de terminaison de gestion n’est plus disponible (probablement parce que le groupe de sécurité réseau a bloqué le trafic entrant).	bool
userWhitelistedIpRanges	L’utilisateur a ajouté la liste des plages d’adresses IP autorisées sur la base de données ASE	string[]
virtualNetwork	Description du Réseau virtuel.	VirtualNetworkProfile (obligatoire)
vnetName	Nom du Réseau virtuel pour le App Service Environment.	string
vnetResourceGroupName	Groupe de ressources du Réseau virtuel.	string
vnetSubnetName	Sous-réseau du Réseau virtuel.	string
workerPools	Description des pools de workers avec des ID de taille de worker, des tailles de machine virtuelle et le nombre de workers dans chaque pool.	WorkerPool[] (obligatoire)

NameValuePair

Nom	Description	Valeur
name	Nom de la paire.	string
value	Valeur de paire.	string

NetworkAccessControlEntry

Nom	Description	Valeur
action	Objet Action.	« Refuser » « Autoriser »
description	Description de l’entrée de contrôle d’accès réseau.	string
order	Ordre de priorité.	int
remoteSubnet	Sous-réseau distant.	string

VirtualNetworkProfile

Nom	Description	Valeur
id	ID de ressource du Réseau virtuel.	string
sous-réseau	Sous-réseau dans le Réseau virtuel.	string

WorkerPool

Nom	Description	Valeur
computeMode	Hébergement d’applications partagée ou dédiée.	« Dédié » « Dynamique » « Partagé »
workerCount	Nombre d’instances dans le pool de workers.	int
workerSize	Taille de machine virtuelle des instances du pool de workers.	string
workerSizeId	ID de taille de worker pour le référencement de ce pool de workers.	int

Partager via

Hébergement Microsoft.WebEnvironments 2020-10-01

Définition de ressource Bicep

Format des ressources

Valeurs de propriétés

hostingEnvironments

AppServiceEnvironment

NameValuePair

NetworkAccessControlEntry

VirtualNetworkProfile

WorkerPool

Modèles de démarrage rapide

Définition de ressources de modèle ARM

Format des ressources

Valeurs de propriétés

hostingEnvironments

AppServiceEnvironment

NameValuePair

NetworkAccessControlEntry

VirtualNetworkProfile

WorkerPool

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format des ressources

Valeurs de propriétés

hostingEnvironments

AppServiceEnvironment

NameValuePair

NetworkAccessControlEntry

VirtualNetworkProfile

WorkerPool

Commentaires

Ressources supplémentaires