Compartilhar via

Instantâneos do Microsoft.Compute 2020-05-01

  • Artigo

Definição de recurso do Bicep

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

resource symbolicname 'Microsoft.Compute/snapshots@2020-05-01' = {
  location: 'string'
  name: 'string'
  properties: {
    creationData: {
      createOption: 'string'
      galleryImageReference: {
        id: 'string'
        lun: int
      }
      imageReference: {
        id: 'string'
        lun: int
      }
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
      uploadSizeBytes: int
    }
    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'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores da propriedade

CreationData

Nome Descrição Valor
createOption Isso enumera as possíveis fontes da criação de um disco. 'Anexar'
'Copiar'
'Vazio'
'FromImage'
'Importar'
'Restaurar'
'Upload' (obrigatório)
galleryImageReference Necessário se for criado a partir de uma Imagem da Galeria. A ID 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. ImageDiskReference
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

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

ImageDiskReference

Nome Descrição Valor
id Um uri relativo que contém um Repositório de Imagens de Plataforma ou uma referência de imagem de usuário. cadeia de caracteres (obrigatório)
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

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)

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)

Microsoft.Compute/snapshots

Nome Descrição Valor
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades do recurso de instantâneo. SnapshotProperties
Sku O nome do sku de instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. SnapshotSku
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

ResourceTags

Nome Descrição Valor

SnapshotProperties

Nome Descrição Valor
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)
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'

SnapshotSku

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

SourceVault

Nome Descrição Valor
id ID do recurso corda

Definição de recurso de modelo do ARM

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

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2020-05-01",
  "name": "string",
  "location": "string",
  "properties": {
    "creationData": {
      "createOption": "string",
      "galleryImageReference": {
        "id": "string",
        "lun": "int"
      },
      "imageReference": {
        "id": "string",
        "lun": "int"
      },
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string",
      "uploadSizeBytes": "int"
    },
    "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"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores da propriedade

CreationData

Nome Descrição Valor
createOption Isso enumera as possíveis fontes da criação de um disco. 'Anexar'
'Copiar'
'Vazio'
'FromImage'
'Importar'
'Restaurar'
'Upload' (obrigatório)
galleryImageReference Necessário se for criado a partir de uma Imagem da Galeria. A ID 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. ImageDiskReference
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

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

ImageDiskReference

Nome Descrição Valor
id Um uri relativo que contém um Repositório de Imagens de Plataforma ou uma referência de imagem de usuário. cadeia de caracteres (obrigatório)
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

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)

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)

Microsoft.Compute/snapshots

Nome Descrição Valor
apiVersion A versão da API '2020-05-01'
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades do recurso de instantâneo. SnapshotProperties
Sku O nome do sku de instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. SnapshotSku
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Compute/snapshots'

ResourceTags

Nome Descrição Valor

SnapshotProperties

Nome Descrição Valor
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)
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'

SnapshotSku

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

SourceVault

Nome Descrição Valor
id ID do recurso corda

Exemplos de uso

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@2020-05-01"
  name = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      creationData = {
        createOption = "string"
        galleryImageReference = {
          id = "string"
          lun = int
        }
        imageReference = {
          id = "string"
          lun = int
        }
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
        uploadSizeBytes = int
      }
      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"
    }
  })
}

Valores da propriedade

CreationData

Nome Descrição Valor
createOption Isso enumera as possíveis fontes da criação de um disco. 'Anexar'
'Copiar'
'Vazio'
'FromImage'
'Importar'
'Restaurar'
'Upload' (obrigatório)
galleryImageReference Necessário se for criado a partir de uma Imagem da Galeria. A ID 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. ImageDiskReference
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

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

ImageDiskReference

Nome Descrição Valor
id Um uri relativo que contém um Repositório de Imagens de Plataforma ou uma referência de imagem de usuário. cadeia de caracteres (obrigatório)
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

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)

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)

Microsoft.Compute/snapshots

Nome Descrição Valor
localização Local do recurso cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades do recurso de instantâneo. SnapshotProperties
Sku O nome do sku de instantâneos. Pode ser Standard_LRS, Premium_LRS ou Standard_ZRS. SnapshotSku
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Compute/snapshots@2020-05-01"

ResourceTags

Nome Descrição Valor

SnapshotProperties

Nome Descrição Valor
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)
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'

SnapshotSku

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

SourceVault

Nome Descrição Valor
id ID do recurso corda