Image Microsoft.VirtualMachineImagesTemplates 2018-02-01-preview
Définition de ressource Bicep
Le type de ressource imageTemplates peut être déployé sur :
- 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.VirtualMachineImages/imageTemplates, ajoutez le Bicep suivant à votre modèle.
resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
customize: [
{
name: 'string'
type: 'string'
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute: [
{
artifactTags: {}
runOutputName: 'string'
type: 'string'
// For remaining properties, see ImageTemplateDistributor objects
}
]
source: {
type: 'string'
// For remaining properties, see ImageTemplateSource objects
}
}
}
Objets ImageTemplateCustomizer
Définissez la propriété type pour spécifier le type d’objet.
Pour l’interpréteur de commandes, utilisez :
type: 'shell'
script: 'string'
Objets ImageTemplateDistributor
Définissez la propriété type pour spécifier le type d’objet.
Pour managedImage, utilisez :
type: 'managedImage'
imageId: 'string'
location: 'string'
Pour sharedImage, utilisez :
type: 'sharedImage'
galleryImageId: 'string'
replicationRegions: [
'string'
]
Objets ImageTemplateSource
Définissez la propriété type pour spécifier le type d’objet.
Pour ISO, utilisez :
type: 'ISO'
sha256Checksum: 'string'
sourceURI: 'string'
Pour PlatformImage, utilisez :
type: 'PlatformImage'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
Valeurs de propriétés
imageTemplates
| 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 |
| properties | ImageTemplateProperties |
ImageTemplateProperties
| Nom | Description | Valeur |
|---|---|---|
| Personnalisation | Spécifie les propriétés utilisées pour décrire les étapes de personnalisation de l’image, telles que la source d’image, etc. | ImageTemplateCustomizer[] |
| distribuer | Cibles de distribution où la sortie de l’image doit aller. | ImageTemplateDistributor[] (obligatoire) |
| source | Spécifie les propriétés utilisées pour décrire l’image source. | ImageTemplateSource (obligatoire) |
ImageTemplateCustomizer
| Nom | Description | Valeur |
|---|---|---|
| name | Nom convivial pour fournir un contexte sur l’action de cette étape de personnalisation | string |
| type | Définir le type d’objet | shell (obligatoire) |
ImageTemplateShellCustomizer
| Nom | Description | Valeur |
|---|---|---|
| type | Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « shell » peut être shellCustomizer | 'shell' (obligatoire) |
| script | Script d’interpréteur de commandes à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’un URI SAS pour Stockage Azure, etc. | string |
ImageTemplateDistributor
| Nom | Description | Valeur |
|---|---|---|
| artifactTags | Balises qui seront appliquées à l’artefact une fois qu’il a été créé/mis à jour par le serveur de distribution. | object |
| runOutputName | Nom à utiliser pour le RunOutput associé. | chaîne (obligatoire) |
| type | Définir le type d’objet | managedImage sharedImage (obligatoire) |
ImageTemplateManagedImageDistributor
| Nom | Description | Valeur |
|---|---|---|
| type | Type de distribution. | 'managedImage' (obligatoire) |
| imageId | ID de ressource de l’image de disque managé | string (obligatoire) |
| location | L’emplacement Azure de l’image doit correspondre si l’image existe déjà | string (obligatoire) |
ImageTemplateSharedImageDistributor
| Nom | Description | Valeur |
|---|---|---|
| type | Type de distribution. | 'sharedImage' (obligatoire) |
| galleryImageId | ID de ressource de l’image Shared Image Gallery | string (obligatoire) |
| replicationRegions | string[] (obligatoire) |
ImageTemplateSource
| Nom | Description | Valeur |
|---|---|---|
| type | Définir le type d’objet | ISO PlatformImage (obligatoire) |
ImageTemplateIsoSource
| Nom | Description | Valeur |
|---|---|---|
| type | Spécifie le type d’image source que vous souhaitez commencer. | 'ISO' (obligatoire) |
| sha256Checksum | Somme de contrôle SHA256 de l’image ISO. | string (obligatoire) |
| sourceURI | URL pour obtenir l’image ISO. Cette URL doit être accessible au fournisseur de ressources au moment de la création de l’imageTemplate. | string (obligatoire) |
ImageTemplatePlatformImageSource
| Nom | Description | Valeur |
|---|---|---|
| type | Spécifie le type d’image source que vous souhaitez commencer. | 'PlatformImage' (obligatoire) |
| offer | Offre d’images de la galerie Azure Images. | string |
| publisher | Éditeur d’images dans azure Gallery Images. | string |
| sku | Référence sku d’image de la galerie Azure Images. | string |
| version | Version de l’image à partir des images de la galerie Azure. | string |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
| Modèle | Description |
|---|---|
Azure Image Builder avec base de référence Azure Windows |
Crée un environnement Azure Image Builder et génère une image Windows Server avec la dernière version de Windows Mises à jour et la base de référence Azure Windows appliquées. |
| Configurer le service Dev Box |
Ce modèle crée toutes les ressources d’administration Dev Box conformément au guide de démarrage rapide dev Box. Vous pouvez afficher toutes les ressources créées ou accéder directement à DevPortal.microsoft.com pour créer votre première Dev Box. |
Définition de ressources de modèle ARM
Le type de ressource imageTemplates peut être déployé sur :
- 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.VirtualMachineImages/imageTemplates, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.VirtualMachineImages/imageTemplates",
"apiVersion": "2018-02-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"customize": [
{
"name": "string",
"type": "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
],
"distribute": [
{
"artifactTags": {},
"runOutputName": "string",
"type": "string"
// For remaining properties, see ImageTemplateDistributor objects
}
],
"source": {
"type": "string"
// For remaining properties, see ImageTemplateSource objects
}
}
}
Objets ImageTemplateCustomizer
Définissez la propriété type pour spécifier le type d’objet.
Pour l’interpréteur de commandes, utilisez :
"type": "shell",
"script": "string"
Objets ImageTemplateDistributor
Définissez la propriété type pour spécifier le type d’objet.
Pour managedImage, utilisez :
"type": "managedImage",
"imageId": "string",
"location": "string"
Pour sharedImage, utilisez :
"type": "sharedImage",
"galleryImageId": "string",
"replicationRegions": [ "string" ]
Objets ImageTemplateSource
Définissez la propriété type pour spécifier le type d’objet.
Pour ISO, utilisez :
"type": "ISO",
"sha256Checksum": "string",
"sourceURI": "string"
Pour PlatformImage, utilisez :
"type": "PlatformImage",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
Valeurs de propriétés
imageTemplates
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | 'Microsoft.VirtualMachineImages/imageTemplates' |
| apiVersion | Version de l’API de ressource | '2018-02-01-preview' |
| 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 |
| properties | ImageTemplateProperties |
ImageTemplateProperties
| Nom | Description | Valeur |
|---|---|---|
| Personnalisation | Spécifie les propriétés utilisées pour décrire les étapes de personnalisation de l’image, telles que la source de l’image, etc. | ImageTemplateCustomizer[] |
| distribuer | Cibles de distribution où la sortie de l’image doit aller. | ImageTemplateDistributor[] (obligatoire) |
| source | Spécifie les propriétés utilisées pour décrire l’image source. | ImageTemplateSource (obligatoire) |
ImageTemplateCustomizer
| Nom | Description | Valeur |
|---|---|---|
| name | Nom convivial pour fournir un contexte sur ce que fait cette étape de personnalisation | string |
| type | Définir le type d’objet | shell (obligatoire) |
ImageTemplateShellCustomizer
| Nom | Description | Valeur |
|---|---|---|
| type | Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « shell » peut être shellCustomizer | 'shell' (obligatoire) |
| script | Script shell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAS pour stockage Azure, etc. | string |
ImageTemplateDistributor
| Nom | Description | Valeur |
|---|---|---|
| artifactTags | Balises qui seront appliquées à l’artefact une fois qu’il a été créé/mis à jour par le serveur de distribution. | object |
| runOutputName | Nom à utiliser pour le RunOutput associé. | string (obligatoire) |
| type | Définir le type d’objet | managedImage sharedImage (obligatoire) |
ImageTemplateManagedImageDistributor
| Nom | Description | Valeur |
|---|---|---|
| type | Type de distribution. | 'managedImage' (obligatoire) |
| imageId | ID de ressource de l’image de disque managé | string (obligatoire) |
| location | L’emplacement Azure de l’image doit correspondre si l’image existe déjà | string (obligatoire) |
ImageTemplateSharedImageDistributor
| Nom | Description | Valeur |
|---|---|---|
| type | Type de distribution. | 'sharedImage' (obligatoire) |
| galleryImageId | ID de ressource de l’image Shared Image Gallery | string (obligatoire) |
| replicationRegions | string[] (obligatoire) |
ImageTemplateSource
| Nom | Description | Valeur |
|---|---|---|
| type | Définir le type d’objet | ISO PlatformImage (obligatoire) |
ImageTemplateIsoSource
| Nom | Description | Valeur |
|---|---|---|
| type | Spécifie le type d’image source que vous souhaitez commencer. | 'ISO' (obligatoire) |
| sha256Checksum | Somme de contrôle SHA256 de l’image ISO. | string (obligatoire) |
| sourceURI | URL pour obtenir l’image ISO. Cette URL doit être accessible au fournisseur de ressources au moment de la création de l’imageTemplate. | string (obligatoire) |
ImageTemplatePlatformImageSource
| Nom | Description | Valeur |
|---|---|---|
| type | Spécifie le type d’image source que vous souhaitez commencer. | 'PlatformImage' (obligatoire) |
| offer | Offre d’images de la galerie Azure Images. | string |
| publisher | Éditeur d’images dans azure Gallery Images. | string |
| sku | Référence sku d’image de la galerie Azure Images. | string |
| version | Version de l’image à partir des images de la galerie Azure. | string |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
| Modèle | Description |
|---|---|
| Azure Image Builder avec base de référence Azure Windows |
Crée un environnement Azure Image Builder et génère une image Windows Server avec la dernière version de Windows Mises à jour et la base de référence Azure Windows appliquées. |
| Configurer le service Dev Box |
Ce modèle crée toutes les ressources d’administration Dev Box conformément au guide de démarrage rapide dev Box. Vous pouvez afficher toutes les ressources créées ou accéder directement à DevPortal.microsoft.com pour créer votre première Dev Box. |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource imageTemplates peut être déployé sur :
- 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.VirtualMachineImages/imageTemplates, ajoutez le Terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
customize = [
{
name = "string"
type = "string"
// For remaining properties, see ImageTemplateCustomizer objects
}
]
distribute = [
{
artifactTags = {}
runOutputName = "string"
type = "string"
// For remaining properties, see ImageTemplateDistributor objects
}
]
source = {
type = "string"
// For remaining properties, see ImageTemplateSource objects
}
}
})
}
Objets ImageTemplateCustomizer
Définissez la propriété type pour spécifier le type d’objet.
Pour l’interpréteur de commandes, utilisez :
type = "shell"
script = "string"
Objets ImageTemplateDistributor
Définissez la propriété type pour spécifier le type d’objet.
Pour managedImage, utilisez :
type = "managedImage"
imageId = "string"
location = "string"
Pour sharedImage, utilisez :
type = "sharedImage"
galleryImageId = "string"
replicationRegions = [
"string"
]
Objets ImageTemplateSource
Définissez la propriété type pour spécifier le type d’objet.
Pour ISO, utilisez :
type = "ISO"
sha256Checksum = "string"
sourceURI = "string"
Pour PlatformImage, utilisez :
type = "PlatformImage"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
Valeurs de propriétés
imageTemplates
| Nom | Description | Valeur |
|---|---|---|
| type | Type de ressource | « Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview » |
| 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. |
| properties | ImageTemplateProperties |
ImageTemplateProperties
| Nom | Description | Valeur |
|---|---|---|
| Personnalisation | Spécifie les propriétés utilisées pour décrire les étapes de personnalisation de l’image, telles que la source de l’image, etc. | ImageTemplateCustomizer[] |
| distribuer | Cibles de distribution où la sortie de l’image doit aller. | ImageTemplateDistributor[] (obligatoire) |
| source | Spécifie les propriétés utilisées pour décrire l’image source. | ImageTemplateSource (obligatoire) |
ImageTemplateCustomizer
| Nom | Description | Valeur |
|---|---|---|
| name | Nom convivial pour fournir un contexte sur ce que fait cette étape de personnalisation | string |
| type | Définir le type d’objet | shell (obligatoire) |
ImageTemplateShellCustomizer
| Nom | Description | Valeur |
|---|---|---|
| type | Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « shell » peut être shellCustomizer | « shell » (obligatoire) |
| script | Script shell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAS pour stockage Azure, etc. | string |
ImageTemplateDistributor
| Nom | Description | Valeur |
|---|---|---|
| artifactTags | Balises qui seront appliquées à l’artefact une fois qu’il a été créé/mis à jour par le serveur de distribution. | object |
| runOutputName | Nom à utiliser pour le RunOutput associé. | string (obligatoire) |
| type | Définir le type d’objet | managedImage sharedImage (obligatoire) |
ImageTemplateManagedImageDistributor
| Nom | Description | Valeur |
|---|---|---|
| type | Type de distribution. | « managedImage » (obligatoire) |
| imageId | ID de ressource de l’image de disque managé | string (obligatoire) |
| location | L’emplacement Azure de l’image doit correspondre si l’image existe déjà | string (obligatoire) |
ImageTemplateSharedImageDistributor
| Nom | Description | Valeur |
|---|---|---|
| type | Type de distribution. | « sharedImage » (obligatoire) |
| galleryImageId | ID de ressource de l’image Shared Image Gallery | string (obligatoire) |
| replicationRegions | string[] (obligatoire) |
ImageTemplateSource
| Nom | Description | Valeur |
|---|---|---|
| type | Définir le type d’objet | ISO PlatformImage (obligatoire) |
ImageTemplateIsoSource
| Nom | Description | Valeur |
|---|---|---|
| type | Spécifie le type d’image source que vous souhaitez commencer. | « ISO » (obligatoire) |
| sha256Checksum | Somme de contrôle SHA256 de l’image ISO. | string (obligatoire) |
| sourceURI | URL pour obtenir l’image ISO. Cette URL doit être accessible au fournisseur de ressources au moment de la création de l’imageTemplate. | string (obligatoire) |
ImageTemplatePlatformImageSource
| Nom | Description | Valeur |
|---|---|---|
| type | Spécifie le type d’image source que vous souhaitez commencer. | « PlatformImage » (obligatoire) |
| offer | Offre d’images de la galerie Azure Images. | string |
| publisher | Éditeur d’images dans azure Gallery Images. | string |
| sku | Référence sku d’image de la galerie Azure Images. | string |
| version | Version de l’image à partir des images de la galerie Azure. | 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