Instantáneas de Microsoft.Compute 2023-01-02
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-01-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'
galleryImageReference: {
communityGalleryImageId: 'string'
id: 'string'
lun: int
sharedGalleryImageId: 'string'
}
imageReference: {
communityGalleryImageId: 'string'
id: 'string'
lun: int
sharedGalleryImageId: 'string'
}
logicalSectorSize: int
performancePlus: bool
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 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' 'CopyStart' 'Vacío' 'FromImage' 'Import' 'ImportSecure' 'Restaurar' 'Cargar' "UploadPreparedSecure" (obligatorio) |
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 |
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_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-01-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",
"galleryImageReference": {
"communityGalleryImageId": "string",
"id": "string",
"lun": "int",
"sharedGalleryImageId": "string"
},
"imageReference": {
"communityGalleryImageId": "string",
"id": "string",
"lun": "int",
"sharedGalleryImageId": "string"
},
"logicalSectorSize": "int",
"performancePlus": "bool",
"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-01-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 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" 'Ninguno' |
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' 'CopyStart' 'Vacío' 'FromImage' 'Import' 'ImportSecure' 'Restaurar' 'Cargar' "UploadPreparedSecure" (obligatorio) |
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 |
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 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_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-01-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"
galleryImageReference = {
communityGalleryImageId = "string"
id = "string"
lun = int
sharedGalleryImageId = "string"
}
imageReference = {
communityGalleryImageId = "string"
id = "string"
lun = int
sharedGalleryImageId = "string"
}
logicalSectorSize = int
performancePlus = bool
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-01-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 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" "None" |
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” "CopyStart" "Empty" "FromImage" "Importar" "ImportSecure" "Restaurar" "Cargar" "UploadPreparedSecure" (obligatorio) |
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 |
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 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 cifrado con la clave administrada por el cliente | string |
securityType | Especifica el SecurityType de la máquina virtual. Solo se aplica a los discos del sistema operativo. | "ConfidentialVM_DiskEncryptedWithCustomerKey" "ConfidentialVM_DiskEncryptedWithPlatformKey" "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" |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de