Instantâneos Microsoft.Compute 2023-04-02

• Últimas
• 2024-03-02
• 2023-10-02
• 2023-04-02
• 2023-01-02
• 2022-07-02
• 2022-03-02
• 2021-12-01
• 2021-08-01
• 2021-04-01
• 2020-12-01
• 2020-09-30
• 2020-06-30
• 2020-05-01
• 2019-11-01
• 2019-07-01
• 2019-03-01
• 2018-09-30
• 2018-06-01
• 2018-04-01
• 2017-03-30
• 2016-04-30-preview

Definição de recursos do bíceps

O tipo de recurso de instantâneos pode ser implantado com operações que visam:

• Grupos de recursos - Consulte comandos de implantação de grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/snapshots, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Compute/snapshots@2023-04-02' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'string'
      errorMessage: 'string'
    }
    creationData: {
      createOption: 'string'
      elasticSanResourceId: 'string'
      galleryImageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      imageReference: {
        communityGalleryImageId: 'string'
        id: 'string'
        lun: int
        sharedGalleryImageId: 'string'
      }
      logicalSectorSize: int
      performancePlus: bool
      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'
      diskControllerTypes: 'string'
    }
    supportsHibernation: bool
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

CopyCompletionError

Designação	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.	string (obrigatório)

CriaçãoData

Designação	Descrição	Valor
createOption	Isso enumera as possíveis fontes de criação de um disco.	«Anexar» 'Copiar' 'CopyFromSanSnapshot' 'CopyStart' 'Vazio' 'FromImage' 'Importação' 'ImportSecure' 'Restaurar' 'Carregar' 'UploadPreparedSecure' (obrigatório)
elasticSanResourceId	Obrigatório se createOption for CopyFromSanSnapshot. Este é o ID ARM do instantâneo de volume do san elástico de origem.	string
galeriaImagemReferência	Obrigatório se criar a partir de uma imagem da Galeria. O id/sharedGalleryImageId/communityGalleryImageId do ImageDiskReference será o id ARM da versão da imagem de galé compartilhada a partir da qual criar um disco.	ImageDiskReference
imageReference	Informações de origem do disco para PIR ou imagens do usuário.	ImageDiskReference
logicalSectorSize	Tamanho do setor lógico em bytes para discos Ultra. Os valores suportados são 512 ad 4096. 4096 é o padrão.	Int
desempenhoPlus	Defina esse sinalizador como true para obter um aumento na meta de desempenho do disco implantado, veja aqui a respetiva meta de desempenho. Este sinalizador só pode ser definido no tempo de criação do disco e não pode ser desativado depois de ativado.	Bool
securityDataUri	Se createOption for ImportSecure, este é o URI de um blob a ser importado para o estado convidado da VM.	string
sourceResourceId	Se createOption for Copy, esta é a ID ARM do snapshot ou disco de origem.	string
fonteUri	Se createOption for Import, este é o URI de um blob a ser importado para um disco gerenciado.	string
storageAccountId	Obrigató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.	string
uploadSizeBytes	Se createOption for Upload, este é o tamanho do conteúdo do upload, incluindo o rodapé 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

DiskSecurityProfile

Designação	Descrição	Valor
secureVMDiskEncryptionSetId	ResourceId do conjunto de criptografia de disco associado ao disco suportado por VM confidencial criptografado com chave gerenciada pelo cliente	string
securityType [en]	Especifica o SecurityType da VM. Aplicável apenas a discos do SO.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'Lançamento confiável'

Encriptação

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

EncryptionSettingsCollection

Designação	Descrição	Valor
ativado	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 null no objeto request, as configurações existentes permanecerão inalteradas.	bool (obrigatório)
criptografiaConfigurações	Uma coleção de configurações de criptografia, uma para cada volume de disco.	EncryptionSettingsElement[]
encryptionSettingsVersion	Descreve o tipo de criptografia usado para os discos. Uma vez que este campo é definido, ele não pode ser substituído. '1.0' corresponde ao aplicativo Azure Disk Encryption with AAD.'1.1' corresponde ao Azure Disk Encryption.	string

EncryptionSettingsElement

Designação	Descrição	Valor
diskEncryptionKey	URL secreto do cofre da chave e ID do cofre da chave de encriptação do disco	KeyVaultAndSecretReference
chaveEncryptionKey	URL da chave do cofre e ID do cofre da chave de encriptação da chave. KeyEncryptionKey é opcional e, quando fornecido, é usado para desembrulhar a chave de criptografia do disco.	KeyVaultAndKeyReference

Localização Estendida

Designação	Descrição	Valor
Designação	O nome do local estendido.	string
tipo	O tipo de local estendido.	'EdgeZone'

ImageDiskReference

Designação	Descrição	Valor
comunidadeGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure da comunidade.	string
ID	Um uri relativo que contém um repositório de imagens da plataforma, uma imagem do usuário ou uma referência de imagem da Galeria de Computação do Azure.	string
LUN	Se o disco for criado a partir do disco de dados de uma imagem, este é um índice que indica qual dos discos de dados na imagem deve ser usado. Para discos do SO, este campo é null.	Int
sharedGalleryImageId	Um uri relativo que contém uma referência de imagem compartilhada direta da Galeria de Computação do Azure.	string

KeyVaultAndKeyReference

Designação	Descrição	Valor
keyUrl	URL apontando para uma chave ou segredo no KeyVault	string (obrigatório)
fonteVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

KeyVaultAndSecretReference

Designação	Descrição	Valor
secretUrl	URL apontando para uma chave ou segredo no KeyVault	string (obrigatório)
fonteVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

Microsoft.Compute/snapshots

Designação	Descrição	Valor
extendedLocalização	O local estendido onde o instantâneo será criado. O local estendido não pode ser alterado.	ExtendedLocation
Localização	Localização do recurso	string (obrigatório)
Designação	O nome do recurso	string (obrigatório)
propriedades	Propriedades do recurso de instantâneo.	SnapshotProperties
SKU	O nome do sku dos instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. Este é um parâmetro opcional para instantâneo incremental e o comportamento padrão é que o SKU será definido como o mesmo sku que o instantâneo anterior	SnapshotSku
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos

Plano de Compra

Designação	Descrição	Valor
Designação	O ID do plano.	string (obrigatório)
produto	Especifica o produto da imagem do mercado. Este é o mesmo valor que Offer sob o elemento imageReference.	string (obrigatório)
Código promocional	O código promocional da oferta.	string
editora	O ID do editor.	string (obrigatório)

Tags de Recursos

Designação	Descrição	Valor

SnapshotProperties

Designação	Descrição	Valor
conclusãoPorcentagem	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
criaçãoDados	Informações sobre a 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 para um disco ou instantâneo.	'AzureActiveDirectory' 'Nenhuma'
diskAccessId	ID ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.	string
diskSizeGB	Se creationData.createOption estiver vazio, este campo é obrigatório e indica o tamanho do disco a ser criado. Se este campo estiver presente para atualizações ou criação com outras opções, indica um redimensionamento. Os redimensionamentos só são permitidos se o disco não estiver conectado a uma VM em execução e só podem 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.	Criptografia
encryptionSettingsCollection	A coleção de configurações de criptografia usada como Criptografia de Disco do Azure pode conter várias configurações de criptografia por disco ou instantâneo.	EncryptionSettingsCollection
hiperVGeneração	A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.	«V1» «V2»
incremental	Se um snapshot é incremental. Os snapshots incrementais no mesmo disco ocupam menos espaço do que os snapshots completos e podem ser diferidos.	Bool
networkAccessPolicy	Política para aceder ao disco através da rede.	'Permitir' 'AllowPrivate' 'DenyAll'
osType	O tipo de sistema operacional.	'Linux' 'Janelas'
publicNetworkAccess	Política para controlar a exportação no disco.	'Desativado' 'Habilitado'
purchasePlan	Informações do plano de compra para a imagem a partir da qual o disco de origem para o snapshot foi originalmente criado.	PurchasePlan
perfil de segurança	Contém as informações relacionadas à segurança do recurso.	DiskSecurityProfile
supportedCapabilities	Lista de recursos suportados para a imagem a partir da qual o disco de origem do snapshot foi originalmente criado.	SupportedCapabilities
suportesHibernação	Indica que o sistema operacional em um instantâneo suporta hibernação.	Bool

SnapshotSku

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

SourceVault

Designação	Descrição	Valor
ID	ID do recurso	string

SupportedCapabilities

Designação	Descrição	Valor
aceleradoRede acelerada	True se a imagem a partir da qual o disco do SO é criado suportar redes aceleradas.	Bool
Arquitetura	Arquitetura de CPU suportada por um disco do sistema operacional.	«Arm64» 'x64'
diskControllerTypes	Os controladores de disco suportados por um disco do SO. Se definido, pode ser SCSI ou SCSI, NVME ou NVME, SCSI.	string

Definição de recurso de modelo ARM

O tipo de recurso de instantâneos pode ser implantado com operações que visam:

• Grupos de recursos - Consulte comandos de implantação de grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/snapshots, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2023-04-02",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "string",
      "errorMessage": "string"
    },
    "creationData": {
      "createOption": "string",
      "elasticSanResourceId": "string",
      "galleryImageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "imageReference": {
        "communityGalleryImageId": "string",
        "id": "string",
        "lun": "int",
        "sharedGalleryImageId": "string"
      },
      "logicalSectorSize": "int",
      "performancePlus": "bool",
      "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",
      "diskControllerTypes": "string"
    },
    "supportsHibernation": "bool"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

CopyCompletionError

Designação	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.	string (obrigatório)

CriaçãoData

Designação	Descrição	Valor
createOption	Isso enumera as possíveis fontes de criação de um disco.	«Anexar» 'Copiar' 'CopyFromSanSnapshot' 'CopyStart' 'Vazio' 'FromImage' 'Importação' 'ImportSecure' 'Restaurar' 'Carregar' 'UploadPreparedSecure' (obrigatório)
elasticSanResourceId	Obrigatório se createOption for CopyFromSanSnapshot. Este é o ID ARM do instantâneo de volume do san elástico de origem.	string
galeriaImagemReferência	Obrigatório se criar a partir de uma imagem da Galeria. O id/sharedGalleryImageId/communityGalleryImageId do ImageDiskReference será o id ARM da versão da imagem de galé compartilhada a partir da qual criar um disco.	ImageDiskReference
imageReference	Informações de origem do disco para PIR ou imagens do usuário.	ImageDiskReference
logicalSectorSize	Tamanho do setor lógico em bytes para discos Ultra. Os valores suportados são 512 ad 4096. 4096 é o padrão.	Int
desempenhoPlus	Defina esse sinalizador como true para obter um aumento na meta de desempenho do disco implantado, veja aqui a respetiva meta de desempenho. Este sinalizador só pode ser definido no tempo de criação do disco e não pode ser desativado depois de ativado.	Bool
securityDataUri	Se createOption for ImportSecure, este é o URI de um blob a ser importado para o estado convidado da VM.	string
sourceResourceId	Se createOption for Copy, esta é a ID ARM do snapshot ou disco de origem.	string
fonteUri	Se createOption for Import, este é o URI de um blob a ser importado para um disco gerenciado.	string
storageAccountId	Obrigató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.	string
uploadSizeBytes	Se createOption for Upload, este é o tamanho do conteúdo do upload, incluindo o rodapé 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

DiskSecurityProfile

Designação	Descrição	Valor
secureVMDiskEncryptionSetId	ResourceId do conjunto de criptografia de disco associado ao disco suportado por VM confidencial criptografado com chave gerenciada pelo cliente	string
securityType [en]	Especifica o SecurityType da VM. Aplicável apenas a discos do SO.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'Lançamento confiável'

Encriptação

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

EncryptionSettingsCollection

Designação	Descrição	Valor
ativado	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 null no objeto request, as configurações existentes permanecerão inalteradas.	bool (obrigatório)
criptografiaConfigurações	Uma coleção de configurações de criptografia, uma para cada volume de disco.	EncryptionSettingsElement[]
encryptionSettingsVersion	Descreve o tipo de criptografia usado para os discos. Uma vez que este campo é definido, ele não pode ser substituído. '1.0' corresponde ao aplicativo Azure Disk Encryption with AAD.'1.1' corresponde ao Azure Disk Encryption.	string

EncryptionSettingsElement

Designação	Descrição	Valor
diskEncryptionKey	URL secreto do cofre da chave e ID do cofre da chave de encriptação do disco	KeyVaultAndSecretReference
chaveEncryptionKey	URL da chave do cofre e ID do cofre da chave de encriptação da chave. KeyEncryptionKey é opcional e, quando fornecido, é usado para desembrulhar a chave de criptografia do disco.	KeyVaultAndKeyReference

Localização Estendida

Designação	Descrição	Valor
Designação	O nome do local estendido.	string
tipo	O tipo de local estendido.	'EdgeZone'

ImageDiskReference

Designação	Descrição	Valor
comunidadeGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure da comunidade.	string
ID	Um uri relativo que contém um repositório de imagens da plataforma, uma imagem do usuário ou uma referência de imagem da Galeria de Computação do Azure.	string
LUN	Se o disco for criado a partir do disco de dados de uma imagem, este é um índice que indica qual dos discos de dados na imagem deve ser usado. Para discos do SO, este campo é null.	Int
sharedGalleryImageId	Um uri relativo que contém uma referência de imagem compartilhada direta da Galeria de Computação do Azure.	string

KeyVaultAndKeyReference

Designação	Descrição	Valor
keyUrl	URL apontando para uma chave ou segredo no KeyVault	string (obrigatório)
fonteVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

KeyVaultAndSecretReference

Designação	Descrição	Valor
secretUrl	URL apontando para uma chave ou segredo no KeyVault	string (obrigatório)
fonteVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

Microsoft.Compute/snapshots

Designação	Descrição	Valor
apiVersion	A versão api	'2023-04-02'
extendedLocalização	O local estendido onde o instantâneo será criado. O local estendido não pode ser alterado.	ExtendedLocation
Localização	Localização do recurso	string (obrigatório)
Designação	O nome do recurso	string (obrigatório)
propriedades	Propriedades do recurso de instantâneo.	SnapshotProperties
SKU	O nome do sku dos instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. Este é um parâmetro opcional para instantâneo incremental e o comportamento padrão é que o SKU será definido como o mesmo sku que o instantâneo anterior	SnapshotSku
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo	O tipo de recurso	'Microsoft.Compute/snapshots'

Plano de Compra

Designação	Descrição	Valor
Designação	O ID do plano.	string (obrigatório)
produto	Especifica o produto da imagem do mercado. Este é o mesmo valor que Offer sob o elemento imageReference.	string (obrigatório)
Código promocional	O código promocional da oferta.	string
editora	O ID do editor.	string (obrigatório)

Tags de Recursos

Designação	Descrição	Valor

SnapshotProperties

Designação	Descrição	Valor
conclusãoPorcentagem	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
criaçãoDados	Informações sobre a 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 para um disco ou instantâneo.	'AzureActiveDirectory' 'Nenhuma'
diskAccessId	ID ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.	string
diskSizeGB	Se creationData.createOption estiver vazio, este campo é obrigatório e indica o tamanho do disco a ser criado. Se este campo estiver presente para atualizações ou criação com outras opções, indica um redimensionamento. Os redimensionamentos só são permitidos se o disco não estiver conectado a uma VM em execução e só podem 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.	Criptografia
encryptionSettingsCollection	A coleção de configurações de criptografia usada como Criptografia de Disco do Azure pode conter várias configurações de criptografia por disco ou instantâneo.	EncryptionSettingsCollection
hiperVGeneração	A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.	«V1» «V2»
incremental	Se um snapshot é incremental. Os snapshots incrementais no mesmo disco ocupam menos espaço do que os snapshots completos e podem ser diferidos.	Bool
networkAccessPolicy	Política para aceder ao disco através da rede.	'Permitir' 'AllowPrivate' 'DenyAll'
osType	O tipo de sistema operacional.	'Linux' 'Janelas'
publicNetworkAccess	Política para controlar a exportação no disco.	'Desativado' 'Habilitado'
purchasePlan	Informações do plano de compra para a imagem a partir da qual o disco de origem para o snapshot foi originalmente criado.	PurchasePlan
perfil de segurança	Contém as informações relacionadas à segurança do recurso.	DiskSecurityProfile
supportedCapabilities	Lista de recursos suportados para a imagem a partir da qual o disco de origem do snapshot foi originalmente criado.	SupportedCapabilities
suportesHibernação	Indica que o sistema operacional em um instantâneo suporta hibernação.	Bool

SnapshotSku

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

SourceVault

Designação	Descrição	Valor
ID	ID do recurso	string

SupportedCapabilities

Designação	Descrição	Valor
aceleradoRede acelerada	True se a imagem a partir da qual o disco do SO é criado suportar redes aceleradas.	Bool
Arquitetura	Arquitetura de CPU suportada por um disco do sistema operacional.	«Arm64» 'x64'
diskControllerTypes	Os controladores de disco suportados por um disco do SO. Se definido, pode ser SCSI ou SCSI, NVME ou NVME, SCSI.	string

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de instantâneos pode ser implantado com operações que visam:

• Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Compute/snapshots, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2023-04-02"
  name = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "string"
        errorMessage = "string"
      }
      creationData = {
        createOption = "string"
        elasticSanResourceId = "string"
        galleryImageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        imageReference = {
          communityGalleryImageId = "string"
          id = "string"
          lun = int
          sharedGalleryImageId = "string"
        }
        logicalSectorSize = int
        performancePlus = bool
        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"
        diskControllerTypes = "string"
      }
      supportsHibernation = bool
    }
  })
}

Valores de propriedade

CopyCompletionError

Designação	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.	string (obrigatório)

CriaçãoData

Designação	Descrição	Valor
createOption	Isso enumera as possíveis fontes de criação de um disco.	«Anexar» 'Copiar' 'CopyFromSanSnapshot' 'CopyStart' 'Vazio' 'FromImage' 'Importação' 'ImportSecure' 'Restaurar' 'Carregar' 'UploadPreparedSecure' (obrigatório)
elasticSanResourceId	Obrigatório se createOption for CopyFromSanSnapshot. Este é o ID ARM do instantâneo de volume do san elástico de origem.	string
galeriaImagemReferência	Obrigatório se criar a partir de uma imagem da Galeria. O id/sharedGalleryImageId/communityGalleryImageId do ImageDiskReference será o id ARM da versão da imagem de galé compartilhada a partir da qual criar um disco.	ImageDiskReference
imageReference	Informações de origem do disco para PIR ou imagens do usuário.	ImageDiskReference
logicalSectorSize	Tamanho do setor lógico em bytes para discos Ultra. Os valores suportados são 512 ad 4096. 4096 é o padrão.	Int
desempenhoPlus	Defina esse sinalizador como true para obter um aumento na meta de desempenho do disco implantado, veja aqui a respetiva meta de desempenho. Este sinalizador só pode ser definido no tempo de criação do disco e não pode ser desativado depois de ativado.	Bool
securityDataUri	Se createOption for ImportSecure, este é o URI de um blob a ser importado para o estado convidado da VM.	string
sourceResourceId	Se createOption for Copy, esta é a ID ARM do snapshot ou disco de origem.	string
fonteUri	Se createOption for Import, este é o URI de um blob a ser importado para um disco gerenciado.	string
storageAccountId	Obrigató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.	string
uploadSizeBytes	Se createOption for Upload, este é o tamanho do conteúdo do upload, incluindo o rodapé 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

DiskSecurityProfile

Designação	Descrição	Valor
secureVMDiskEncryptionSetId	ResourceId do conjunto de criptografia de disco associado ao disco suportado por VM confidencial criptografado com chave gerenciada pelo cliente	string
securityType [en]	Especifica o SecurityType da VM. Aplicável apenas a discos do SO.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'Lançamento confiável'

Encriptação

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

EncryptionSettingsCollection

Designação	Descrição	Valor
ativado	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 null no objeto request, as configurações existentes permanecerão inalteradas.	bool (obrigatório)
criptografiaConfigurações	Uma coleção de configurações de criptografia, uma para cada volume de disco.	EncryptionSettingsElement[]
encryptionSettingsVersion	Descreve o tipo de criptografia usado para os discos. Uma vez que este campo é definido, ele não pode ser substituído. '1.0' corresponde ao aplicativo Azure Disk Encryption with AAD.'1.1' corresponde ao Azure Disk Encryption.	string

EncryptionSettingsElement

Designação	Descrição	Valor
diskEncryptionKey	URL secreto do cofre da chave e ID do cofre da chave de encriptação do disco	KeyVaultAndSecretReference
chaveEncryptionKey	URL da chave do cofre e ID do cofre da chave de encriptação da chave. KeyEncryptionKey é opcional e, quando fornecido, é usado para desembrulhar a chave de criptografia do disco.	KeyVaultAndKeyReference

Localização Estendida

Designação	Descrição	Valor
Designação	O nome do local estendido.	string
tipo	O tipo de local estendido.	'EdgeZone'

ImageDiskReference

Designação	Descrição	Valor
comunidadeGalleryImageId	Um uri relativo que contém uma referência de imagem da Galeria de Computação do Azure da comunidade.	string
ID	Um uri relativo que contém um repositório de imagens da plataforma, uma imagem do usuário ou uma referência de imagem da Galeria de Computação do Azure.	string
LUN	Se o disco for criado a partir do disco de dados de uma imagem, este é um índice que indica qual dos discos de dados na imagem deve ser usado. Para discos do SO, este campo é null.	Int
sharedGalleryImageId	Um uri relativo que contém uma referência de imagem compartilhada direta da Galeria de Computação do Azure.	string

KeyVaultAndKeyReference

Designação	Descrição	Valor
keyUrl	URL apontando para uma chave ou segredo no KeyVault	string (obrigatório)
fonteVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

KeyVaultAndSecretReference

Designação	Descrição	Valor
secretUrl	URL apontando para uma chave ou segredo no KeyVault	string (obrigatório)
fonteVault	ID do recurso do KeyVault que contém a chave ou o segredo	SourceVault (obrigatório)

Microsoft.Compute/snapshots

Designação	Descrição	Valor
extendedLocalização	O local estendido onde o instantâneo será criado. O local estendido não pode ser alterado.	ExtendedLocation
Localização	Localização do recurso	string (obrigatório)
Designação	O nome do recurso	string (obrigatório)
propriedades	Propriedades do recurso de instantâneo.	SnapshotProperties
SKU	O nome do sku dos instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. Este é um parâmetro opcional para instantâneo incremental e o comportamento padrão é que o SKU será definido como o mesmo sku que o instantâneo anterior	SnapshotSku
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags.
tipo	O tipo de recurso	"Microsoft.Compute/snapshots@2023-04-02"

Plano de Compra

Designação	Descrição	Valor
Designação	O ID do plano.	string (obrigatório)
produto	Especifica o produto da imagem do mercado. Este é o mesmo valor que Offer sob o elemento imageReference.	string (obrigatório)
Código promocional	O código promocional da oferta.	string
editora	O ID do editor.	string (obrigatório)

Tags de Recursos

Designação	Descrição	Valor

SnapshotProperties

Designação	Descrição	Valor
conclusãoPorcentagem	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
criaçãoDados	Informações sobre a 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 para um disco ou instantâneo.	'AzureActiveDirectory' 'Nenhuma'
diskAccessId	ID ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.	string
diskSizeGB	Se creationData.createOption estiver vazio, este campo é obrigatório e indica o tamanho do disco a ser criado. Se este campo estiver presente para atualizações ou criação com outras opções, indica um redimensionamento. Os redimensionamentos só são permitidos se o disco não estiver conectado a uma VM em execução e só podem 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.	Criptografia
encryptionSettingsCollection	A coleção de configurações de criptografia usada como Criptografia de Disco do Azure pode conter várias configurações de criptografia por disco ou instantâneo.	EncryptionSettingsCollection
hiperVGeneração	A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.	«V1» «V2»
incremental	Se um snapshot é incremental. Os snapshots incrementais no mesmo disco ocupam menos espaço do que os snapshots completos e podem ser diferidos.	Bool
networkAccessPolicy	Política para aceder ao disco através da rede.	'Permitir' 'AllowPrivate' 'DenyAll'
osType	O tipo de sistema operacional.	'Linux' 'Janelas'
publicNetworkAccess	Política para controlar a exportação no disco.	'Desativado' 'Habilitado'
purchasePlan	Informações do plano de compra para a imagem a partir da qual o disco de origem para o snapshot foi originalmente criado.	PurchasePlan
perfil de segurança	Contém as informações relacionadas à segurança do recurso.	DiskSecurityProfile
supportedCapabilities	Lista de recursos suportados para a imagem a partir da qual o disco de origem do snapshot foi originalmente criado.	SupportedCapabilities
suportesHibernação	Indica que o sistema operacional em um instantâneo suporta hibernação.	Bool

SnapshotSku

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

SourceVault

Designação	Descrição	Valor
ID	ID do recurso	string

SupportedCapabilities

Designação	Descrição	Valor
aceleradoRede acelerada	True se a imagem a partir da qual o disco do SO é criado suportar redes aceleradas.	Bool
Arquitetura	Arquitetura de CPU suportada por um disco do sistema operacional.	«Arm64» 'x64'
diskControllerTypes	Os controladores de disco suportados por um disco do SO. Se definido, pode ser SCSI ou SCSI, NVME ou NVME, SCSI.	string