Partager via

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

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 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 supposent que vous fournissez des informations d’identification d’autorisation à l’aide de l’ID Microsoft Entra.

Si vous souhaitez utiliser un jeton SAP pour autoriser l’accès aux données d’objet blob, ajoutez ce jeton à l’URL de la 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. Le rôle Propriétaire des données de blob de stockage et toute personne disposant d’une signature d’accès partagé autorisée à accéder aux balises du blob (autorisation t SAS) peuvent définir des balises d’index de blob. 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 :

  • Last updated on