Compartilhar via

Galerias/aplicativos/versões do Microsoft.Compute 2024-03-03

  • Artigo

Definição de recurso do Bicep

O tipo de recurso de galerias/aplicativos/versões 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/applications/versions, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Compute/galleries/applications/versions@2024-03-03' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    publishingProfile: {
      advancedSettings: {
        {customized property}: 'string'
      }
      customActions: [
        {
          description: 'string'
          name: 'string'
          parameters: [
            {
              defaultValue: 'string'
              description: 'string'
              name: 'string'
              required: bool
              type: 'string'
            }
          ]
          script: 'string'
        }
      ]
      enableHealthCheck: bool
      endOfLifeDate: 'string'
      excludeFromLatest: bool
      manageActions: {
        install: 'string'
        remove: 'string'
        update: 'string'
      }
      replicaCount: int
      replicationMode: 'string'
      settings: {
        configFileName: 'string'
        packageFileName: 'string'
        scriptBehaviorAfterReboot: 'string'
      }
      source: {
        defaultConfigurationLink: 'string'
        mediaLink: 'string'
      }
      storageAccountType: 'string'
      targetExtendedLocations: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          extendedLocation: {
            name: 'string'
            type: 'string'
          }
          extendedLocationReplicaCount: int
          name: 'string'
          storageAccountType: 'string'
        }
      ]
      targetRegions: [
        {
          additionalReplicaSets: [
            {
              regionalReplicaCount: int
              storageAccountType: 'string'
            }
          ]
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          excludeFromLatest: bool
          name: 'string'
          regionalReplicaCount: int
          storageAccountType: 'string'
        }
      ]
    }
    safetyProfile: {
      allowDeletionOfReplicatedLocations: bool
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores da propriedade

AdditionalReplicaSet

Nome Descrição Valor
regionalReplicaCount O número de réplicas de unidade direta da Versão da Imagem a ser criada. Esta propriedade é atualizável int
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para criar as réplicas de unidade direta 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

DataDiskImageEncryption

Nome Descrição Valor
diskEncryptionSetId Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco. corda
Lun Essa propriedade especifica o número de unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da Máquina Virtual e, portanto, deve ser exclusivo para cada disco de dados anexado à Máquina Virtual. int (obrigatório)

EncryptionImages

Nome Descrição Valor
dataDiskImages Uma lista de especificações de criptografia para imagens de disco de dados. DataDiskImageEncryption[]
osDiskImage Contém configurações de criptografia para uma imagem de disco do sistema operacional. OSDiskImageEncryption

GalleryApplicationCustomAction

Nome Descrição Valor
descrição Descrição para ajudar os usuários a entender o que essa ação personalizada faz. corda
nome O nome da ação personalizada. Deve ser exclusivo na Versão do Aplicativo da Galeria. cadeia de caracteres (obrigatório)
Parâmetros Os parâmetros que essa ação personalizada usa GalleryApplicationCustomActionParameter[]
roteiro O script a ser executado ao executar essa ação personalizada. cadeia de caracteres (obrigatório)

GalleryApplicationCustomActionParameter

Nome Descrição Valor
defaultValue O valor padrão do parâmetro. Aplica-se somente a tipos de cadeia de caracteres corda
descrição Uma descrição para ajudar os usuários a entender o que esse parâmetro significa corda
nome O nome da ação personalizada. Deve ser exclusivo na Versão do Aplicativo da Galeria. cadeia de caracteres (obrigatório)
Necessário Indica se esse parâmetro deve ser passado ao executar a ação personalizada. Bool
tipo Especifica o tipo do parâmetro de ação personalizado. Os valores possíveis são: String, ConfigurationDataBlob ou LogOutputBlob 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

GalleryApplicationVersionProperties

Nome Descrição Valor
publishingProfile O perfil de publicação de uma versão de imagem da galeria. GalleryApplicationVersionPublishingProfile (obrigatório)
safetyProfile O perfil de segurança da Versão do Aplicativo da Galeria. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Nome Descrição Valor
advancedSettings Opcional. Configurações adicionais a serem passadas para a extensão vm-application-manager. Somente para uso avançado. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Uma lista de ações personalizadas que podem ser executadas com esta Versão do Aplicativo da Galeria. GalleryApplicationCustomAction[]
enableHealthCheck Opcional. Se esse aplicativo relata ou não a integridade. Bool
endOfLifeDate A data de término da vida útil da versão da imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. corda
excludeFromLatest Se definido como true, as Máquinas Virtuais implantadas a partir da versão mais recente da Definição de Imagem não usarão essa Versão da Imagem. Bool
manageActions UserArtifactManage
replicaCount O número de réplicas da Versão da Imagem a serem criadas por região. Essa propriedade entraria em vigor para uma região quando regionalReplicaCount não for especificado. Essa propriedade é atualizável. int
replicationMode Parâmetro opcional que especifica o modo a ser usado para replicação. Essa propriedade não é atualizável. 'Completo'
'Superficial'
Configurações Configurações adicionais para o aplicativo de VM que contém o pacote de destino e o nome do arquivo de configuração quando ele é implantado no conjunto de dimensionamento de VM ou VM de destino. UserArtifactSettings
fonte A imagem de origem da qual a Versão da Imagem será criada. UserArtifactSource (obrigatório)
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations Os locais estendidos de destino para os quais a Versão da Imagem será replicada. Essa propriedade é atualizável. GalleryTargetExtendedLocation []
targetRegions As regiões de destino para as quais a Versão da Imagem será replicada. Essa propriedade é atualizável. de Região de Destino []

GalleryApplicationVersionPublishingProfileAdvancedSettings

Nome Descrição Valor

GalleryApplicationVersionSafetyProfile

Nome Descrição Valor
allowDeletionOfReplicatedLocations Indica se a remoção ou não dessa Versão da Imagem da Galeria de regiões replicadas é permitida. Bool

GalleryExtendedLocation

Nome Descrição Valor
nome corda
tipo É o tipo do local estendido. 'EdgeZone'
'Desconhecido'

GalleryTargetExtendedLocation

Nome Descrição Valor
encriptação Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria. do EncryptionImages
extendedLocation O nome do local estendido. GalleryExtendedLocation
extendedLocationReplicaCount O número de réplicas da Versão da Imagem a ser criada por local estendido. Essa propriedade é atualizável. int
nome O nome da região. corda
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

Microsoft.Compute/galleries/applications/versions

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/aplicativos
Propriedades Descreve as propriedades de uma versão de imagem da galeria. GalleryApplicationVersionProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

OSDiskImageEncryption

Nome Descrição Valor
diskEncryptionSetId Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco. corda
securityProfile Essa propriedade especifica o perfil de segurança de uma imagem de disco do sistema operacional. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nome Descrição Valor
confidentialVMEncryptionType tipos de criptografia de VM confidenciais 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId ID do conjunto de criptografia de disco de VM segura corda

ResourceTags

Nome Descrição Valor

TargetRegion

Nome Descrição Valor
additionalReplicaSets Lista de sku de armazenamento com contagem de réplicas para criar réplicas de unidade direta. AdditionalReplicaSet []
encriptação Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria. do EncryptionImages
excludeFromLatest Contém a configuração de sinalizador para ocultar uma imagem quando os usuários especificam version='latest' Bool
nome O nome da região. cadeia de caracteres (obrigatório)
regionalReplicaCount O número de réplicas da Versão da Imagem a serem criadas por região. Essa propriedade é atualizável. int
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

UserArtifactManage

Nome Descrição Valor
instalar Necessário. O caminho e os argumentos para instalar o aplicativo da galeria. Isso é limitado a 4.096 caracteres. cadeia de caracteres (obrigatório)
retirar Necessário. O caminho e os argumentos para remover o aplicativo da galeria. Isso é limitado a 4.096 caracteres. cadeia de caracteres (obrigatório)
atualização Opcional. O caminho e os argumentos para atualizar o aplicativo da galeria. Se não estiver presente, a operação de atualização invocará o comando remove na versão anterior e instalará o comando na versão atual do aplicativo da galeria. Isso é limitado a 4.096 caracteres. corda

UserArtifactSettings

Nome Descrição Valor
configFileName Opcional. O nome para atribuir o arquivo de configuração baixado na VM. Isso é limitado a 4.096 caracteres. Se não for especificado, o arquivo de configuração será nomeado o nome do Aplicativo da Galeria acrescentado com "_config". corda
packageFileName Opcional. O nome para atribuir o arquivo de pacote baixado na VM. Isso é limitado a 4.096 caracteres. Se não for especificado, o arquivo de pacote será nomeado da mesma forma que o nome do Aplicativo da Galeria. corda
scriptBehaviorAfterReboot Opcional. A ação a ser tomada em relação à instalação/atualização/remoção do aplicativo da galeria no caso de uma reinicialização. 'None'
'Executar novamente'

UserArtifactSource

Nome Descrição Valor
defaultConfigurationLink Opcional. O defaultConfigurationLink do artefato deve ser um blob de página de armazenamento legível. corda
mediaLink Necessário. O mediaLink do artefato deve ser um blob de página de armazenamento legível. cadeia de caracteres (obrigatório)

Definição de recurso de modelo do ARM

O tipo de recurso de galerias/aplicativos/versões 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/applications/versions, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Compute/galleries/applications/versions",
  "apiVersion": "2024-03-03",
  "name": "string",
  "location": "string",
  "properties": {
    "publishingProfile": {
      "advancedSettings": {
        "{customized property}": "string"
      },
      "customActions": [
        {
          "description": "string",
          "name": "string",
          "parameters": [
            {
              "defaultValue": "string",
              "description": "string",
              "name": "string",
              "required": "bool",
              "type": "string"
            }
          ],
          "script": "string"
        }
      ],
      "enableHealthCheck": "bool",
      "endOfLifeDate": "string",
      "excludeFromLatest": "bool",
      "manageActions": {
        "install": "string",
        "remove": "string",
        "update": "string"
      },
      "replicaCount": "int",
      "replicationMode": "string",
      "settings": {
        "configFileName": "string",
        "packageFileName": "string",
        "scriptBehaviorAfterReboot": "string"
      },
      "source": {
        "defaultConfigurationLink": "string",
        "mediaLink": "string"
      },
      "storageAccountType": "string",
      "targetExtendedLocations": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "extendedLocation": {
            "name": "string",
            "type": "string"
          },
          "extendedLocationReplicaCount": "int",
          "name": "string",
          "storageAccountType": "string"
        }
      ],
      "targetRegions": [
        {
          "additionalReplicaSets": [
            {
              "regionalReplicaCount": "int",
              "storageAccountType": "string"
            }
          ],
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "excludeFromLatest": "bool",
          "name": "string",
          "regionalReplicaCount": "int",
          "storageAccountType": "string"
        }
      ]
    },
    "safetyProfile": {
      "allowDeletionOfReplicatedLocations": "bool"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores da propriedade

AdditionalReplicaSet

Nome Descrição Valor
regionalReplicaCount O número de réplicas de unidade direta da Versão da Imagem a ser criada. Esta propriedade é atualizável int
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para criar as réplicas de unidade direta 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

DataDiskImageEncryption

Nome Descrição Valor
diskEncryptionSetId Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco. corda
Lun Essa propriedade especifica o número de unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da Máquina Virtual e, portanto, deve ser exclusivo para cada disco de dados anexado à Máquina Virtual. int (obrigatório)

EncryptionImages

Nome Descrição Valor
dataDiskImages Uma lista de especificações de criptografia para imagens de disco de dados. DataDiskImageEncryption[]
osDiskImage Contém configurações de criptografia para uma imagem de disco do sistema operacional. OSDiskImageEncryption

GalleryApplicationCustomAction

Nome Descrição Valor
descrição Descrição para ajudar os usuários a entender o que essa ação personalizada faz. corda
nome O nome da ação personalizada. Deve ser exclusivo na Versão do Aplicativo da Galeria. cadeia de caracteres (obrigatório)
Parâmetros Os parâmetros que essa ação personalizada usa GalleryApplicationCustomActionParameter[]
roteiro O script a ser executado ao executar essa ação personalizada. cadeia de caracteres (obrigatório)

GalleryApplicationCustomActionParameter

Nome Descrição Valor
defaultValue O valor padrão do parâmetro. Aplica-se somente a tipos de cadeia de caracteres corda
descrição Uma descrição para ajudar os usuários a entender o que esse parâmetro significa corda
nome O nome da ação personalizada. Deve ser exclusivo na Versão do Aplicativo da Galeria. cadeia de caracteres (obrigatório)
Necessário Indica se esse parâmetro deve ser passado ao executar a ação personalizada. Bool
tipo Especifica o tipo do parâmetro de ação personalizado. Os valores possíveis são: String, ConfigurationDataBlob ou LogOutputBlob 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

GalleryApplicationVersionProperties

Nome Descrição Valor
publishingProfile O perfil de publicação de uma versão de imagem da galeria. GalleryApplicationVersionPublishingProfile (obrigatório)
safetyProfile O perfil de segurança da Versão do Aplicativo da Galeria. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Nome Descrição Valor
advancedSettings Opcional. Configurações adicionais a serem passadas para a extensão vm-application-manager. Somente para uso avançado. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Uma lista de ações personalizadas que podem ser executadas com esta Versão do Aplicativo da Galeria. GalleryApplicationCustomAction[]
enableHealthCheck Opcional. Se esse aplicativo relata ou não a integridade. Bool
endOfLifeDate A data de término da vida útil da versão da imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. corda
excludeFromLatest Se definido como true, as Máquinas Virtuais implantadas a partir da versão mais recente da Definição de Imagem não usarão essa Versão da Imagem. Bool
manageActions UserArtifactManage
replicaCount O número de réplicas da Versão da Imagem a serem criadas por região. Essa propriedade entraria em vigor para uma região quando regionalReplicaCount não for especificado. Essa propriedade é atualizável. int
replicationMode Parâmetro opcional que especifica o modo a ser usado para replicação. Essa propriedade não é atualizável. 'Completo'
'Superficial'
Configurações Configurações adicionais para o aplicativo de VM que contém o pacote de destino e o nome do arquivo de configuração quando ele é implantado no conjunto de dimensionamento de VM ou VM de destino. UserArtifactSettings
fonte A imagem de origem da qual a Versão da Imagem será criada. UserArtifactSource (obrigatório)
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations Os locais estendidos de destino para os quais a Versão da Imagem será replicada. Essa propriedade é atualizável. GalleryTargetExtendedLocation []
targetRegions As regiões de destino para as quais a Versão da Imagem será replicada. Essa propriedade é atualizável. de Região de Destino []

GalleryApplicationVersionPublishingProfileAdvancedSettings

Nome Descrição Valor

GalleryApplicationVersionSafetyProfile

Nome Descrição Valor
allowDeletionOfReplicatedLocations Indica se a remoção ou não dessa Versão da Imagem da Galeria de regiões replicadas é permitida. Bool

GalleryExtendedLocation

Nome Descrição Valor
nome corda
tipo É o tipo do local estendido. 'EdgeZone'
'Desconhecido'

GalleryTargetExtendedLocation

Nome Descrição Valor
encriptação Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria. do EncryptionImages
extendedLocation O nome do local estendido. GalleryExtendedLocation
extendedLocationReplicaCount O número de réplicas da Versão da Imagem a ser criada por local estendido. Essa propriedade é atualizável. int
nome O nome da região. corda
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

Microsoft.Compute/galleries/applications/versions

Nome Descrição Valor
apiVersion A versão da API '2024-03-03'
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 versão de imagem da galeria. GalleryApplicationVersionProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Compute/galleries/applications/versions'

OSDiskImageEncryption

Nome Descrição Valor
diskEncryptionSetId Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco. corda
securityProfile Essa propriedade especifica o perfil de segurança de uma imagem de disco do sistema operacional. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nome Descrição Valor
confidentialVMEncryptionType tipos de criptografia de VM confidenciais 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId ID do conjunto de criptografia de disco de VM segura corda

ResourceTags

Nome Descrição Valor

TargetRegion

Nome Descrição Valor
additionalReplicaSets Lista de sku de armazenamento com contagem de réplicas para criar réplicas de unidade direta. AdditionalReplicaSet []
encriptação Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria. do EncryptionImages
excludeFromLatest Contém a configuração de sinalizador para ocultar uma imagem quando os usuários especificam version='latest' Bool
nome O nome da região. cadeia de caracteres (obrigatório)
regionalReplicaCount O número de réplicas da Versão da Imagem a serem criadas por região. Essa propriedade é atualizável. int
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

UserArtifactManage

Nome Descrição Valor
instalar Necessário. O caminho e os argumentos para instalar o aplicativo da galeria. Isso é limitado a 4.096 caracteres. cadeia de caracteres (obrigatório)
retirar Necessário. O caminho e os argumentos para remover o aplicativo da galeria. Isso é limitado a 4.096 caracteres. cadeia de caracteres (obrigatório)
atualização Opcional. O caminho e os argumentos para atualizar o aplicativo da galeria. Se não estiver presente, a operação de atualização invocará o comando remove na versão anterior e instalará o comando na versão atual do aplicativo da galeria. Isso é limitado a 4.096 caracteres. corda

UserArtifactSettings

Nome Descrição Valor
configFileName Opcional. O nome para atribuir o arquivo de configuração baixado na VM. Isso é limitado a 4.096 caracteres. Se não for especificado, o arquivo de configuração será nomeado o nome do Aplicativo da Galeria acrescentado com "_config". corda
packageFileName Opcional. O nome para atribuir o arquivo de pacote baixado na VM. Isso é limitado a 4.096 caracteres. Se não for especificado, o arquivo de pacote será nomeado da mesma forma que o nome do Aplicativo da Galeria. corda
scriptBehaviorAfterReboot Opcional. A ação a ser tomada em relação à instalação/atualização/remoção do aplicativo da galeria no caso de uma reinicialização. 'None'
'Executar novamente'

UserArtifactSource

Nome Descrição Valor
defaultConfigurationLink Opcional. O defaultConfigurationLink do artefato deve ser um blob de página de armazenamento legível. corda
mediaLink Necessário. O mediaLink do artefato deve ser um blob de página de armazenamento legível. cadeia de caracteres (obrigatório)

Exemplos de uso

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

O tipo de recurso de galerias/aplicativos/versões 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/applications/versions, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/applications/versions@2024-03-03"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      publishingProfile = {
        advancedSettings = {
          {customized property} = "string"
        }
        customActions = [
          {
            description = "string"
            name = "string"
            parameters = [
              {
                defaultValue = "string"
                description = "string"
                name = "string"
                required = bool
                type = "string"
              }
            ]
            script = "string"
          }
        ]
        enableHealthCheck = bool
        endOfLifeDate = "string"
        excludeFromLatest = bool
        manageActions = {
          install = "string"
          remove = "string"
          update = "string"
        }
        replicaCount = int
        replicationMode = "string"
        settings = {
          configFileName = "string"
          packageFileName = "string"
          scriptBehaviorAfterReboot = "string"
        }
        source = {
          defaultConfigurationLink = "string"
          mediaLink = "string"
        }
        storageAccountType = "string"
        targetExtendedLocations = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            extendedLocation = {
              name = "string"
              type = "string"
            }
            extendedLocationReplicaCount = int
            name = "string"
            storageAccountType = "string"
          }
        ]
        targetRegions = [
          {
            additionalReplicaSets = [
              {
                regionalReplicaCount = int
                storageAccountType = "string"
              }
            ]
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            excludeFromLatest = bool
            name = "string"
            regionalReplicaCount = int
            storageAccountType = "string"
          }
        ]
      }
      safetyProfile = {
        allowDeletionOfReplicatedLocations = bool
      }
    }
  })
}

Valores da propriedade

AdditionalReplicaSet

Nome Descrição Valor
regionalReplicaCount O número de réplicas de unidade direta da Versão da Imagem a ser criada. Esta propriedade é atualizável int
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para criar as réplicas de unidade direta 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

DataDiskImageEncryption

Nome Descrição Valor
diskEncryptionSetId Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco. corda
Lun Essa propriedade especifica o número de unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da Máquina Virtual e, portanto, deve ser exclusivo para cada disco de dados anexado à Máquina Virtual. int (obrigatório)

EncryptionImages

Nome Descrição Valor
dataDiskImages Uma lista de especificações de criptografia para imagens de disco de dados. DataDiskImageEncryption[]
osDiskImage Contém configurações de criptografia para uma imagem de disco do sistema operacional. OSDiskImageEncryption

GalleryApplicationCustomAction

Nome Descrição Valor
descrição Descrição para ajudar os usuários a entender o que essa ação personalizada faz. corda
nome O nome da ação personalizada. Deve ser exclusivo na Versão do Aplicativo da Galeria. cadeia de caracteres (obrigatório)
Parâmetros Os parâmetros que essa ação personalizada usa GalleryApplicationCustomActionParameter[]
roteiro O script a ser executado ao executar essa ação personalizada. cadeia de caracteres (obrigatório)

GalleryApplicationCustomActionParameter

Nome Descrição Valor
defaultValue O valor padrão do parâmetro. Aplica-se somente a tipos de cadeia de caracteres corda
descrição Uma descrição para ajudar os usuários a entender o que esse parâmetro significa corda
nome O nome da ação personalizada. Deve ser exclusivo na Versão do Aplicativo da Galeria. cadeia de caracteres (obrigatório)
Necessário Indica se esse parâmetro deve ser passado ao executar a ação personalizada. Bool
tipo Especifica o tipo do parâmetro de ação personalizado. Os valores possíveis são: String, ConfigurationDataBlob ou LogOutputBlob 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

GalleryApplicationVersionProperties

Nome Descrição Valor
publishingProfile O perfil de publicação de uma versão de imagem da galeria. GalleryApplicationVersionPublishingProfile (obrigatório)
safetyProfile O perfil de segurança da Versão do Aplicativo da Galeria. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Nome Descrição Valor
advancedSettings Opcional. Configurações adicionais a serem passadas para a extensão vm-application-manager. Somente para uso avançado. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Uma lista de ações personalizadas que podem ser executadas com esta Versão do Aplicativo da Galeria. GalleryApplicationCustomAction[]
enableHealthCheck Opcional. Se esse aplicativo relata ou não a integridade. Bool
endOfLifeDate A data de término da vida útil da versão da imagem da galeria. Essa propriedade pode ser usada para fins de descomissionamento. Essa propriedade é atualizável. corda
excludeFromLatest Se definido como true, as Máquinas Virtuais implantadas a partir da versão mais recente da Definição de Imagem não usarão essa Versão da Imagem. Bool
manageActions UserArtifactManage
replicaCount O número de réplicas da Versão da Imagem a serem criadas por região. Essa propriedade entraria em vigor para uma região quando regionalReplicaCount não for especificado. Essa propriedade é atualizável. int
replicationMode Parâmetro opcional que especifica o modo a ser usado para replicação. Essa propriedade não é atualizável. 'Completo'
'Superficial'
Configurações Configurações adicionais para o aplicativo de VM que contém o pacote de destino e o nome do arquivo de configuração quando ele é implantado no conjunto de dimensionamento de VM ou VM de destino. UserArtifactSettings
fonte A imagem de origem da qual a Versão da Imagem será criada. UserArtifactSource (obrigatório)
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetExtendedLocations Os locais estendidos de destino para os quais a Versão da Imagem será replicada. Essa propriedade é atualizável. GalleryTargetExtendedLocation []
targetRegions As regiões de destino para as quais a Versão da Imagem será replicada. Essa propriedade é atualizável. de Região de Destino []

GalleryApplicationVersionPublishingProfileAdvancedSettings

Nome Descrição Valor

GalleryApplicationVersionSafetyProfile

Nome Descrição Valor
allowDeletionOfReplicatedLocations Indica se a remoção ou não dessa Versão da Imagem da Galeria de regiões replicadas é permitida. Bool

GalleryExtendedLocation

Nome Descrição Valor
nome corda
tipo É o tipo do local estendido. 'EdgeZone'
'Desconhecido'

GalleryTargetExtendedLocation

Nome Descrição Valor
encriptação Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria. do EncryptionImages
extendedLocation O nome do local estendido. GalleryExtendedLocation
extendedLocationReplicaCount O número de réplicas da Versão da Imagem a ser criada por local estendido. Essa propriedade é atualizável. int
nome O nome da região. corda
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'
'Standard_ZRS'

Microsoft.Compute/galleries/applications/versions

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/aplicativos
Propriedades Descreve as propriedades de uma versão de imagem da galeria. GalleryApplicationVersionProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Compute/galleries/applications/versions@2024-03-03"

OSDiskImageEncryption

Nome Descrição Valor
diskEncryptionSetId Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco. corda
securityProfile Essa propriedade especifica o perfil de segurança de uma imagem de disco do sistema operacional. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nome Descrição Valor
confidentialVMEncryptionType tipos de criptografia de VM confidenciais 'EncryptedVMGuestStateOnlyWithPmk'
'EncryptedWithCmk'
'EncryptedWithPmk'
'NonPersistedTPM'
secureVMDiskEncryptionSetId ID do conjunto de criptografia de disco de VM segura corda

ResourceTags

Nome Descrição Valor

TargetRegion

Nome Descrição Valor
additionalReplicaSets Lista de sku de armazenamento com contagem de réplicas para criar réplicas de unidade direta. AdditionalReplicaSet []
encriptação Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria. do EncryptionImages
excludeFromLatest Contém a configuração de sinalizador para ocultar uma imagem quando os usuários especificam version='latest' Bool
nome O nome da região. cadeia de caracteres (obrigatório)
regionalReplicaCount O número de réplicas da Versão da Imagem a serem criadas por região. Essa propriedade é atualizável. int
storageAccountType Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Essa propriedade não é atualizável. 'PremiumV2_LRS'
'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

UserArtifactManage

Nome Descrição Valor
instalar Necessário. O caminho e os argumentos para instalar o aplicativo da galeria. Isso é limitado a 4.096 caracteres. cadeia de caracteres (obrigatório)
retirar Necessário. O caminho e os argumentos para remover o aplicativo da galeria. Isso é limitado a 4.096 caracteres. cadeia de caracteres (obrigatório)
atualização Opcional. O caminho e os argumentos para atualizar o aplicativo da galeria. Se não estiver presente, a operação de atualização invocará o comando remove na versão anterior e instalará o comando na versão atual do aplicativo da galeria. Isso é limitado a 4.096 caracteres. corda

UserArtifactSettings

Nome Descrição Valor
configFileName Opcional. O nome para atribuir o arquivo de configuração baixado na VM. Isso é limitado a 4.096 caracteres. Se não for especificado, o arquivo de configuração será nomeado o nome do Aplicativo da Galeria acrescentado com "_config". corda
packageFileName Opcional. O nome para atribuir o arquivo de pacote baixado na VM. Isso é limitado a 4.096 caracteres. Se não for especificado, o arquivo de pacote será nomeado da mesma forma que o nome do Aplicativo da Galeria. corda
scriptBehaviorAfterReboot Opcional. A ação a ser tomada em relação à instalação/atualização/remoção do aplicativo da galeria no caso de uma reinicialização. 'None'
'Executar novamente'

UserArtifactSource

Nome Descrição Valor
defaultConfigurationLink Opcional. O defaultConfigurationLink do artefato deve ser um blob de página de armazenamento legível. corda
mediaLink Necessário. O mediaLink do artefato deve ser um blob de página de armazenamento legível. cadeia de caracteres (obrigatório)