Ersetzen von Blobeigenschaften und Metadaten mithilfe von AzCopy v10 (Vorschau)

  • Artikel

Sie können mithilfe von AzCopy die Zugriffsebene für ein oder mehrere Blobs ändern und die Metadaten und Indextags eines oder mehrerer Blobs ersetzen (überschreiben).

Wichtig

Diese Funktion befindet sich derzeit in der VORSCHAUPHASE. Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Erste Schritte

Lesen Sie den Artikel Erste Schritte mit AzCopy, um AzCopy herunterzuladen und zu erfahren, wie Sie dem Speicherdienst Autorisierungsanmeldeinformationen bereitstellen können.

Hinweis

In den Beispielen in diesem Artikel wird davon ausgegangen, dass Sie Anmeldeinformationen für Autorisierung mithilfe von Microsoft Entra ID bereitgestellt haben.

Wenn Sie lieber ein SAS-Token für die Autorisierung des Zugriffs auf Blobdaten verwenden möchten, können Sie dieses Token in jedem AzCopy-Befehl an die Ressourcen-URL anfügen. Beispiel: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Ändern der Zugriffsebene

Um die Zugriffsebene eines Blob zu ändern, verwenden Sie den Befehl azcopy set-properties und legen den Parameter -block-blob-tier auf den Namen der Zugriffsebene fest.

Tipp

In diesem Beispiel werden Pfadargumente in einfache Anführungszeichen ('') eingeschlossen. Verwenden Sie in allen Befehlsshells außer der Windows-Befehlszeile (cmd.exe) einfache Anführungszeichen. Wenn Sie eine Windows-Befehlszeile (cmd.exe) verwenden, müssen Sie Pfadargumente in doppelte Anführungszeichen ("") anstelle von einfachen Anführungszeichen ('') einschließen.

Syntax

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot

Wenn Sie die Zugriffsebene für alle Blobs in einem virtuellen Verzeichnis ändern möchten, verweisen Sie auf den Namen des virtuellen Verzeichnisses statt auf den Namen des Blobs, und fügen Sie --recursive=true an den Befehl an.

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true

Wenn Sie ein Blob aus der Archivebene für eine Onlineebene aktivieren möchten, legen Sie --rehydrate-priority auf standard oder high fest. Dieser Parameter ist standardmäßig auf standard festgelegt. Weitere Informationen zu den Zielkonflikten der einzelnen Optionen finden Sie unter Aktivierungspriorität.

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high

Ersetzen von Metadaten

Um die Metadaten eines Blobs zu ersetzen, verwenden Sie den Befehl azcopy set-properties und legen den Parameter --metadata auf mindestens ein Schlüssel-Werte-Paar fest.

Tipp

In diesem Beispiel werden Pfadargumente in einfache Anführungszeichen ('') eingeschlossen. Verwenden Sie in allen Befehlsshells außer der Windows-Befehlszeile (cmd.exe) einfache Anführungszeichen. Wenn Sie eine Windows-Befehlszeile (cmd.exe) verwenden, müssen Sie Pfadargumente in doppelte Anführungszeichen ("") anstelle von einfachen Anführungszeichen ('') einschließen.

Syntax

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2

Wenn Sie die Metadaten für alle Blobs in einem virtuellen Verzeichnis ersetzen möchten, verweisen Sie auf den Namen des virtuellen Verzeichnisses statt auf den Namen des Blobs, und fügen Sie --recursive=true an den Befehl an.

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true

Um Metadaten zu löschen, lassen Sie die Tags weg und fügen --metadata=clear an das Ende des Befehls an.

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear

Ersetzen von Indextags

Um die Indextags eines Blobs zu ersetzen, verwenden Sie den Befehl azcopy set-properties und legen den Parameter --blob-tags auf mindestens ein Schlüssel-Wert-Paar fest. Das Festlegen von Blobindextags kann vom Besitzer von Speicherblobdaten und allen anderen Benutzern mit einer Shared Access Signature, die über die Berechtigung zum Zugreifen auf die Tags des Blobs verfügt (SAS-Berechtigung t), durchgeführt werden. Auch RBAC-Benutzer mit der Berechtigung Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write können diesen Vorgang durchführen.

Tipp

In diesem Beispiel werden Pfadargumente in einfache Anführungszeichen ('') eingeschlossen. Verwenden Sie in allen Befehlsshells außer der Windows-Befehlszeile (cmd.exe) einfache Anführungszeichen. Wenn Sie eine Windows-Befehlszeile (cmd.exe) verwenden, müssen Sie Pfadargumente in doppelte Anführungszeichen ("") anstelle von einfachen Anführungszeichen ('') einschließen.

Syntax

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

Wenn Sie die Indextags für alle Blobs in einem virtuellen Verzeichnis ersetzen möchten, verweisen Sie auf den Namen des virtuellen Verzeichnisses statt auf den Namen des Blobs, und fügen Sie --recursive=true an den Befehl an.

Beispiel

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

Nächste Schritte

Weitere Beispiele finden Sie in diesen Artikeln:

Lesen Sie diese Artikel, um Einstellungen zu konfigurieren, die Leistung zu optimieren und Probleme zu beheben: