Microsoft.VirtualMachineImages imageTemplates 2018-02-01-preview
Definición de recursos de Bicep
El tipo de recurso imageTemplates se puede implementar en:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente bicep a la plantilla.
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
}
}
}
Objetos ImageTemplateCustomizer
Establezca la propiedad type para especificar el tipo de objeto.
Para shell, use:
type: 'shell'
script: 'string'
Objetos ImageTemplateDistributor
Establezca la propiedad type para especificar el tipo de objeto.
Para managedImage, use:
type: 'managedImage'
imageId: 'string'
location: 'string'
Para sharedImage, use:
type: 'sharedImage'
galleryImageId: 'string'
replicationRegions: [
'string'
]
Objetos ImageTemplateSource
Establezca la propiedad type para especificar el tipo de objeto.
Para ISO, use:
type: 'ISO'
sha256Checksum: 'string'
sourceURI: 'string'
Para PlatformImage, use:
type: 'PlatformImage'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
Valores de propiedad
imageTemplates
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) |
| ubicación | Ubicación de los recursos | string (obligatorio) |
| etiquetas | Etiquetas del recurso | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| properties | ImageTemplateProperties |
ImageTemplateProperties
| Nombre | Descripción | Valor |
|---|---|---|
| Personalización | Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. | ImageTemplateCustomizer[] |
| distribuir | Los destinos de distribución a los que debe ir la salida de la imagen. | ImageTemplateDistributor[] (obligatorio) |
| source | Especifica las propiedades usadas para describir la imagen de origen. | ImageTemplateSource (obligatorio) |
ImageTemplateCustomizer
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización | string |
| type | Establecimiento del tipo de objeto | shell (obligatorio) |
ImageTemplateShellCustomizer
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "shell" puede ser shellCustomizer. | 'shell' (obligatorio) |
| script | Script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
ImageTemplateDistributor
| Nombre | Descripción | Valor |
|---|---|---|
| artifactTags | Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. | object |
| runOutputName | Nombre que se va a usar para el RunOutput asociado. | string (obligatorio) |
| tipo | Establecimiento del tipo de objeto | managedImage sharedImage (obligatorio) |
ImageTemplateManagedImageDistributor
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de distribución. | 'managedImage' (obligatorio) |
| imageId | Identificador de recurso de la imagen de disco administrado | string (obligatorio) |
| ubicación | La ubicación de Azure de la imagen debe coincidir si la imagen ya existe. | string (obligatorio) |
ImageTemplateSharedImageDistributor
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de distribución. | 'sharedImage' (obligatorio) |
| galleryImageId | Identificador de recurso de la imagen de Shared Image Gallery | string (obligatorio) |
| replicationRegions | string[] (obligatorio) |
ImageTemplateSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Establecimiento del tipo de objeto | ISO PlatformImage (obligatorio) |
ImageTemplateIsoSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Especifica el tipo de imagen de origen con el que desea empezar. | 'ISO' (obligatorio) |
| sha256Checksum | Suma de comprobación SHA256 de la imagen ISO. | string (obligatorio) |
| sourceURI | Dirección URL para obtener la imagen ISO. Esta dirección URL debe ser accesible para el proveedor de recursos en el momento de la creación de imageTemplate. | string (obligatorio) |
ImageTemplatePlatformImageSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Especifica el tipo de imagen de origen con el que desea empezar. | 'PlatformImage' (obligatorio) |
| offer | Oferta de imagen de las imágenes de la Galería de Azure. | string |
| publisher | Image Publisher en imágenes de la Galería de Azure. | string |
| sku | SKU de imagen de las imágenes de la Galería de Azure. | string |
| version | Versión de la imagen de las imágenes de la Galería de Azure. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
Azure Image Builder con Azure Windows Baseline |
Crea un entorno de Azure Image Builder y crea una imagen de Windows Server con la versión más reciente de Windows Novedades y La línea de base de Windows de Azure aplicada. |
| Configuración del servicio Dev Box |
Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box. Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer dev Box. |
Definición de recursos de plantilla de ARM
El tipo de recurso imageTemplates se puede implementar en:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente json a la plantilla.
{
"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
}
}
}
Objetos ImageTemplateCustomizer
Establezca la propiedad type para especificar el tipo de objeto.
Para shell, use:
"type": "shell",
"script": "string"
Objetos ImageTemplateDistributor
Establezca la propiedad type para especificar el tipo de objeto.
Para managedImage, use:
"type": "managedImage",
"imageId": "string",
"location": "string"
Para sharedImage, use:
"type": "sharedImage",
"galleryImageId": "string",
"replicationRegions": [ "string" ]
Objetos ImageTemplateSource
Establezca la propiedad type para especificar el tipo de objeto.
Para ISO, use:
"type": "ISO",
"sha256Checksum": "string",
"sourceURI": "string"
Para PlatformImage, use:
"type": "PlatformImage",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
Valores de propiedad
imageTemplates
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | 'Microsoft.VirtualMachineImages/imageTemplates' |
| apiVersion | La versión de la API de recursos | "2018-02-01-preview" |
| name | El nombre del recurso | string (obligatorio) |
| ubicación | Ubicación de los recursos | string (obligatorio) |
| etiquetas | Etiquetas del recurso | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| properties | ImageTemplateProperties |
ImageTemplateProperties
| Nombre | Descripción | Valor |
|---|---|---|
| Personalización | Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. | ImageTemplateCustomizer[] |
| distribuir | Los destinos de distribución a los que debe ir la salida de la imagen. | ImageTemplateDistributor[] (obligatorio) |
| source | Especifica las propiedades usadas para describir la imagen de origen. | ImageTemplateSource (obligatorio) |
ImageTemplateCustomizer
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización | string |
| type | Establecimiento del tipo de objeto | shell (obligatorio) |
ImageTemplateShellCustomizer
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "shell" puede ser shellCustomizer. | 'shell' (obligatorio) |
| script | Script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
ImageTemplateDistributor
| Nombre | Descripción | Valor |
|---|---|---|
| artifactTags | Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. | object |
| runOutputName | Nombre que se va a usar para el RunOutput asociado. | string (obligatorio) |
| tipo | Establecimiento del tipo de objeto | managedImage sharedImage (obligatorio) |
ImageTemplateManagedImageDistributor
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de distribución. | 'managedImage' (obligatorio) |
| imageId | Identificador de recurso de la imagen de disco administrado | string (obligatorio) |
| ubicación | La ubicación de Azure de la imagen debe coincidir si la imagen ya existe. | string (obligatorio) |
ImageTemplateSharedImageDistributor
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de distribución. | 'sharedImage' (obligatorio) |
| galleryImageId | Identificador de recurso de la imagen de Shared Image Gallery | string (obligatorio) |
| replicationRegions | string[] (obligatorio) |
ImageTemplateSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Establecimiento del tipo de objeto | ISO PlatformImage (obligatorio) |
ImageTemplateIsoSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Especifica el tipo de imagen de origen con el que desea empezar. | 'ISO' (obligatorio) |
| sha256Checksum | Suma de comprobación SHA256 de la imagen ISO. | string (obligatorio) |
| sourceURI | Dirección URL para obtener la imagen ISO. Esta dirección URL debe ser accesible para el proveedor de recursos en el momento de la creación de imageTemplate. | string (obligatorio) |
ImageTemplatePlatformImageSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Especifica el tipo de imagen de origen con el que desea empezar. | 'PlatformImage' (obligatorio) |
| offer | Oferta de imagen de las imágenes de la Galería de Azure. | string |
| publisher | Image Publisher en imágenes de la Galería de Azure. | string |
| sku | SKU de imagen de las imágenes de la Galería de Azure. | string |
| version | Versión de imagen de las imágenes de la Galería de Azure. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
| Azure Image Builder con la línea de base de Windows de Azure |
Crea un entorno de Azure Image Builder y crea una imagen de Windows Server con la versión más reciente de Windows Novedades y La línea base de Windows de Azure aplicada. |
| Configuración del servicio Dev Box |
Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box. Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer dev Box. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso imageTemplates se puede implementar en:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente terraform a la plantilla.
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
}
}
})
}
Objetos ImageTemplateCustomizer
Establezca la propiedad type para especificar el tipo de objeto.
Para shell, use:
type = "shell"
script = "string"
Objetos ImageTemplateDistributor
Establezca la propiedad type para especificar el tipo de objeto.
Para managedImage, use:
type = "managedImage"
imageId = "string"
location = "string"
Para sharedImage, use:
type = "sharedImage"
galleryImageId = "string"
replicationRegions = [
"string"
]
Objetos ImageTemplateSource
Establezca la propiedad type para especificar el tipo de objeto.
Para ISO, use:
type = "ISO"
sha256Checksum = "string"
sourceURI = "string"
Para PlatformImage, use:
type = "PlatformImage"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
Valores de propiedad
imageTemplates
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview" |
| name | El nombre del recurso | string (obligatorio) |
| ubicación | Ubicación de los recursos | string (obligatorio) |
| parent_id | Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. | string (obligatorio) |
| etiquetas | Etiquetas del recurso | Diccionario de nombres y valores de etiqueta. |
| properties | ImageTemplateProperties |
ImageTemplateProperties
| Nombre | Descripción | Valor |
|---|---|---|
| Personalización | Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. | ImageTemplateCustomizer[] |
| distribuir | Los destinos de distribución a los que debe ir la salida de la imagen. | ImageTemplateDistributor[] (obligatorio) |
| source | Especifica las propiedades usadas para describir la imagen de origen. | ImageTemplateSource (obligatorio) |
ImageTemplateCustomizer
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización | string |
| type | Establecimiento del tipo de objeto | shell (obligatorio) |
ImageTemplateShellCustomizer
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "shell" puede ser shellCustomizer. | "shell" (obligatorio) |
| script | Script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. | string |
ImageTemplateDistributor
| Nombre | Descripción | Valor |
|---|---|---|
| artifactTags | Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. | object |
| runOutputName | Nombre que se va a usar para el RunOutput asociado. | string (obligatorio) |
| tipo | Establecimiento del tipo de objeto | managedImage sharedImage (obligatorio) |
ImageTemplateManagedImageDistributor
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de distribución. | "managedImage" (obligatorio) |
| imageId | Identificador de recurso de la imagen de disco administrado | string (obligatorio) |
| ubicación | La ubicación de Azure de la imagen debe coincidir si la imagen ya existe. | string (obligatorio) |
ImageTemplateSharedImageDistributor
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de distribución. | "sharedImage" (obligatorio) |
| galleryImageId | Identificador de recurso de la imagen de Shared Image Gallery | string (obligatorio) |
| replicationRegions | string[] (obligatorio) |
ImageTemplateSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Establecimiento del tipo de objeto | ISO PlatformImage (obligatorio) |
ImageTemplateIsoSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Especifica el tipo de imagen de origen con el que desea empezar. | "ISO" (obligatorio) |
| sha256Checksum | Suma de comprobación SHA256 de la imagen ISO. | string (obligatorio) |
| sourceURI | Dirección URL para obtener la imagen ISO. Esta dirección URL debe ser accesible para el proveedor de recursos en el momento de la creación de imageTemplate. | string (obligatorio) |
ImageTemplatePlatformImageSource
| Nombre | Descripción | Value |
|---|---|---|
| type | Especifica el tipo de imagen de origen con el que desea empezar. | "PlatformImage" (obligatorio) |
| offer | Oferta de imagen de las imágenes de la Galería de Azure. | string |
| publisher | Image Publisher en imágenes de la Galería de Azure. | string |
| sku | SKU de imagen de las imágenes de la Galería de Azure. | string |
| version | Versión de imagen de las imágenes de la Galería de Azure. | string |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de