Instantâneos do Microsoft.Compute 2022-03-02

Artigo
08/17/2024

Definição de recurso do Bicep

O tipo de recurso de instantâneos 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/snapshots, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.Compute/snapshots@2022-03-02' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'CopySourceNotFound'
      errorMessage: 'string'
    }
    creationData: {
      createOption: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      securityDataUri: 'string'
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    dataAccessAuthMode: 'string'
    diskAccessId: 'string'
    diskSizeGB: int
    encryption: {
      diskEncryptionSetId: 'string'
      type: 'string'
    }
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
      encryptionSettingsVersion: 'string'
    }
    hyperVGeneration: 'string'
    incremental: bool
    networkAccessPolicy: 'string'
    osType: 'string'
    publicNetworkAccess: 'string'
    purchasePlan: {
      name: 'string'
      product: 'string'
      promotionCode: 'string'
      publisher: 'string'
    }
    securityProfile: {
      secureVMDiskEncryptionSetId: 'string'
      securityType: 'string'
    }
    supportedCapabilities: {
      acceleratedNetwork: bool
      architecture: 'string'
    }
    supportsHibernation: bool
  }
}

Valores de propriedade

Instantâneos

Nome	Descrição	Valor
nome	O nome do recurso	cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Alfanuméricos, sublinhados, períodos e hifens. Comece com alfanumérico. Termine com alfanumérico ou sublinhado.
localização	Local do recurso	cadeia de caracteres (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
Sku	O nome do sku de instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. Esse é um parâmetro opcional para instantâneo incremental e o comportamento padrão é que o SKU será definido como o mesmo sku do instantâneo anterior	SnapshotSku
extendedLocation	O local estendido onde o instantâneo será criado. O local estendido não pode ser alterado.	ExtendedLocation
Propriedades	Propriedades do recurso de instantâneo.	SnapshotProperties

ExtendedLocation

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

SnapshotProperties

Nome	Descrição	Valor
completionPercent	Porcentagem concluída para a cópia em segundo plano quando um recurso é criado por meio da operação CopyStart.	int
copyCompletionError	Indica os detalhes do erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	CopyCompletionError
creationData	Informações de origem do disco. As informações de CreationData não podem ser alteradas após a criação do disco.	CreationData (obrigatório)
dataAccessAuthMode	Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.	'AzureActiveDirectory' 'None'
diskAccessId	ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.	corda
diskSizeGB	Se creationData.createOption estiver Vazio, esse campo será obrigatório e indicará o tamanho do disco a ser criado. Se esse campo estiver presente para atualizações ou criação com outras opções, ele indicará um redimensionamento. Os redimensionamentos só serão permitidos se o disco não estiver anexado a uma VM em execução e só puderem aumentar o tamanho do disco.	int
encriptação	A propriedade de criptografia pode ser usada para criptografar dados em repouso com chaves gerenciadas pelo cliente ou chaves gerenciadas pela plataforma.	Encryption
encryptionSettingsCollection	A coleção de configurações de criptografia usada é a Criptografia de Disco do Azure, pode conter várias configurações de criptografia por disco ou instantâneo.	EncryptionSettingsCollection
hyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.	'V1' 'V2'
incremental	Se um instantâneo é incremental. Instantâneos incrementais no mesmo disco ocupam menos espaço do que instantâneos completos e podem ser diferenciados.	Bool
networkAccessPolicy	Política para acessar o disco por meio da rede.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	O tipo de sistema operacional.	'Linux' 'Windows'
publicNetworkAccess	Política para controlar a exportação no disco.	'Desabilitado' 'Habilitado'
purchasePlan	Informações do plano de compra para a imagem da qual o disco de origem para o instantâneo foi criado originalmente.	PurchasePlan
securityProfile	Contém as informações relacionadas à segurança do recurso.	DiskSecurityProfile
supportedCapabilities	Lista de recursos com suporte para a imagem da qual o disco de origem do instantâneo foi criado originalmente.	supportedCapabilities
supportsHibernation	Indica que o sistema operacional em um instantâneo dá suporte à hibernação.	Bool

CopyCompletionError

Nome	Descrição	Valor
errorCode	Indica o código de erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	'CopySourceNotFound' (obrigatório)
errorMessage	Indica a mensagem de erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	cadeia de caracteres (obrigatório)

CreationData

Nome	Descrição	Valor
createOption	Isso enumera as possíveis fontes da criação de um disco.	'Anexar' 'Copiar' 'CopyStart' 'Vazio' 'FromImage' 'Importar' 'ImportSecure' 'Restaurar' 'Carregar' 'UploadPreparedSecure' (obrigatório)
galleryImageReference	Necessário se for criado a partir de uma Imagem da Galeria. A id/sharedGalleryImageId/communityGalleryImageId do ImageDiskReference será a ID do ARM da versão de imagem de galeria compartilhada da qual criar um disco.	ImageDiskReference
imageReference	Informações de origem do disco para pir ou imagens de usuário.	ImageDiskReference
logicalSectorSize	Tamanho do setor lógico em bytes para discos Ultra. Os valores com suporte são 512 ad 4096. 4096 é o padrão.	int
securityDataUri	Se createOption for ImportSecure, esse será o URI de um blob a ser importado para o estado convidado da VM.	corda
sourceResourceId	Se createOption for Copy, essa será a ID do ARM do instantâneo ou disco de origem.	corda
sourceUri	Se createOption for Import, esse será o URI de um blob a ser importado para um disco gerenciado.	corda
storageAccountId	Necessário se createOption for Import. O identificador do Azure Resource Manager da conta de armazenamento que contém o blob a ser importado como um disco.	corda
uploadSizeBytes	Se createOption for Upload, esse será o tamanho do conteúdo do upload, incluindo o rodapé do VHD. Esse valor deve estar entre 20972032 (20 MiB + 512 bytes para o rodapé VHD) e 35183298347520 bytes (32 TiB + 512 bytes para o rodapé VHD).	int

ImageDiskReference

Nome	Descrição	Valor
communityGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure da comunidade.	corda
id	Um uri relativo que contém um Repositório de Imagens de Plataforma, uma imagem de usuário ou uma referência de imagem da Galeria de Computação do Azure.	corda
Lun	Se o disco for criado a partir do disco de dados de uma imagem, esse será um índice que indica qual dos discos de dados na imagem será usado. Para discos do sistema operacional, esse campo é nulo.	int
sharedGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure compartilhada direta.	corda

Encriptação

Nome	Descrição	Valor
diskEncryptionSetId	ResourceId do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.	corda
tipo	O tipo de chave usado para criptografar os dados do disco.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nome	Descrição	Valor
Habilitado	Defina esse sinalizador como true e forneça DiskEncryptionKey e KeyEncryptionKey opcional para habilitar a criptografia. Defina esse sinalizador como false e remova DiskEncryptionKey e KeyEncryptionKey para desabilitar a criptografia. Se EncryptionSettings for nulo no objeto de solicitação, as configurações existentes permanecerão inalteradas.	bool (obrigatório)
encryptionSettings	Uma coleção de configurações de criptografia, uma para cada volume de disco.	EncryptionSettingsElement[]
encryptionSettingsVersion	Descreve que tipo de criptografia é usado para os discos. Depois que esse campo for definido, ele não poderá ser substituído. '1.0' corresponde ao Azure Disk Encryption com o aplicativo AAD.'1.1' corresponde ao Azure Disk Encryption.	corda

EncryptionSettingsElement

Nome	Descrição	Valor
diskEncryptionKey	Url secreta do Key Vault e id do cofre da chave de criptografia de disco	KeyVaultAndSecretReference
keyEncryptionKey	Url da Chave do Key Vault e id do cofre da chave de criptografia de chave. KeyEncryptionKey é opcional e quando fornecido é usado para desembrulhar a chave de criptografia de disco.	KeyVaultAndKeyReference

KeyVaultAndSecretReference

Nome	Descrição	Valor
secretUrl	Url apontando para uma chave ou segredo no KeyVault	cadeia de caracteres (obrigatório)
sourceVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

SourceVault

Nome	Descrição	Valor
id	ID do recurso	corda

KeyVaultAndKeyReference

Nome	Descrição	Valor
keyUrl	Url apontando para uma chave ou segredo no KeyVault	cadeia de caracteres (obrigatório)
sourceVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

PurchasePlan

Nome	Descrição	Valor
nome	A ID do plano.	cadeia de caracteres (obrigatório)
produto	Especifica o produto da imagem do marketplace. Esse é o mesmo valor que Offer no elemento imageReference.	cadeia de caracteres (obrigatório)
promotionCode	O código de promoção da oferta.	corda
editor	A ID do editor.	cadeia de caracteres (obrigatório)

DiskSecurityProfile

Nome	Descrição	Valor
secureVMDiskEncryptionSetId	ResourceId do conjunto de criptografia de disco associado ao disco com suporte de VM confidencial criptografado com chave gerenciada pelo cliente	corda
securityType	Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

SupportedCapabilities

Nome	Descrição	Valor
acceleratedNetwork	True se a imagem da qual o disco do sistema operacional é criado dá suporte à rede acelerada.	Bool
arquitetura	Arquitetura de CPU compatível com um disco do sistema operacional.	'Arm64' 'x64'

SnapshotSku

Nome	Descrição	Valor
nome	O nome do sku.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

Definição de recurso de modelo do ARM

O tipo de recurso de instantâneos 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/snapshots, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2022-03-02",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "CopySourceNotFound",
      "errorMessage": "string"
    },
    "creationData": {
      "createOption": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "securityDataUri": "string",
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "dataAccessAuthMode": "string",
    "diskAccessId": "string",
    "diskSizeGB": "int",
    "encryption": {
      "diskEncryptionSetId": "string",
      "type": "string"
    },
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ],
      "encryptionSettingsVersion": "string"
    },
    "hyperVGeneration": "string",
    "incremental": "bool",
    "networkAccessPolicy": "string",
    "osType": "string",
    "publicNetworkAccess": "string",
    "purchasePlan": {
      "name": "string",
      "product": "string",
      "promotionCode": "string",
      "publisher": "string"
    },
    "securityProfile": {
      "secureVMDiskEncryptionSetId": "string",
      "securityType": "string"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": "bool",
      "architecture": "string"
    },
    "supportsHibernation": "bool"
  }
}

Valores de propriedade

Instantâneos

Nome	Descrição	Valor
tipo	O tipo de recurso	'Microsoft.Compute/snapshots'
apiVersion	A versão da API do recurso	'2022-03-02'
nome	O nome do recurso	cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Alfanuméricos, sublinhados, períodos e hifens. Comece com alfanumérico. Termine com alfanumérico ou sublinhado.
localização	Local do recurso	cadeia de caracteres (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca. Consulte Marcas em modelos
Sku	O nome do sku de instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. Esse é um parâmetro opcional para instantâneo incremental e o comportamento padrão é que o SKU será definido como o mesmo sku do instantâneo anterior	SnapshotSku
extendedLocation	O local estendido onde o instantâneo será criado. O local estendido não pode ser alterado.	ExtendedLocation
Propriedades	Propriedades do recurso de instantâneo.	SnapshotProperties

ExtendedLocation

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

SnapshotProperties

Nome	Descrição	Valor
completionPercent	Porcentagem concluída para a cópia em segundo plano quando um recurso é criado por meio da operação CopyStart.	int
copyCompletionError	Indica os detalhes do erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	CopyCompletionError
creationData	Informações de origem do disco. As informações de CreationData não podem ser alteradas após a criação do disco.	CreationData (obrigatório)
dataAccessAuthMode	Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.	'AzureActiveDirectory' 'None'
diskAccessId	ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.	corda
diskSizeGB	Se creationData.createOption estiver Vazio, esse campo será obrigatório e indicará o tamanho do disco a ser criado. Se esse campo estiver presente para atualizações ou criação com outras opções, ele indicará um redimensionamento. Os redimensionamentos só serão permitidos se o disco não estiver anexado a uma VM em execução e só puderem aumentar o tamanho do disco.	int
encriptação	A propriedade de criptografia pode ser usada para criptografar dados em repouso com chaves gerenciadas pelo cliente ou chaves gerenciadas pela plataforma.	Encryption
encryptionSettingsCollection	A coleção de configurações de criptografia usada é a Criptografia de Disco do Azure, pode conter várias configurações de criptografia por disco ou instantâneo.	EncryptionSettingsCollection
hyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.	'V1' 'V2'
incremental	Se um instantâneo é incremental. Instantâneos incrementais no mesmo disco ocupam menos espaço do que instantâneos completos e podem ser diferenciados.	Bool
networkAccessPolicy	Política para acessar o disco por meio da rede.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	O tipo de sistema operacional.	'Linux' 'Windows'
publicNetworkAccess	Política para controlar a exportação no disco.	'Desabilitado' 'Habilitado'
purchasePlan	Informações do plano de compra para a imagem da qual o disco de origem para o instantâneo foi criado originalmente.	PurchasePlan
securityProfile	Contém as informações relacionadas à segurança do recurso.	DiskSecurityProfile
supportedCapabilities	Lista de recursos com suporte para a imagem da qual o disco de origem do instantâneo foi criado originalmente.	supportedCapabilities
supportsHibernation	Indica que o sistema operacional em um instantâneo dá suporte à hibernação.	Bool

CopyCompletionError

Nome	Descrição	Valor
errorCode	Indica o código de erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	'CopySourceNotFound' (obrigatório)
errorMessage	Indica a mensagem de erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	cadeia de caracteres (obrigatório)

CreationData

Nome	Descrição	Valor
createOption	Isso enumera as possíveis fontes da criação de um disco.	'Anexar' 'Copiar' 'CopyStart' 'Vazio' 'FromImage' 'Importar' 'ImportSecure' 'Restaurar' 'Carregar' 'UploadPreparedSecure' (obrigatório)
galleryImageReference	Necessário se for criado a partir de uma Imagem da Galeria. A id/sharedGalleryImageId/communityGalleryImageId do ImageDiskReference será a ID do ARM da versão de imagem de galeria compartilhada da qual criar um disco.	ImageDiskReference
imageReference	Informações de origem do disco para pir ou imagens de usuário.	ImageDiskReference
logicalSectorSize	Tamanho do setor lógico em bytes para discos Ultra. Os valores com suporte são 512 ad 4096. 4096 é o padrão.	int
securityDataUri	Se createOption for ImportSecure, esse será o URI de um blob a ser importado para o estado convidado da VM.	corda
sourceResourceId	Se createOption for Copy, essa será a ID do ARM do instantâneo ou disco de origem.	corda
sourceUri	Se createOption for Import, esse será o URI de um blob a ser importado para um disco gerenciado.	corda
storageAccountId	Necessário se createOption for Import. O identificador do Azure Resource Manager da conta de armazenamento que contém o blob a ser importado como um disco.	corda
uploadSizeBytes	Se createOption for Upload, esse será o tamanho do conteúdo do upload, incluindo o rodapé do VHD. Esse valor deve estar entre 20972032 (20 MiB + 512 bytes para o rodapé VHD) e 35183298347520 bytes (32 TiB + 512 bytes para o rodapé VHD).	int

ImageDiskReference

Nome	Descrição	Valor
communityGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure da comunidade.	corda
id	Um uri relativo que contém um Repositório de Imagens de Plataforma, uma imagem de usuário ou uma referência de imagem da Galeria de Computação do Azure.	corda
Lun	Se o disco for criado a partir do disco de dados de uma imagem, esse será um índice que indica qual dos discos de dados na imagem será usado. Para discos do sistema operacional, esse campo é nulo.	int
sharedGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure compartilhada direta.	corda

Encriptação

Nome	Descrição	Valor
diskEncryptionSetId	ResourceId do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.	corda
tipo	O tipo de chave usado para criptografar os dados do disco.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nome	Descrição	Valor
Habilitado	Defina esse sinalizador como true e forneça DiskEncryptionKey e KeyEncryptionKey opcional para habilitar a criptografia. Defina esse sinalizador como false e remova DiskEncryptionKey e KeyEncryptionKey para desabilitar a criptografia. Se EncryptionSettings for nulo no objeto de solicitação, as configurações existentes permanecerão inalteradas.	bool (obrigatório)
encryptionSettings	Uma coleção de configurações de criptografia, uma para cada volume de disco.	EncryptionSettingsElement[]
encryptionSettingsVersion	Descreve que tipo de criptografia é usado para os discos. Depois que esse campo for definido, ele não poderá ser substituído. '1.0' corresponde ao Azure Disk Encryption com o aplicativo AAD.'1.1' corresponde ao Azure Disk Encryption.	corda

EncryptionSettingsElement

Nome	Descrição	Valor
diskEncryptionKey	Url secreta do Key Vault e id do cofre da chave de criptografia de disco	KeyVaultAndSecretReference
keyEncryptionKey	Url da Chave do Key Vault e id do cofre da chave de criptografia de chave. KeyEncryptionKey é opcional e quando fornecido é usado para desembrulhar a chave de criptografia de disco.	KeyVaultAndKeyReference

KeyVaultAndSecretReference

Nome	Descrição	Valor
secretUrl	Url apontando para uma chave ou segredo no KeyVault	cadeia de caracteres (obrigatório)
sourceVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

SourceVault

Nome	Descrição	Valor
id	ID do recurso	corda

KeyVaultAndKeyReference

Nome	Descrição	Valor
keyUrl	Url apontando para uma chave ou segredo no KeyVault	cadeia de caracteres (obrigatório)
sourceVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

PurchasePlan

Nome	Descrição	Valor
nome	A ID do plano.	cadeia de caracteres (obrigatório)
produto	Especifica o produto da imagem do marketplace. Esse é o mesmo valor que Offer no elemento imageReference.	cadeia de caracteres (obrigatório)
promotionCode	O código de promoção da oferta.	corda
editor	A ID do editor.	cadeia de caracteres (obrigatório)

DiskSecurityProfile

Nome	Descrição	Valor
secureVMDiskEncryptionSetId	ResourceId do conjunto de criptografia de disco associado ao disco com suporte de VM confidencial criptografado com chave gerenciada pelo cliente	corda
securityType	Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

SupportedCapabilities

Nome	Descrição	Valor
acceleratedNetwork	True se a imagem da qual o disco do sistema operacional é criado dá suporte à rede acelerada.	Bool
arquitetura	Arquitetura de CPU compatível com um disco do sistema operacional.	'Arm64' 'x64'

SnapshotSku

Nome	Descrição	Valor
nome	O nome do sku.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

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

O tipo de recurso de instantâneos 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/snapshots, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2022-03-02"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "CopySourceNotFound"
        errorMessage = "string"
      }
      creationData = {
        createOption = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        securityDataUri = "string"
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      dataAccessAuthMode = "string"
      diskAccessId = "string"
      diskSizeGB = int
      encryption = {
        diskEncryptionSetId = "string"
        type = "string"
      }
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
        encryptionSettingsVersion = "string"
      }
      hyperVGeneration = "string"
      incremental = bool
      networkAccessPolicy = "string"
      osType = "string"
      publicNetworkAccess = "string"
      purchasePlan = {
        name = "string"
        product = "string"
        promotionCode = "string"
        publisher = "string"
      }
      securityProfile = {
        secureVMDiskEncryptionSetId = "string"
        securityType = "string"
      }
      supportedCapabilities = {
        acceleratedNetwork = bool
        architecture = "string"
      }
      supportsHibernation = bool
    }
    sku = {
      name = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Valores de propriedade

Instantâneos

Nome	Descrição	Valor
tipo	O tipo de recurso	"Microsoft.Compute/snapshots@2022-03-02"
nome	O nome do recurso	cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 80 Caracteres válidos: Alfanuméricos, sublinhados, períodos e hifens. Comece com alfanumérico. Termine com alfanumérico ou sublinhado.
localização	Local do recurso	cadeia de caracteres (obrigatório)
parent_id	Para implantar em um grupo de recursos, use a ID desse grupo de recursos.	cadeia de caracteres (obrigatório)
Tags	Marcas de recurso	Dicionário de nomes e valores de marca.
Sku	O nome do sku de instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. Esse é um parâmetro opcional para instantâneo incremental e o comportamento padrão é que o SKU será definido como o mesmo sku do instantâneo anterior	SnapshotSku
extendedLocation	O local estendido onde o instantâneo será criado. O local estendido não pode ser alterado.	ExtendedLocation
Propriedades	Propriedades do recurso de instantâneo.	SnapshotProperties

ExtendedLocation

Nome	Descrição	Valor
nome	O nome do local estendido.	corda
tipo	O tipo do local estendido.	"EdgeZone"

SnapshotProperties

Nome	Descrição	Valor
completionPercent	Porcentagem concluída para a cópia em segundo plano quando um recurso é criado por meio da operação CopyStart.	int
copyCompletionError	Indica os detalhes do erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	CopyCompletionError
creationData	Informações de origem do disco. As informações de CreationData não podem ser alteradas após a criação do disco.	CreationData (obrigatório)
dataAccessAuthMode	Requisitos de autenticação adicionais ao exportar ou carregar em um disco ou instantâneo.	"AzureActiveDirectory" "Nenhum"
diskAccessId	ID do ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.	corda
diskSizeGB	Se creationData.createOption estiver Vazio, esse campo será obrigatório e indicará o tamanho do disco a ser criado. Se esse campo estiver presente para atualizações ou criação com outras opções, ele indicará um redimensionamento. Os redimensionamentos só serão permitidos se o disco não estiver anexado a uma VM em execução e só puderem aumentar o tamanho do disco.	int
encriptação	A propriedade de criptografia pode ser usada para criptografar dados em repouso com chaves gerenciadas pelo cliente ou chaves gerenciadas pela plataforma.	Encryption
encryptionSettingsCollection	A coleção de configurações de criptografia usada é a Criptografia de Disco do Azure, pode conter várias configurações de criptografia por disco ou instantâneo.	EncryptionSettingsCollection
hyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.	"V1" "V2"
incremental	Se um instantâneo é incremental. Instantâneos incrementais no mesmo disco ocupam menos espaço do que instantâneos completos e podem ser diferenciados.	Bool
networkAccessPolicy	Política para acessar o disco por meio da rede.	"AllowAll" "AllowPrivate" "DenyAll"
osType	O tipo de sistema operacional.	"Linux" "Windows"
publicNetworkAccess	Política para controlar a exportação no disco.	"Desabilitado" "Habilitado"
purchasePlan	Informações do plano de compra para a imagem da qual o disco de origem para o instantâneo foi criado originalmente.	PurchasePlan
securityProfile	Contém as informações relacionadas à segurança do recurso.	DiskSecurityProfile
supportedCapabilities	Lista de recursos com suporte para a imagem da qual o disco de origem do instantâneo foi criado originalmente.	supportedCapabilities
supportsHibernation	Indica que o sistema operacional em um instantâneo dá suporte à hibernação.	Bool

CopyCompletionError

Nome	Descrição	Valor
errorCode	Indica o código de erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	"CopySourceNotFound" (obrigatório)
errorMessage	Indica a mensagem de erro se a cópia em segundo plano de um recurso criado por meio da operação CopyStart falhar.	cadeia de caracteres (obrigatório)

CreationData

Nome	Descrição	Valor
createOption	Isso enumera as possíveis fontes da criação de um disco.	"Anexar" "Copiar" "CopyStart" "Vazio" "FromImage" "Importar" "ImportSecure" "Restaurar" "Carregar" "UploadPreparedSecure" (obrigatório)
galleryImageReference	Necessário se for criado a partir de uma Imagem da Galeria. A id/sharedGalleryImageId/communityGalleryImageId do ImageDiskReference será a ID do ARM da versão de imagem de galeria compartilhada da qual criar um disco.	ImageDiskReference
imageReference	Informações de origem do disco para pir ou imagens de usuário.	ImageDiskReference
logicalSectorSize	Tamanho do setor lógico em bytes para discos Ultra. Os valores com suporte são 512 ad 4096. 4096 é o padrão.	int
securityDataUri	Se createOption for ImportSecure, esse será o URI de um blob a ser importado para o estado convidado da VM.	corda
sourceResourceId	Se createOption for Copy, essa será a ID do ARM do instantâneo ou disco de origem.	corda
sourceUri	Se createOption for Import, esse será o URI de um blob a ser importado para um disco gerenciado.	corda
storageAccountId	Necessário se createOption for Import. O identificador do Azure Resource Manager da conta de armazenamento que contém o blob a ser importado como um disco.	corda
uploadSizeBytes	Se createOption for Upload, esse será o tamanho do conteúdo do upload, incluindo o rodapé do VHD. Esse valor deve estar entre 20972032 (20 MiB + 512 bytes para o rodapé VHD) e 35183298347520 bytes (32 TiB + 512 bytes para o rodapé VHD).	int

ImageDiskReference

Nome	Descrição	Valor
communityGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure da comunidade.	corda
id	Um uri relativo que contém um Repositório de Imagens de Plataforma, uma imagem de usuário ou uma referência de imagem da Galeria de Computação do Azure.	corda
Lun	Se o disco for criado a partir do disco de dados de uma imagem, esse será um índice que indica qual dos discos de dados na imagem será usado. Para discos do sistema operacional, esse campo é nulo.	int
sharedGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure compartilhada direta.	corda

Encriptação

Nome	Descrição	Valor
diskEncryptionSetId	ResourceId do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.	corda
tipo	O tipo de chave usado para criptografar os dados do disco.	"EncryptionAtRestWithCustomerKey" "EncryptionAtRestWithPlatformAndCustomerKeys" "EncryptionAtRestWithPlatformKey"

EncryptionSettingsCollection

Nome	Descrição	Valor
Habilitado	Defina esse sinalizador como true e forneça DiskEncryptionKey e KeyEncryptionKey opcional para habilitar a criptografia. Defina esse sinalizador como false e remova DiskEncryptionKey e KeyEncryptionKey para desabilitar a criptografia. Se EncryptionSettings for nulo no objeto de solicitação, as configurações existentes permanecerão inalteradas.	bool (obrigatório)
encryptionSettings	Uma coleção de configurações de criptografia, uma para cada volume de disco.	EncryptionSettingsElement[]
encryptionSettingsVersion	Descreve que tipo de criptografia é usado para os discos. Depois que esse campo for definido, ele não poderá ser substituído. '1.0' corresponde ao Azure Disk Encryption com o aplicativo AAD.'1.1' corresponde ao Azure Disk Encryption.	corda

EncryptionSettingsElement

Nome	Descrição	Valor
diskEncryptionKey	Url secreta do Key Vault e id do cofre da chave de criptografia de disco	KeyVaultAndSecretReference
keyEncryptionKey	Url da Chave do Key Vault e id do cofre da chave de criptografia de chave. KeyEncryptionKey é opcional e quando fornecido é usado para desembrulhar a chave de criptografia de disco.	KeyVaultAndKeyReference

KeyVaultAndSecretReference

Nome	Descrição	Valor
secretUrl	Url apontando para uma chave ou segredo no KeyVault	cadeia de caracteres (obrigatório)
sourceVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

SourceVault

Nome	Descrição	Valor
id	ID do recurso	corda

KeyVaultAndKeyReference

Nome	Descrição	Valor
keyUrl	Url apontando para uma chave ou segredo no KeyVault	cadeia de caracteres (obrigatório)
sourceVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

PurchasePlan

Nome	Descrição	Valor
nome	A ID do plano.	cadeia de caracteres (obrigatório)
produto	Especifica o produto da imagem do marketplace. Esse é o mesmo valor que Offer no elemento imageReference.	cadeia de caracteres (obrigatório)
promotionCode	O código de promoção da oferta.	corda
editor	A ID do editor.	cadeia de caracteres (obrigatório)

DiskSecurityProfile

Nome	Descrição	Valor
secureVMDiskEncryptionSetId	ResourceId do conjunto de criptografia de disco associado ao disco com suporte de VM confidencial criptografado com chave gerenciada pelo cliente	corda
securityType	Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.	"ConfidentialVM_DiskEncryptedWithCustomerKey" "ConfidentialVM_DiskEncryptedWithPlatformKey" "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey" "TrustedLaunch"

SupportedCapabilities

Nome	Descrição	Valor
acceleratedNetwork	True se a imagem da qual o disco do sistema operacional é criado dá suporte à rede acelerada.	Bool
arquitetura	Arquitetura de CPU compatível com um disco do sistema operacional.	"Arm64" "x64"

SnapshotSku

Nome	Descrição	Valor
nome	O nome do sku.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

Compartilhar via

Instantâneos do Microsoft.Compute 2022-03-02

Definição de recurso do Bicep

Formato de recurso

Valores de propriedade

Instantâneos

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

Encriptação

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Definição de recurso de modelo do ARM

Formato de recurso

Valores de propriedade

Instantâneos

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

Encriptação

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

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

Formato de recurso

Valores de propriedade

Instantâneos

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

Encriptação

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Comentários

Recursos adicionais