azcopy set-properties (préversion)
En fonction d’un emplacement, changez toutes les propriétés système valides de ce stockage (objet blob ou fichier).
Synopsis
azcopy set-properties [resourceURL] [flags]
Définit les propriétés du stockage d’objets blob et de fichiers. Les propriétés prises en charge par cette commande sont les suivantes :
- Objets blob -> Niveau, Métadonnées, Étiquettes
- Data Lake Storage Gen2 -> Niveau, Métadonnées, Étiquettes
- Fichiers -> Métadonnées
Notes
Les points de terminaison Data Lake Storage Gen2 sont remplacés par des points de terminaison Stockage Blob.
Pour plus d’informations, consultez les exemples.
Articles conceptuels associés
- Bien démarrer avec AzCopy
- Remplacer les propriétés et les métadonnées d’objets blob avec AzCopy v10 (préversion)
Exemples
Définir le niveau de l’objet blob sur chaud :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
Faire passer le niveau de l’objet blob d’archive à froid avec une priorité de réhydratation définie sur élevée :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
Définir le niveau de tous les fichiers d’un répertoire sur archive :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
Définir les métadonnées de l’objet blob sur {key = "abc", val = "def"} et {key = "ghi", val = "jkl"} :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl
Définir les métadonnées de tous les fichiers d’un répertoire sur {key = "abc", val = "def"} et {key = "ghi", val = "jkl"}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true
Effacez toutes les métadonnées existantes de l’objet blob :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
Définir les étiquettes d’objet blob de l’objet blob sur {key = "abc", val = "def"} et {key = "ghi", val = "jkl"} :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl
Lors de la définition d’étiquettes sur les objets blob, il existe d’autres autorisations (« t » pour étiquettes) avec SAS. Sans ces étiquettes, le service retourne une erreur d’autorisation.
Effacer toutes les étiquettes d’objets blob existantes de l’objet blob :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
Lors de la définition d’étiquettes sur les objets blob, il existe d’autres autorisations (« t » pour étiquettes) avec SAS. Sans ces étiquettes, le service retourne une erreur d’autorisation.
Options
--blob-tags chaîne Définir des balises sur des objets blob pour catégoriser les données dans votre compte de stockage (séparées par ' &')
--block-blob-tier, chaîne : définit le niveau d’accès des objets blob sur le niveau donné (par défaut « Aucun »)
--dry-run Imprime le chemin des fichiers qui seraient affectés par cette commande. Cet indicateur n’affecte pas les fichiers réels.
--exclude-path, chaîne : exclut ces chemins d’accès lors de la suppression. Cette option ne prend pas en charge les caractères génériques (*). Vérifie le préfixe du chemin d’accès relatif. Par exemple : myFolder;myFolder/subDirName/file.pdf
--exclude-pattern, chaîne : exclut les fichiers dont le nom correspond à la liste des modèles. Par exemple : .jpg; .pdf;exactName
--from-to, chaîne : spécifie éventuellement la combinaison destination-source. Valeurs valides : BlobNone, FileNone, BlobFSNone
-h, --help aide pour set-properties
--include-path, chaîne : inclut uniquement ces chemins lors de la définition de la propriété. Cette option ne prend pas en charge les caractères génériques (*). Vérifie le préfixe du chemin d’accès relatif. Par exemple : myFolder;myFolder/subDirName/file.pdf
--include-pattern, chaîne : inclut uniquement les fichiers dont le nom correspond à la liste des modèles. Par exemple : .jpg; .pdf;exactName
--list-of-files, chaîne : définit l’emplacement du fichier texte qui a la liste des fichiers à copier.
--metadata, chaîne : définit l’emplacement donné avec ces paires clé-valeur (séparées par « ; ») comme métadonnées.
--page-blob-tier, chaîne : charge un objet blob de pages dans le Stockage Azure à l’aide de ce niveau d’objet blob. (par défaut : « None »). (par défaut : « None »).
--recursive : examine le contenu des sous-répertoires de manière récursive lors du chargement à partir du système de fichiers local.
--rehydrate-priority, chaîne : indicateur facultatif qui définit la priorité de réhydratation pour la réhydratation. Valeurs valides : Standard, High. Default- standard (valeur par défaut « Standard »)
Options héritées des commandes parentes
--cap-mbps float Limite la vitesse de transfert en mégabits par seconde. Par moment, le débit peut dépasser légèrement cette limite. Si cette option est définie sur zéro ou si elle est omise, le débit n’est pas limité.
--log-level (chaîne) : définit la verbosité des journaux du fichier journal. Niveaux disponibles : INFO (toutes les demandes et réponses), WARNING (les réponses lentes), ERROR (uniquement les échecs de demandes) et NONE (aucun journal de sortie). (par défaut : « INFO ») (par défaut : « INFO »)
--output-type (string) Met en forme la sortie de la commande. Les formats possibles sont « text » et « JSON ». La valeur par défaut est « text ». (par défaut : « text »).
--output-level (chaîne) : définit la verbosité de la sortie. Niveaux disponibles : essential, quiet. (valeur par défaut « default »)
--trusted-microsoft-suffixes (chaîne) Spécifie d’autres suffixes de domaine où les jetons de connexion Microsoft Entra ID peuvent être envoyés. La valeur par défaut est « .core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net ». Tous les éléments répertoriés ici sont ajoutés à la valeur par défaut. Pour la sécurité, vous devez placer uniquement des domaines Microsoft Azure ici. Séparez plusieurs entrées par des points-virgules.