Galerias microsoft.compute

Definição de recurso do Bicep

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

Grupos de recursos - Consulte comandos de implantação do grupo 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, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Compute/galleries@2025-03-03' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    description: 'string'
    identifier: {}
    sharingProfile: {
      communityGalleryInfo: {
        eula: 'string'
        publicNamePrefix: 'string'
        publisherContact: 'string'
        publisherUri: 'string'
      }
      permissions: 'string'
    }
    softDeletePolicy: {
      isSoftDeleteEnabled: bool
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.Compute/galleries

Nome	Descrição	Valor
identidade	A identidade da galeria, se configurada.	GaleriaIdentidade
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	string Restrições: Padrão = `^[^_\W][\w-._]{0,79}(?<![-.])$` (obrigatório)
Propriedades	Descreve as propriedades de uma Galeria de Imagens Compartilhadas.	GaleriaPropriedades
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos

CommonUserAssignedIdentitiesValue

Nome	Descrição	Valor

Informações da Galeria da Comunidade

Nome	Descrição	Valor
Eula	Contrato de licença do usuário final para a imagem da galeria da comunidade.	cadeia
publicNamePrefix	O prefixo do nome da galeria que será exibido publicamente. Visível para todos os usuários.	cadeia
publisherContato	Email de suporte do editor da galeria da comunidade. O endereço de email do editor. Visível para todos os usuários.	cadeia
publisherUri	O link para o site do editor. Visível para todos os usuários.	cadeia

Identificador de Galeria

Nome	Descrição	Valor

GaleriaIdentidade

Nome	Descrição	Valor
tipo	O tipo de identidade usado para a galeria. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades da galeria.	'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
Identidades Atribuídas pelo Usuário	A lista de identidades de usuário associadas à galeria. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	GalleryIdentityUserAssignedIdentities

GalleryIdentityUserAssignedIdentities

Nome	Descrição	Valor

GaleriaPropriedades

Nome	Descrição	Valor
descrição	A descrição deste recurso da Galeria de Imagens Compartilhadas. Essa propriedade é atualizável.	cadeia
identificador	Descreve o nome exclusivo da galeria.	GalleryIdentifier
sharingProfile	Perfil para compartilhamento de galeria para assinatura ou locatário	SharingProfile
softDeletePolicy	Contém informações sobre a política de exclusão reversível da galeria.	SoftDeletePolicy

Perfil de compartilhamento

Nome	Descrição	Valor
communityGalleryInfo	Informações da galeria da comunidade se a galeria atual for compartilhada com a comunidade.	CommunityGalleryInfo
permissões	Essa propriedade permite que você especifique a permissão de compartilhar a galeria. Os valores possíveis são: Grupos privados,Comunidade.	'Comunidade' 'Grupos' 'Privado'

SoftDeletePolicy

Nome	Descrição	Valor
isSoftDeleteEnabled	Permite a exclusão temporária de recursos nesta galeria, permitindo que eles sejam recuperados dentro do tempo de retenção.	Bool

TrackedResourceTags

Nome	Descrição	Valor

Exemplos de uso

Exemplos do Bicep

Um exemplo básico de implantação da Galeria de Imagens Compartilhadas.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource gallery 'Microsoft.Compute/galleries@2022-03-03' = {
  name: resourceName
  location: location
  properties: {
    description: ''
  }
}

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
Galeria de Computação do Azure	Módulo de recursos da AVM para a Galeria de Computação do Azure

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 de galerias pode ser implantado com operações direcionadas:

Grupos de recursos - Consulte comandos de implantação do grupo 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, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Compute/galleries",
  "apiVersion": "2025-03-03",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "description": "string",
    "identifier": {
    },
    "sharingProfile": {
      "communityGalleryInfo": {
        "eula": "string",
        "publicNamePrefix": "string",
        "publisherContact": "string",
        "publisherUri": "string"
      },
      "permissions": "string"
    },
    "softDeletePolicy": {
      "isSoftDeleteEnabled": "bool"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.Compute/galleries

Nome	Descrição	Valor
apiVersion	A versão da API	'2025-03-03'
identidade	A identidade da galeria, se configurada.	GaleriaIdentidade
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	string Restrições: Padrão = `^[^_\W][\w-._]{0,79}(?<![-.])$` (obrigatório)
Propriedades	Descreve as propriedades de uma Galeria de Imagens Compartilhadas.	GaleriaPropriedades
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.Compute/galleries'

CommonUserAssignedIdentitiesValue

Nome	Descrição	Valor

Informações da Galeria da Comunidade

Nome	Descrição	Valor
Eula	Contrato de licença do usuário final para a imagem da galeria da comunidade.	cadeia
publicNamePrefix	O prefixo do nome da galeria que será exibido publicamente. Visível para todos os usuários.	cadeia
publisherContato	Email de suporte do editor da galeria da comunidade. O endereço de email do editor. Visível para todos os usuários.	cadeia
publisherUri	O link para o site do editor. Visível para todos os usuários.	cadeia

Identificador de Galeria

Nome	Descrição	Valor

GaleriaIdentidade

Nome	Descrição	Valor
tipo	O tipo de identidade usado para a galeria. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades da galeria.	'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
Identidades Atribuídas pelo Usuário	A lista de identidades de usuário associadas à galeria. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	GalleryIdentityUserAssignedIdentities

GalleryIdentityUserAssignedIdentities

Nome	Descrição	Valor

GaleriaPropriedades

Nome	Descrição	Valor
descrição	A descrição deste recurso da Galeria de Imagens Compartilhadas. Essa propriedade é atualizável.	cadeia
identificador	Descreve o nome exclusivo da galeria.	GalleryIdentifier
sharingProfile	Perfil para compartilhamento de galeria para assinatura ou locatário	SharingProfile
softDeletePolicy	Contém informações sobre a política de exclusão reversível da galeria.	SoftDeletePolicy

Perfil de compartilhamento

Nome	Descrição	Valor
communityGalleryInfo	Informações da galeria da comunidade se a galeria atual for compartilhada com a comunidade.	CommunityGalleryInfo
permissões	Essa propriedade permite que você especifique a permissão de compartilhar a galeria. Os valores possíveis são: Grupos privados,Comunidade.	'Comunidade' 'Grupos' 'Privado'

SoftDeletePolicy

Nome	Descrição	Valor
isSoftDeleteEnabled	Permite a exclusão temporária de recursos nesta galeria, permitindo que eles sejam recuperados dentro do tempo de retenção.	Bool

TrackedResourceTags

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	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.
criar um da Galeria de Computação do Azure	Esse modelo permite que você crie uma Galeria de Computação do Azure.
criar um da Galeria de Computação do Azure	Este módulo cria um recurso da Galeria de Computação do Azure com apiVersion 2019-12-01.

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

O tipo de recurso de galerias 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, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries@2025-03-03"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      description = "string"
      identifier = {
      }
      sharingProfile = {
        communityGalleryInfo = {
          eula = "string"
          publicNamePrefix = "string"
          publisherContact = "string"
          publisherUri = "string"
        }
        permissions = "string"
      }
      softDeletePolicy = {
        isSoftDeleteEnabled = bool
      }
    }
  }
}

Valores de propriedade

Microsoft.Compute/galleries

Nome	Descrição	Valor
identidade	A identidade da galeria, se configurada.	GaleriaIdentidade
local	A localização geográfica onde o recurso reside	cadeia de caracteres (obrigatório)
nome	O nome do recurso	string Restrições: Padrão = `^[^_\W][\w-._]{0,79}(?<![-.])$` (obrigatório)
Propriedades	Descreve as propriedades de uma Galeria de Imagens Compartilhadas.	GaleriaPropriedades
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
tipo	O tipo de recurso	"Microsoft.Compute/galleries@2025-03-03"

CommonUserAssignedIdentitiesValue

Nome	Descrição	Valor

Informações da Galeria da Comunidade

Nome	Descrição	Valor
Eula	Contrato de licença do usuário final para a imagem da galeria da comunidade.	cadeia
publicNamePrefix	O prefixo do nome da galeria que será exibido publicamente. Visível para todos os usuários.	cadeia
publisherContato	Email de suporte do editor da galeria da comunidade. O endereço de email do editor. Visível para todos os usuários.	cadeia
publisherUri	O link para o site do editor. Visível para todos os usuários.	cadeia

Identificador de Galeria

Nome	Descrição	Valor

GaleriaIdentidade

Nome	Descrição	Valor
tipo	O tipo de identidade usado para a galeria. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades da galeria.	'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
Identidades Atribuídas pelo Usuário	A lista de identidades de usuário associadas à galeria. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	GalleryIdentityUserAssignedIdentities

GalleryIdentityUserAssignedIdentities

Nome	Descrição	Valor

GaleriaPropriedades

Nome	Descrição	Valor
descrição	A descrição deste recurso da Galeria de Imagens Compartilhadas. Essa propriedade é atualizável.	cadeia
identificador	Descreve o nome exclusivo da galeria.	GalleryIdentifier
sharingProfile	Perfil para compartilhamento de galeria para assinatura ou locatário	SharingProfile
softDeletePolicy	Contém informações sobre a política de exclusão reversível da galeria.	SoftDeletePolicy

Perfil de compartilhamento

Nome	Descrição	Valor
communityGalleryInfo	Informações da galeria da comunidade se a galeria atual for compartilhada com a comunidade.	CommunityGalleryInfo
permissões	Essa propriedade permite que você especifique a permissão de compartilhar a galeria. Os valores possíveis são: Grupos privados,Comunidade.	'Comunidade' 'Grupos' 'Privado'

SoftDeletePolicy

Nome	Descrição	Valor
isSoftDeleteEnabled	Permite a exclusão temporária de recursos nesta galeria, permitindo que eles sejam recuperados dentro do tempo de retenção.	Bool

TrackedResourceTags

Nome	Descrição	Valor

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação da Galeria de Imagens Compartilhadas.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "gallery" {
  type      = "Microsoft.Compute/galleries@2022-03-03"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      description = ""
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo	Descrição
Galeria de Computação do Azure	Módulo de recursos da AVM para a Galeria de Computação do Azure

Comentários

Esta página foi útil?

Last updated on 2025-07-08

Compartilhar via

Galerias microsoft.compute

Definição de recurso do Bicep

Formato de recurso

Valores de propriedade

Microsoft.Compute/galleries

CommonUserAssignedIdentitiesValue

Informações da Galeria da Comunidade

Identificador de Galeria

GaleriaIdentidade

GalleryIdentityUserAssignedIdentities

GaleriaPropriedades

Perfil de compartilhamento

SoftDeletePolicy

TrackedResourceTags

Exemplos de uso

Exemplos do Bicep

Módulos verificados do Azure

Exemplos de Início Rápido do Azure

Definição de recurso de modelo do ARM

Formato de recurso

Valores de propriedade

Microsoft.Compute/galleries

CommonUserAssignedIdentitiesValue

Informações da Galeria da Comunidade

Identificador de Galeria

GaleriaIdentidade

GalleryIdentityUserAssignedIdentities

GaleriaPropriedades

Perfil de compartilhamento

SoftDeletePolicy

TrackedResourceTags

Exemplos de uso

Modelos de Início Rápido do Azure

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

Formato de recurso

Valores de propriedade

Microsoft.Compute/galleries

CommonUserAssignedIdentitiesValue

Informações da Galeria da Comunidade

Identificador de Galeria

GaleriaIdentidade

GalleryIdentityUserAssignedIdentities

GaleriaPropriedades

Perfil de compartilhamento

SoftDeletePolicy

TrackedResourceTags

Exemplos de uso

Exemplos do Terraform

Módulos verificados do Azure

Comentários

Recursos adicionais