Compartilhar via

Galerias/imagens microsoft.compute 2021-10-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso galerias/imagens pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.Compute/galleries/images, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.Compute/galleries/images@2021-10-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    architecture: 'string'
    description: 'string'
    disallowed: {
      diskTypes: [
        'string'
      ]
    }
    endOfLifeDate: 'string'
    eula: 'string'
    features: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    hyperVGeneration: 'string'
    identifier: {
      offer: 'string'
      publisher: 'string'
      sku: 'string'
    }
    osState: 'string'
    osType: 'string'
    privacyStatementUri: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      publisher: 'string'
    }
    recommended: {
      memory: {
        max: int
        min: int
      }
      vCPUs: {
        max: int
        min: int
      }
    }
    releaseNoteUri: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Desaprovados

Nome Descrição Valor
diskTypes Uma lista de tipos de disco. string[]

GalleryImageFeature

Nome Descrição Valor
nome O nome do recurso de imagem da galeria. corda
valor O valor do recurso de imagem da galeria. corda

GalleryImageIdentifier

Nome Descrição Valor
oferecer O nome da oferta de definição de imagem da galeria. cadeia de caracteres (obrigatório)
editor O nome do editor de definição de imagem da galeria. cadeia de caracteres (obrigatório)
Sku O nome da SKU de definição de imagem da galeria. cadeia de caracteres (obrigatório)

GalleryImageProperties

Nome Descrição Valor
arquitetura A arquitetura da imagem. Aplicável somente a discos do sistema operacional. 'Arm64'
'x64'
descrição A descrição deste recurso de definição de imagem da galeria. Essa propriedade é atualizável. corda
Desaprovados Descreve os tipos de disco não permitidos. não permitido
endOfLifeDate A data de término da vida útil da definição de imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. corda
Eula O contrato Eula para a definição de imagem da galeria. corda
Características Uma lista de recursos de imagem da galeria. GalleryImageFeature[]
hyperVGeneration A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional. 'V1'
'V2'
identificador Esse é o identificador de definição de imagem da galeria. galleryImageIdentifier (obrigatório)
osState Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob essa imagem são "Generalizadas" ou "Especializadas". 'Generalizado'
'Especializado' (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco ao criar uma VM a partir de uma imagem gerenciada.

Os valores possíveis são:

Windows

do Linux		 'Linux'
'Windows' (obrigatório)
privacyStatementUri O uri da política de privacidade. corda
purchasePlan Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens do marketplace. ImagePurchasePlan
Recomendado As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis. RecommendedMachineConfiguration
releaseNoteUri O uri da nota de versão. corda

ImagePurchasePlan

Nome Descrição Valor
nome A ID do plano. corda
produto A ID do produto. corda
editor A ID do editor. corda

Microsoft.Compute/galleries/images

Nome Descrição Valor
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para recurso do tipo: galerias
Propriedades Descreve as propriedades de uma definição de imagem da galeria. GalleryImageProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

RecommendedMachineConfiguration

Nome Descrição Valor
memória Descreve o intervalo de recursos. do ResourceRange
vCPUs Descreve o intervalo de recursos. do ResourceRange

ResourceRange

Nome Descrição Valor
Max O número máximo do recurso. int
Min O número mínimo do recurso. int

ResourceTags

Nome Descrição Valor

Exemplos de uso

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Construtor de Imagens do Azure com o de Linha de Base do Windows do Azure Cria um ambiente do Construtor de Imagens do Azure 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 de serviço do Dev Box Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box (/azure/dev-box/quickstart-create-dev-box). Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.

Definição de recurso de modelo do ARM

O tipo de recurso galerias/imagens pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.Compute/galleries/images, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Compute/galleries/images",
  "apiVersion": "2021-10-01",
  "name": "string",
  "location": "string",
  "properties": {
    "architecture": "string",
    "description": "string",
    "disallowed": {
      "diskTypes": [ "string" ]
    },
    "endOfLifeDate": "string",
    "eula": "string",
    "features": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "hyperVGeneration": "string",
    "identifier": {
      "offer": "string",
      "publisher": "string",
      "sku": "string"
    },
    "osState": "string",
    "osType": "string",
    "privacyStatementUri": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "publisher": "string"
    },
    "recommended": {
      "memory": {
        "max": "int",
        "min": "int"
      },
      "vCPUs": {
        "max": "int",
        "min": "int"
      }
    },
    "releaseNoteUri": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Desaprovados

Nome Descrição Valor
diskTypes Uma lista de tipos de disco. string[]

GalleryImageFeature

Nome Descrição Valor
nome O nome do recurso de imagem da galeria. corda
valor O valor do recurso de imagem da galeria. corda

GalleryImageIdentifier

Nome Descrição Valor
oferecer O nome da oferta de definição de imagem da galeria. cadeia de caracteres (obrigatório)
editor O nome do editor de definição de imagem da galeria. cadeia de caracteres (obrigatório)
Sku O nome da SKU de definição de imagem da galeria. cadeia de caracteres (obrigatório)

GalleryImageProperties

Nome Descrição Valor
arquitetura A arquitetura da imagem. Aplicável somente a discos do sistema operacional. 'Arm64'
'x64'
descrição A descrição deste recurso de definição de imagem da galeria. Essa propriedade é atualizável. corda
Desaprovados Descreve os tipos de disco não permitidos. não permitido
endOfLifeDate A data de término da vida útil da definição de imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. corda
Eula O contrato Eula para a definição de imagem da galeria. corda
Características Uma lista de recursos de imagem da galeria. GalleryImageFeature[]
hyperVGeneration A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional. 'V1'
'V2'
identificador Esse é o identificador de definição de imagem da galeria. galleryImageIdentifier (obrigatório)
osState Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob essa imagem são "Generalizadas" ou "Especializadas". 'Generalizado'
'Especializado' (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco ao criar uma VM a partir de uma imagem gerenciada.

Os valores possíveis são:

Windows

do Linux		 'Linux'
'Windows' (obrigatório)
privacyStatementUri O uri da política de privacidade. corda
purchasePlan Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens do marketplace. ImagePurchasePlan
Recomendado As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis. RecommendedMachineConfiguration
releaseNoteUri O uri da nota de versão. corda

ImagePurchasePlan

Nome Descrição Valor
nome A ID do plano. corda
produto A ID do produto. corda
editor A ID do editor. corda

Microsoft.Compute/galleries/images

Nome Descrição Valor
apiVersion A versão da API '2021-10-01'
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Descreve as propriedades de uma definição de imagem da galeria. GalleryImageProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Compute/galleries/images'

RecommendedMachineConfiguration

Nome Descrição Valor
memória Descreve o intervalo de recursos. do ResourceRange
vCPUs Descreve o intervalo de recursos. do ResourceRange

ResourceRange

Nome Descrição Valor
Max O número máximo do recurso. int
Min O número mínimo do recurso. int

ResourceTags

Nome Descrição Valor

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

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

Implantar no Azure 		Cria um ambiente do Construtor de Imagens do Azure 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 de serviço do Dev Box

Implantar no Azure 		Esse modelo criaria todos os recursos de administrador do Dev Box de acordo com o guia de início rápido do Dev Box (/azure/dev-box/quickstart-create-dev-box). Você pode exibir todos os recursos criados ou ir diretamente para DevPortal.microsoft.com para criar sua primeira Caixa de Desenvolvimento.
criar uma definição de imagem em um da Galeria de Computação do Azure

Implantar no Azure 		Esse modelo permite que você crie uma definição de imagem simples em uma Galeria de Computação do Azure. Verifique se você executou o Modelo da Galeria de Imagens Compartilhadas 101 antes de implantá-lo.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso galerias/imagens pode ser implantado com operações direcionadas:

  • grupos de recursos

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

Formato de recurso

Para criar um recurso Microsoft.Compute/galleries/images, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images@2021-10-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      architecture = "string"
      description = "string"
      disallowed = {
        diskTypes = [
          "string"
        ]
      }
      endOfLifeDate = "string"
      eula = "string"
      features = [
        {
          name = "string"
          value = "string"
        }
      ]
      hyperVGeneration = "string"
      identifier = {
        offer = "string"
        publisher = "string"
        sku = "string"
      }
      osState = "string"
      osType = "string"
      privacyStatementUri = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        publisher = "string"
      }
      recommended = {
        memory = {
          max = int
          min = int
        }
        vCPUs = {
          max = int
          min = int
        }
      }
      releaseNoteUri = "string"
    }
  })
}

Valores de propriedade

Desaprovados

Nome Descrição Valor
diskTypes Uma lista de tipos de disco. string[]

GalleryImageFeature

Nome Descrição Valor
nome O nome do recurso de imagem da galeria. corda
valor O valor do recurso de imagem da galeria. corda

GalleryImageIdentifier

Nome Descrição Valor
oferecer O nome da oferta de definição de imagem da galeria. cadeia de caracteres (obrigatório)
editor O nome do editor de definição de imagem da galeria. cadeia de caracteres (obrigatório)
Sku O nome da SKU de definição de imagem da galeria. cadeia de caracteres (obrigatório)

GalleryImageProperties

Nome Descrição Valor
arquitetura A arquitetura da imagem. Aplicável somente a discos do sistema operacional. 'Arm64'
'x64'
descrição A descrição deste recurso de definição de imagem da galeria. Essa propriedade é atualizável. corda
Desaprovados Descreve os tipos de disco não permitidos. não permitido
endOfLifeDate A data de término da vida útil da definição de imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. corda
Eula O contrato Eula para a definição de imagem da galeria. corda
Características Uma lista de recursos de imagem da galeria. GalleryImageFeature[]
hyperVGeneration A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional. 'V1'
'V2'
identificador Esse é o identificador de definição de imagem da galeria. galleryImageIdentifier (obrigatório)
osState Essa propriedade permite que o usuário especifique se as máquinas virtuais criadas sob essa imagem são "Generalizadas" ou "Especializadas". 'Generalizado'
'Especializado' (obrigatório)
osType Essa propriedade permite que você especifique o tipo do sistema operacional incluído no disco ao criar uma VM a partir de uma imagem gerenciada.

Os valores possíveis são:

Windows

do Linux		 'Linux'
'Windows' (obrigatório)
privacyStatementUri O uri da política de privacidade. corda
purchasePlan Descreve o plano de compra de definição de imagem da galeria. Isso é usado por imagens do marketplace. ImagePurchasePlan
Recomendado As propriedades descrevem a configuração de computador recomendada para essa Definição de Imagem. Essas propriedades são atualizáveis. RecommendedMachineConfiguration
releaseNoteUri O uri da nota de versão. corda

ImagePurchasePlan

Nome Descrição Valor
nome A ID do plano. corda
produto A ID do produto. corda
editor A ID do editor. corda

Microsoft.Compute/galleries/images

Nome Descrição Valor
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: galerias
Propriedades Descreve as propriedades de uma definição de imagem da galeria. GalleryImageProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Compute/galleries/images@2021-10-01"

RecommendedMachineConfiguration

Nome Descrição Valor
memória Descreve o intervalo de recursos. do ResourceRange
vCPUs Descreve o intervalo de recursos. do ResourceRange

ResourceRange

Nome Descrição Valor
Max O número máximo do recurso. int
Min O número mínimo do recurso. int

ResourceTags

Nome Descrição Valor