Instantáneas de Microsoft.Compute

Artículo
12/21/2024

Definición de recursos de Bicep

El tipo de recurso snapshots se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Compute/snapshots, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/snapshots@2024-03-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
      provisionedBandwidthCopySpeed: 'string'
      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 propiedad

CopyCompletionError

Nombre	Descripción	Valor
errorCode	Indica el código de error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	'CopySourceNotFound' (obligatorio)
errorMessage	Indica el mensaje de error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	string (obligatorio)

CreationData

Nombre	Descripción	Valor
createOption	Esto enumera los posibles orígenes de la creación de un disco.	'Adjuntar' 'Copiar' 'CopyFromSanSnapshot' 'CopyStart' 'Vacío' 'FromImage' 'Importar' 'ImportSecure' 'Restaurar' 'Cargar' 'UploadPreparedSecure' (obligatorio)
elasticSanResourceId	Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador de ARM de la instantánea de volumen elástica de origen san.	cuerda
galleryImageReference	Obligatorio si se crea desde una imagen de la galería. El id/sharedGalleryImageId/communityGalleryImageId de ImageDiskReference será el identificador arm de la versión de la imagen de galley compartida desde la que se va a crear un disco.	ImageDiskReference
imageReference	Información de origen del disco para imágenes PIR o de usuario.	ImageDiskReference
logicalSectorSize	Tamaño del sector lógico en bytes para discos Ultra. Los valores admitidos son 512 anuncios 4096. 4096 es el valor predeterminado.	Int
performancePlus	Establezca esta marca en true para obtener un aumento en el destino de rendimiento del disco implementado, consulte aquí en el destino de rendimiento correspondiente. Esta marca solo se puede establecer en el tiempo de creación del disco y no se puede deshabilitar después de habilitarse.	Bool
provisionedBandwidthCopySpeed	Si este campo se establece en una instantánea y createOption es CopyStart, la instantánea se copiará a una velocidad más rápida.	"Mejorado" 'Ninguno'
securityDataUri	Si createOption es ImportSecure, este es el URI de un blob que se va a importar en el estado de invitado de la máquina virtual.	cuerda
sourceResourceId	Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco.	cuerda
sourceUri	Si createOption es Import, este es el URI de un blob que se va a importar en un disco administrado.	cuerda
storageAccountId	Obligatorio si createOption es Import. Identificador de Azure Resource Manager de la cuenta de almacenamiento que contiene el blob que se va a importar como un disco.	cuerda
uploadSizeBytes	Si createOption es Upload, este es el tamaño del contenido de la carga, incluido el pie de página del disco duro virtual. Este valor debe estar entre 20972032 (20 MiB + 512 bytes para el pie de página de VHD) y 35183298347520 bytes (32 TiB + 512 bytes para el pie de página VHD).	Int

DiskSecurityProfile

Nombre	Descripción	Valor
secureVMDiskEncryptionSetId	ResourceId del conjunto de cifrado de disco asociado al disco compatible con la máquina virtual confidencial cifrada con la clave administrada por el cliente	cuerda
securityType	Especifica securityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.	"ConfidentialVM_DiskEncryptedWithCustomerKey" "ConfidentialVM_DiskEncryptedWithPlatformKey" "ConfidentialVM_NonPersistedTPM" "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey" "TrustedLaunch"

Encriptación

Nombre	Descripción	Valor
diskEncryptionSetId	ResourceId del conjunto de cifrado de disco que se va a usar para habilitar el cifrado en reposo.	cuerda
tipo	Tipo de clave que se usa para cifrar los datos del disco.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nombre	Descripción	Valor
Habilitado	Establezca esta marca en true y proporcione DiskEncryptionKey y keyEncryptionKey opcional para habilitar el cifrado. Establezca esta marca en false y quite DiskEncryptionKey y KeyEncryptionKey para deshabilitar el cifrado. Si EncryptionSettings es null en el objeto de solicitud, la configuración existente permanece sin cambios.	bool (obligatorio)
encryptionSettings	Colección de la configuración de cifrado, una para cada volumen de disco.	encryptionSettingsElement[]
encryptionSettingsVersion	Describe qué tipo de cifrado se usa para los discos. Una vez establecido este campo, no se puede sobrescribir. "1.0" corresponde a Azure Disk Encryption con la aplicación AAD.'1.1' corresponde a Azure Disk Encryption.	cuerda

EncryptionSettingsElement

Nombre	Descripción	Valor
diskEncryptionKey	Dirección URL del secreto de Key Vault e identificador del almacén de la clave de cifrado de disco	KeyVaultAndSecretReference
keyEncryptionKey	Dirección URL de la clave de Key Vault e identificador del almacén de la clave de cifrado de claves. KeyEncryptionKey es opcional y, cuando se proporciona, se usa para desencapsular la clave de cifrado de disco.	KeyVaultAndKeyReference

ExtendedLocation

Nombre	Descripción	Valor
nombre	Nombre de la ubicación extendida.	cuerda
tipo	Tipo de la ubicación extendida.	'EdgeZone'

ImageDiskReference

Nombre	Descripción	Valor
communityGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery de la comunidad.	cuerda
identificación	Un URI relativo que contiene un repositorio de imágenes de plataforma, una imagen de usuario o una referencia de imagen de Azure Compute Gallery.	cuerda
Lun	Si el disco se crea a partir del disco de datos de una imagen, se trata de un índice que indica cuáles de los discos de datos de la imagen se van a usar. En el caso de los discos del sistema operativo, este campo es NULL.	Int
sharedGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery compartida directa.	cuerda

KeyVaultAndKeyReference

Nombre	Descripción	Valor
keyUrl	Dirección URL que apunta a una clave o un secreto en KeyVault	string (obligatorio)
sourceVault	Identificador de recurso de KeyVault que contiene la clave o el secreto	sourceVault (obligatorio)

KeyVaultAndSecretReference

Nombre	Descripción	Valor
secretUrl	Dirección URL que apunta a una clave o un secreto en KeyVault	string (obligatorio)
sourceVault	Identificador de recurso de KeyVault que contiene la clave o el secreto	sourceVault (obligatorio)

Microsoft.Compute/snapshots

Nombre	Descripción	Valor
extendedLocation	Ubicación extendida donde se creará la instantánea. No se puede cambiar la ubicación extendida.	ExtendedLocation
ubicación	Ubicación del recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de recursos de instantáneas.	SnapshotProperties de
Sku	Nombre de SKU de instantáneas. Puede ser Standard_LRS, Premium_LRS o Standard_ZRS. Se trata de un parámetro opcional para la instantánea incremental y el comportamiento predeterminado es la SKU se establecerá en la misma SKU que la instantánea anterior.	SnapshotSku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

PurchasePlan

Nombre	Descripción	Valor
nombre	Identificador del plan.	string (obligatorio)
producto	Especifica el producto de la imagen de Marketplace. Este es el mismo valor que Offer en el elemento imageReference.	string (obligatorio)
promotionCode	El código de promoción de la oferta.	cuerda
editor	Identificador del publicador.	string (obligatorio)

ResourceTags

Nombre	Descripción	Valor

SnapshotProperties

Nombre	Descripción	Valor
completionPercent	Porcentaje completado para la copia en segundo plano cuando se crea un recurso a través de la operación CopyStart.	Int
copyCompletionError	Indica los detalles del error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	CopyCompletionError de
creationData	Información de origen del disco. La información de CreationData no se puede cambiar después de crear el disco.	CreationData (obligatorio)
dataAccessAuthMode	Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.	"AzureActiveDirectory" 'Ninguno'
diskAccessId	Identificador de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.	cuerda
diskSizeGB	Si creationData.createOption es Vacío, este campo es obligatorio e indica el tamaño del disco que se va a crear. Si este campo está presente para actualizaciones o creación con otras opciones, indica un cambio de tamaño. Solo se permiten cambios de tamaño si el disco no está conectado a una máquina virtual en ejecución y solo puede aumentar el tamaño del disco.	Int
encriptación	La propiedad de cifrado se puede usar para cifrar los datos en reposo con claves administradas por el cliente o claves administradas por la plataforma.	Cifrado
encryptionSettingsCollection	La recopilación de configuración de cifrado usada es Azure Disk Encryption, puede contener varias opciones de cifrado por disco o instantánea.	encryptionSettingsCollection de
hyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.	'V1' 'V2'
incremental	Si una instantánea es incremental. Las instantáneas incrementales del mismo disco ocupan menos espacio que las instantáneas completas y se pueden diffed.	Bool
networkAccessPolicy	Directiva para acceder al disco a través de la red.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	Tipo de sistema operativo.	"Linux" 'Windows'
publicNetworkAccess	Directiva para controlar la exportación en el disco.	'Deshabilitado' 'Habilitado'
purchasePlan	Información del plan de compra para la imagen desde la que se creó originalmente el disco de origen de la instantánea.	PurchasePlan
securityProfile	Contiene la información relacionada con la seguridad del recurso.	DiskSecurityProfile de
supportedCapabilities	Lista de funcionalidades admitidas para la imagen desde la que se creó originalmente el disco de origen de la instantánea.	SupportedCapabilities
supportsHibernation	Indica que el sistema operativo en una instantánea admite la hibernación.	Bool

SnapshotSku

Nombre	Descripción	Valor
nombre	El nombre de la SKU.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

SourceVault

Nombre	Descripción	Valor
identificación	Identificador de recurso	cuerda

SupportedCapabilities

Nombre	Descripción	Valor
acceleratedNetwork	True si la imagen desde la que se crea el disco del sistema operativo admite redes aceleradas.	Bool
arquitectura	Arquitectura de CPU compatible con un disco del sistema operativo.	'Arm64' 'x64'
diskControllerTypes	Controladores de disco que admite un disco del sistema operativo. Si se establece, puede ser SCSI o SCSI, NVME o NVME, SCSI.	cuerda

Definición de recursos de plantilla de ARM

El tipo de recurso snapshots se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Compute/snapshots, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2024-03-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",
      "provisionedBandwidthCopySpeed": "string",
      "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 propiedad

CopyCompletionError

Nombre	Descripción	Valor
errorCode	Indica el código de error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	'CopySourceNotFound' (obligatorio)
errorMessage	Indica el mensaje de error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	string (obligatorio)

CreationData

Nombre	Descripción	Valor
createOption	Esto enumera los posibles orígenes de la creación de un disco.	'Adjuntar' 'Copiar' 'CopyFromSanSnapshot' 'CopyStart' 'Vacío' 'FromImage' 'Importar' 'ImportSecure' 'Restaurar' 'Cargar' 'UploadPreparedSecure' (obligatorio)
elasticSanResourceId	Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador de ARM de la instantánea de volumen elástica de origen san.	cuerda
galleryImageReference	Obligatorio si se crea desde una imagen de la galería. El id/sharedGalleryImageId/communityGalleryImageId de ImageDiskReference será el identificador arm de la versión de la imagen de galley compartida desde la que se va a crear un disco.	ImageDiskReference
imageReference	Información de origen del disco para imágenes PIR o de usuario.	ImageDiskReference
logicalSectorSize	Tamaño del sector lógico en bytes para discos Ultra. Los valores admitidos son 512 anuncios 4096. 4096 es el valor predeterminado.	Int
performancePlus	Establezca esta marca en true para obtener un aumento en el destino de rendimiento del disco implementado, consulte aquí en el destino de rendimiento correspondiente. Esta marca solo se puede establecer en el tiempo de creación del disco y no se puede deshabilitar después de habilitarse.	Bool
provisionedBandwidthCopySpeed	Si este campo se establece en una instantánea y createOption es CopyStart, la instantánea se copiará a una velocidad más rápida.	"Mejorado" 'Ninguno'
securityDataUri	Si createOption es ImportSecure, este es el URI de un blob que se va a importar en el estado de invitado de la máquina virtual.	cuerda
sourceResourceId	Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco.	cuerda
sourceUri	Si createOption es Import, este es el URI de un blob que se va a importar en un disco administrado.	cuerda
storageAccountId	Obligatorio si createOption es Import. Identificador de Azure Resource Manager de la cuenta de almacenamiento que contiene el blob que se va a importar como un disco.	cuerda
uploadSizeBytes	Si createOption es Upload, este es el tamaño del contenido de la carga, incluido el pie de página del disco duro virtual. Este valor debe estar entre 20972032 (20 MiB + 512 bytes para el pie de página de VHD) y 35183298347520 bytes (32 TiB + 512 bytes para el pie de página VHD).	Int

DiskSecurityProfile

Nombre	Descripción	Valor
secureVMDiskEncryptionSetId	ResourceId del conjunto de cifrado de disco asociado al disco compatible con la máquina virtual confidencial cifrada con la clave administrada por el cliente	cuerda
securityType	Especifica securityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.	"ConfidentialVM_DiskEncryptedWithCustomerKey" "ConfidentialVM_DiskEncryptedWithPlatformKey" "ConfidentialVM_NonPersistedTPM" "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey" "TrustedLaunch"

Encriptación

Nombre	Descripción	Valor
diskEncryptionSetId	ResourceId del conjunto de cifrado de disco que se va a usar para habilitar el cifrado en reposo.	cuerda
tipo	Tipo de clave que se usa para cifrar los datos del disco.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nombre	Descripción	Valor
Habilitado	Establezca esta marca en true y proporcione DiskEncryptionKey y keyEncryptionKey opcional para habilitar el cifrado. Establezca esta marca en false y quite DiskEncryptionKey y KeyEncryptionKey para deshabilitar el cifrado. Si EncryptionSettings es null en el objeto de solicitud, la configuración existente permanece sin cambios.	bool (obligatorio)
encryptionSettings	Colección de la configuración de cifrado, una para cada volumen de disco.	encryptionSettingsElement[]
encryptionSettingsVersion	Describe qué tipo de cifrado se usa para los discos. Una vez establecido este campo, no se puede sobrescribir. "1.0" corresponde a Azure Disk Encryption con la aplicación AAD.'1.1' corresponde a Azure Disk Encryption.	cuerda

EncryptionSettingsElement

Nombre	Descripción	Valor
diskEncryptionKey	Dirección URL del secreto de Key Vault e identificador del almacén de la clave de cifrado de disco	KeyVaultAndSecretReference
keyEncryptionKey	Dirección URL de la clave de Key Vault e identificador del almacén de la clave de cifrado de claves. KeyEncryptionKey es opcional y, cuando se proporciona, se usa para desencapsular la clave de cifrado de disco.	KeyVaultAndKeyReference

ExtendedLocation

Nombre	Descripción	Valor
nombre	Nombre de la ubicación extendida.	cuerda
tipo	Tipo de la ubicación extendida.	'EdgeZone'

ImageDiskReference

Nombre	Descripción	Valor
communityGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery de la comunidad.	cuerda
identificación	Un URI relativo que contiene un repositorio de imágenes de plataforma, una imagen de usuario o una referencia de imagen de Azure Compute Gallery.	cuerda
Lun	Si el disco se crea a partir del disco de datos de una imagen, se trata de un índice que indica cuáles de los discos de datos de la imagen se van a usar. En el caso de los discos del sistema operativo, este campo es NULL.	Int
sharedGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery compartida directa.	cuerda

KeyVaultAndKeyReference

Nombre	Descripción	Valor
keyUrl	Dirección URL que apunta a una clave o un secreto en KeyVault	string (obligatorio)
sourceVault	Identificador de recurso de KeyVault que contiene la clave o el secreto	sourceVault (obligatorio)

KeyVaultAndSecretReference

Nombre	Descripción	Valor
secretUrl	Dirección URL que apunta a una clave o un secreto en KeyVault	string (obligatorio)
sourceVault	Identificador de recurso de KeyVault que contiene la clave o el secreto	sourceVault (obligatorio)

Microsoft.Compute/snapshots

Nombre	Descripción	Valor
apiVersion	La versión de api	'2024-03-02'
extendedLocation	Ubicación extendida donde se creará la instantánea. No se puede cambiar la ubicación extendida.	ExtendedLocation
ubicación	Ubicación del recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de recursos de instantáneas.	SnapshotProperties de
Sku	Nombre de SKU de instantáneas. Puede ser Standard_LRS, Premium_LRS o Standard_ZRS. Se trata de un parámetro opcional para la instantánea incremental y el comportamiento predeterminado es la SKU se establecerá en la misma SKU que la instantánea anterior.	SnapshotSku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	"Microsoft.Compute/snapshots"

PurchasePlan

Nombre	Descripción	Valor
nombre	Identificador del plan.	string (obligatorio)
producto	Especifica el producto de la imagen de Marketplace. Este es el mismo valor que Offer en el elemento imageReference.	string (obligatorio)
promotionCode	El código de promoción de la oferta.	cuerda
editor	Identificador del publicador.	string (obligatorio)

ResourceTags

Nombre	Descripción	Valor

SnapshotProperties

Nombre	Descripción	Valor
completionPercent	Porcentaje completado para la copia en segundo plano cuando se crea un recurso a través de la operación CopyStart.	Int
copyCompletionError	Indica los detalles del error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	CopyCompletionError de
creationData	Información de origen del disco. La información de CreationData no se puede cambiar después de crear el disco.	CreationData (obligatorio)
dataAccessAuthMode	Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.	"AzureActiveDirectory" 'Ninguno'
diskAccessId	Identificador de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.	cuerda
diskSizeGB	Si creationData.createOption es Vacío, este campo es obligatorio e indica el tamaño del disco que se va a crear. Si este campo está presente para actualizaciones o creación con otras opciones, indica un cambio de tamaño. Solo se permiten cambios de tamaño si el disco no está conectado a una máquina virtual en ejecución y solo puede aumentar el tamaño del disco.	Int
encriptación	La propiedad de cifrado se puede usar para cifrar los datos en reposo con claves administradas por el cliente o claves administradas por la plataforma.	Cifrado
encryptionSettingsCollection	La recopilación de configuración de cifrado usada es Azure Disk Encryption, puede contener varias opciones de cifrado por disco o instantánea.	encryptionSettingsCollection de
hyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.	'V1' 'V2'
incremental	Si una instantánea es incremental. Las instantáneas incrementales del mismo disco ocupan menos espacio que las instantáneas completas y se pueden diffed.	Bool
networkAccessPolicy	Directiva para acceder al disco a través de la red.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	Tipo de sistema operativo.	"Linux" 'Windows'
publicNetworkAccess	Directiva para controlar la exportación en el disco.	'Deshabilitado' 'Habilitado'
purchasePlan	Información del plan de compra para la imagen desde la que se creó originalmente el disco de origen de la instantánea.	PurchasePlan
securityProfile	Contiene la información relacionada con la seguridad del recurso.	DiskSecurityProfile de
supportedCapabilities	Lista de funcionalidades admitidas para la imagen desde la que se creó originalmente el disco de origen de la instantánea.	SupportedCapabilities
supportsHibernation	Indica que el sistema operativo en una instantánea admite la hibernación.	Bool

SnapshotSku

Nombre	Descripción	Valor
nombre	El nombre de la SKU.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

SourceVault

Nombre	Descripción	Valor
identificación	Identificador de recurso	cuerda

SupportedCapabilities

Nombre	Descripción	Valor
acceleratedNetwork	True si la imagen desde la que se crea el disco del sistema operativo admite redes aceleradas.	Bool
arquitectura	Arquitectura de CPU compatible con un disco del sistema operativo.	'Arm64' 'x64'
diskControllerTypes	Controladores de disco que admite un disco del sistema operativo. Si se establece, puede ser SCSI o SCSI, NVME o NVME, SCSI.	cuerda

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso snapshots se puede implementar con operaciones que tienen como destino:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Compute/snapshots, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2024-03-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
        provisionedBandwidthCopySpeed = "string"
        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 propiedad

CopyCompletionError

Nombre	Descripción	Valor
errorCode	Indica el código de error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	'CopySourceNotFound' (obligatorio)
errorMessage	Indica el mensaje de error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	string (obligatorio)

CreationData

Nombre	Descripción	Valor
createOption	Esto enumera los posibles orígenes de la creación de un disco.	'Adjuntar' 'Copiar' 'CopyFromSanSnapshot' 'CopyStart' 'Vacío' 'FromImage' 'Importar' 'ImportSecure' 'Restaurar' 'Cargar' 'UploadPreparedSecure' (obligatorio)
elasticSanResourceId	Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador de ARM de la instantánea de volumen elástica de origen san.	cuerda
galleryImageReference	Obligatorio si se crea desde una imagen de la galería. El id/sharedGalleryImageId/communityGalleryImageId de ImageDiskReference será el identificador arm de la versión de la imagen de galley compartida desde la que se va a crear un disco.	ImageDiskReference
imageReference	Información de origen del disco para imágenes PIR o de usuario.	ImageDiskReference
logicalSectorSize	Tamaño del sector lógico en bytes para discos Ultra. Los valores admitidos son 512 anuncios 4096. 4096 es el valor predeterminado.	Int
performancePlus	Establezca esta marca en true para obtener un aumento en el destino de rendimiento del disco implementado, consulte aquí en el destino de rendimiento correspondiente. Esta marca solo se puede establecer en el tiempo de creación del disco y no se puede deshabilitar después de habilitarse.	Bool
provisionedBandwidthCopySpeed	Si este campo se establece en una instantánea y createOption es CopyStart, la instantánea se copiará a una velocidad más rápida.	"Mejorado" 'Ninguno'
securityDataUri	Si createOption es ImportSecure, este es el URI de un blob que se va a importar en el estado de invitado de la máquina virtual.	cuerda
sourceResourceId	Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco.	cuerda
sourceUri	Si createOption es Import, este es el URI de un blob que se va a importar en un disco administrado.	cuerda
storageAccountId	Obligatorio si createOption es Import. Identificador de Azure Resource Manager de la cuenta de almacenamiento que contiene el blob que se va a importar como un disco.	cuerda
uploadSizeBytes	Si createOption es Upload, este es el tamaño del contenido de la carga, incluido el pie de página del disco duro virtual. Este valor debe estar entre 20972032 (20 MiB + 512 bytes para el pie de página de VHD) y 35183298347520 bytes (32 TiB + 512 bytes para el pie de página VHD).	Int

DiskSecurityProfile

Nombre	Descripción	Valor
secureVMDiskEncryptionSetId	ResourceId del conjunto de cifrado de disco asociado al disco compatible con la máquina virtual confidencial cifrada con la clave administrada por el cliente	cuerda
securityType	Especifica securityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.	"ConfidentialVM_DiskEncryptedWithCustomerKey" "ConfidentialVM_DiskEncryptedWithPlatformKey" "ConfidentialVM_NonPersistedTPM" "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey" "TrustedLaunch"

Encriptación

Nombre	Descripción	Valor
diskEncryptionSetId	ResourceId del conjunto de cifrado de disco que se va a usar para habilitar el cifrado en reposo.	cuerda
tipo	Tipo de clave que se usa para cifrar los datos del disco.	'EncryptionAtRestWithCustomerKey' 'EncryptionAtRestWithPlatformAndCustomerKeys' 'EncryptionAtRestWithPlatformKey'

EncryptionSettingsCollection

Nombre	Descripción	Valor
Habilitado	Establezca esta marca en true y proporcione DiskEncryptionKey y keyEncryptionKey opcional para habilitar el cifrado. Establezca esta marca en false y quite DiskEncryptionKey y KeyEncryptionKey para deshabilitar el cifrado. Si EncryptionSettings es null en el objeto de solicitud, la configuración existente permanece sin cambios.	bool (obligatorio)
encryptionSettings	Colección de la configuración de cifrado, una para cada volumen de disco.	encryptionSettingsElement[]
encryptionSettingsVersion	Describe qué tipo de cifrado se usa para los discos. Una vez establecido este campo, no se puede sobrescribir. "1.0" corresponde a Azure Disk Encryption con la aplicación AAD.'1.1' corresponde a Azure Disk Encryption.	cuerda

EncryptionSettingsElement

Nombre	Descripción	Valor
diskEncryptionKey	Dirección URL del secreto de Key Vault e identificador del almacén de la clave de cifrado de disco	KeyVaultAndSecretReference
keyEncryptionKey	Dirección URL de la clave de Key Vault e identificador del almacén de la clave de cifrado de claves. KeyEncryptionKey es opcional y, cuando se proporciona, se usa para desencapsular la clave de cifrado de disco.	KeyVaultAndKeyReference

ExtendedLocation

Nombre	Descripción	Valor
nombre	Nombre de la ubicación extendida.	cuerda
tipo	Tipo de la ubicación extendida.	'EdgeZone'

ImageDiskReference

Nombre	Descripción	Valor
communityGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery de la comunidad.	cuerda
identificación	Un URI relativo que contiene un repositorio de imágenes de plataforma, una imagen de usuario o una referencia de imagen de Azure Compute Gallery.	cuerda
Lun	Si el disco se crea a partir del disco de datos de una imagen, se trata de un índice que indica cuáles de los discos de datos de la imagen se van a usar. En el caso de los discos del sistema operativo, este campo es NULL.	Int
sharedGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery compartida directa.	cuerda

KeyVaultAndKeyReference

Nombre	Descripción	Valor
keyUrl	Dirección URL que apunta a una clave o un secreto en KeyVault	string (obligatorio)
sourceVault	Identificador de recurso de KeyVault que contiene la clave o el secreto	sourceVault (obligatorio)

KeyVaultAndSecretReference

Nombre	Descripción	Valor
secretUrl	Dirección URL que apunta a una clave o un secreto en KeyVault	string (obligatorio)
sourceVault	Identificador de recurso de KeyVault que contiene la clave o el secreto	sourceVault (obligatorio)

Microsoft.Compute/snapshots

Nombre	Descripción	Valor
extendedLocation	Ubicación extendida donde se creará la instantánea. No se puede cambiar la ubicación extendida.	ExtendedLocation
ubicación	Ubicación del recurso	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de recursos de instantáneas.	SnapshotProperties de
Sku	Nombre de SKU de instantáneas. Puede ser Standard_LRS, Premium_LRS o Standard_ZRS. Se trata de un parámetro opcional para la instantánea incremental y el comportamiento predeterminado es la SKU se establecerá en la misma SKU que la instantánea anterior.	SnapshotSku de
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.Compute/snapshots@2024-03-02"

PurchasePlan

Nombre	Descripción	Valor
nombre	Identificador del plan.	string (obligatorio)
producto	Especifica el producto de la imagen de Marketplace. Este es el mismo valor que Offer en el elemento imageReference.	string (obligatorio)
promotionCode	El código de promoción de la oferta.	cuerda
editor	Identificador del publicador.	string (obligatorio)

ResourceTags

Nombre	Descripción	Valor

SnapshotProperties

Nombre	Descripción	Valor
completionPercent	Porcentaje completado para la copia en segundo plano cuando se crea un recurso a través de la operación CopyStart.	Int
copyCompletionError	Indica los detalles del error si se produce un error en la copia en segundo plano de un recurso creado a través de la operación CopyStart.	CopyCompletionError de
creationData	Información de origen del disco. La información de CreationData no se puede cambiar después de crear el disco.	CreationData (obligatorio)
dataAccessAuthMode	Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.	"AzureActiveDirectory" 'Ninguno'
diskAccessId	Identificador de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.	cuerda
diskSizeGB	Si creationData.createOption es Vacío, este campo es obligatorio e indica el tamaño del disco que se va a crear. Si este campo está presente para actualizaciones o creación con otras opciones, indica un cambio de tamaño. Solo se permiten cambios de tamaño si el disco no está conectado a una máquina virtual en ejecución y solo puede aumentar el tamaño del disco.	Int
encriptación	La propiedad de cifrado se puede usar para cifrar los datos en reposo con claves administradas por el cliente o claves administradas por la plataforma.	Cifrado
encryptionSettingsCollection	La recopilación de configuración de cifrado usada es Azure Disk Encryption, puede contener varias opciones de cifrado por disco o instantánea.	encryptionSettingsCollection de
hyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.	'V1' 'V2'
incremental	Si una instantánea es incremental. Las instantáneas incrementales del mismo disco ocupan menos espacio que las instantáneas completas y se pueden diffed.	Bool
networkAccessPolicy	Directiva para acceder al disco a través de la red.	'AllowAll' 'AllowPrivate' 'DenyAll'
osType	Tipo de sistema operativo.	"Linux" 'Windows'
publicNetworkAccess	Directiva para controlar la exportación en el disco.	'Deshabilitado' 'Habilitado'
purchasePlan	Información del plan de compra para la imagen desde la que se creó originalmente el disco de origen de la instantánea.	PurchasePlan
securityProfile	Contiene la información relacionada con la seguridad del recurso.	DiskSecurityProfile de
supportedCapabilities	Lista de funcionalidades admitidas para la imagen desde la que se creó originalmente el disco de origen de la instantánea.	SupportedCapabilities
supportsHibernation	Indica que el sistema operativo en una instantánea admite la hibernación.	Bool

SnapshotSku

Nombre	Descripción	Valor
nombre	El nombre de la SKU.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

SourceVault

Nombre	Descripción	Valor
identificación	Identificador de recurso	cuerda

SupportedCapabilities

Nombre	Descripción	Valor
acceleratedNetwork	True si la imagen desde la que se crea el disco del sistema operativo admite redes aceleradas.	Bool
arquitectura	Arquitectura de CPU compatible con un disco del sistema operativo.	'Arm64' 'x64'
diskControllerTypes	Controladores de disco que admite un disco del sistema operativo. Si se establece, puede ser SCSI o SCSI, NVME o NVME, SCSI.	cuerda

Compartir a través de

Instantáneas de Microsoft.Compute

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

CopyCompletionError

CreationData

DiskSecurityProfile

Encriptación

EncryptionSettingsCollection

EncryptionSettingsElement

ExtendedLocation

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

PurchasePlan

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

SupportedCapabilities

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

CopyCompletionError

CreationData

DiskSecurityProfile

Encriptación

EncryptionSettingsCollection

EncryptionSettingsElement

ExtendedLocation

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

PurchasePlan

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

SupportedCapabilities

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

CopyCompletionError

CreationData

DiskSecurityProfile

Encriptación

EncryptionSettingsCollection

EncryptionSettingsElement

ExtendedLocation

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

Microsoft.Compute/snapshots

PurchasePlan

ResourceTags

SnapshotProperties

SnapshotSku

SourceVault

SupportedCapabilities

Comentarios

Recursos adicionales