Freigeben über


Ersetzen von Eigenschaften und Metadaten von Blobs mithilfe von AzCopy V10

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).

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 die 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: