Actualizar la redundancia de almacenamiento de copia de seguridad periódica de Azure Cosmos DB

SE APLICA A: NoSQL MongoDB Cassandra Gremlin Table

De forma predeterminada, Azure Cosmos DB almacena los datos de copia de seguridad de modo periódico en el almacenamiento de blobs con redundancia geográfica que se replica en una región emparejada. Puede invalidar la redundancia predeterminada del almacenamiento de copia de seguridad. En este artículo se explica cómo actualizar la redundancia de almacenamiento de copia de seguridad con la CLI de Azure y PowerShell. También muestra cómo configurar una directiva de Azure en sus cuentas para exigir la redundancia de almacenamiento necesaria.

Requisitos previos

• Una cuenta existente de Azure Cosmos DB.
  • Si tiene una suscripción de Azure, cree una nueva cuenta.
  • Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
  • Como alternativa, puede probar Azure Cosmos DB gratis antes de confirmarlo.

Actualizar redundancia de almacenamiento

Siga estos pasos para actualizar la redundancia de almacenamiento de copia de seguridad.

Azure Portal

1. Inicie sesión en Azure Portal y vaya a su cuenta de Azure Cosmos DB.

2. Abra el panel Copia de seguridad y restauración, actualice la redundancia del almacenamiento de copia de seguridad y seleccione Enviar. La operación tardará unos minutos en completarse.

   

CLI de Azure

1. Asegúrese de tener la última versión de la CLI de Azure o una versión superior o igual a 2.30.0. Si tuviera instalada la extensión cosmosdb-preview, asegúrese de quitarla.

2. Use el comando az cosmosdb locations show para obtener las opciones de redundancia de copia de seguridad disponibles en las regiones donde exista su cuenta.

   az cosmosdb locations show \
         --location <region-name>
   

   La salida debería incluir JSON similar a este ejemplo:

   {
     "id": "subscriptionId/<Subscription_ID>/providers/Microsoft.DocumentDB/locations/eastus/",
     "name": "East US",
     "properties": {
       "backupStorageRedundancies": [
         "Geo",
         "Zone",
         "Local"
       ],
       "isResidencyRestricted": false,
       "supportsAvailabilityZone": true
     },
     "type": "Microsoft.DocumentDB/locations"
   }
   

   Nota:

   El comando anterior muestra una lista de las redundancias de copia de seguridad disponibles en la región específica. Los valores admitidos se muestran en la propiedad backupStorageRedundancies. Por ejemplo, algunas regiones pueden admitir hasta tres opciones de redundancia: Geoárea, Zona y Local. Otras regiones podrían admitir un subconjunto de estas opciones. Antes de actualizar, elija la opción de redundancia de almacenamiento de copia de seguridad compatible en todas las regiones que use su cuenta de Azure Cosmos DB.

3. Use el comando az cosmosdb update con la opción de redundancia de copia de seguridad seleccionada para actualizar la redundancia de copia de seguridad en una cuenta existente.

   az cosmosdb update \
       --resource-group <resource-group-name> \
       --name <account_name> \
       --backup-redundancy Zone
   

4. De forma alternativa, use el comando az cosmosdb create para crear una nueva cuenta con la opción de redundancia de copia de seguridad seleccionada.

   az cosmosdb create \
       --resource-group <resource-group-name> \
       --name <account-name> \
       --backup-redundancy Geo \
       --locations regionName=<azure-region>
   

Azure PowerShell

1. Instale la versión más reciente de Azure PowerShell o una versión superior o igual a 1.4.0.

   $parameters = @{
       Name = "Az.CosmosDB"
       RequiredVersion = "1.4.0"
   }
   Install-Module @parameters
   

2. Use el cmdlet Get-AzCosmosDBLocation para obtener las opciones de redundancia de copia de seguridad disponibles en las regiones donde exista su cuenta.

   $parameters = @{
       Location = "<azure-region>"
   }
   (Get-AzCosmosDBLocation @parameters).Properties
   

   La salida debería incluir contenido similar a este ejemplo:

   SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
   ------------------------ --------------------- -------------------------
                       True                 False {Geo, Zone, Local}
   

   Nota:

   El comando anterior muestra una lista de las redundancias de copia de seguridad disponibles en la región específica. Los valores admitidos se muestran en la propiedad BackupStorageRedundancies. Por ejemplo, algunas regiones pueden admitir hasta tres opciones de redundancia: Geoárea, Zona y Local. Otras regiones podrían admitir un subconjunto de estas opciones. Antes de actualizar, elija la opción de redundancia de almacenamiento de copia de seguridad compatible en todas las regiones que use su cuenta de Azure Cosmos DB.

3. Use el cmdlet Update-AzCosmosDBAccount con la opción de redundancia de copia de seguridad seleccionada para actualizar la redundancia de copia de seguridad en una cuenta existente:

   $parameters = @{
       ResourceGroupName "<resource-group-name>"
       Name = "<account-name>"
       BackupStorageRedundancy = "Zone"
   }
   Update-AzCosmosDBAccount @parameters
   

4. De forma alternativa, use el cmdlet New-AzCosmosDBAccount para crear una nueva cuenta con la opción de redundancia de copia de seguridad seleccionada:

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       Location = "<azure-region>"
       BackupPolicyType = "Periodic"
       BackupStorageRedundancy = "Geo"
   }
   New-AzCosmosDBAccount @parameters
   

Añadir Azure Policy para la redundancia de almacenamiento de copia de seguridad

Azure Policy le ayuda a aplicar los estándares de la organización y a evaluar el cumplimiento a gran escala. Para obtener más información, consulte ¿Qué es Azure Policy?.

En el ejemplo siguiente, se muestra cómo agregar una directiva de Azure a las cuentas de Azure Cosmos DB para validar (mediante audit) que tengan la redundancia de copia de seguridad configurada en Local.

"parameters": {},
"policyRule": {
  "if": {
    "allOf": [
      {
        "field": "Microsoft.DocumentDB/databaseAccounts/backupPolicy.periodicModeProperties.backupStorageRedundancy",
        "match": "Local"
      }
    ]
  },
  "then": {
    "effect": "audit"
  }
}

Pasos siguientes

Modificación del intervalo de copias de seguridad y el período de retención