Imagem Microsoft.VirtualMachineImagesTemplates 2018-02-01-preview
Definição de recurso do Bicep
O tipo de recurso imageTemplates pode ser implementado em:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte Bicep ao seu modelo.
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
}
}
}
ImageTemplateCustomizer objects (Objetos ImageTemplateCustomizer)
Defina a propriedade tipo para especificar o tipo de objeto.
Para shell, utilize:
type: 'shell'
script: 'string'
Objetos ImageTemplateDistributor
Defina a propriedade tipo para especificar o tipo de objeto.
Para managedImage, utilize:
type: 'managedImage'
imageId: 'string'
location: 'string'
Para sharedImage, utilize:
type: 'sharedImage'
galleryImageId: 'string'
replicationRegions: [
'string'
]
Objetos ImageTemplateSource
Defina a propriedade tipo para especificar o tipo de objeto.
Para ISO, utilize:
type: 'ISO'
sha256Checksum: 'string'
sourceURI: 'string'
Para PlatformImage, utilize:
type: 'PlatformImage'
offer: 'string'
publisher: 'string'
sku: 'string'
version: 'string'
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia (obrigatório) |
| localização | Localização do recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| propriedades | ImageTemplateProperties |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| personalizar | Especifica as propriedades utilizadas para descrever os passos de personalização da imagem, como a Origem da imagem, etc. | ImageTemplateCustomizer[] |
| distribuir | Os destinos de distribuição para onde a saída da imagem tem de ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades utilizadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome Amigável para fornecer contexto sobre o que faz este passo de personalização | string |
| tipo | Definir o tipo de objeto | shell (obrigatório) |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "shell" pode ser shellCustomizer | "shell" (obrigatório) |
| script | O script da shell a ser executado para personalização. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Etiquetas que serão aplicadas ao artefacto depois de serem criadas/atualizadas pelo distribuidor. | objeto |
| runOutputName | O nome a utilizar para o RunOutput associado. | cadeia (obrigatório) |
| tipo | Definir o tipo de objeto | managedImage sharedImage (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "managedImage" (obrigatório) |
| imageId | ID do Recurso da Imagem do Disco Gerido | cadeia (obrigatório) |
| localização | A localização do Azure para a imagem deve corresponder se a imagem já existir | cadeia (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "sharedImage" (obrigatório) |
| galleryImageId | ID do recurso da imagem de Shared Image Gallery | cadeia (obrigatório) |
| replicationRegions | string[] (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ISO PlatformImage (obrigatório) |
ImageTemplateIsoSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ISO" (obrigatório) |
| sha256Checksum | SHA256 Soma de verificação da imagem ISO. | cadeia (obrigatório) |
| sourceURI | URL para obter a imagem ISO. Este URL tem de estar acessível ao fornecedor de recursos no momento da criação do imageTemplate. | cadeia (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "PlatformImage" (obrigatório) |
| oferta | Oferta de imagem a partir das Imagens da Galeria do Azure. | string |
| publicador | Image Publisher in Azure Gallery Images (Imagens da Galeria do Azure). | string |
| sku | SKU de imagem das Imagens da Galeria do Azure. | string |
| versão | Versão da imagem das Imagens da Galeria do Azure. | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Azure Image Builder with Azure Windows Baseline |
Cria um ambiente do Azure Image Builder e cria uma imagem do Windows Server com o Atualizações mais recente do Windows e a Linha de Base do Windows do Azure aplicadas. |
| Configurar o serviço Dev Box |
Este modelo criaria todos os recursos de administrador do Dev Box de acordo com o Guia de introdução do Dev Box. Pode ver todos os recursos criados ou aceder diretamente a DevPortal.microsoft.com para criar o seu primeiro Dev Box. |
Definição de recurso do modelo arm
O tipo de recurso imageTemplates pode ser implementado em:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte JSON ao seu modelo.
{
"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
Defina a propriedade type para especificar o tipo de objeto.
Para shell, utilize:
"type": "shell",
"script": "string"
Objetos ImageTemplateDistributor
Defina a propriedade type para especificar o tipo de objeto.
Para managedImage, utilize:
"type": "managedImage",
"imageId": "string",
"location": "string"
Para sharedImage, utilize:
"type": "sharedImage",
"galleryImageId": "string",
"replicationRegions": [ "string" ]
Objetos ImageTemplateSource
Defina a propriedade type para especificar o tipo de objeto.
Para ISO, utilize:
"type": "ISO",
"sha256Checksum": "string",
"sourceURI": "string"
Para PlatformImage, utilize:
"type": "PlatformImage",
"offer": "string",
"publisher": "string",
"sku": "string",
"version": "string"
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.VirtualMachineImages/imageTemplates" |
| apiVersion | A versão da API de recursos | '2018-02-01-preview' |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | Localização do recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| propriedades | ImageTemplateProperties |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| personalizar | Especifica as propriedades utilizadas para descrever os passos de personalização da imagem, como a Origem da imagem, etc. | ImageTemplateCustomizer[] |
| distribuir | Os destinos de distribuição para onde a saída da imagem tem de ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades utilizadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome Amigável para fornecer contexto sobre o que faz este passo de personalização | string |
| tipo | Definir o tipo de objeto | shell (obrigatório) |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "shell" pode ser shellCustomizer | "shell" (obrigatório) |
| script | O script da shell a ser executado para personalização. Pode ser uma ligação do github, URI de SAS para o Armazenamento do Azure, etc. | string |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Etiquetas que serão aplicadas ao artefacto depois de serem criadas/atualizadas pelo distribuidor. | objeto |
| runOutputName | O nome a utilizar para o RunOutput associado. | cadeia (obrigatório) |
| tipo | Definir o tipo de objeto | managedImage sharedImage (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "managedImage" (obrigatório) |
| imageId | ID do Recurso da Imagem de Disco Gerido | cadeia (obrigatório) |
| localização | A localização do Azure para a imagem deve corresponder se a imagem já existir | cadeia (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "sharedImage" (obrigatório) |
| galleryImageId | ID de recurso da imagem de Shared Image Gallery | cadeia (obrigatório) |
| replicationRegions | string[] (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ISO PlatformImage (obrigatório) |
ImageTemplateIsoSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ISO" (obrigatório) |
| sha256Checksum | SHA256 Soma de Verificação da imagem ISO. | cadeia (obrigatório) |
| sourceURI | URL para obter a imagem ISO. Este URL tem de estar acessível ao fornecedor de recursos no momento da criação do imageTemplate. | cadeia (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "PlatformImage" (obrigatório) |
| oferta | Oferta de imagem a partir das Imagens da Galeria do Azure. | string |
| publicador | Image Publisher in Azure Gallery Images (Imagens da Galeria do Azure). | string |
| sku | SKU da imagem a partir das Imagens da Galeria do Azure. | string |
| versão | Versão da imagem das Imagens da Galeria do Azure. | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Azure Image Builder com a Linha de Base do Windows do Azure |
Cria um ambiente do Azure Image Builder e cria uma imagem do Windows Server com as Atualizações do Windows mais recentes e a Linha de Base do Windows do Azure aplicadas. |
| Configurar o serviço Dev Box |
Este modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box. Pode ver todos os recursos criados ou aceder diretamente a DevPortal.microsoft.com para criar o seu primeiro Dev Box. |
Definição de recurso do Terraform (fornecedor AzAPI)
O tipo de recurso imageTemplates pode ser implementado em:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte Terraform ao seu modelo.
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
}
}
})
}
ImageTemplateCustomizer objects (Objetos ImageTemplateCustomizer)
Defina a propriedade tipo para especificar o tipo de objeto.
Para shell, utilize:
type = "shell"
script = "string"
Objetos ImageTemplateDistributor
Defina a propriedade tipo para especificar o tipo de objeto.
Para managedImage, utilize:
type = "managedImage"
imageId = "string"
location = "string"
Para sharedImage, utilize:
type = "sharedImage"
galleryImageId = "string"
replicationRegions = [
"string"
]
Objetos ImageTemplateSource
Defina a propriedade tipo para especificar o tipo de objeto.
Para ISO, utilize:
type = "ISO"
sha256Checksum = "string"
sourceURI = "string"
Para PlatformImage, utilize:
type = "PlatformImage"
offer = "string"
publisher = "string"
sku = "string"
version = "string"
Valores de propriedade
imageTemplates
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview" |
| name | O nome do recurso | cadeia (obrigatório) |
| localização | Localização do recurso | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos | Dicionário de nomes e valores de etiquetas. |
| propriedades | ImageTemplateProperties |
ImageTemplateProperties
| Nome | Descrição | Valor |
|---|---|---|
| personalizar | Especifica as propriedades utilizadas para descrever os passos de personalização da imagem, como a Origem da imagem, etc. | ImageTemplateCustomizer[] |
| distribuir | Os destinos de distribuição para onde a saída da imagem tem de ir. | ImageTemplateDistributor[] (obrigatório) |
| source | Especifica as propriedades utilizadas para descrever a imagem de origem. | ImageTemplateSource (obrigatório) |
ImageTemplateCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| name | Nome Amigável para fornecer contexto sobre o que faz este passo de personalização | string |
| tipo | Definir o tipo de objeto | shell (obrigatório) |
ImageTemplateShellCustomizer
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de ferramenta de personalização que pretende utilizar na Imagem. Por exemplo, "shell" pode ser shellCustomizer | "shell" (obrigatório) |
| script | O script da shell a ser executado para personalização. Pode ser uma ligação do github, um URI de SAS para o Armazenamento do Azure, etc. | string |
ImageTemplateDistributor
| Nome | Descrição | Valor |
|---|---|---|
| artifactTags | Etiquetas que serão aplicadas ao artefacto depois de serem criadas/atualizadas pelo distribuidor. | objeto |
| runOutputName | O nome a utilizar para o RunOutput associado. | cadeia (obrigatório) |
| tipo | Definir o tipo de objeto | managedImage sharedImage (obrigatório) |
ImageTemplateManagedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "managedImage" (obrigatório) |
| imageId | ID do Recurso da Imagem do Disco Gerido | cadeia (obrigatório) |
| localização | A localização do Azure para a imagem deve corresponder se a imagem já existir | cadeia (obrigatório) |
ImageTemplateSharedImageDistributor
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de distribuição. | "sharedImage" (obrigatório) |
| galleryImageId | ID do recurso da imagem de Shared Image Gallery | cadeia (obrigatório) |
| replicationRegions | string[] (obrigatório) |
ImageTemplateSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Definir o tipo de objeto | ISO PlatformImage (obrigatório) |
ImageTemplateIsoSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "ISO" (obrigatório) |
| sha256Checksum | SHA256 Soma de verificação da imagem ISO. | cadeia (obrigatório) |
| sourceURI | URL para obter a imagem ISO. Este URL tem de estar acessível ao fornecedor de recursos no momento da criação do imageTemplate. | cadeia (obrigatório) |
ImageTemplatePlatformImageSource
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Especifica o tipo de imagem de origem com que pretende começar. | "PlatformImage" (obrigatório) |
| oferta | Oferta de imagem a partir das Imagens da Galeria do Azure. | string |
| publicador | Image Publisher in Azure Gallery Images (Imagens da Galeria do Azure). | string |
| sku | SKU de imagem das Imagens da Galeria do Azure. | string |
| versão | Versão da imagem das Imagens da Galeria do Azure. | string |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários