I dati di backup in modalità periodo di Azure Cosmos DB vengono replicati in modi diversi. Per impostazione predefinita, se l'area primaria supporta le aree associate, Azure Cosmos DB archivia i dati di backup in modalità periodica nell’archiviazione BLOB con ridondanza geografica, che viene replicata nell'area abbinata. È possibile eseguire l'override della ridondanza predefinita dell'archiviazione di backup. In alternativa, se si usa un'area non associata, è necessario scegliere in modo esplicito la ridondanza dell'archiviazione di backup. Questo articolo descrive come aggiornare la ridondanza dell'archiviazione di backup usando l'interfaccia della riga di comando di Azure e PowerShell. Viene mostrato inoltre come configurare una policy di Azure sui propri account per applicare la ridondanza di archiviazione necessaria.
Prerequisiti
- Un account di Azure Cosmos DB esistente.
Aggiornare la ridondanza di archiviazione
Utilizzare la procedura seguente per aggiornare la ridondanza della memorizzazione di backup.
Accedere al portale di Azure e passare all'account Azure Cosmos DB.
Aprire il riquadro Backup e ripristino, aggiornare la ridondanza dell'archiviazione di backup e selezionare Submit. Il completamento dell'operazione richiede alcuni minuti.
Assicurarsi di avere la versione più recente dell'interfaccia della riga di comando di Azure o una versione successiva o uguale a 2.30.0. Se è installata l’estensione cosmosdb-preview, assicurarsi di rimuoverla.
Usare il comando az cosmosdb locations show per ottenere le opzioni di ridondanza di backup disponibili nelle aree in cui è presente l'account.
az cosmosdb locations show \
--location <region-name>
L'output deve includere lo standard JSON simile a questo esempio:
{
"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"
}
Annotazioni
Il comando precedente mostra un elenco delle ridondanze di backup disponibili nell'area specifica. I valori supportati vengono visualizzati nella proprietà backupStorageRedundancies. Ad esempio, alcune aree possono supportare fino a tre opzioni di ridondanza: Posizione geografica, Zona e Locale. Altre aree possono supportare un subset di queste opzioni. Prima dell'aggiornamento, scegliere l'opzione di ridondanza dell'archiviazione di backup supportata in tutte le aree usate dall'account Azure Cosmos DB.
Usare il comando az cosmosdb update con l'opzione di ridondanza di backup scelta per aggiornare la ridondanza del backup in un account esistente.
az cosmosdb update \
--resource-group <resource-group-name> \
--name <account_name> \
--backup-redundancy Zone
In alternativa, usare il comando az cosmosdb create per creare un nuovo account con l'opzione di ridondanza di backup scelta.
az cosmosdb create \
--resource-group <resource-group-name> \
--name <account-name> \
--backup-redundancy Geo \
--locations regionName=<azure-region>
Installare la versione più recente di Azure PowerShell o una versione successiva o uguale a 1.4.0.
$parameters = @{
Name = "Az.CosmosDB"
RequiredVersion = "1.4.0"
}
Install-Module @parameters
Usare il cmdlet Get-AzCosmosDBLocation per ottenere le opzioni di ridondanza del backup disponibili nelle aree in cui è presente l'account.
$parameters = @{
Location = "<azure-region>"
}
(Get-AzCosmosDBLocation @parameters).Properties
L'output deve includere contenuto simile all'esempio seguente:
SupportsAvailabilityZone IsResidencyRestricted BackupStorageRedundancies
------------------------ --------------------- -------------------------
True False {Geo, Zone, Local}
Annotazioni
Il comando precedente mostra un elenco delle ridondanze di backup disponibili nell'area specifica. I valori supportati vengono visualizzati nella proprietà BackupStorageRedundancies. Ad esempio, alcune aree possono supportare fino a tre opzioni di ridondanza: Posizione geografica, Zona e Locale. Altre aree possono supportare un subset di queste opzioni. Prima dell'aggiornamento, scegliere l'opzione di ridondanza dell'archiviazione di backup supportata in tutte le aree usate dall'account Azure Cosmos DB.
Usare il cmdlet Update-AzCosmosDBAccount con l'opzione di ridondanza di backup scelta per aggiornare la ridondanza del backup in un account esistente:
$parameters = @{
ResourceGroupName "<resource-group-name>"
Name = "<account-name>"
BackupStorageRedundancy = "Zone"
}
Update-AzCosmosDBAccount @parameters
In alternativa, usare il cmdlet New-AzCosmosDBAccount per creare un nuovo account con l'opzione di ridondanza di backup scelta:
$parameters = @{
ResourceGroupName = "<resource-group-name>"
Name = "<account-name>"
Location = "<azure-region>"
BackupPolicyType = "Periodic"
BackupStorageRedundancy = "Geo"
}
New-AzCosmosDBAccount @parameters
Aggiungere un criterio di Azure per la ridondanza di archiviazione di backup
Criteri di Azure aiuta a imporre standard aziendali e a valutare la conformità su larga scala. Per altre informazioni, vedere Informazioni su Criteri di Azure.
L'esempio seguente mostra come aggiungere una politica di Azure per gli account Azure Cosmos DB per convalidare (usando audit) che abbiano la ridondanza del backup configurata a Local.
"parameters": {},
"policyRule": {
"if": {
"allOf": [
{
"field": "Microsoft.DocumentDB/databaseAccounts/backupPolicy.periodicModeProperties.backupStorageRedundancy",
"match": "Local"
}
]
},
"then": {
"effect": "audit"
}
}
Passaggi successivi
