Microsoft.Web hostingEnvironments
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 groupe de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version d’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@2022-09-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
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
}
}
Valeurs de propriétés
hostingEnvironments
| Nom | Description | Valeur |
|---|---|---|
| name | Nom de la ressource | string (obligatoire) |
| location | Emplacement de la ressource. | string (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 ressource de base | AppServiceEnvironment |
AppServiceEnvironment
| Nom | Description | Valeur |
|---|---|---|
| clusterSettings | Paramètres personnalisés pour modifier le comportement du App Service Environment. | NameValuePair[] |
| customDnsSuffixConfiguration | Vue complète de la configuration du suffixe de domaine personnalisé pour ASEv3. | CustomDnsSuffixConfiguration |
| dedicatedHostCount | Nombre d’hôtes dédiés | int |
| dnsSuffix | Suffixe DNS du App Service Environment. | string |
| frontEndScaleFactor | Facteur d’échelle pour les serveurs frontaux. | int |
| 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 au App Service Environment. | int |
| multiSize | Taille de la machine virtuelle frontale, par exemple « Moyenne », « Grande ». | string |
| networkingConfiguration | Vue complète de la configuration réseau d’un ASE. | AseV3NetworkingConfiguration |
| upgradePreference | Préférence de mise à niveau | 'Tôt' 'Late' 'Manuel' 'None' |
| userWhitelistedIpRanges | L’utilisateur a ajouté des plages d’adresses IP à autoriser sur la base de données ASE | string[] |
| virtualNetwork | Description du Réseau virtuel. | VirtualNetworkProfile (obligatoire) |
| zoneRedundant | Indique si cette App Service Environment est redondante interzone ou non. | bool |
NameValuePair
| Nom | Description | Valeur |
|---|---|---|
| name | Nom de la paire. | string |
| value | Valeur de paire. | string |
CustomDnsSuffixConfiguration
| Nom | Description | Valeur |
|---|---|---|
| kind | Type de ressource. | string |
| properties | Propriétés spécifiques à la ressource CustomDnsSuffixConfiguration | CustomDnsSuffixConfigurationProperties |
CustomDnsSuffixConfigurationProperties
| Nom | Description | Valeur |
|---|---|---|
| certificateUrl | URL référençant le secret de certificat Azure Key Vault qui doit être utilisé comme certificat SSL/TLS par défaut pour les sites avec le suffixe de domaine personnalisé. | string |
| dnsSuffix | Suffixe de domaine personnalisé par défaut à utiliser pour tous les sites déployés sur l’ASE. | string |
| keyVaultReferenceIdentity | Identité affectée par l’utilisateur à utiliser pour résoudre la référence de certificat de coffre de clés. Si elle n’est pas spécifiée, l’identité ASE affectée par le système est utilisée si elle est disponible. | string |
AseV3NetworkingConfiguration
| Nom | Description | Valeur |
|---|---|---|
| kind | Type de ressource. | string |
| properties | Propriétés spécifiques à la ressource AseV3NetworkingConfiguration | AseV3NetworkingConfigurationProperties |
AseV3NetworkingConfigurationProperties
| Nom | Description | Valeur |
|---|---|---|
| allowNewPrivateEndpointConnections | Propriété permettant d’activer et de désactiver la création d’une connexion de point de terminaison privé sur ASE | bool |
| ftpEnabled | Propriété permettant d’activer et de désactiver FTP sur ASEV3 | bool |
| inboundIpAddressOverride | Adresse IP entrante fournie par le client. Peut uniquement être défini sur Ase create. | string |
| remoteDebugEnabled | Propriété permettant d’activer et de désactiver le débogage à distance sur ASEV3 | bool |
VirtualNetworkProfile
| Nom | Description | Valeur |
|---|---|---|
| id | ID de ressource du Réseau virtuel. | string (obligatoire) |
| sous-réseau | Sous-réseau dans le Réseau virtuel. | string |
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 groupe de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.Web/hostingEnvironments, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.Web/hostingEnvironments",
"apiVersion": "2022-09-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"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"
}
}
Valeurs de propriétés
hostingEnvironments
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | 'Microsoft.Web/hostingEnvironments' |
| apiVersion | Version de l’API de ressource | '2022-09-01' |
| name | Nom de la ressource | string (obligatoire) |
| location | Emplacement de la ressource. | string (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 ressource de base | AppServiceEnvironment |
AppServiceEnvironment
| Nom | Description | Valeur |
|---|---|---|
| clusterSettings | Paramètres personnalisés pour modifier le comportement du App Service Environment. | NameValuePair[] |
| customDnsSuffixConfiguration | Vue complète de la configuration du suffixe de domaine personnalisé pour ASEv3. | CustomDnsSuffixConfiguration |
| dedicatedHostCount | Nombre d’hôtes dédiés | int |
| dnsSuffix | Suffixe DNS du App Service Environment. | string |
| frontEndScaleFactor | Facteur d’échelle pour les serveurs frontaux. | int |
| 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 au App Service Environment. | int |
| multiSize | Taille de la machine virtuelle frontale, par exemple « Moyenne », « Grande ». | string |
| networkingConfiguration | Vue complète de la configuration réseau d’un ASE. | AseV3NetworkingConfiguration |
| upgradePreference | Préférence de mise à niveau | 'Tôt' 'Late' 'Manuel' 'None' |
| userWhitelistedIpRanges | L’utilisateur a ajouté des plages d’adresses IP à autoriser sur la base de données ASE | string[] |
| virtualNetwork | Description du Réseau virtuel. | VirtualNetworkProfile (obligatoire) |
| zoneRedundant | Indique si cette App Service Environment est redondante interzone ou non. | bool |
NameValuePair
| Nom | Description | Valeur |
|---|---|---|
| name | Nom de la paire. | string |
| value | Valeur de paire. | string |
CustomDnsSuffixConfiguration
| Nom | Description | Valeur |
|---|---|---|
| kind | Type de ressource. | string |
| properties | Propriétés spécifiques à la ressource CustomDnsSuffixConfiguration | CustomDnsSuffixConfigurationProperties |
CustomDnsSuffixConfigurationProperties
| Nom | Description | Valeur |
|---|---|---|
| certificateUrl | URL référençant le secret de certificat Azure Key Vault qui doit être utilisé comme certificat SSL/TLS par défaut pour les sites avec le suffixe de domaine personnalisé. | string |
| dnsSuffix | Suffixe de domaine personnalisé par défaut à utiliser pour tous les sites déployés sur l’ASE. | string |
| keyVaultReferenceIdentity | Identité affectée par l’utilisateur à utiliser pour résoudre la référence de certificat de coffre de clés. Si elle n’est pas spécifiée, l’identité ASE affectée par le système est utilisée si elle est disponible. | string |
AseV3NetworkingConfiguration
| Nom | Description | Valeur |
|---|---|---|
| kind | Type de ressource. | string |
| properties | Propriétés spécifiques à la ressource AseV3NetworkingConfiguration | AseV3NetworkingConfigurationProperties |
AseV3NetworkingConfigurationProperties
| Nom | Description | Valeur |
|---|---|---|
| allowNewPrivateEndpointConnections | Propriété permettant d’activer et de désactiver la création d’une connexion de point de terminaison privé sur ASE | bool |
| ftpEnabled | Propriété permettant d’activer et de désactiver FTP sur ASEV3 | bool |
| inboundIpAddressOverride | Adresse IP entrante fournie par le client. Peut uniquement être défini sur Ase create. | string |
| remoteDebugEnabled | Propriété permettant d’activer et de désactiver le débogage à distance sur ASEV3 | bool |
VirtualNetworkProfile
| Nom | Description | Valeur |
|---|---|---|
| id | ID de ressource du Réseau virtuel. | string (obligatoire) |
| sous-réseau | Sous-réseau dans le Réseau virtuel. | string |
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 d’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@2022-09-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
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
}
kind = "string"
})
}
Valeurs de propriétés
hostingEnvironments
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | « Microsoft.Web/hostingEnvironments@2022-09-01 » |
| name | Nom de la ressource | string (obligatoire) |
| location | Emplacement de la ressource. | string (obligatoire) |
| parent_id | Pour effectuer un déploiement dans un groupe de ressources, utilisez l’ID de ce groupe de ressources. | string (obligatoire) |
| tags | Balises de ressource. | Dictionnaire de noms et de valeurs d’étiquettes. |
| kind | Type de ressource. | string |
| properties | Propriétés de ressource de base | AppServiceEnvironment |
AppServiceEnvironment
| Nom | Description | Valeur |
|---|---|---|
| clusterSettings | Paramètres personnalisés pour modifier le comportement du App Service Environment. | NameValuePair[] |
| customDnsSuffixConfiguration | Vue complète de la configuration du suffixe de domaine personnalisé pour ASEv3. | CustomDnsSuffixConfiguration |
| dedicatedHostCount | Nombre d’hôtes dédiés | int |
| dnsSuffix | Suffixe DNS du App Service Environment. | string |
| frontEndScaleFactor | Facteur d’échelle pour les serveurs frontaux. | int |
| 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 au App Service Environment. | int |
| multiSize | Taille de la machine virtuelle frontale, par exemple « Moyenne », « Grande ». | string |
| networkingConfiguration | Vue complète de la configuration réseau d’un ASE. | AseV3NetworkingConfiguration |
| upgradePreference | Préférence de mise à niveau | « Tôt » « En retard » « Manuel » "None" |
| userWhitelistedIpRanges | L’utilisateur a ajouté des plages d’adresses IP à autoriser sur la base de données ASE | string[] |
| virtualNetwork | Description du Réseau virtuel. | VirtualNetworkProfile (obligatoire) |
| zoneRedundant | Indique si cette App Service Environment est redondante interzone ou non. | bool |
NameValuePair
| Nom | Description | Valeur |
|---|---|---|
| name | Nom de la paire. | string |
| value | Valeur de paire. | string |
CustomDnsSuffixConfiguration
| Nom | Description | Valeur |
|---|---|---|
| kind | Type de ressource. | string |
| properties | Propriétés spécifiques à la ressource CustomDnsSuffixConfiguration | CustomDnsSuffixConfigurationProperties |
CustomDnsSuffixConfigurationProperties
| Nom | Description | Valeur |
|---|---|---|
| certificateUrl | URL référençant le secret de certificat Azure Key Vault qui doit être utilisé comme certificat SSL/TLS par défaut pour les sites avec le suffixe de domaine personnalisé. | string |
| dnsSuffix | Suffixe de domaine personnalisé par défaut à utiliser pour tous les sites déployés sur l’ASE. | string |
| keyVaultReferenceIdentity | Identité affectée par l’utilisateur à utiliser pour résoudre la référence de certificat de coffre de clés. Si elle n’est pas spécifiée, l’identité ASE affectée par le système est utilisée si disponible. | string |
AseV3NetworkingConfiguration
| Nom | Description | Valeur |
|---|---|---|
| kind | Type de ressource. | string |
| properties | Propriétés spécifiques à la ressource AseV3NetworkingConfiguration | AseV3NetworkingConfigurationProperties |
AseV3NetworkingConfigurationProperties
| Nom | Description | Valeur |
|---|---|---|
| allowNewPrivateEndpointConnections | Propriété permettant d’activer et de désactiver la création d’une connexion de point de terminaison privé sur ASE | bool |
| ftpEnabled | Propriété permettant d’activer et de désactiver FTP sur ASEV3 | bool |
| inboundIpAddressOverride | Adresse IP entrante fournie par le client. Ne peut être défini que sur Ase create. | string |
| remoteDebugEnabled | Propriété permettant d’activer et de désactiver le débogage distant sur ASEV3 | bool |
VirtualNetworkProfile
| Nom | Description | Valeur |
|---|---|---|
| id | ID de ressource du Réseau virtuel. | chaîne (obligatoire) |
| sous-réseau | Sous-réseau dans le Réseau virtuel. | string |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour