Partager via

Remplacer les propriétés et les métadonnées de blob en utilisant AzCopy v10

  • Article

Vous pouvez utiliser AzCopy pour modifier le niveau d’accès d’un ou plusieurs objets blob et remplacer (remplacer) les métadonnées et les balises d’index d’un ou plusieurs objets blob.

Bien démarrer

Consultez l’article Prise en main d’AzCopy pour télécharger AzCopy, et découvrez comment vous pouvez fournir des informations d’identification au service de stockage.

Remarque

Les exemples de cet article partent du principe que vous avez fourni des informations d’identification d’autorisation en utilisant Microsoft Entra ID.

Si vous préférez utiliser un jeton SAS pour autoriser l’accès aux données d’objets blob, vous pouvez ajouter ce jeton à l’URL de ressource dans chaque commande AzCopy. Par exemple : 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Changer le niveau d’accès

Pour changer le niveau d’accès d’un objet blob, utilisez la commande azcopy set-properties et définissez le paramètre -block-blob-tier sur le nom du niveau d’accès.

Conseil

Cet exemple englobe les arguments de chemin d’accès avec des guillemets simples (' '). Utilisez des guillemets simples dans tous les interpréteurs de commandes, à l’exception de l’interface de commande Windows (cmd. exe). Si vous utilisez une interface de commande Windows (cmd. exe), placez les arguments de chemin d’accès entre guillemets doubles (" ") au lieu de guillemets simples (' ').

Syntaxe

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

Exemple

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

Pour changer le niveau d’accès de tous les objets blob d’un répertoire virtuel, référez-vous au nom du répertoire virtuel plutôt qu’au nom de l’objet blob, puis ajoutez --recursive=true à la commande.

Exemple

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

Pour réhydrater un objet blob du niveau archive vers un niveau en ligne, définissez --rehydrate-priority sur standard ou high. Par défaut, ce paramètre a la valeur standard. Pour en savoir plus sur les désavantages de chaque option, consultez Priorité de réhydratation.

Exemple

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

Remplacer les métadonnées

Pour remplacer les métadonnées d’un objet blob, utilisez la commande azcopy set-properties et définissez le paramètre --metadata sur une ou plusieurs paires clé-valeur.

Conseil

Cet exemple englobe les arguments de chemin d’accès avec des guillemets simples (' '). Utilisez des guillemets simples dans tous les interpréteurs de commandes, à l’exception de l’interface de commande Windows (cmd. exe). Si vous utilisez une interface de commande Windows (cmd. exe), placez les arguments de chemin d’accès entre guillemets doubles (" ") au lieu de guillemets simples (' ').

Syntaxe

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

Exemple

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

Pour remplacer les métadonnées de tous les objets blob d’un répertoire virtuel, référez-vous au nom du répertoire virtuel plutôt qu’au nom de l’objet blob, puis ajoutez --recursive=true à la commande.

Exemple

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

Pour effacer les métadonnées, omettez les étiquettes et ajoutez --metadata=clear à la fin de la commande.

Exemple

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

Remplacer les étiquettes d’index

Pour remplacer les étiquettes d’index d’un objet blob, utilisez la commande azcopy set-properties et définissez le paramètre --blob-tags sur une ou plusieurs paires clé-valeur. La définition des balises d’index de blob peut être effectuée par le propriétaire des données Blob du stockage et par toute personne disposant d’une signature d’accès partagé qui a l’autorisation d’accéder aux balises du blob (l’autorisation SAP t). En outre, les utilisateurs RBAC dotés de l’autorisation Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write peuvent effectuer cette opération.

Conseil

Cet exemple englobe les arguments de chemin d’accès avec des guillemets simples (' '). Utilisez des guillemets simples dans tous les interpréteurs de commandes, à l’exception de l’interface de commande Windows (cmd. exe). Si vous utilisez une interface de commande Windows (cmd. exe), placez les arguments de chemin d’accès entre guillemets doubles (" ") au lieu de guillemets simples (' ').

Syntaxe

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

Exemple

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

Pour remplacer les étiquettes d’index de tous les objets blob d’un répertoire virtuel, référez-vous au nom du répertoire virtuel plutôt qu’au nom de l’objet blob, puis ajoutez --recursive=true à la commande.

Exemple

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

Étapes suivantes

Vous trouverez plus d’exemples dans ces articles :

Consultez les articles suivants pour configurer les paramètres, optimiser les performances et résoudre les problèmes :