Compartir a través de

az dataprotection backup-vault

  • Referencia

Nota:

Esta referencia forma parte de la extensión de protección de datos para la CLI de Azure (versión 2.57.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az dataprotection backup-vault . Obtenga más información sobre las extensiones.

Administrar el almacén de copia de seguridad con protección de datos.

Comandos

Nombre Description Tipo Estado
az dataprotection backup-vault create

Cree un recurso backupVault que pertenezca a un grupo de recursos.

 Extensión GA
az dataprotection backup-vault delete

Elimine un recurso BackupVault del grupo de recursos.

 Extensión GA
az dataprotection backup-vault list

Obtiene la lista del almacén de copia de seguridad en una suscripción o en un grupo de recursos.

 Extensión GA
az dataprotection backup-vault list-from-resourcegraph

Enumere los almacenes de copia de seguridad entre suscripciones, grupos de recursos y almacenes.

 Extensión GA
az dataprotection backup-vault resource-guard-mapping

Administrar asignaciones de ResourceGuard para un almacén de copia de seguridad.

 Extensión GA
az dataprotection backup-vault resource-guard-mapping create

Cree una asignación de ResourceGuard.

 Extensión GA
az dataprotection backup-vault resource-guard-mapping delete

Elimine la asignación de ResourceGuard.

 Extensión GA
az dataprotection backup-vault resource-guard-mapping show

Obtenga el objeto de asignación de ResourceGuard asociado al almacén y que coincida con el nombre de la solicitud.

 Extensión GA
az dataprotection backup-vault show

Obtenga un recurso que pertenezca a un grupo de recursos.

 Extensión GA
az dataprotection backup-vault update

Novedades un recurso backupVault que pertenece a un grupo de recursos. Por ejemplo, actualizando etiquetas para un recurso.

 Extensión GA
az dataprotection backup-vault wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión GA

az dataprotection backup-vault create

Cree un recurso backupVault que pertenezca a un grupo de recursos.

az dataprotection backup-vault create --resource-group
                                      --storage-setting
                                      --vault-name
                                      [--azure-monitor-alerts-for-job-failures {Disabled, Enabled}]
                                      [--cmk-encryption-key-uri]
                                      [--cmk-encryption-state {Disabled, Enabled, Inconsistent}]
                                      [--cmk-identity-type {SystemAssigned, UserAssigned}]
                                      [--cmk-infra-encryption {Disabled, Enabled}]
                                      [--cmk-uami]
                                      [--cross-region-restore-state {Disabled, Enabled}]
                                      [--cross-subscription-restore-state {Disabled, Enabled, PermanentlyDisabled}]
                                      [--e-tag]
                                      [--immutability-state {Disabled, Locked, Unlocked}]
                                      [--location]
                                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                      [--retention-duration-in-days]
                                      [--soft-delete-state {AlwaysOn, Off, On}]
                                      [--tags]
                                      [--type]
                                      [--uami]

Ejemplos

Creación de BackupVault

az dataprotection backup-vault create --type "None" --location "WestUS" --azure-monitor-alerts-for-job-failures "Enabled" --storage-setting "[{type:'LocallyRedundant',datastore-type:'VaultStore'}]" --tags key1="val1" --resource-group "SampleResourceGroup" --vault-name "swaggerExample"

Creación de BackupVault con MSI

az dataprotection backup-vault create --type "systemAssigned" --location "WestUS" --azure-monitor-alerts-for-job-failures "Enabled" --storage-setting "[{type:'LocallyRedundant',datastore-type:'VaultStore'}]" --tags key1="val1" --resource-group "SampleResourceGroup" --vault-name "swaggerExample"

Creación de BackupVault con cifrado CMK

az dataprotection backup-vault create -g "resourceGroupName" -v "vaultName" --location "eastasia" --storage-setting "[{type:'LocallyRedundant',datastore-type:'VaultStore'}]" --type "UserAssigned" --user-assigned-identities '{"/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami":{}}' --cmk-encryption-key-uri "https://samplekvazbckp.vault.azure.net/keys/testkey/3cd5235ad6ac4c11b40a6f35444bcbe1" --cmk-encryption-state "Enabled" --cmk-identity-type "UserAssigned" --cmk-infrastructure-encryption "Enabled" --cmk-user-assigned-identity-id  "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami"

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--storage-setting --storage-settings

Configuración de almacenamiento. Uso: --storage-setting "[{type:'LocallyRedundant',datastore-type:'VaultStore'}]" Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más. Marcas singulares: --storage-settings.

--vault-name -v

Nombre del almacén de copia de seguridad.

Parámetros opcionales

--azure-monitor-alerts-for-job-failures --job-failure-alerts

Propiedad que especifica si las alertas integradas de Azure Monitor deben desencadenarse para todos los trabajos con errores.

valores aceptados: Disabled, Enabled
--cmk-encryption-key-uri

Identificador URI de clave de la clave CMK que se va a usar para el cifrado. Para habilitar la rotación automática de claves, excluya el componente de versión del URI de clave.

--cmk-encryption-state

Habilite el estado de cifrado de CMK para un almacén de Backup.

valores aceptados: Disabled, Enabled, Inconsistent
--cmk-identity-type

Tipo de identidad que se va a usar para el cifrado de CMK: SystemAssigned o UserAssigned Identity.

valores aceptados: SystemAssigned, UserAssigned
--cmk-infra-encryption --cmk-infrastructure-encryption

Habilite o deshabilite el cifrado de infraestructura con CMK en este almacén. El cifrado de infraestructura solo debe configurarse al crear el almacén.

valores aceptados: Disabled, Enabled
--cmk-uami --cmk-user-assigned-identity-id

Este parámetro es necesario si el tipo de identidad es UserAssigned. Agregue el identificador de identidad administrada asignada por el usuario que se va a usar, que tiene permisos de acceso a Key Vault.

--cross-region-restore-state --crr-state

Establezca el estado CrossRegionRestore. Una vez habilitado, no se puede establecer en deshabilitado.

valores aceptados: Disabled, Enabled
--cross-subscription-restore-state --csr-state

Estado CrossSubscriptionRestore.

valores aceptados: Disabled, Enabled, PermanentlyDisabled
--e-tag

ETag opcional.

--immutability-state

Estado de inmutabilidad.

valores aceptados: Disabled, Locked, Unlocked
--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>. Cuando no se especifique, se usará la ubicación del grupo de recursos.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--retention-duration-in-days --soft-delete-retention

Duración de retención de eliminación temporal.

valor predeterminado: 14.0
--soft-delete-state

Estado de eliminación temporal.

valores aceptados: AlwaysOn, Off, On
valor predeterminado: On
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--type

IdentityType que puede ser "SystemAssigned", "UserAssigned", "SystemAssigned,UserAssigned" o "None".

--uami --user-assigned-identities

Obtiene o establece las identidades asignadas por el usuario. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dataprotection backup-vault delete

Elimine un recurso BackupVault del grupo de recursos.

az dataprotection backup-vault delete [--ids]
                                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                      [--resource-group]
                                      [--subscription]
                                      [--vault-name]
                                      [--yes]

Ejemplos

Eliminar BackupVault

az dataprotection backup-vault delete --resource-group "SampleResourceGroup" --vault-name "swaggerExample"

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--vault-name -v

Nombre del almacén de copia de seguridad.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dataprotection backup-vault list

Obtiene la lista del almacén de copia de seguridad en una suscripción o en un grupo de recursos.

az dataprotection backup-vault list [--max-items]
                                    [--next-token]
                                    [--resource-group]

Ejemplos

Enumeración del almacén de copia de seguridad en una suscripción

az dataprotection backup-vault list

Enumeración del almacén de copia de seguridad en un grupo de recursos

az dataprotection backup-vault list -g sarath-rg

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dataprotection backup-vault list-from-resourcegraph

Enumere los almacenes de copia de seguridad entre suscripciones, grupos de recursos y almacenes.

az dataprotection backup-vault list-from-resourcegraph [--resource-groups]
                                                       [--subscriptions]
                                                       [--vault-id]
                                                       [--vaults]

Ejemplos

Captura de un almacén de copia de seguridad específico

az dataprotection backup-vault list-from-resourcegraph --subscriptions 00000000-0000-0000-0000-000000000000 --resource-groups sample_rg --vaults sample_vault

Parámetros opcionales

--resource-groups

Lista de grupos de recursos.

--subscriptions

Lista de identificadores de suscripción.

--vault-id

Especifique el filtro de identificador de almacén que se va a aplicar.

--vaults

Lista de nombres de almacén.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dataprotection backup-vault show

Obtenga un recurso que pertenezca a un grupo de recursos.

az dataprotection backup-vault show [--ids]
                                    [--resource-group]
                                    [--subscription]
                                    [--vault-name]

Ejemplos

Obtención de BackupVault

az dataprotection backup-vault show --resource-group "SampleResourceGroup" --vault-name "swaggerExample"

Obtención de BackupVault con MSI

az dataprotection backup-vault show --resource-group "SampleResourceGroup" --vault-name "swaggerExample"

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--vault-name -v

Nombre del almacén de copia de seguridad.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dataprotection backup-vault update

Novedades un recurso backupVault que pertenece a un grupo de recursos. Por ejemplo, actualizando etiquetas para un recurso.

az dataprotection backup-vault update [--add]
                                      [--azure-monitor-alerts-for-job-failures {Disabled, Enabled}]
                                      [--cmk-encryption-key-uri]
                                      [--cmk-encryption-state {Disabled, Enabled, Inconsistent}]
                                      [--cmk-identity-type {SystemAssigned, UserAssigned}]
                                      [--cmk-uami]
                                      [--cross-region-restore-state {Disabled, Enabled}]
                                      [--cross-subscription-restore-state {Disabled, Enabled, PermanentlyDisabled}]
                                      [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                      [--ids]
                                      [--immutability-state {Disabled, Locked, Unlocked}]
                                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                      [--operation-requests]
                                      [--remove]
                                      [--resource-group]
                                      [--retention-duration-in-days]
                                      [--set]
                                      [--soft-delete-state {AlwaysOn, Off, On}]
                                      [--subscription]
                                      [--tags]
                                      [--tenant-id]
                                      [--type]
                                      [--uami]
                                      [--vault-name]

Ejemplos

Patch BackupVault

az dataprotection backup-vault update --azure-monitor-alerts-for-job-failures "Enabled" --tags newKey="newVal" --resource-group "SampleResourceGroup" --vault-name "swaggerExample"

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string o JSON string>.

--azure-monitor-alerts-for-job-failures --job-failure-alerts

Propiedad que especifica si las alertas integradas de Azure Monitor deben desencadenarse para todos los trabajos con errores.

valores aceptados: Disabled, Enabled
--cmk-encryption-key-uri

Identificador URI de clave de la clave administrada por el cliente.

--cmk-encryption-state

Habilite el estado de cifrado de CMK para un almacén de Backup.

valores aceptados: Disabled, Enabled, Inconsistent
--cmk-identity-type

Tipo de identidad que se va a usar para el cifrado de CMK: SystemAssigned o UserAssigned Identity.

valores aceptados: SystemAssigned, UserAssigned
--cmk-uami --cmk-user-assigned-identity-id

Este parámetro es necesario si el tipo de identidad es UserAssigned. Agregue el identificador de identidad administrada asignada por el usuario que se va a usar, que tiene permisos de acceso a Key Vault.

--cross-region-restore-state --crr-state

Establezca el estado CrossRegionRestore. Una vez habilitado, no se puede establecer en deshabilitado.

valores aceptados: Disabled, Enabled
--cross-subscription-restore-state --csr-state

Estado CrossSubscriptionRestore.

valores aceptados: Disabled, Enabled, PermanentlyDisabled
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--immutability-state

Estado de inmutabilidad.

valores aceptados: Disabled, Locked, Unlocked
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--operation-requests --resource-guard-operation-requests

ResourceGuardOperationRequests en los que se realizará la comprobación laC admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más. Marcas singulares: --operation-requests.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--retention-duration-in-days --soft-delete-retention

Duración de retención de eliminación temporal.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=.

--soft-delete-state

Estado de eliminación temporal.

valores aceptados: AlwaysOn, Off, On
--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--tenant-id

Identificador de inquilino para llamadas entre inquilinos.

--type

IdentityType que puede ser "SystemAssigned", "UserAssigned", "SystemAssigned,UserAssigned" o "None".

--uami --user-assigned-identities

Obtiene o establece las identidades asignadas por el usuario. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--vault-name -v

Nombre del almacén de copia de seguridad.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dataprotection backup-vault wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az dataprotection backup-vault wait [--created]
                                    [--custom]
                                    [--deleted]
                                    [--exists]
                                    [--ids]
                                    [--interval]
                                    [--resource-group]
                                    [--subscription]
                                    [--timeout]
                                    [--updated]
                                    [--vault-name]

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False
--vault-name -v

Nombre del almacén de copia de seguridad.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.