Compartilhar via

Instantâneos da Microsoft.Compute 2018-09-30

  • 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@2018-09-30' = {
  location: 'string'
  name: 'string'
  properties: {
    creationData: {
      createOption: 'string'
      imageReference: {
        id: 'string'
        lun: int
      }
      sourceResourceId: 'string'
      sourceUri: 'string'
      storageAccountId: 'string'
    }
    diskSizeGB: int
    encryptionSettingsCollection: {
      enabled: bool
      encryptionSettings: [
        {
          diskEncryptionKey: {
            secretUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
          keyEncryptionKey: {
            keyUrl: 'string'
            sourceVault: {
              id: 'string'
            }
          }
        }
      ]
    }
    hyperVGeneration: '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)
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 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. Necessário somente se o blob estiver em uma assinatura diferente corda

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[]

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)
diskSizeGB Se creationData.createOption estiver Vazio, esse campo será obrigatório e indicará o tamanho do VHD 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
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'
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": "2018-09-30",
  "name": "string",
  "location": "string",
  "properties": {
    "creationData": {
      "createOption": "string",
      "imageReference": {
        "id": "string",
        "lun": "int"
      },
      "sourceResourceId": "string",
      "sourceUri": "string",
      "storageAccountId": "string"
    },
    "diskSizeGB": "int",
    "encryptionSettingsCollection": {
      "enabled": "bool",
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "secretUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          },
          "keyEncryptionKey": {
            "keyUrl": "string",
            "sourceVault": {
              "id": "string"
            }
          }
        }
      ]
    },
    "hyperVGeneration": "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)
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 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. Necessário somente se o blob estiver em uma assinatura diferente corda

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[]

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 '2018-09-30'
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)
diskSizeGB Se creationData.createOption estiver Vazio, esse campo será obrigatório e indicará o tamanho do VHD 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
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'
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@2018-09-30"
  name = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      creationData = {
        createOption = "string"
        imageReference = {
          id = "string"
          lun = int
        }
        sourceResourceId = "string"
        sourceUri = "string"
        storageAccountId = "string"
      }
      diskSizeGB = int
      encryptionSettingsCollection = {
        enabled = bool
        encryptionSettings = [
          {
            diskEncryptionKey = {
              secretUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
            keyEncryptionKey = {
              keyUrl = "string"
              sourceVault = {
                id = "string"
              }
            }
          }
        ]
      }
      hyperVGeneration = "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)
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 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. Necessário somente se o blob estiver em uma assinatura diferente corda

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[]

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@2018-09-30"

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)
diskSizeGB Se creationData.createOption estiver Vazio, esse campo será obrigatório e indicará o tamanho do VHD 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
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'
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