Partilhar via

Instantâneos Microsoft.Compute 2020-05-01

  • Artigo

Definição de recursos do bíceps

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

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@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 de propriedade

CriaçãoData

Designação Descrição Valor
createOption Isso enumera as possíveis fontes de criação de um disco. «Anexar»
'Copiar'
'Vazio'
'FromImage'
'Importação'
'Restaurar'
'Upload' (obrigatório)
galeriaImagemReferência Obrigatório se criar a partir de uma imagem da Galeria. O id 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 sobre a origem do disco. ImageDiskReference
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

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

ImageDiskReference

Designação Descrição Valor
ID Um uri relativo contendo um repositório de imagens da plataforma ou uma referência de imagem do usuário. string (obrigatório)
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

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
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. SnapshotSku
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Tags de Recursos

Designação Descrição Valor

SnapshotProperties

Designação Descrição Valor
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)
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. de 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'

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

Definição de recurso de modelo ARM

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

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": "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 de propriedade

CriaçãoData

Designação Descrição Valor
createOption Isso enumera as possíveis fontes de criação de um disco. «Anexar»
'Copiar'
'Vazio'
'FromImage'
'Importação'
'Restaurar'
'Upload' (obrigatório)
galeriaImagemReferência Obrigatório se criar a partir de uma imagem da Galeria. O id 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 sobre a origem do disco. ImageDiskReference
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

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

ImageDiskReference

Designação Descrição Valor
ID Um uri relativo contendo um repositório de imagens da plataforma ou uma referência de imagem do usuário. string (obrigatório)
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

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 '2020-05-01'
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. 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'

Tags de Recursos

Designação Descrição Valor

SnapshotProperties

Designação Descrição Valor
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)
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. de 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'

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

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@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 de propriedade

CriaçãoData

Designação Descrição Valor
createOption Isso enumera as possíveis fontes de criação de um disco. «Anexar»
'Copiar'
'Vazio'
'FromImage'
'Importação'
'Restaurar'
'Upload' (obrigatório)
galeriaImagemReferência Obrigatório se criar a partir de uma imagem da Galeria. O id 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 sobre a origem do disco. ImageDiskReference
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

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

ImageDiskReference

Designação Descrição Valor
ID Um uri relativo contendo um repositório de imagens da plataforma ou uma referência de imagem do usuário. string (obrigatório)
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

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
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. SnapshotSku
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Compute/snapshots@2020-05-01"

Tags de Recursos

Designação Descrição Valor

SnapshotProperties

Designação Descrição Valor
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)
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. de 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'

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