Instantáneas de Microsoft.Compute 2023-10-02

Artículo
03/09/2024

Definición de recursos de Bicep

El tipo de recurso snapshots se puede implementar con operaciones destinadas a:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

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

Formato de los recursos

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

resource symbolicname 'Microsoft.Compute/snapshots@2023-10-02' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    completionPercent: int
    copyCompletionError: {
      errorCode: 'CopySourceNotFound'
      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

snapshots

Nombre	Descripción	Value
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 1-80 Caracteres válidos: Caracteres alfanuméricos, de subrayado, puntos y guiones. Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
ubicación	Ubicación de los recursos	string (obligatorio)
etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku	Nombre de la 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
extendedLocation	Ubicación extendida donde se creará la instantánea. No se puede cambiar la ubicación extendida.	ExtendedLocation
properties	Propiedades de recursos de instantánea.	SnapshotProperties

ExtendedLocation

Nombre	Descripción	Value
name	Nombre de la ubicación extendida.	string
type	Tipo de la ubicación extendida.	'EdgeZone'

SnapshotProperties

Nombre	Descripción	Valor
completionPercent	Porcentaje completado para la copia en segundo plano cuando se crea un recurso mediante 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
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	Id. de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.	string
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 las actualizaciones o la 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
El cifrado	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 colección de configuración de cifrado que se usa es Azure Disk Encryption, puede contener varias opciones de cifrado por disco o instantánea.	EncryptionSettingsCollection
hyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.	'V1' 'V2'
incrementales	Si una instantánea es incremental. Las instantáneas incrementales del mismo disco ocupan menos espacio que las instantáneas completas y se pueden dificar.	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 de 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
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

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' 'Import' 'ImportSecure' 'Restaurar' 'Cargar' "UploadPreparedSecure" (obligatorio)
elasticSanResourceId	Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador arm de la instantánea de volumen elástica de origen san.	string
galleryImageReference	Obligatorio si se crea desde una imagen de galería. Id/sharedGalleryImageId/communityGalleryImageId de ImageDiskReference será el identificador arm de la versión de imagen de galley compartida desde la que se va a crear un disco.	ImageDiskReference
imageReference	Información de origen de disco para pir o imágenes de usuario.	ImageDiskReference
logicalSectorSize	Tamaño del sector lógico en bytes para discos Ultra. Los valores admitidos son 512 y 4096. El valor predeterminado es 4096.	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.	string
sourceResourceId	Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco.	string
SourceUri	Si createOption es Import, este es el URI de un blob que se va a importar en un disco administrado.	string
storageAccountId	Obligatorio si createOption es Import. El identificador de Azure Resource Manager de la cuenta de almacenamiento que contiene el blob que se va a importar como un disco.	string
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

ImageDiskReference

Nombre	Descripción	Valor
communityGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery de la comunidad.	string
id	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.	string
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.	string

Cifrado

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

EncryptionSettingsCollection

Nombre	Descripción	Valor
enabled	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 configuraciones 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 de AAD.'1.1' corresponde a Azure Disk Encryption.	string

EncryptionSettingsElement

Nombre	Descripción	Valor
diskEncryptionKey	Key Vault dirección URL secreta y el identificador del almacén de la clave de cifrado de disco	KeyVaultAndSecretReference
keyEncryptionKey	Key Vault la dirección URL de la clave y el 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

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 del almacén de claves que contiene la clave o el secreto	SourceVault (obligatorio)

SourceVault

Nombre	Descripción	Value
id	Id. de recurso	string

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 del almacén de claves que contiene la clave o el secreto	SourceVault (obligatorio)

PurchasePlan

Nombre	Descripción	Value
name	Identificador del plan.	string (obligatorio)
product	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.	string
publisher	Identificador del publicador.	string (obligatorio)

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	string
securityType	Especifica el valor SecurityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_NonPersistedTPM' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

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.	string

SnapshotSku

Nombre	Descripción	Value
name	Nombre de la SKU.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

Definición de recursos de plantilla de ARM

El tipo de recurso snapshots se puede implementar con operaciones destinadas a:

Grupos de recursos: consulte los comandos de implementación del grupo de recursos.

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

Formato de los recursos

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

{
  "type": "Microsoft.Compute/snapshots",
  "apiVersion": "2023-10-02",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "completionPercent": "int",
    "copyCompletionError": {
      "errorCode": "CopySourceNotFound",
      "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

snapshots

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.Compute/snapshots"
apiVersion	La versión de la API de recursos	'2023-10-02'
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 1-80 Caracteres válidos: Caracteres alfanuméricos, de subrayado, puntos y guiones. Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
ubicación	Ubicación de los recursos	string (obligatorio)
etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku	Nombre de la 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
extendedLocation	Ubicación extendida donde se creará la instantánea. No se puede cambiar la ubicación extendida.	ExtendedLocation
properties	Propiedades de recursos de instantánea.	SnapshotProperties

ExtendedLocation

Nombre	Descripción	Value
name	Nombre de la ubicación extendida.	string
type	Tipo de la ubicación extendida.	'EdgeZone'

SnapshotProperties

Nombre	Descripción	Valor
completionPercent	Porcentaje completado para la copia en segundo plano cuando se crea un recurso mediante 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
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	Id. de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.	string
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 las actualizaciones o la 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
El cifrado	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 colección de configuración de cifrado que se usa es Azure Disk Encryption, puede contener varias opciones de cifrado por disco o instantánea.	EncryptionSettingsCollection
hyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.	'V1' 'V2'
incrementales	Si una instantánea es incremental. Las instantáneas incrementales del mismo disco ocupan menos espacio que las instantáneas completas y se pueden dificar.	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 de 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
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

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' 'Import' 'ImportSecure' 'Restaurar' 'Cargar' "UploadPreparedSecure" (obligatorio)
elasticSanResourceId	Obligatorio si createOption es CopyFromSanSnapshot. Este es el identificador arm de la instantánea de volumen elástica de origen san.	string
galleryImageReference	Obligatorio si se crea desde una imagen de galería. Id/sharedGalleryImageId/communityGalleryImageId de ImageDiskReference será el identificador arm de la versión de imagen de galley compartida desde la que se va a crear un disco.	ImageDiskReference
imageReference	Información de origen de disco para pir o imágenes de usuario.	ImageDiskReference
logicalSectorSize	Tamaño del sector lógico en bytes para discos Ultra. Los valores admitidos son 512 y 4096. El valor predeterminado es 4096.	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.	string
sourceResourceId	Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco.	string
SourceUri	Si createOption es Import, este es el URI de un blob que se va a importar en un disco administrado.	string
storageAccountId	Obligatorio si createOption es Import. El identificador de Azure Resource Manager de la cuenta de almacenamiento que contiene el blob que se va a importar como disco.	string
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

ImageDiskReference

Nombre	Descripción	Valor
communityGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery de la comunidad.	string
id	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.	string
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.	string

Cifrado

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

EncryptionSettingsCollection

Nombre	Descripción	Valor
enabled	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 configuraciones 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 de AAD.'1.1' corresponde a Azure Disk Encryption.	string

EncryptionSettingsElement

Nombre	Descripción	Valor
diskEncryptionKey	Key Vault dirección URL secreta y el identificador del almacén de la clave de cifrado de disco	KeyVaultAndSecretReference
keyEncryptionKey	Key Vault la dirección URL de la clave y el 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

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 del almacén de claves que contiene la clave o el secreto	SourceVault (obligatorio)

SourceVault

Nombre	Descripción	Value
id	Id. de recurso	string

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)

PurchasePlan

Nombre	Descripción	Value
name	Identificador del plan.	string (obligatorio)
product	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.	string
publisher	Identificador del publicador.	string (obligatorio)

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	string
securityType	Especifica el valor SecurityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.	'ConfidentialVM_DiskEncryptedWithCustomerKey' 'ConfidentialVM_DiskEncryptedWithPlatformKey' 'ConfidentialVM_NonPersistedTPM' 'ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey' 'TrustedLaunch'

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.	string

SnapshotSku

Nombre	Descripción	Value
name	Nombre de la SKU.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso snapshots se puede implementar con operaciones destinadas a:

Grupos de recursos

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

Formato de los recursos

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/snapshots@2023-10-02"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      completionPercent = int
      copyCompletionError = {
        errorCode = "CopySourceNotFound"
        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"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Valores de propiedad

snapshots

Nombre	Descripción	Value
type	Tipo de recurso	"Microsoft.Compute/snapshots@2023-10-02"
name	El nombre del recurso	string (obligatorio) Límite de caracteres: 1-80 Caracteres válidos: Caracteres alfanuméricos, de subrayado, puntos y guiones. Comience con un carácter alfanumérico. Termine con un carácter alfanumérico o de subrayado.
ubicación	Ubicación de los recursos	string (obligatorio)
parent_id	Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos.	string (obligatorio)
etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta.
sku	Nombre de la 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
extendedLocation	Ubicación extendida donde se creará la instantánea. No se puede cambiar la ubicación extendida.	ExtendedLocation
properties	Propiedades del recurso de instantánea.	SnapshotProperties

ExtendedLocation

Nombre	Descripción	Value
name	Nombre de la ubicación extendida.	string
type	Tipo de la ubicación extendida.	"EdgeZone"

SnapshotProperties

Nombre	Descripción	Valor
completionPercent	Porcentaje completado para la copia en segundo plano cuando se crea un recurso mediante 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
creationData	Información de origen del disco. La información de CreationData no se puede cambiar una vez creado el disco.	CreationData (obligatorio)
dataAccessAuthMode	Requisitos de autenticación adicionales al exportar o cargar en un disco o instantánea.	"AzureActiveDirectory" "None"
diskAccessId	Identificador de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.	string
diskSizeGB	Si creationData.createOption es Empty, este campo es obligatorio e indica el tamaño del disco que se va a crear. Si este campo está presente para las actualizaciones o la 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
El cifrado	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 configuraciones de cifrado usada como Azure Disk Encryption puede contener varias opciones de cifrado por disco o instantánea.	EncryptionSettingsCollection
hyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.	"V1" "V2"
incrementales	Si una instantánea es incremental. Las instantáneas incrementales en el 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
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 de una instantánea admite la hibernación.	bool

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" "Empty" "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ástico de origen san.	string
galleryImageReference	Obligatorio si se crea desde una imagen de la galería. Id/sharedGalleryImageId/communityGalleryImageId de ImageDiskReference será el identificador arm de la versión de 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 y 4096. El valor predeterminado es 4096.	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" "None"
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.	string
sourceResourceId	Si createOption es Copy, este es el identificador arm de la instantánea de origen o el disco.	string
SourceUri	Si createOption es Import, este es el URI de un blob que se va a importar en un disco administrado.	string
storageAccountId	Obligatorio si createOption es Import. El identificador de Azure Resource Manager de la cuenta de almacenamiento que contiene el blob que se va a importar como disco.	string
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

ImageDiskReference

Nombre	Descripción	Valor
communityGalleryImageId	Un URI relativo que contiene una referencia de imagen de Azure Compute Gallery de la comunidad.	string
id	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.	string
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.	string

Cifrado

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

EncryptionSettingsCollection

Nombre	Descripción	Valor
enabled	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 configuraciones 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 de AAD.'1.1' corresponde a Azure Disk Encryption.	string

EncryptionSettingsElement

Nombre	Descripción	Valor
diskEncryptionKey	Key Vault dirección URL secreta y el identificador del almacén de la clave de cifrado de disco	KeyVaultAndSecretReference
keyEncryptionKey	Key Vault dirección URL de la clave y el 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

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)

SourceVault

Nombre	Descripción	Value
id	Id. de recurso	string

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)

PurchasePlan

Nombre	Descripción	Value
name	Identificador del plan.	string (obligatorio)
product	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.	string
publisher	Identificador del publicador.	string (obligatorio)

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	string
securityType	Especifica el valor SecurityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.	"ConfidentialVM_DiskEncryptedWithCustomerKey" "ConfidentialVM_DiskEncryptedWithPlatformKey" "ConfidentialVM_NonPersistedTPM" "ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey" "TrustedLaunch"

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.	string

SnapshotSku

Nombre	Descripción	Value
name	Nombre de la SKU.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

Instantáneas de Microsoft.Compute 2023-10-02

Definición de recursos de Bicep

Formato de los recursos

Valores de propiedad

snapshots

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

Cifrado

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Definición de recursos de plantilla de ARM

Formato de los recursos

Valores de propiedad

snapshots

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

Cifrado

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Definición de recursos de Terraform (proveedor AzAPI)

Formato de los recursos

Valores de propiedad

snapshots

ExtendedLocation

SnapshotProperties

CopyCompletionError

CreationData

ImageDiskReference

Cifrado

EncryptionSettingsCollection

EncryptionSettingsElement

KeyVaultAndSecretReference

SourceVault

KeyVaultAndKeyReference

PurchasePlan

DiskSecurityProfile

SupportedCapabilities

SnapshotSku

Comentarios

Comentarios

Recursos adicionales