Share via

Sostituire le proprietà e i metadati dei BLOB usando AzCopy v10 (anteprima)

  • Articolo

È possibile usare AzCopy per modificare il livello di accesso di uno o più BLOB e sostituire (sovrascrivere) i metadati e i tag di indice di uno o più BLOB.

Importante

Questa funzionalità è attualmente in ANTEPRIMA. Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

Operazioni preliminari

Vedere l'articolo Introduzione ad AzCopy per scaricare AzCopy e scoprire informazioni sui modi in cui è possibile fornire le credenziali di autorizzazione al servizio di archiviazione.

Nota

Gli esempi in questo articolo presuppongono che siano state fornite le credenziali di autorizzazione usando l'ID Microsoft Entra.

Se si preferisce usare un token di firma di accesso condiviso per autorizzare l'accesso ai dati BLOB, è possibile aggiungere tale token all'URL della risorsa in ogni comando AzCopy. Ad esempio: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Cambiare il livello di accesso

Per modificare il livello di accesso di un BLOB, usare il comando azcopy set-properties e impostare il parametro -block-blob-tier sul nome del livello di accesso.

Suggerimento

In questo esempio gli argomenti path vengono racchiusi con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della Shell dei comandi di Windows (cmd.exe). Se si usa una Shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti path con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

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

Esempio

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

Per modificare il livello di accesso per tutti i BLOB in una directory virtuale, fare riferimento al nome della directory virtuale anziché al nome del BLOB e quindi aggiungere --recursive=true al comando.

Esempio

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

Per riattivare un BLOB dal livello archivio a un livello online, impostare il --rehydrate-priority su standard o high. Per impostazione predefinita, il parametro è impostato su standard. Per altre informazioni sui vantaggi e gli svantaggi di ogni opzione, vedere Priorità di riattivazione.

Esempio

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

Sostituire i metadati

Per sostituire i metadati di un BLOB, usare il comando azcopy set-properties e impostare il parametro --metadata su una o più coppie chiave-valore.

Suggerimento

In questo esempio gli argomenti path vengono racchiusi con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della Shell dei comandi di Windows (cmd.exe). Se si usa una Shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti path con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

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

Esempio

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

Per sostituire i metadati per tutti i BLOB in una directory virtuale, fare riferimento al nome della directory virtuale anziché al nome del BLOB e quindi aggiungere --recursive=true al comando.

Esempio

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

Per cancellare i metadati, omettere i tag e aggiungere --metadata=clear alla fine del comando.

Esempio

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

Sostituire i tag indice

Per sostituire i tag indice di un BLOB, usare il comando azcopy set-properties e impostare il parametro --blob-tags su una o più coppie chiave-valore. L'impostazione dei tag indice dei BLOB può essere eseguita dal proprietario dei dati del BLOB di archiviazione e da chiunque disponga di una firma di accesso condiviso con l'autorizzazione per accedere ai tag del BLOB (autorizzazione di firma di accesso condiviso t). Inoltre, gli utenti del controllo degli accessi in base al ruolo con l'autorizzazione Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write possono eseguire questa operazione.

Suggerimento

In questo esempio gli argomenti path vengono racchiusi con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della Shell dei comandi di Windows (cmd.exe). Se si usa una Shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti path con virgolette doppie ("") anziché virgolette singole ('').

Sintassi

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

Esempio

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

Per sostituire i tag indice per tutti i BLOB in una directory virtuale, fare riferimento al nome della directory virtuale anziché al nome del BLOB e quindi aggiungere --recursive=true al comando.

Esempio

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

Passaggi successivi

Altri esempi sono disponibili in questi articoli:

Vedere questi articoli per configurare le impostazioni, ottimizzare le prestazioni e risolvere i problemi: