Blob-eigenschappen en -metagegevens vervangen met AzCopy v10
U kunt AzCopy gebruiken om de toegangslaag van een of meer blobs te wijzigen en de metagegevens te vervangen (overschrijven) en indextags van een of meer blobs te indexeren.
Aan de slag
Zie het artikel Aan de slag met AzCopy om AzCopy te downloaden en meer te weten te komen over de manieren waarop u autorisatiereferenties kunt opgeven voor de opslagservice.
Notitie
In de voorbeelden in dit artikel wordt ervan uitgegaan dat u autorisatiereferenties hebt opgegeven met behulp van Microsoft Entra-id.
Als u liever een SAS-token gebruikt om toegang tot blobgegevens te autoriseren, kunt u dat token toevoegen aan de resource-URL in elke AzCopy-opdracht. Voorbeeld: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.
De toegangslaag wijzigen
Als u de toegangslaag van een blob wilt wijzigen, gebruikt u de opdracht azcopy set-properties en stelt u de -block-blob-tier parameter in op de naam van de toegangslaag.
Tip
In dit voorbeeld worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').
Syntaxis
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot
Als u de toegangslaag voor alle blobs in een virtuele map wilt wijzigen, raadpleegt u de naam van de virtuele map in plaats van de blobnaam en voegt u deze vervolgens toe aan --recursive=true de opdracht.
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true
Als u een blob van de archieflaag wilt reactiveren naar een onlinelaag, stelt u het --rehydrate-priority in standard op of high. Deze parameter is standaard ingesteld op standard. Zie Rehydratatieprioriteit voor meer informatie over de afwegingen van elke optie.
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high
Metagegevens vervangen
Als u de metagegevens van een blob wilt vervangen, gebruikt u de opdracht azcopy set-properties en stelt u de --metadata parameter in op een of meer sleutel-waardeparen.
Tip
In dit voorbeeld worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').
Syntaxis
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2
Als u de metagegevens voor alle blobs in een virtuele map wilt vervangen, raadpleegt u de naam van de virtuele map in plaats van de blobnaam en voegt u deze vervolgens toe --recursive=true aan de opdracht.
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true
Als u metagegevens wilt wissen, laat u de tags weg en voegt u deze toe aan --metadata=clear het einde van de opdracht.
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear
Indextags vervangen
Als u de indextags van een blob wilt vervangen, gebruikt u de opdracht azcopy set-properties en stelt u de --blob-tags parameter in op een of meer sleutel-waardeparen. Het instellen van blobindextags kan worden uitgevoerd door de eigenaar van de opslagblobgegevens en door iedereen met een Shared Access Signature die gemachtigd is voor toegang tot de tags van de blob (de t SAS-machtiging). Daarnaast kunnen RBAC-gebruikers met de Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write machtiging deze bewerking uitvoeren.
Tip
In dit voorbeeld worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').
Syntaxis
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
Als u de indextags voor alle blobs in een virtuele map wilt vervangen, raadpleegt u de naam van de virtuele map in plaats van de blobnaam en voegt u deze vervolgens toe --recursive=true aan de opdracht.
Voorbeeld
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
Volgende stappen
Bekijk meer voorbeelden in deze artikelen:
- Voorbeelden: Uploaden
- Voorbeelden: Downloaden
- Voorbeelden: Kopiëren tussen accounts
- Voorbeelden: Synchroniseren
- Voorbeelden: Amazon S3-buckets
- Voorbeelden: Google Cloud Storage
- Voorbeelden: Azure Files
- Zelfstudie: On-premises gegevens migreren naar cloudopslag met behulp van AzCopy
Zie deze artikelen voor het configureren van instellingen, het optimaliseren van de prestaties en het oplossen van problemen: