Partilhar via


Microsoft.VirtualMachineImages imageTemplates 2018-02-01-preview

Definição de recursos do bíceps

O tipo de recurso imageTemplates pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.VirtualMachineImages/imageTemplates, adicione o seguinte Bíceps ao seu modelo.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {
          {customized property}: 'string'
        }
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos ImageTemplateDistributor

Defina a propriedade type para especificar o tipo de objeto.

Para managedImage, use:

{
  imageId: 'string'
  location: 'string'
  type: 'managedImage'
}

Para sharedImage, use:

{
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  type: 'sharedImage'
}

Objetos ImageTemplateCustomizer

Defina a propriedade type para especificar o tipo de objeto.

Para shell , use:

{
  script: 'string'
  type: 'shell'
}

Objetos ImageTemplateSource

Defina a propriedade type para especificar o tipo de objeto.

Para ISO, use:

{
  sha256Checksum: 'string'
  sourceURI: 'string'
  type: 'ISO'
}

Para PlatformImage , use:

{
  offer: 'string'
  publisher: 'string'
  sku: 'string'
  type: 'PlatformImage'
  version: 'string'
}

Valores de propriedade

ImageTemplateCustomizer

Designação Descrição Valor
Designação Nome amigável para fornecer contexto sobre o que esta etapa de personalização faz string
tipo Defina como 'shell' para o tipo ImageTemplateShellCustomizer. 'shell' (obrigatório)

ImageTemplateDistribuidor

Designação Descrição Valor
artifactTags Tags que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. string

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
tipo Defina como 'managedImage' para o tipo ImageTemplateManagedImageDistributor. Defina como 'sharedImage' para o tipo ImageTemplateSharedImageDistributor. 'managedImage'
'sharedImage' (obrigatório)

ImageTemplateDistributorArtifactTags

Designação Descrição Valor

ImageTemplateIsoSource

Designação Descrição Valor
sha256Soma de verificação SHA256 Soma de verificação da imagem ISO. string (obrigatório)
sourceURI URL para obter a imagem ISO. Essa URL deve estar acessível ao provedor de recursos no momento da criação do imageTemplate. string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. «ISO» (obrigatório)

ImageTemplateManagedImageDistributor

Designação Descrição Valor
imageId ID do recurso da imagem de disco gerenciado string (obrigatório)
Localização O local do Azure para a imagem, deve corresponder se a imagem já existir string (obrigatório)
tipo Tipo de distribuição. 'managedImage' (obrigatório)

ImageTemplatePlatformImageSource

Designação Descrição Valor
oferta Oferta de imagem do Azure Gallery Images. string
editora Image Publisher no Azure Gallery Images. string
SKU Documento de imagem do Azure Gallery Images. string
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'PlatformImage' (obrigatório)
Versão Versão da imagem do Azure Gallery Images. string

ImageTemplateProperties

Designação Descrição Valor
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte da imagem, etc ImageTemplateCustomizer[]
distribuir A distribuição destina-se para onde a saída de imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)

ImageTemplateSharedImageDistributor

Designação Descrição Valor
galeriaImageId ID do recurso da imagem da Galeria de Imagens Partilhadas string (obrigatório)
replicaçãoRegiões string[] (obrigatório)
tipo Tipo de distribuição. 'sharedImage' (obrigatório)

ImageTemplateShellCustomizer

Designação Descrição Valor
guião O shell script a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc string
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "shell" pode ser shellCustomizer 'shell' (obrigatório)

ImageTemplateSource

Designação Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. «ISO»
'PlatformImage' (obrigatório)

Microsoft.VirtualMachineImages/imageTemplates

Designação Descrição Valor
Localização Localização do recurso string (obrigatório)
Designação O nome do recurso string

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
propriedades ImageTemplateProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Tags de Recursos

Designação Descrição Valor

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Construtor de Imagens do Azure com de 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 mais recentes do Windows e a linha de base do Windows do Azure aplicadas.
Configurar o serviço Caixa de Desenvolvimento Este modelo criaria todos os recursos de administração da Caixa de Desenvolvimento de acordo com o guia de início rápido da Caixa de Desenvolvimento (/azure/dev-box/quickstart-create-dev-box). Você pode visualizar todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.

Definição de recurso de modelo ARM

O tipo de recurso imageTemplates pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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",
  "properties": {
    "customize": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateCustomizer objects
    } ],
    "distribute": [ {
      "artifactTags": {
        "{customized property}": "string"
      },
      "runOutputName": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateDistributor objects
    } ],
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos ImageTemplateDistributor

Defina a propriedade type para especificar o tipo de objeto.

Para managedImage, use:

{
  "imageId": "string",
  "location": "string",
  "type": "managedImage"
}

Para sharedImage, use:

{
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "type": "sharedImage"
}

Objetos ImageTemplateCustomizer

Defina a propriedade type para especificar o tipo de objeto.

Para shell , use:

{
  "script": "string",
  "type": "shell"
}

Objetos ImageTemplateSource

Defina a propriedade type para especificar o tipo de objeto.

Para ISO, use:

{
  "sha256Checksum": "string",
  "sourceURI": "string",
  "type": "ISO"
}

Para PlatformImage , use:

{
  "offer": "string",
  "publisher": "string",
  "sku": "string",
  "type": "PlatformImage",
  "version": "string"
}

Valores de propriedade

ImageTemplateCustomizer

Designação Descrição Valor
Designação Nome amigável para fornecer contexto sobre o que esta etapa de personalização faz string
tipo Defina como 'shell' para o tipo ImageTemplateShellCustomizer. 'shell' (obrigatório)

ImageTemplateDistribuidor

Designação Descrição Valor
artifactTags Tags que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. string

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
tipo Defina como 'managedImage' para o tipo ImageTemplateManagedImageDistributor. Defina como 'sharedImage' para o tipo ImageTemplateSharedImageDistributor. 'managedImage'
'sharedImage' (obrigatório)

ImageTemplateDistributorArtifactTags

Designação Descrição Valor

ImageTemplateIsoSource

Designação Descrição Valor
sha256Soma de verificação SHA256 Soma de verificação da imagem ISO. string (obrigatório)
sourceURI URL para obter a imagem ISO. Essa URL deve estar acessível ao provedor de recursos no momento da criação do imageTemplate. string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. «ISO» (obrigatório)

ImageTemplateManagedImageDistributor

Designação Descrição Valor
imageId ID do recurso da imagem de disco gerenciado string (obrigatório)
Localização O local do Azure para a imagem, deve corresponder se a imagem já existir string (obrigatório)
tipo Tipo de distribuição. 'managedImage' (obrigatório)

ImageTemplatePlatformImageSource

Designação Descrição Valor
oferta Oferta de imagem do Azure Gallery Images. string
editora Image Publisher no Azure Gallery Images. string
SKU Documento de imagem do Azure Gallery Images. string
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'PlatformImage' (obrigatório)
Versão Versão da imagem do Azure Gallery Images. string

ImageTemplateProperties

Designação Descrição Valor
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte da imagem, etc ImageTemplateCustomizer[]
distribuir A distribuição destina-se para onde a saída de imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)

ImageTemplateSharedImageDistributor

Designação Descrição Valor
galeriaImageId ID do recurso da imagem da Galeria de Imagens Partilhadas string (obrigatório)
replicaçãoRegiões string[] (obrigatório)
tipo Tipo de distribuição. 'sharedImage' (obrigatório)

ImageTemplateShellCustomizer

Designação Descrição Valor
guião O shell script a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc string
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "shell" pode ser shellCustomizer 'shell' (obrigatório)

ImageTemplateSource

Designação Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. «ISO»
'PlatformImage' (obrigatório)

Microsoft.VirtualMachineImages/imageTemplates

Designação Descrição Valor
apiVersion A versão api '2018-02-01-pré-visualização'
Localização Localização do recurso string (obrigatório)
Designação O nome do recurso string

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
propriedades ImageTemplateProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.VirtualMachineImages/imageTemplates'

Tags de Recursos

Designação Descrição Valor

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Construtor de Imagens do Azure com de Linha de Base do Windows do Azure

Implantar no Azure
Cria um ambiente do Azure Image Builder e cria uma imagem do Windows Server com as atualizações mais recentes do Windows e a linha de base do Windows do Azure aplicadas.
Configurar o serviço Caixa de Desenvolvimento

Implantar no Azure
Este modelo criaria todos os recursos de administração da Caixa de Desenvolvimento de acordo com o guia de início rápido da Caixa de Desenvolvimento (/azure/dev-box/quickstart-create-dev-box). Você pode visualizar todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso imageTemplates pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {
            {customized property} = "string"
          }
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
    }
  })
}

Objetos ImageTemplateDistributor

Defina a propriedade type para especificar o tipo de objeto.

Para managedImage, use:

{
  imageId = "string"
  location = "string"
  type = "managedImage"
}

Para sharedImage, use:

{
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  type = "sharedImage"
}

Objetos ImageTemplateCustomizer

Defina a propriedade type para especificar o tipo de objeto.

Para shell , use:

{
  script = "string"
  type = "shell"
}

Objetos ImageTemplateSource

Defina a propriedade type para especificar o tipo de objeto.

Para ISO, use:

{
  sha256Checksum = "string"
  sourceURI = "string"
  type = "ISO"
}

Para PlatformImage , use:

{
  offer = "string"
  publisher = "string"
  sku = "string"
  type = "PlatformImage"
  version = "string"
}

Valores de propriedade

ImageTemplateCustomizer

Designação Descrição Valor
Designação Nome amigável para fornecer contexto sobre o que esta etapa de personalização faz string
tipo Defina como 'shell' para o tipo ImageTemplateShellCustomizer. 'shell' (obrigatório)

ImageTemplateDistribuidor

Designação Descrição Valor
artifactTags Tags que serão aplicadas ao artefato depois que ele for criado/atualizado pelo distribuidor. ImageTemplateDistributorArtifactTags
runOutputName O nome a ser usado para o RunOutput associado. string

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
tipo Defina como 'managedImage' para o tipo ImageTemplateManagedImageDistributor. Defina como 'sharedImage' para o tipo ImageTemplateSharedImageDistributor. 'managedImage'
'sharedImage' (obrigatório)

ImageTemplateDistributorArtifactTags

Designação Descrição Valor

ImageTemplateIsoSource

Designação Descrição Valor
sha256Soma de verificação SHA256 Soma de verificação da imagem ISO. string (obrigatório)
sourceURI URL para obter a imagem ISO. Essa URL deve estar acessível ao provedor de recursos no momento da criação do imageTemplate. string (obrigatório)
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. «ISO» (obrigatório)

ImageTemplateManagedImageDistributor

Designação Descrição Valor
imageId ID do recurso da imagem de disco gerenciado string (obrigatório)
Localização O local do Azure para a imagem, deve corresponder se a imagem já existir string (obrigatório)
tipo Tipo de distribuição. 'managedImage' (obrigatório)

ImageTemplatePlatformImageSource

Designação Descrição Valor
oferta Oferta de imagem do Azure Gallery Images. string
editora Image Publisher no Azure Gallery Images. string
SKU Documento de imagem do Azure Gallery Images. string
tipo Especifica o tipo de imagem de origem com a qual você deseja começar. 'PlatformImage' (obrigatório)
Versão Versão da imagem do Azure Gallery Images. string

ImageTemplateProperties

Designação Descrição Valor
Personalizar Especifica as propriedades usadas para descrever as etapas de personalização da imagem, como Fonte da imagem, etc ImageTemplateCustomizer[]
distribuir A distribuição destina-se para onde a saída de imagem precisa ir. ImageTemplateDistributor[] (obrigatório)
fonte Especifica as propriedades usadas para descrever a imagem de origem. ImageTemplateSource (obrigatório)

ImageTemplateSharedImageDistributor

Designação Descrição Valor
galeriaImageId ID do recurso da imagem da Galeria de Imagens Partilhadas string (obrigatório)
replicaçãoRegiões string[] (obrigatório)
tipo Tipo de distribuição. 'sharedImage' (obrigatório)

ImageTemplateShellCustomizer

Designação Descrição Valor
guião O shell script a ser executado para personalização. Pode ser um link github, URI SAS para Armazenamento do Azure, etc string
tipo O tipo de ferramenta de personalização que você deseja usar na Imagem. Por exemplo, "shell" pode ser shellCustomizer 'shell' (obrigatório)

ImageTemplateSource

Designação Descrição Valor
tipo Defina como 'ISO' para o tipo ImageTemplateIsoSource. Defina como 'PlatformImage' para o tipo ImageTemplatePlatformImageSource. «ISO»
'PlatformImage' (obrigatório)

Microsoft.VirtualMachineImages/imageTemplates

Designação Descrição Valor
Localização Localização do recurso string (obrigatório)
Designação O nome do recurso string

Restrições:
Padrão = ^[A-Za-z0-9-_]{1,64}$ (obrigatório)
propriedades ImageTemplateProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"

Tags de Recursos

Designação Descrição Valor