Konfigurieren der Objektreplikation für Block-Blobs

Wenn Sie die Objektreplikation im Azure portal konfigurieren, müssen Sie die Richtlinie nur für das Quellkonto konfigurieren. Die Azure portal erstellt die Richtlinie automatisch für das Zielkonto, nachdem Sie sie für das Quellkonto konfiguriert haben.

Führen Sie die folgenden Schritte aus, um eine Replikationsrichtlinie im Azure portal zu erstellen:

1. Navigieren Sie zum Quellspeicherkonto im Azure-Portal.

2. Wählen Sie unter Data managementObjektreplikation aus.

3. Wählen Sie "Replikationsregeln erstellen" aus.

4. Wählen Sie das Zielabonnement und das Speicherkonto aus.

5. Wählen Sie im Abschnitt "Containerpaardetails " einen Quellcontainer aus dem Quellkonto und einen Zielcontainer aus dem Zielkonto aus. Sie können bis zu 10 Containerpaare pro Replikationsrichtlinie aus dem Azure portal erstellen. Informationen zum Konfigurieren von mehr als 10 Containerpaaren (bis zu 1000) finden Sie unter Konfigurieren der Objektreplikation mithilfe einer JSON-Datei.

   Die folgende Abbildung zeigt eine Reihe von Replikationsregeln.

   

6. Geben Sie bei Bedarf einen oder mehrere Filter an, um nur Blobs zu kopieren, die einem Präfixmuster entsprechen. Wenn Sie beispielsweise ein Präfix bangeben, werden nur Blobs, deren Name mit diesem Buchstaben beginnt, repliziert. Sie können ein virtuelles Verzeichnis als Teil des Präfixes angeben. Sie können maximal fünf Präfix-Übereinstimmungen hinzufügen. Die Präfixzeichenfolge unterstützt keine Wildcardzeichen.

   Die folgende Abbildung zeigt Filter, die einschränken, welche Blobs als Teil einer Replikationsregel kopiert werden.

   

7. Standardmäßig ist der Kopierbereich so festgelegt, dass nur neue Objekte kopiert werden. Wenn Sie alle Objekte im Container kopieren oder Objekte ab einem benutzerdefinierten Datum und einer benutzerdefinierten Uhrzeit kopieren möchten, wählen Sie den Änderungslink aus, und konfigurieren Sie den Kopierbereich für das Containerpaar.

   Die folgende Abbildung zeigt einen benutzerdefinierten Kopierbereich, der Objekte ab einem bestimmten Datum und einer bestimmten Uhrzeit kopiert.

   

8. Wählen Sie "Speichern" aus, und wenden Sie sie an, um die Replikationsrichtlinie zu erstellen und mit der Replikation von Daten zu beginnen.

Nachdem Sie die Objektreplikation konfiguriert haben, zeigt die Azure portal die Replikationsrichtlinie und -regeln an, wie in der folgenden Abbildung dargestellt.

Um eine Replikationsrichtlinie mit PowerShell zu erstellen, installieren Sie zuerst version 2.5.0 oder höher des Az.Storage PowerShell-Moduls. Weitere Informationen zum Installieren von Azure PowerShell finden Sie unter Install Azure PowerShell mit PowerShellGet.

Das folgende Beispiel zeigt, wie Sie zuerst eine Replikationsrichtlinie für das Zielkonto und dann für das Quellkonto erstellen. Denken Sie daran, die Werte in eckigen Klammern durch Ihre eigenen Werte zu ersetzen:

# 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

Um eine Replikationsrichtlinie mit Azure CLI zu erstellen, installieren Sie zuerst Azure CLI Version 2.11.1 oder höher. Weitere Informationen finden Sie unter Get started mit Azure CLI.

Aktivieren Sie als Nächstes die Blob-Versionierung für die Quell- und Ziel-Speicherkonten und aktivieren Sie den Änderungsfeed für das Quellkonto, indem Sie den Befehl az storage account blob-service-properties update aufrufen. Denken Sie daran, die Werte in eckigen Klammern durch Ihre eigenen Werte zu ersetzen:

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

Erstellen Sie die Quell- und Zielcontainer in ihren jeweiligen Speicherkonten.

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

Erstellen Sie eine neue Replikationsrichtlinie und eine zugehörige Regel für das Zielkonto, indem Sie "az storage account or-policy create" aufrufen.

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 legt die Richtlinien-ID für die neue Richtlinie fest, wenn sie erstellt wird. Um der Richtlinie zusätzliche Regeln hinzuzufügen, rufen Sie az storage account or-policy rule add auf und geben Sie die Richtlinien-ID an.

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

Erstellen Sie als Nächstes die Richtlinie für das Quellkonto mithilfe der Richtlinien-ID.

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

Führen Sie die folgenden Schritte aus, um die Objektreplikation für das Zielkonto mit einer JSON-Datei im Azure portal zu konfigurieren:

1. Erstellen Sie eine lokale JSON-Datei, die die Replikationsrichtlinie für das Zielkonto definiert. Legen Sie das Feld policyId auf default fest, sodass Azure Storage die Richtlinien-ID definiert.

   Eine einfache Möglichkeit zum Erstellen einer JSON-Datei, die eine Replikationsrichtlinie definiert, besteht darin, zuerst eine Testreplikationsrichtlinie zwischen zwei storage Konten in der Azure portal zu erstellen. Anschließend können Sie die Replikationsregeln herunterladen und die JSON-Datei nach Bedarf ändern.

2. Navigieren Sie zu den Objektreplikation-Einstellungen für das Zielkonto im Azure-Portal.

3. Wählen Sie "Upload-Replikationsregeln" aus.

4. Laden Sie die JSON-Datei hoch. Die Azure portal zeigt die Richtlinie und Regeln an, die erstellt werden, wie in der folgenden Abbildung dargestellt.

   

5. Wählen Sie "Hochladen" aus, um die Replikationsrichtlinie für das Zielkonto zu erstellen.

Anschließend können Sie eine JSON-Datei herunterladen, die die Richtliniendefinition enthält, die Sie einem anderen Benutzer zum Konfigurieren des Quellkontos bereitstellen können. Führen Sie die folgenden Schritte aus, um diese JSON-Datei herunterzuladen:

1. Navigieren Sie zu den Objektreplikation Einstellungen für das Zielkonto im Azure-Portal.

2. Wählen Sie die Schaltfläche "Weitere " neben der Richtlinie aus, die Sie herunterladen möchten, und wählen Sie dann "Regeln herunterladen" aus, wie in der folgenden Abbildung dargestellt.

   

3. Speichern Sie die JSON-Datei auf Ihrem lokalen Computer, um sie für einen anderen Benutzer freizugeben, um die Richtlinie für das Quellkonto zu konfigurieren.

Die heruntergeladene JSON-Datei enthält die Richtlinien-ID, die Azure Storage für die Richtlinie auf dem Zielkonto erstellt hat. Sie müssen dieselbe Richtlinien-ID verwenden, um die Objektreplikation für das Quellkonto zu konfigurieren.

Beachten Sie, dass das Hochladen einer JSON-Datei zum Erstellen einer Replikationsrichtlinie für das Zielkonto über die Azure portal nicht automatisch dieselbe Richtlinie im Quellkonto erstellt. Ein anderer Benutzer muss die Richtlinie für das Quellkonto erstellen, bevor Azure Storage mit der Replikation von Objekten beginnt.

Rufen Sie zum Herunterladen einer JSON-Datei, die die Replikationsrichtliniendefinition für das Zielkonto aus PowerShell enthält, den Befehl Get-AzStorageObjectReplicationPolicy auf, um die Richtlinie zurückzugeben. Konvertieren Sie dann die Richtlinie in JSON, und speichern Sie sie als lokale Datei, wie im folgenden Beispiel gezeigt. Denken Sie daran, Werte in spitzen Klammern und den Dateipfad durch Ihre eigenen Werte zu ersetzen.

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

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

Um die JSON-Datei zum Definieren der Replikationsrichtlinie für das Quellkonto mit PowerShell zu verwenden, rufen Sie die lokale Datei ab und konvertieren sie aus JSON in ein Objekt. Rufen Sie dann den Befehl Set-AzStorageObjectReplicationPolicy auf, um die Richtlinie für das Quellkonto zu konfigurieren, wie im folgenden Beispiel gezeigt.

Achten Sie beim Ausführen des Beispiels darauf, den -ResourceGroupName Parameter auf die Ressourcengruppe für das Quellkonto und den -StorageAccountName Parameter auf den Namen des Quellkontos festzulegen. Denken Sie auch daran, die Werte in spitzen Klammern und den Dateipfad durch Ihre eigenen Werte zu ersetzen.

$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

Um die Replikationsrichtliniendefinition für das Zielkonto in eine JSON-Datei aus der Azure CLI zu schreiben, rufen Sie den Befehl az storage account or-policy show auf und leiten Sie die Ausgabe in eine Datei um.

Im folgenden Beispiel wird die Richtliniendefinition in eine JSON-Datei mit dem Namen policy.jsongeschrieben. Denken Sie daran, Werte in spitzen Klammern und den Dateipfad durch Ihre eigenen Werte zu ersetzen.

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

Um die JSON-Datei zum Konfigurieren der Replikationsrichtlinie für das Quellkonto mit Azure CLI zu verwenden, rufen Sie den Befehl az storage account or-policy create auf und verweisen Sie auf die Datei policy.json. Denken Sie daran, Werte in spitzen Klammern und den Dateipfad durch Ihre eigenen Werte zu ersetzen.

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

N/A

Aktivieren Sie die Tagreplikation über das Blatt „Objektreplikation“, wenn Sie eine Regel erstellen oder vorhandene Regeln mithilfe der Spalte „Tagreplikation“ aktualisieren.

Führen Sie die folgenden Schritte aus, um replizierbare BLOB-Indextags beim Erstellen einer neuen Regel zu konfigurieren:

1. Navigieren Sie zum Quell-Storage-Konto im Azure-Portal.
2. Wählen Sie unter Data managementObjektreplikation aus.
3. Wählen Sie "Replikationsregeln erstellen" aus.
4. Wählen Sie "Tags-Replikation aktivieren" aus, und wählen Sie schließlich "Speichern und anwenden" aus, um die Replikation von BLOB-Indextags zu konfigurieren.

Führen Sie die folgenden Schritte aus, um replizierende Blob-Indextags für bestehende Regeln zu konfigurieren:

1. Navigieren Sie zur Registerkarte "Ihre Konten" auf der Seite 'Objektreplikation'
2. Wählen Sie die Option "Aktivieren" unter der Spalte "Tags-Replikation" in der Tabelle "Objekte, die aus diesem Konto kopiert wurden" und wählen Sie "OK" aus.
3. Status der Tags-Replikation-Statusspalte für eine Regel wird jetzt als Aktiviert angezeigt.

Führen Sie die folgenden Schritte aus, um die Replikation von BLOB-Indextags für bestehende Regeln zu deaktivieren:

1. Gehen Sie zur Registerkarte "Ihre Konten" auf der Seite Objektreplikation
2. Wählen Sie eine exsitierende Regel aus, und wählen Sie " Regeln bearbeiten " aus dem "..." aus. Menü
3. Deaktivieren Sie die Option " Tagsreplikation aktivieren ", und wählen Sie schließlich " Speichern" und "Übernehmen" aus, um replizierbare BLOB-Indextags zu deaktivieren.

N/A.

N/A.

Benutzer können vorhandene REST-APIs verwenden: Objektreplikationsrichtlinien – Erstellen oder Aktualisieren – REST-API zum Konfigurieren von Richtlinien für replizierbare Tags, die für blobs festgelegt sind.

Fügen Sie beim Erstellen oder Aktualisieren der Replikationsregeln für das Quellkonto die folgende Zeile “tagsReplication”: { “enabled”: true } hinzu.

Die Tagsreplikation wird ab API-Version 2022-05-01 und höher unterstützt. Sie können das neue tagsReplication-Feld zur Replikationsrichtlinie hinzufügen.

Beispiel:

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

Sie können Metriken entweder über das Objektreplikations-Blatt in der neuen Metriken-Spalte aktivieren oder den Abschnitt Regeln bearbeiten einer Richtlinie über "…" in der Zeile der "OR-Richtlinie" bearbeiten.

Noch nicht unterstützt.

Noch nicht unterstützt.

Das Aktivieren von Metriken wird in API Version 2021-08-01 und höher unterstützt. Sie können das neue Metrikfeld der Replikationsrichtlinie hinzufügen. Beispiel:

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

Führen Sie die folgenden Schritte aus, um den Replikationsstatus für ein BLOB im Quellkonto im Azure portal zu überprüfen:

1. Navigieren Sie zum Quellkonto im Azure portal.
2. Suchen Sie den Container, der das Quell-BLOB enthält.
3. Wählen Sie das Blob aus, um dessen Eigenschaften anzuzeigen. Wenn das Blob erfolgreich repliziert wurde, sehen Sie im Abschnitt "Objektreplikation ", dass der Status auf "Abgeschlossen" festgelegt ist. Die Replikationsrichtlinien-ID und die ID für die Regel zur Objektreplikation für diesen Container werden ebenfalls aufgeführt.

Um den Replikationsstatus für ein Blob im Quellkonto mit PowerShell zu überprüfen, rufen Sie den Wert der Objektreplikationsreplikationsstatus-Eigenschaft ab, wie im folgenden Beispiel gezeigt. Denken Sie daran, die Werte in eckigen Klammern durch Ihre eigenen Werte zu ersetzen:

$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

Um den Replikationsstatus für ein Blob im Quellkonto mit Azure CLI zu überprüfen, rufen Sie den Wert der Objektreplikation statuseigenschaft ab, wie im folgenden Beispiel gezeigt:

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

Wenn der Replikationsstatus für ein Blob im Quellkonto auf einen Fehler hinweist, untersuchen Sie die folgenden möglichen Ursachen:

• Stellen Sie sicher, dass die Objektreplikationsrichtlinie im Zielkonto konfiguriert ist.
• Überprüfen Sie, ob der Zielcontainer noch vorhanden ist.
• Wenn das Quellblob im Rahmen eines Schreibvorgangs mit einem vom Kunden bereitgestellten Schlüssel verschlüsselt wurde, tritt bei der Objektreplikation ein Fehler auf. Weitere Informationen zu vom Kunden bereitgestellten Schlüsseln finden Sie unter Verschlüsselungsschlüssel für eine Anfrage an den Blob-Speicher bereitstellen.

N/A

Führen Sie die folgenden Schritte aus, um eine Replikationsrichtlinie im Azure portal zu entfernen:

1. Navigieren Sie zum Quellspeicherkonto im Azure-Portal.
2. Wählen Sie unter "Einstellungen" die Option "Objektreplikation" aus.
3. Wählen Sie die Schaltfläche "Weitere " neben dem Richtliniennamen aus.
4. Wählen Sie "Regeln löschen" aus.

Um eine Replikationsrichtlinie zu entfernen, löschen Sie die Richtlinie sowohl aus dem Quellkonto als auch aus dem Zielkonto. Durch das Löschen der Richtlinie werden auch alle damit verbundenen Regeln gelöscht.

# 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

Um eine Replikationsrichtlinie zu entfernen, löschen Sie die Richtlinie sowohl aus dem Quellkonto als auch aus dem Zielkonto. Durch das Löschen der Richtlinie werden auch alle damit verbundenen Regeln gelöscht.

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