Freigeben über


Ersetzen von Eigenschaften und Metadaten von Blobs mithilfe von AzCopy V10

Sie können AzCopy verwenden, um die Zugriffsebene eines oder mehrerer Blobs zu ändern und die Metadaten und Indextags eines oder mehrerer Blobs zu 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 Autorisierungsanmeldeinformationen mithilfe der Microsoft Entra-ID angeben.

Wenn Sie ein SAS-Token verwenden möchten, um den Zugriff auf Blobdaten zu autorisieren, fügen Sie dieses Token an die Ressourcen-URL in jedem AzCopy-Befehl an. 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. Die Rolle "Besitzer von Speicher-BLOB-Daten" und jede Person mit einer geteilten Zugriffssignatur, die berechtigt ist, auf die BLOB-Tags zuzugreifen (die t SAS-Berechtigung), können BLOB-Indextags festlegen. 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: