azcopy set-properties
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 -> Niveau, Métadonnées, Étiquettes
- Fichiers -> Métadonnées
Remarque
Les points de terminaison Data Lake Storage seront remplacés par les 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’objet blob à l’aide d’AzCopy v10
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
Remplacez le niveau d’objet blob par froid :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold
Changez le niveau d’objet blob de chaud à archive :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive
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
Changez le niveau d’objet blob de froid à chaud avec une priorité réhydratée définie sur standard :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard
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
Modifier le niveau d’un objet blob de pages :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]
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
Effacez toutes les métadonnées existantes de tous les fichiers :
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --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.