Galerias/imagens Microsoft.Compute 2022-08-03
Definição de recurso do Bicep
O tipo de recurso galerias/imagens pode ser implementado com operações que visam:
- 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.Compute/galleries/images, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.Compute/galleries/images@2022-08-03' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
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
galerias/imagens
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados no Bicep. |
cadeia (obrigatório) Limite de carateres: 1-80 Carateres válidos: Alfanuméricos, carateres de sublinhado, hífenes e períodos. Comece e termine com alfanumérico. |
| 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 |
| principal | No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal. Para obter mais informações, veja Recurso subordinado fora do recurso principal. |
Nome simbólico para recurso do tipo: galerias |
| propriedades | Descreve as propriedades de uma definição de imagem de galeria. | GalleryImageProperties |
GalleryImageProperties
| Nome | Descrição | Valor |
|---|---|---|
| arquitetura | A arquitetura da imagem. Aplicável apenas aos discos do SO. | 'Arm64' 'x64' |
| descrição | A descrição deste recurso de definição de imagem da galeria. Esta propriedade é atualizável. | string |
| não permitido | Descreve os tipos de disco não permitidos. | Não permitido |
| endOfLifeDate | A data de fim de vida da definição da imagem da galeria. Esta propriedade pode ser utilizada para fins de desativação. Esta propriedade é atualizável. | string |
| eula | O contrato Eula para a definição de imagem da galeria. | string |
| funcionalidades | Uma lista de funcionalidades da imagem da galeria. | GalleryImageFeature[] |
| hyperVGeneration | A geração do hipervisor da Máquina Virtual. Aplicável apenas aos discos do SO. | 'V1' 'V2' |
| identificador | Este é o identificador de definição de imagem da galeria. | GalleryImageIdentifier (obrigatório) |
| osState | Esta propriedade permite ao utilizador especificar se as máquinas virtuais criadas nesta imagem são "Generalizadas" ou "Especializadas". | "Generalizado" "Especializado" (obrigatório) |
| osType | Esta propriedade permite-lhe especificar o tipo de SO incluído no disco ao criar uma VM a partir de uma imagem gerida. Os valores possíveis são: Windows,Linux. | 'Linux' "Windows" (obrigatório) |
| privacyStatementUri | O uri da declaração de privacidade. | string |
| purchasePlan | Descreve o plano de compra da definição de imagem da galeria. Isto é utilizado por imagens do marketplace. | ImagePurchasePlan |
| recomendado | As propriedades descrevem a configuração recomendada do computador para esta Definição de Imagem. Estas propriedades são atualizáveis. | RecommendedMachineConfiguration |
| releaseNoteUri | O uri da nota de versão. | string |
Não permitido
| Nome | Descrição | Valor |
|---|---|---|
| diskTypes | Uma lista de tipos de disco. | cadeia[] |
GalleryImageFeature
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da funcionalidade de imagem da galeria. | string |
| valor | O valor da funcionalidade de imagem da galeria. | string |
GalleryImageIdentifier
| Nome | Descrição | Valor |
|---|---|---|
| oferta | O nome da oferta de definição de imagem da galeria. | cadeia (obrigatório) |
| publicador | O nome do editor de definições de imagem da galeria. | cadeia (obrigatório) |
| sku | O nome do SKU de definição de imagem da galeria. | cadeia (obrigatório) |
ImagePurchasePlan
| Nome | Descrição | Valor |
|---|---|---|
| name | O ID do plano. | string |
| produto | O ID do produto. | string |
| publicador | O ID do editor. | string |
RecommendedMachineConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| Memória | Descreve o intervalo de recursos. | ResourceRange |
| vCPUs | Descreve o intervalo de recursos. | ResourceRange |
ResourceRange
| Nome | Descrição | Valor |
|---|---|---|
| max | O número máximo do recurso. | int |
| min | O número mínimo do recurso. | int |
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. |
| Criar uma Definição de Imagem numa Galeria de Computação do Azure |
Este modelo permite-lhe criar uma Definição de Imagem simples numa Galeria de Computação do Azure. Certifique-se de que executou o modelo Shared Image Gallery 101 antes de o implementar. |
| 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 de modelo do ARM
O tipo de recurso galerias/imagens pode ser implementado com operações que visam:
- 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.Compute/galleries/images, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.Compute/galleries/images",
"apiVersion": "2022-08-03",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"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
galerias/imagens
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Compute/galleries/images" |
| apiVersion | A versão da API de recursos | '2022-08-03' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON. |
cadeia (obrigatório) Limite de carateres: 1-80 Carateres válidos: Alfanuméricos, carateres de sublinhado, hífenes e períodos. Comece e termine com alfanumérico. |
| 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 | Descreve as propriedades de uma definição de imagem de galeria. | GalleryImageProperties |
GalleryImageProperties
| Nome | Descrição | Valor |
|---|---|---|
| arquitetura | A arquitetura da imagem. Aplicável apenas aos discos do SO. | 'Arm64' 'x64' |
| descrição | A descrição deste recurso de definição de imagem da galeria. Esta propriedade é atualizável. | string |
| não permitido | Descreve os tipos de disco não permitidos. | Não permitido |
| endOfLifeDate | A data de fim de vida da definição da imagem da galeria. Esta propriedade pode ser utilizada para fins de desativação. Esta propriedade é atualizável. | string |
| eula | O contrato Eula para a definição de imagem da galeria. | string |
| funcionalidades | Uma lista de funcionalidades da imagem da galeria. | GalleryImageFeature[] |
| hyperVGeneration | A geração do hipervisor da Máquina Virtual. Aplicável apenas aos discos do SO. | 'V1' 'V2' |
| identificador | Este é o identificador de definição de imagem da galeria. | GalleryImageIdentifier (obrigatório) |
| osState | Esta propriedade permite ao utilizador especificar se as máquinas virtuais criadas nesta imagem são "Generalizadas" ou "Especializadas". | "Generalizado" "Especializado" (obrigatório) |
| osType | Esta propriedade permite-lhe especificar o tipo de SO incluído no disco ao criar uma VM a partir de uma imagem gerida. Os valores possíveis são: Windows,Linux. | 'Linux' "Windows" (obrigatório) |
| privacyStatementUri | O uri da declaração de privacidade. | string |
| purchasePlan | Descreve o plano de compra da definição de imagem da galeria. Isto é utilizado por imagens do marketplace. | ImagePurchasePlan |
| recomendado | As propriedades descrevem a configuração recomendada do computador para esta Definição de Imagem. Estas propriedades são atualizáveis. | RecommendedMachineConfiguration |
| releaseNoteUri | O uri da nota de versão. | string |
Não permitido
| Nome | Descrição | Valor |
|---|---|---|
| diskTypes | Uma lista de tipos de disco. | cadeia[] |
GalleryImageFeature
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da funcionalidade de imagem da galeria. | string |
| valor | O valor da funcionalidade de imagem da galeria. | string |
GalleryImageIdentifier
| Nome | Descrição | Valor |
|---|---|---|
| oferta | O nome da oferta de definição de imagem da galeria. | cadeia (obrigatório) |
| publicador | O nome do editor de definições de imagem da galeria. | cadeia (obrigatório) |
| sku | O nome do SKU de definição de imagem da galeria. | cadeia (obrigatório) |
ImagePurchasePlan
| Nome | Descrição | Valor |
|---|---|---|
| name | O ID do plano. | string |
| produto | O ID do produto. | string |
| publicador | O ID do editor. | string |
RecommendedMachineConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| Memória | Descreve o intervalo de recursos. | ResourceRange |
| vCPUs | Descreve o intervalo de recursos. | ResourceRange |
ResourceRange
| Nome | Descrição | Valor |
|---|---|---|
| max | O número máximo do recurso. | int |
| min | O número mínimo do recurso. | int |
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. |
| Criar uma Definição de Imagem numa Galeria de Computação do Azure |
Este modelo permite-lhe criar uma Definição de Imagem simples numa Galeria de Computação do Azure. Certifique-se de que executou o modelo Shared Image Gallery 101 antes de o implementar. |
| 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 galerias/imagens pode ser implementado com operações que visam:
- 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.Compute/galleries/images, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/galleries/images@2022-08-03"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
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
galerias/imagens
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Compute/galleries/images@2022-08-03" |
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 1-80 Carateres válidos: Alfanuméricos, carateres de sublinhado, hífenes e períodos. Comece e termine com alfanumérico. |
| localização | Localização do recurso | cadeia (obrigatório) |
| parent_id | O ID do recurso que é o principal para este recurso. | ID para recurso do tipo: galerias |
| etiquetas | Etiquetas de recursos | Dicionário de nomes e valores de etiquetas. |
| propriedades | Descreve as propriedades de uma definição de imagem de galeria. | GalleryImageProperties |
GalleryImageProperties
| Nome | Descrição | Valor |
|---|---|---|
| arquitetura | A arquitetura da imagem. Aplicável apenas aos discos do SO. | "Arm64" "x64" |
| descrição | A descrição deste recurso de definição de imagem da galeria. Esta propriedade é atualizável. | string |
| não permitido | Descreve os tipos de disco não permitidos. | Não permitido |
| endOfLifeDate | A data de fim de vida da definição da imagem da galeria. Esta propriedade pode ser utilizada para fins de desativação. Esta propriedade é atualizável. | string |
| eula | O contrato Eula para a definição de imagem da galeria. | string |
| funcionalidades | Uma lista de funcionalidades de imagens da galeria. | GalleryImageFeature[] |
| hyperVGeneration | A geração do hipervisor da Máquina Virtual. Aplicável apenas a discos do SO. | "V1" "V2" |
| identificador | Este é o identificador de definição de imagem da galeria. | GalleryImageIdentifier (obrigatório) |
| osState | Esta propriedade permite ao utilizador especificar se as máquinas virtuais criadas nesta imagem são "Generalizadas" ou "Especializadas". | "Generalizado" "Especializado" (obrigatório) |
| osType | Esta propriedade permite-lhe especificar o tipo de SO incluído no disco ao criar uma VM a partir de uma imagem gerida. Os valores possíveis são: Windows,Linux. | "Linux" "Windows" (obrigatório) |
| privacyStatementUri | O URI da declaração de privacidade. | string |
| purchasePlan | Descreve o plano de compra da definição de imagem da galeria. Isto é utilizado por imagens do marketplace. | ImagePurchasePlan |
| recomendado | As propriedades descrevem a configuração recomendada do computador para esta Definição de Imagem. Estas propriedades são atualizáveis. | RecommendedMachineConfiguration |
| releaseNoteUri | O URI da nota de versão. | string |
Não permitido
| Nome | Descrição | Valor |
|---|---|---|
| diskTypes | Uma lista de tipos de disco. | string[] |
GalleryImageFeature
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da funcionalidade de imagem da galeria. | string |
| valor | O valor da funcionalidade de imagem da galeria. | string |
GalleryImageIdentifier
| Nome | Descrição | Valor |
|---|---|---|
| oferta | O nome da oferta de definição de imagem da galeria. | cadeia (obrigatório) |
| publicador | O nome do publicador de definições de imagem da galeria. | cadeia (obrigatório) |
| sku | O nome do SKU de definição de imagem da galeria. | cadeia (obrigatório) |
ImagePurchasePlan
| Nome | Descrição | Valor |
|---|---|---|
| name | O ID do plano. | string |
| produto | O ID do produto. | string |
| publicador | O ID do editor. | string |
RecommendedMachineConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| Memória | Descreve o intervalo de recursos. | ResourceRange |
| vCPUs | Descreve o intervalo de recursos. | ResourceRange |
ResourceRange
| Nome | Descrição | Valor |
|---|---|---|
| max | O número máximo do recurso. | int |
| min | O número mínimo do recurso. | int |
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