Configurare la replica di oggetti per i BLOB in blocchi

Quando si configura la replica di oggetti nella Azure portal, è sufficiente configurare i criteri nell'account di origine. Il portale di Azure crea automaticamente la politica sull'account di destinazione dopo averlo configurato per l'account di origine.

Per creare un criterio di replica nella Azure portal, seguire questa procedura:

1. Passare all'account di archiviazione di origine nel portale di Azure.

2. In Data management, selezionare Replica oggetto.

3. Selezionare Crea regole di replica.

4. Selezionare la sottoscrizione di destinazione e l'account di archiviazione.

5. Nella sezione Dettagli coppia contenitori, selezionare un contenitore dall'account di origine e uno dall'account di destinazione. È possibile creare fino a 10 coppie di contenitori per ogni criterio di replica dal Azure portal. Per configurare più di 10 coppie di contenitori (fino a 1000), vedere Configurare la replica di oggetti usando un file JSON.

   L'immagine seguente mostra un set di regole di replica.

   

6. Se necessario, specificare uno o più filtri per copiare solo i BLOB che corrispondono a un modello di prefisso. Ad esempio, se si specifica un prefisso b, vengono replicati solo i BLOB il cui nome inizia con tale lettera. È possibile specificare una directory virtuale come parte del prefisso. È possibile aggiungere un massimo di cinque corrispondenze di prefisso. La stringa di prefisso non supporta caratteri jolly.

   L'immagine seguente mostra i filtri che limitano i BLOB copiati come parte di una regola di replica.

   

7. Per impostazione predefinita, l'ambito di copia è impostato per copiare solo nuovi oggetti. Per copiare tutti gli oggetti nel contenitore o per copiare oggetti a partire da una data e un'ora personalizzate, selezionare il collegamento di modifica e configurare l'ambito di copia per la coppia di contenitori.

   L'immagine seguente mostra un ambito di copia personalizzato che copia gli oggetti da una data e un'ora specificate.

   

8. Selezionare Salva e applica per creare i criteri di replica e avviare la replica dei dati.

Dopo aver configurato la replica di oggetti, il Azure portal visualizza i criteri e le regole di replica, come illustrato nell'immagine seguente.

Per creare criteri di replica con PowerShell, installare prima la versione 2.5.0 o versione successiva del modulo Az.Storage PowerShell. Per altre informazioni sull'installazione di Azure PowerShell, vedere Installare Azure PowerShell con PowerShellGet.

Nell'esempio seguente viene illustrato come creare prima un criterio di replica nell'account di destinazione e quindi nell'account di origine. Ricordare di sostituire i valori tra parentesi angolari con valori personalizzati:

# Sign in to your Azure account.
Connect-AzAccount

# Set variables.
$rgName = "<resource-group>"
$srcAccountName = "<source-storage-account>"
$destAccountName = "<destination-storage-account>"
$srcContainerName1 = "source-container1"
$destContainerName1 = "dest-container1"
$srcContainerName2 = "source-container2"
$destContainerName2 = "dest-container2"

# Enable blob versioning and change feed on the source account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -EnableChangeFeed $true `
    -IsVersioningEnabled $true

# Enable blob versioning on the destination account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName `
    -IsVersioningEnabled $true

# List the service properties for both accounts.
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName

# Create containers in the source and destination accounts.
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $srcAccountName |
    New-AzStorageContainer $srcContainerName1
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $destAccountName |
    New-AzStorageContainer $destContainerName1
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $srcAccountName |
    New-AzStorageContainer $srcContainerName2
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $destAccountName |
    New-AzStorageContainer $destContainerName2

# Define replication rules for each container.
$rule1 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName1 `
    -DestinationContainer $destContainerName1 `
    -PrefixMatch b
$rule2 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName2 `
    -DestinationContainer $destContainerName2  `
    -MinCreationTime 2021-09-01T00:00:00Z

# Create the replication policy on the destination account.
$destPolicy = Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName `
    -PolicyId default `
    -SourceAccount $srcAccountName `
    -Rule $rule1,$rule2

# Create the same policy on the source account.
Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -InputObject $destPolicy

Per creare criteri di replica con Azure CLI, installare prima Azure CLI versione 2.11.1 o successiva. Per altre informazioni, vedere Introduzione ad Azure CLI.

Successivamente, abilita il controllo delle versioni BLOB sugli account di archiviazione di origine e di destinazione e abilita il feed di modifiche sull'account di origine chiamando il comando az storage account blob-service-properties update. Ricordare di sostituire i valori tra parentesi angolari con valori personalizzati:

az login

az storage account blob-service-properties update \
    --resource-group <resource-group> \
    --account-name <source-storage-account> \
    --enable-versioning \
    --enable-change-feed

az storage account blob-service-properties update \
    --resource-group <resource-group> \
    --account-name <dest-storage-account> \
    --enable-versioning

Creare i contenitori di origine e di destinazione nei rispettivi account storage.

az storage container create \
    --account-name <source-storage-account> \
    --name source-container-1 \
    --auth-mode login
az storage container create \
    --account-name <source-storage-account> \
    --name source-container-2 \
    --auth-mode login

az storage container create \
    --account-name <dest-storage-account> \
    --name dest-container-1 \
    --auth-mode login
az storage container create \
    --account-name <dest-storage-account> \
    --name dest-container-2 \
    --auth-mode login

Creare una nuova policy di replica e la regola associata nell'account di destinazione tramite il comando az storage account o-policy create.

az storage account or-policy create \
    --account-name <dest-storage-account> \
    --resource-group <resource-group> \
    --source-account <source-storage-account> \
    --destination-account <dest-storage-account> \
    --source-container source-container-1 \
    --destination-container dest-container-1 \
    --min-creation-time '2021-09-01T00:00:00Z' \
    --prefix-match a

Azure Storage imposta l'ID della policy per la nuova policy quando viene creata. Per aggiungere ulteriori regole alla politica, chiamare il comando az storage account or-policy rule add e specificare l'ID della politica.

az storage account or-policy rule add \
    --account-name <dest-storage-account> \
    --resource-group <resource-group> \
    --source-container source-container-2 \
    --destination-container dest-container-2 \
    --policy-id <policy-id> \
    --prefix-match b

Quindi, crea la policy nell'account di origine usando l'ID della policy.

az storage account or-policy show \
    --resource-group <resource-group> \
    --account-name <dest-storage-account> \
    --policy-id <policy-id> |
    az storage account or-policy create --resource-group <resource-group> \
    --account-name <source-storage-account> \
    --policy "@-"

N/A

Per configurare la replica di oggetti nell'account di destinazione con un file JSON nel Azure portal, seguire questa procedura:

1. Creare un file JSON locale che definisce i criteri di replica nell'account di destinazione. Impostare il campo policyId su default in modo che Azure Storage definirà l'ID criterio.

   Un modo semplice per creare un file JSON che definisce un criterio di replica consiste innanzitutto nel creare un criterio di replica di test tra due account storage nel Azure portal. È quindi possibile scaricare le regole di replica e modificare il file JSON in base alle esigenze.

2. Passare alle impostazioni di replica oggetti per l'account di destinazione nel portale di Azure.

3. Selezionare Carica regole di replica.

4. Caricare il file JSON. Il Azure portal visualizza i criteri e le regole che verranno creati, come illustrato nell'immagine seguente.

   

5. Selezionare Carica per creare i criteri di replica nell'account di destinazione.

È quindi possibile scaricare un file JSON contenente la definizione di criteri che è possibile fornire a un altro utente per configurare l'account di origine. Per scaricare questo file JSON, seguire questa procedura:

1. Passare alle impostazioni di replica di oggetti per l'account di destinazione nel portale di Azure.

2. Selezionare il pulsante Altro accanto al criterio da scaricare, quindi selezionare Scarica regole, come illustrato nell'immagine seguente.

   

3. Salvare il file JSON nel computer locale per condividerlo con un altro utente per configurare i criteri nell'account di origine.

Il file JSON scaricato include l'ID della politica che Azure Storage ha creato per la politica sull'account di destinazione. È necessario usare lo stesso ID della politica per configurare la replica di oggetti nell'account di origine.

Tenere presente che il caricamento di un file JSON per creare un criterio di replica per l'account di destinazione tramite il Azure portal non crea automaticamente gli stessi criteri nell'account di origine. Un altro utente deve creare i criteri nell'account di origine prima che Azure Storage inizi la replica degli oggetti.

Per scaricare un file JSON contenente la definizione dei criteri di replica per l'account di destinazione da PowerShell, chiamare il comando Get-AzStorageObjectReplicationPolicy per restituire i criteri. Convertire quindi il criterio in JSON e salvarlo come file locale, come illustrato nell'esempio seguente. Ricordarsi di sostituire i valori tra parentesi angolari e il percorso del file con i propri valori:

$rgName = "<resource-group>"
$destAccountName = "<destination-storage-account>"

$destPolicy = Get-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName
$destPolicy | ConvertTo-Json -Depth 5 > c:\temp\json.txt

Per usare il file JSON per definire i criteri di replica nell'account di origine con PowerShell, recuperare il file locale e convertirlo da JSON a un oggetto . Chiamare quindi il comando Set-AzStorageObjectReplicationPolicy per configurare i criteri nell'account di origine, come illustrato nell'esempio seguente.

Quando si esegue l'esempio, assicurarsi di impostare il -ResourceGroupName parametro sul gruppo di risorse per l'account di origine e sul -StorageAccountName parametro sul nome dell'account di origine. Ricordarsi anche di sostituire i valori tra parentesi angolari e il percorso del file con i propri valori:

$object = Get-Content -Path C:\temp\json.txt | ConvertFrom-Json
Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -PolicyId $object.PolicyId `
    -SourceAccount $object.SourceAccount `
    -DestinationAccount $object.DestinationAccount `
    -Rule $object.Rules

Per scrivere la definizione dei criteri di replica per l'account di destinazione in un file JSON da Azure CLI, chiamare il comando az storage account or-policy show e reindirizzarne l'output verso un file.

L'esempio seguente scrive la definizione dei criteri in un file JSON denominato policy.json. Ricordarsi di sostituire i valori tra parentesi angolari e il percorso del file con i propri valori:

az storage account or-policy show \
    --account-name <dest-account-name> \
    --policy-id  <policy-id> > policy.json

Per usare il file JSON per configurare i criteri di replica nell'account di origine con Azure CLI, chiamare il az storage account o-policy create comando e fare riferimento al file policy.json. Ricordarsi di sostituire i valori tra parentesi angolari e il percorso del file con i propri valori:

az storage account or-policy create \
    -resource-group <resource-group> \
    --source-account <source-account-name> \
    --policy @policy.json

N/A

Abilitare la replica dei tag dal pannello Replica oggetti quando si crea una regola o si aggiornano le regole esistenti usando la colonna Replica tag.

Per configurare la replica dei tag di indice BLOB durante la creazione di una nuova regola, seguire questa procedura:

1. Passare all'account di archiviazione di origine nel portale Azure.
2. In Data management, selezionare Replica oggetto.
3. Selezionare Crea regole di replica.
4. Selezionare Abilita replica tag e infine Salva e applica per configurare la replica dei tag di indice BLOB.

Per configurare la replicazione dei tag di indice BLOB per le regole esistenti, seguire questa procedura:

1. Passare alla scheda dei Tuoi account nella pagina Replica degli oggetti
2. Selezionare l'opzione Abilita nella colonna Replica tag in Oggetti copiati dalla tabella dell'account e selezionare OK.
3. Lo stato della colonna di replica dei tag rispetto a una regola ora mostra Abilitato.

Per disabilitare la replica dei tag di indice BLOB per le regole esistenti, seguire questa procedura:

1. Passare alla scheda Account nella pagina Replica oggetti
2. Selezionare una regola esistente e selezionare Modifica regole dal menu '...'
3. Deselezionare l'opzione Abilita replica tag e infine selezionare Salva e applica per disabilitare la replica dei tag di indice BLOB.

Non disponibile.

Non disponibile.

Gli utenti possono usare le API REST esistenti: Criteri di replica degli oggetti - Creazione o aggiornamento - API REST per configurare i criteri per la replica dei tag impostati nei BLOB.

Aggiungere la riga “tagsReplication”: { “enabled”: true } seguente durante la creazione o l'aggiornamento delle regole di replica nell'account di origine.

La replica dei tag è supportata nell'API versione 2022-05-01 e successive. È possibile aggiungere il nuovo campo tagsReplication ai criteri di replica.

Esempio:

{
    "sourceAccount": "<source-account-name>",
    "destinationAccount": "<destination-account-name>",
    "tagsReplication":
    {
     "enabled": true
    },
    "rules":
    [
        {
            "ruleId": "<rule-id>",
            "sourceContainer": "<source-container-name>",
            "destinationContainer": "<destination-container-name>"
        }
    ]
}

È possibile abilitare le metriche usando il pannello Oggetto Replicazione dalla nuova colonna Metriche o modificando la sezione Modifica regole di un criterio da "..." nella riga del criterio OR.

Non ancora supportato.

Non ancora supportato.

L'abilitazione delle metriche è supportata nell'API versione 2021-08-01 e successive. È possibile aggiungere il nuovo campo delle metriche ai criteri di replica. Esempio:

{
    "sourceAccount": "<source-account-name>",
    "destinationAccount": "<destination-account-name>",
    "metrics":
    {
     "enabled": true
    },
    "rules":
    [
        {
            "ruleId": "<rule-id>",
            "sourceContainer": "<source-container-name>",
            "destinationContainer": "<destination-container-name>"
        }
    ]
}

Per controllare lo stato della replica per un blob nell'account di origine nel portale di Azure, seguire questa procedura:

1. Passare all'account di origine nella Azure portal.
2. Individuare il contenitore che include il blob di origine.
3. Selezionare il BLOB per visualizzarne le proprietà. Se il BLOB è stato replicato correttamente, nella sezione Replica oggetti lo stato è impostato su Completa. Sono elencati anche l'ID dei criteri di replica e l'ID per la regola che regola la replica degli oggetti per questo contenitore.

Per controllare lo stato della replica di un BLOB nell'account di origine con PowerShell, ottieni il valore della proprietà ReplicationStatus degli oggetti di replica, come illustrato nell'esempio seguente. Ricordare di sostituire i valori tra parentesi angolari con valori personalizzati:

$ctxSrc = (Get-AzStorageAccount -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName).Context
$blobSrc = Get-AzStorageBlob -Container $srcContainerName1 `
    -Context $ctxSrc `
    -Blob <blob-name>
$blobSrc.BlobProperties.ObjectReplicationSourceProperties[0].Rules[0].ReplicationStatus

Per controllare lo stato di replica di un BLOB nell'account di origine con Azure CLI, ottieni il valore della proprietà status della replica di oggetti, come illustrato nell'esempio seguente.

az storage blob show \
    --account-name <source-account-name> \
    --container-name <source-container-name> \
    --name <source-blob-name> \
    --query 'objectReplicationSourceProperties[].rules[].status' \
    --output tsv \
    --auth-mode login

Se lo stato di replica per un BLOB nell'account di origine indica un errore, esaminare le possibili cause seguenti:

• Assicurarsi che i criteri di replica degli oggetti siano configurati nell'account di destinazione.
• Verificare che il contenitore di destinazione esista ancora.
• Se il BLOB di origine è stato crittografato con una chiave fornita dal cliente come parte di un'operazione di scrittura, la replica degli oggetti avrà esito negativo. Per altre informazioni sulle chiavi fornite dal cliente, vedere Provide una chiave di crittografia in una richiesta di Blob storage.

N/A

Per rimuovere un criterio di replica nella Azure portal, seguire questa procedura:

1. Passare all'account di archiviazione di origine nel portale di Azure.
2. In Impostazioni selezionare Replica di oggetti.
3. Selezionare il pulsante Altro accanto al nome del criterio.
4. Selezionare Elimina regole.

Per rimuovere un criterio di replica, eliminare il criterio sia dall'account di origine che da quello di destinazione. L'eliminazione del criterio comporta anche l'eliminazione di tutte le regole associate.

# Remove the policy from the destination account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $destAccountName `
    -PolicyId $destPolicy.PolicyId

# Remove the policy from the source account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
    -StorageAccountName $srcAccountName `
    -PolicyId $destPolicy.PolicyId

Per rimuovere un criterio di replica, eliminare il criterio sia dall'account di origine che da quello di destinazione. L'eliminazione del criterio comporta anche l'eliminazione di tutte le regole associate.

az storage account or-policy delete \
    --policy-id <policy-id> \
    --account-name <source-storage-account> \
    --resource-group <resource-group>

az storage account or-policy delete \
    --policy-id <policy-id> \
    --account-name <dest-storage-account> \
    --resource-group <resource-group>

N/A