azcopy remove
Löscht Blobs oder Dateien aus einem Azure Storage-Konto.
Zusammenfassung
azcopy remove [resourceURL] [flags]
Verwandte konzeptionelle Artikel
- Erste Schritte mit AzCopy
- Übertragen von Daten mit AzCopy und Blobspeicher
- Übertragen von Daten mit AzCopy und Dateispeicher
Beispiele
Entfernen eines einzelnen Blobs mithilfe eines SAS-Tokens:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Entfernen eines gesamten virtuellen Verzeichnisses mithilfe eines SAS-Tokens:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Entfernen Sie nur die Blobs innerhalb eines virtuellen Verzeichnisses, aber entfernen Sie keine Unterverzeichnisse oder Blobs innerhalb dieser Unterverzeichnisse:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false
Entfernen Sie eine Teilmenge von Blobs in einem virtuellen Verzeichnis (Beispiel: Entfernen Sie nur JPG- und PDF-Dateien oder wenn der Blobname „exactName“ lautet):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --include-pattern="*.jpg;*.pdf;exactName"
Entfernen Sie ein gesamtes virtuelles Verzeichnis, doch schließen Sie bestimmte Blobs aus dem Umfang aus (z. B. alle Blobs, die mit „foo“ beginnen oder mit „bar“ enden):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --exclude-pattern="foo*;*bar"
Entfernen Sie angegebene Versions-IDs eines Blobs aus Azure Storage. Stellen Sie sicher, dass die Quelle ein gültiges Blob ist und versionidsfile einen Pfad zur Datei nimmt, in dem jede Version in einer separaten Zeile geschrieben ist. Alle angegebenen Versionen werden aus Azure Storage entfernt.
azcopy rm "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/path/to/dir/[versionidsfile]"
Entfernen Sie bestimmte Blobs und virtuelle Verzeichnisse, indem Sie ihre relativen Pfade (NOT URL-codiert) in eine Textdatei (z. B. : list.txt) mithilfe des --list-of-files Flags einfügen. In der Textdatei wird jedes BLOB und jedes virtuelle Verzeichnis in einer separaten Zeile geschrieben. Das --list-of-files Kennzeichen kann aufgrund zusätzlicher Transaktionen zum Abrufen von Objekteigenschaften Leistungskosten verursachen. Weitere Informationen zu den APIs, die AzCopy verwendet und um Kosten zu schätzen, finden Sie unter "Schätzen der Kosten für die Verwendung von AzCopy zum Übertragen von Blobs".
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/parent/dir]" --recursive=true --list-of-files=/usr/bar/list.txt
Entfernen Sie eine einzelne Datei aus einem Blob Storage-Konto, das über einen hierarchischen Namespace verfügt („include“/„exclude“ nicht unterstützt):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"
Entfernen Sie ein einzelnes Verzeichnis aus einem Blob Storage-Konto, das über einen hierarchischen Namespace verfügt („include“/„exclude“ nicht unterstützt):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"
Optionen
--cpk-by-name (Zeichenfolge) Der vom Client bereitgestellte Schlüssel anhand des Namens ermöglicht Clients, die Anforderungen an Azure Blob Storage stellen, eine Option, um einen Verschlüsselungsschlüssel pro Anforderung bereitzustellen. Der bereitgestellte Schlüsselname wird aus Azure Key Vault abgerufen und zum Verschlüsseln der Daten verwendet.
--cpk-by-value – Der Standardwert ist „false“. Der vom Client bereitgestellte Schlüssel anhand des Namens ermöglicht Clients, die Anforderungen an Azure Blob Storage stellen, eine Option, um einen Verschlüsselungsschlüssel pro Anforderung bereitzustellen. Der bereitgestellte Schlüssel und sein Hash werden aus Umgebungsvariablen CPK_ENCRYPTION_KEY und CPK_ENCRYPTION_KEY_SHA256.
--delete-snapshots (Zeichenfolge) Standardmäßig schlagen Löschvorgänge fehl, wenn ein Blob über Momentaufnahmen verfügt. Geben Sie „include“ an, um das Stammblob und alle zugehörigen Momentaufnahmen zu entfernen. Alternativ können Sie auch „only“ angeben, um nur die Momentaufnahmen zu entfernen und den Stammblob zu behalten.
--dry-run – Der Standardwert ist „false“. Druckt die Pfaddateien, die vom Befehl entfernt werden würden. Dieses Flag löst das Entfernen der Dateien nicht aus.
--exclude-path (Zeichenfolge): Schließt diese Pfade beim Entfernen aus. Diese Option unterstützt keine Platzhalterzeichen (*). Überprüft das Präfix des relativen Pfads. Beispiel: myFolder;myFolder/subDirName/file.pdf
--exclude-pattern (Zeichenfolge): Schließt Dateien aus, in denen der Name der Musterliste entspricht. Beispiel: .jpg; .pdf;exactName
--force-if-read-only – Der Standardwert ist „false“. Wenn Sie eine Azure Files-Datei oder einen Ordner löschen, müssen Sie erzwingen, dass der Löschvorgang auch dann funktioniert, wenn das vorhandene Objekt den schreibgeschützten Attributsatz aufweist.
--from-to (Zeichenfolge): Gibt optional die Quelle/Ziel-Kombination an. Beispiel: BlobTrash, FileTrash, BlobFSTrash
-h, --help Hilfe zu „remove“
--include-after (Zeichenfolge) Schließen Sie nur die Dateien ein, die am oder nach dem angegebenen Datum und der angegebenen Uhrzeit geändert wurden. Der Wert sollte das ISO 8601-Format aufweisen. Wenn keine Zeitzone angegeben wird, wird angenommen, dass sich der Wert in der lokalen Zeitzone des Computers befindet, auf dem AzCopy ausgeführt wird (z. B. "2020-08-19T15:04:00Z" für eine UTC-Zeit oder "2020-08-19" für Mitternacht (00:00) in der lokalen Zeitzone). Ab AzCopy 10.5 gilt dieses Kennzeichen nur für Dateien, nicht für Ordner, sodass Ordnereigenschaften nicht kopiert werden, wenn sie dieses Flag mit --preserve-smb-info oder --preserve-smb-permissions verwenden.
--include-before (Zeichenfolge) Schließen Sie nur die Dateien ein, die vor oder zu dem angegebenen Datum und der angegebenen Uhrzeit geändert wurden. Der Wert sollte das ISO 8601-Format aufweisen. Wenn keine Zeitzone angegeben wird, wird angenommen, dass sich der Wert in der lokalen Zeitzone des Computers befindet, auf dem AzCopy ausgeführt wird (z. B. "2020-08-19T15:04:00Z" für eine UTC-Zeit oder "2020-08-19" für Mitternacht (00:00) in der lokalen Zeitzone). Ab AzCopy 10.7 gilt dieses Flag nur für Dateien, nicht für Ordner, sodass Ordnereigenschaften nicht kopiert werden, wenn dieses Flag mit --preserve-smb-info oder --preserve-smb-permissions verwendet wird.
--include-path (Zeichenfolge): Schließt nur diese Pfade beim Entfernen ein. Diese Option unterstützt keine Platzhalterzeichen (*). Überprüft das Präfix des relativen Pfads. Beispiel: myFolder;myFolder/subDirName/file.pdf
--include-pattern (Zeichenfolge): Schließt nur Dateien ein, deren Name der Musterliste entspricht. Beispiel: .jpg; .pdf;exactName
--list-of-files (Zeichenfolge) Definiert den Speicherort einer Textdatei, die die Liste der zu löschenden Dateien und Verzeichnisse enthält. Die relativen Pfade sollten durch Zeilenumbrüche getrennt werden, und die Pfade sollten NICHT URL-codiert sein.
--list-of-versions (Zeichenfolge) Gibt eine Textdatei an, in der jede Versions-ID in einer separaten Zeile aufgeführt ist. Beachten Sie, dass die Quelle auf ein einzelnes Blob verweisen muss und dass alle in der Datei mit diesem Flag angegebenen Versions-IDs nur zum Quellblob gehören dürfen. Die angegebenen Versions-IDs des jeweiligen Blobs werden aus Azure Storage gelöscht.
--permanent-delete (Zeichenfolge) Dies ist eine Previewfunktion, die vorläufig gelöschte Momentaufnahmen/Versionen DAUERHAFT löscht. Mögliche Werte sind „snapshots“, „versions“, „snapshotsandversions“, „none“. (Der Standardwert lautet „None“.)
--trailing-dot Standardmäßig aktiviert, um dateifreigabebezogene Vorgänge auf sichere Weise zu behandeln. Verfügbare Optionen: Enable, Disable. Wählen Sie aus, dass Sie Disable zur älteren (potenziell unsicheren) Behandlung nachgestellter Punktdateien zurückkehren möchten, bei denen der Dateidienst nachfolgende Punkte in Pfaden kürzen wird. Dies kann zu einer potenziellen Datenbeschädigung führen, wenn die Übertragung zwei Pfade enthält, die sich nur von einem nachgestellten Punkt unterscheiden (z. B mypath . und mypath.). Wenn dieses Flag auf Disable "AzCopy" festgelegt ist und eine nachfolgende Punktdatei auftritt, warnt es Kunden im Scanprotokoll, versucht jedoch nicht, den Vorgang abzubrechen. Wenn das Ziel nachfolgende Punktdateien (Windows oder Blob Storage) nicht unterstützt, schlägt AzCopy fehl, wenn die nachfolgende Punktdatei der Stamm der Übertragung ist und alle nachfolgenden Punktpfade überspringen, die während der Enumeration aufgetreten sind.
--recursive – Der Standardwert ist „false“. Suchen Sie rekursiv nach Unterverzeichnissen, wenn Sie zwischen Verzeichnissen synchronisieren.
Von übergeordneten Befehlen geerbte Optionen
--cap-mbps float (Zeichenfolge): Begrenzt die Übertragungsrate (in Megabit pro Sekunde). Der Schritt-für-Schritt-Durchsatz kann von der Obergrenze geringfügig abweichen. Wenn diese Option auf „Null“ festgelegt oder weggelassen wird, ist der Durchsatz nicht begrenzt.
--output-type (Zeichenfolge) – Format der Befehlsausgabe. Folgende Optionen sind verfügbar: „text“ und „json“. Der Standardwert lautet „text“. (Standardwert: „text“)
--trusted-microsoft-suffixes (Zeichenfolge) Gibt zusätzliche Domänensuffixe an, bei denen möglicherweise Microsoft Entra-Anmeldetoken gesendet werden. Der Standardwert ist '.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net'. Alle hier aufgelisteten Werte werden zum Standardwert hinzugefügt. Aus Sicherheitsgründen sollten Sie hier nur Microsoft Azure-Domänen platzieren. Trennen Sie mehrere E-Mail-Adressen durch Semikolons voneinander.
--log-level (Zeichenfolge): Definiert die Ausführlichkeit der Protokolldatei. Folgende Ebenen sind verfügbar: INFO (alle Anforderungen/Antworten), WARNING (langsame Antworten), ERROR (nur fehlgeschlagene Anforderungen) und NONE (keine Ausgabeprotokolle). (Der Standardwert lautet „INFO“.) (Standardwert: „INFO“)