Galerías de Microsoft.Compute/images 2021-10-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso gallerys/images se puede implementar con operaciones que tienen como destino:

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.Compute/galleries/images, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/galleries/images@2021-10-01' = {
  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 propiedad

galleries/images

Nombre Descripción Value
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.		 string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, guiones y puntos.

Comience y termine con un carácter alfanumérico.
ubicación Ubicación de los recursos string (obligatorio)
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
primario En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para más información, consulte Recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: galerías
properties Describe las propiedades de una definición de imagen de la galería. GalleryImageProperties

GalleryImageProperties

Nombre Descripción Valor
arquitectura La arquitectura de la imagen. Solo se aplica a los discos del sistema operativo. 'Arm64'
'x64'
description Descripción de este recurso de definición de imagen de la galería. Esta propiedad es actualizable. string
no permitido Describe los tipos de disco no permitidos. No permitido
endOfLifeDate Fecha de finalización del ciclo de vida de la definición de la imagen de la galería. Esta propiedad se puede usar con fines de retirada. Esta propiedad es actualizable. string
eula El acuerdo eula para la definición de la imagen de la galería. string
features Una lista de características de imagen de la galería. GalleryImageFeature[]
hyperVGeneration Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. 'V1'
'V2'
identificador Este es el identificador de definición de imagen de la galería. GalleryImageIdentifier (obligatorio)
osState Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas". "Generalizado"
'Specialized' (obligatorio)
osType Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada.

Los valores posibles son:

Windows

Linux		 "Linux"
'Windows' (obligatorio)
privacyStatementUri URI de la declaración de privacidad. string
purchasePlan Describe el plan de compra de la definición de imagen de la galería. Las imágenes de Marketplace lo usan. ImagePurchasePlan
recomendado Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables. RecommendedMachineConfiguration
releaseNoteUri URI de la nota de la versión. string

No permitida.

Nombre Descripción Valor
diskTypes Lista de tipos de disco. string[]

GalleryImageFeature

Nombre Descripción Value
name Nombre de la característica de imagen de la galería. string
value Valor de la característica de imagen de la galería. string

GalleryImageIdentifier

Nombre Descripción Valor
offer Nombre de la oferta de definición de imagen de la galería. string (obligatorio)
publisher Nombre del publicador de definiciones de imágenes de la galería. string (obligatorio)
sku Nombre de la SKU de definición de imagen de la galería. string (obligatorio)

ImagePurchasePlan

Nombre Descripción Value
name Identificador del plan. string
product Id. de producto. string
publisher Identificador del publicador. string

RecommendedMachineConfiguration

Nombre Descripción Valor
memoria Describe el intervalo de recursos. ResourceRange
vCPU Describe el intervalo de recursos. ResourceRange

ResourceRange

Nombre Descripción Valor
max Número máximo del recurso. int
min. Número mínimo del recurso. int

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

Implementación en 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 de base de Windows de Azure aplicada.
Creación de una definición de imagen en una instancia de Azure Compute Gallery

Implementación en Azure		 Esta plantilla le permite crear una definición de imagen sencilla en una galería de proceso de Azure. Asegúrese de que ha ejecutado la plantilla Shared Image Gallery 101 antes de implementarla.
Configuración del servicio Dev Box

Implementación en Azure		 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 gallerys/images se puede implementar con operaciones que tienen como destino:

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.Compute/galleries/images, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Compute/galleries/images",
  "apiVersion": "2021-10-01",
  "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 propiedad

galleries/images

Nombre Descripción Value
type Tipo de recurso "Microsoft.Compute/galleries/images"
apiVersion La versión de la API de recursos '2021-10-01'
name El nombre del recurso

Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON.		 string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, guiones y puntos.

Comience y termine con un carácter alfanumérico.
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 Describe las propiedades de una definición de imagen de galería. GalleryImageProperties

GalleryImageProperties

Nombre Descripción Valor
arquitectura Arquitectura de la imagen. Solo se aplica a los discos del sistema operativo. 'Arm64'
'x64'
description Descripción de este recurso de definición de imagen de la galería. Esta propiedad es actualizable. string
no permitido Describe los tipos de disco no permitidos. No permitido
endOfLifeDate Fecha de finalización del ciclo de vida de la definición de la imagen de la galería. Esta propiedad se puede usar con fines de retirada. Esta propiedad es actualizable. string
eula Contrato eula para la definición de imagen de la galería. string
features Lista de características de imagen de la galería. GalleryImageFeature[]
hyperVGeneration Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. 'V1'
'V2'
identificador Se trata del identificador de definición de imagen de la galería. GalleryImageIdentifier (obligatorio)
osState Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas". 'Generalizado'
'Specialized' (obligatorio)
osType Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada.

Los valores posibles son:

Windows

Linux		 'Linux'
'Windows' (obligatorio)
privacyStatementUri El URI de la declaración de privacidad. string
purchasePlan Describe el plan de compra de la definición de imagen de la galería. Esto lo usan las imágenes de Marketplace. ImagePurchasePlan
recomendado Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables. RecommendedMachineConfiguration
releaseNoteUri El URI de la nota de versión. string

No permitida.

Nombre Descripción Valor
diskTypes Lista de tipos de disco. string[]

GalleryImageFeature

Nombre Descripción Value
name Nombre de la característica de imagen de la galería. string
value Valor de la característica de imagen de la galería. string

GalleryImageIdentifier

Nombre Descripción Valor
offer Nombre de la oferta de definición de imagen de la galería. string (obligatorio)
publisher Nombre del publicador de definiciones de imágenes de la galería. string (obligatorio)
sku Nombre de la SKU de definición de imagen de la galería. string (obligatorio)

ImagePurchasePlan

Nombre Descripción Value
name Identificador del plan. string
product Id. de producto. string
publisher Identificador del publicador. string

RecommendedMachineConfiguration

Nombre Descripción Valor
memoria Describe el intervalo de recursos. ResourceRange
vCPU Describe el intervalo de recursos. ResourceRange

ResourceRange

Nombre Descripción Valor
max Número máximo del recurso. int
min. Número mínimo del recurso. int

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

Implementación en 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 de base de Windows de Azure aplicada.
Creación de una definición de imagen en una instancia de Azure Compute Gallery

Implementación en Azure		 Esta plantilla le permite crear una definición de imagen sencilla en una galería de proceso de Azure. Asegúrese de que ha ejecutado la plantilla Shared Image Gallery 101 antes de implementarla.
Configuración del servicio Dev Box

Implementación en Azure		 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 gallerys/images se puede implementar con operaciones que tienen como destino:

  • 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.Compute/galleries/images, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/images@2021-10-01"
  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 propiedad

galleries/images

Nombre Descripción Value
type Tipo de recurso "Microsoft.Compute/galleries/images@2021-10-01"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-80

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, guiones y puntos.

Comience y termine con un carácter alfanumérico.
ubicación Ubicación de los recursos string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: galerías
etiquetas Etiquetas del recurso Diccionario de nombres y valores de etiqueta.
properties Describe las propiedades de una definición de imagen de la galería. GalleryImageProperties

GalleryImageProperties

Nombre Descripción Valor
arquitectura La arquitectura de la imagen. Solo se aplica a los discos del sistema operativo. "Arm64"
"x64"
description Descripción de este recurso de definición de imagen de la galería. Esta propiedad es actualizable. string
no permitido Describe los tipos de disco no permitidos. No permitido
endOfLifeDate Fecha de finalización del ciclo de vida de la definición de la imagen de la galería. Esta propiedad se puede usar con fines de retirada. Esta propiedad es actualizable. string
eula El acuerdo eula para la definición de la imagen de la galería. string
features Una lista de características de imagen de la galería. GalleryImageFeature[]
hyperVGeneration Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo. "V1"
"V2"
identificador Este es el identificador de definición de imagen de la galería. GalleryImageIdentifier (obligatorio)
osState Esta propiedad permite al usuario especificar si las máquinas virtuales creadas en esta imagen son "Generalizadas" o "Especializadas". "Generalizado"
"Especializado" (obligatorio)
osType Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco al crear una máquina virtual a partir de una imagen administrada.

Los valores posibles son:

Windows

Linux		 "Linux"
"Windows" (obligatorio)
privacyStatementUri URI de la declaración de privacidad. string
purchasePlan Describe el plan de compra de la definición de imagen de la galería. Las imágenes de Marketplace lo usan. ImagePurchasePlan
recomendado Las propiedades describen la configuración de máquina recomendada para esta definición de imagen. Estas propiedades son actualizables. RecommendedMachineConfiguration
releaseNoteUri URI de la nota de la versión. string

No permitida.

Nombre Descripción Valor
diskTypes Lista de tipos de disco. string[]

GalleryImageFeature

Nombre Descripción Value
name Nombre de la característica de imagen de la galería. string
value Valor de la característica de imagen de la galería. string

GalleryImageIdentifier

Nombre Descripción Valor
offer Nombre de la oferta de definición de imagen de la galería. string (obligatorio)
publisher Nombre del publicador de definiciones de imágenes de la galería. string (obligatorio)
sku Nombre de la SKU de definición de imagen de la galería. string (obligatorio)

ImagePurchasePlan

Nombre Descripción Value
name Identificador del plan. string
product Id. de producto. string
publisher Identificador del publicador. string

RecommendedMachineConfiguration

Nombre Descripción Valor
memoria Describe el intervalo de recursos. ResourceRange
vCPU Describe el intervalo de recursos. ResourceRange

ResourceRange

Nombre Descripción Valor
max Número máximo del recurso. int
min. Número mínimo del recurso. int