azcopy remove
Supprimez des objets BLOB ou des fichiers d’un compte de stockage Azure.
Synopsis
azcopy remove [resourceURL] [flags]
Articles conceptuels associés
- Bien démarrer avec AzCopy
- Transférer des données avec AzCopy et le Stockage Blob
- Transférer des données avec AzCopy et le stockage de fichiers
Exemples
Suppression d’un seul objet BLOB à l’aide d’un jeton SAS :
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Suppression d’un répertoire virtuel entier à l’aide d’un jeton SAS :
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Supprimer uniquement les objets BLOB dans un répertoire virtuel, mais ne pas supprimer les sous-répertoires ou les objets BLOB de ces sous-répertoires :
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false
Supprimer un sous-ensemble d’objets blob dans un répertoire virtuel (par exemple, supprimer uniquement les fichiers .jpg et PDF, ou uniquement les objets blob dont le nom est « exactName ») :
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --include-pattern="*.jpg;*.pdf;exactName"
Supprimer l’intégralité d’un répertoire virtuel, mais exclure certains objets blob (par exemple, tous ceux dont le nom commence par « foo » ou se termine par « bar ») :
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --exclude-pattern="foo*;*bar"
Supprimez les ID de version spécifiés d’un objet blob de Stockage Azure. La source doit être un objet blob valide, et versionidsfile prend un chemin du fichier où chaque version est écrite sur une ligne distincte. Toutes les versions spécifiées seront supprimées de Stockage Azure.
azcopy rm "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/path/to/dir/[versionidsfile]"
Supprimez des objets blob et des répertoires virtuels spécifiques en plaçant leurs chemins d’accès relatifs (non codés en URL) dans un fichier texte (par exemple : list.txt) à l’aide de l’indicateur --list-of-files . Dans le fichier texte, chaque objet blob et répertoire virtuel est écrit sur une ligne distincte. L’indicateur --list-of-files peut entraîner des coûts de performances en raison de transactions supplémentaires pour récupérer les propriétés d’objet. Pour plus d’informations sur les API utilisées par AzCopy et pour estimer les coûts, consultez Estimer le coût d’utilisation d’AzCopy pour transférer des objets blob.
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/parent/dir]" --recursive=true --list-of-files=/usr/bar/list.txt
Supprimez un seul fichier d’un compte de stockage d’objets BLOB qui a un espace de noms hiérarchique (inclure/exclure non pris en charge) :
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"
Supprimez un seul répertoire d’un compte de stockage d’objets BLOB qui a un espace de noms hiérarchique (inclure/exclure non pris en charge) :
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"
Options
--cpk-by-name(chaîne) Le client fourni par clé par nom permet aux clients d’effectuer des requêtes par rapport à Stockage Blob Azure une option permettant de fournir une clé de chiffrement par demande. Le nom de la clé fournie sera récupéré dans Azure Key Vault et sera utilisé pour chiffrer les données.
--cpk-by-value (false par défaut) : Le client fourni par clé par nom permet aux clients d’effectuer des requêtes par rapport à Stockage Blob Azure une option permettant de fournir une clé de chiffrement par demande. La clé fournie et son hachage sont récupérés à partir de variables CPK_ENCRYPTION_KEY d’environnement et CPK_ENCRYPTION_KEY_SHA256.
--delete-snapshots (chaîne) Par défaut, l’opération de suppression échoue si un objet blob comporte des captures instantanées. Spécifiez « include » pour supprimer l’objet blob racine et tous ses instantanés. Vous pouvez également spécifier « only » pour supprimer uniquement les captures instantanées et conserver l’objet blob racine.
--dry-run (false par défaut) : Imprime les fichiers de chemin d’accès qui seraient supprimés par la commande. Cet indicateur ne déclenche pas la suppression des fichiers.
--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 (string) Exclut les fichiers dont le nom correspond à la liste des modèles. Par exemple : .jpg; .pdf;exactName
--force-if-read-only (false par défaut) : Lors de la suppression d’un fichier ou d’un dossier Azure Files, forcez la suppression à fonctionner même si l’objet existant a son jeu d’attributs en lecture seule
--from-to (string) Spécifie éventuellement la combinaison destination-source. Par exemple : BlobTrash, FileTrash, BlobFSTrash
-h, --help aide pour la suppression
--include-after (chaîne) Incluez uniquement ces fichiers modifiés à la date et à l’heure spécifiées. La valeur doit être au format ISO8601. Si aucun fuseau horaire n’est spécifié, la valeur est supposée être dans le fuseau horaire local de l’ordinateur exécutant AzCopy (par exemple : « 2020-08-19T15 :04 :00Z » pour une heure UTC, ou « 2020-08-19 » pour minuit (00 :00) dans le fuseau horaire local). À compter d’AzCopy 10.5, cet indicateur s’applique uniquement aux fichiers, et non aux dossiers. Les propriétés des dossiers ne seront donc pas copiées lors de l’utilisation de cet indicateur avec ou --preserve-smb-permissionde --preserve-smb-info s.
--include-before (chaîne) Incluez uniquement ces fichiers modifiés avant ou à la date et à l’heure spécifiées. La valeur doit être au format ISO8601. Si aucun fuseau horaire n’est spécifié, la valeur est supposée être dans le fuseau horaire local de l’ordinateur exécutant AzCopy (par exemple : « 2020-08-19T15 :04 :00Z » pour une heure UTC, ou « 2020-08-19 » pour minuit (00 :00) dans le fuseau horaire local). À partir d’AzCopy 10.7, cet indicateur s’applique uniquement aux fichiers, et non aux dossiers. Les propriétés de dossier ne sont donc pas copiées lors de l’utilisation de cet indicateur avec --preserve-smb-info ou --preserve-smb-permissions.
--include-path (chaîne) Inclut uniquement ces chemins 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
--include-pattern (chaîne) Inclut uniquement les fichiers dont le nom correspond à la liste de caractères génériques. Par exemple : .jpg; .pdf;exactName
--list-of-files (chaîne) Définit l’emplacement d’un fichier texte qui contient la liste des fichiers et répertoires à supprimer. Les chemins d’accès relatifs doivent être délimités par des sauts de ligne, et les chemins d’accès ne doivent pas être codés URL.
--list-of-versions (chaîne) Spécifie un fichier texte dans lequel chaque ID de version est répertorié sur une ligne distincte. Assurez-vous que la source pointe vers un blob unique et que tous les ID de version spécifiés dans le fichier à l’aide de cet indicateur appartiennent uniquement au blob source. Les ID de version spécifiés de l’objet Blob donné seront supprimés du stockage Azure.
--permanent-delete (chaîne) Il s’agit d’une fonctionnalité en préversion qui supprime DÉFINITIVEMENT les captures instantanées/versions supprimées de manière réversible. Valeurs possibles : 'snapshots', 'versions', 'snapshotsandversions', 'none'. (par défaut : « None »)
--trailing-dot Activé par défaut pour traiter les opérations liées au partage de fichiers de manière sécurisée. Options disponibles : Enable, Disable. Choisissez Disable de revenir au traitement hérité (potentiellement dangereux) des fichiers de points de fin dans lesquels le service de fichiers supprime les points de fin dans les chemins. Cela peut entraîner une altération potentielle des données si le transfert contient deux chemins qui diffèrent uniquement par un point de fin (par exemple mypath et mypath.). Si cet indicateur est défini Disable sur et qu’AzCopy rencontre un fichier point de fin, il avertit les clients dans le journal d’analyse, mais ne tente pas d’abandonner l’opération. Si la destination ne prend pas en charge les fichiers points de fin (Windows ou Blob Stockage), AzCopy échoue si le fichier point de fin est la racine du transfert et ignore les chemins de points de fin rencontrés pendant l’énumération.
--recursive (false par défaut) : Examinez les sous-répertoires de manière récursive lors de la synchronisation entre les répertoires.
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é.
--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 »).
--trusted-microsoft-suffixes (chaîne) Spécifie des suffixes de domaine supplémentaires où les jetons de connexion Microsoft Entra 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.
--log-level (chaîne) Définit la verbosité du journal pour le fichier journal. Niveaux disponibles : INFO (toutes les requêtes/réponses), WARNING (réponses lentes), ERROR (uniquement les échecs de requêtes) et NONE (aucun journal de sortie) (« INFO » par défaut) (« INFO » par défaut)