Remplacer les propriétés et les métadonnées d’objets blob avec AzCopy v10 (préversion)
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.
Important
Cette capacité est actuellement disponible en PRÉVERSION. Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.
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 :
- Exemples : Charger
- Exemples : Téléchargement
- Exemples : Copier entre comptes
- Exemples : Synchroniser
- Exemples : Compartiments Amazon S3
- Exemples : Google Cloud Storage
- Exemples : Azure Files
- Tutoriel : Migrer des données locales vers un stockage cloud à l’aide d’AzCopy
Consultez les articles suivants pour configurer les paramètres, optimiser les performances et résoudre les problèmes :