azcopy set-properties (Vorschau)
Ändern Sie angesichts eines Speicherorts alle gültigen Systemeigenschaften dieses Speichers (Blob oder Datei).
Übersicht
azcopy set-properties [resourceURL] [flags]
Legt die Eigenschaften von Blob- und Dateispeicher fest. Es folgen die derzeit von diesem Befehl unterstützten Eigenschaften:
- Blobs -> Ebene, Metadaten, Tags
- Data Lake Storage Gen2 -> Ebene, Metadaten, Tags
- Dateien -> Metadaten
Hinweis
Data Lake Storage Gen2-Endpunkte werden durch Blob Storage-Endpunkte ersetzt.
Weitere Informationen finden Sie in den Beispielen.
Verwandte konzeptionelle Artikel
- Erste Schritte mit AzCopy
- Ersetzen von Eigenschaften und Metadaten von Blobs mithilfe von AzCopy v10 (Vorschau)
Beispiele
Ändern der Ebene des Blobs in „Heiß“:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
Ändern der Ebene des Blobs von „Archivieren“ in „Kalt“ mit auf „Hoch“ festgelegter Aktivierungspriorität:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
Ändern der Ebene aller Dateien in einem Verzeichnis in „Archivieren“:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
Ändern von Metadaten des Blobs in {key = "abc", val = "def"} und {key = "ghi", val = "jkl"}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl
Ändern von Metadaten aller Dateien in einem Verzeichnis in {key = "abc", val = "def"} und {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
Löschen aller vorhandenen Metadaten des Blobs:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
Ändern von Blobtags des Blobs in {key = "abc", val = "def"} und {key = "ghi", val = "jkl"}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl
Beim Festlegen von Tags für die Blobs gibt es andere Berechtigungen („t“ für Tags) mit SAS. Ohne diese Tags gibt der Dienst einen Autorisierungsfehler zurück.
Löschen aller vorhandenen Blobtags des Blobs:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
Beim Festlegen von Tags für die Blobs gibt es andere Berechtigungen („t“ für Tags) mit SAS. Ohne diese Tags gibt der Dienst einen Autorisierungsfehler zurück.
Optionen
--blob-tags String Set tags on blobs to kategorisier data in your storage account (separated by '&')
--block-blob-tier (Zeichenfolge): ändert die Zugriffsebene der Blobs in die angegebene Ebene (Standardwert „None“)
--dry-run: gibt die Dateipfade aus, die von diesem Befehl betroffen wären. Dieses Flag hat keinen Einfluss auf die tatsächlichen Dateien.
--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, deren Name der Musterliste entspricht. Beispiel: .jpg; .pdf;exactName
--from-to (Zeichenfolge): gibt optional die Quelle-Ziel-Kombination an. Gültige Werte: BlobNone, FileNone, BlobFSNone
-h, --help: Hilfe für set-properties
--include-path (Zeichenfolge): schließt nur diese Pfade beim Festlegen der Eigenschaft 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 der Textdatei mit der Liste der zu kopierenden Dateien.
--metadata (Zeichenfolge): legt den angegebenen Speicherort mit diesen Schlüssel-Werte-Paaren (getrennt durch „;“) als Metadaten fest.
--page-blob-tier (Zeichenfolge): lädt ein Seitenblob unter Verwendung dieser Blobebene in Azure Storage hoch. (Der Standardwert lautet „None“.) (Standardwert: „None“)
--recursive Dient beim Hochladen aus dem lokalen Dateisystem zum rekursiven Durchsuchen von Unterverzeichnissen.
--rehydrate-priority (Zeichenfolge): optionales Flag, das die Priorität für die Aktivierung festlegt. Gültige Werte: Standard, High. Standardwert: Standard
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.
--log-level (Zeichenfolge) Definiert, wie ausführlich die Protokolldatei sein soll. Verfügbare Stufen: INFO (alle Anforderungen/Antworten), WARNING (langsame Antworten), ERROR (nur fehlgeschlagene Anforderungen) und NONE (keine Ausgabeprotokolle). (Der Standardwert lautet „INFO“). (Standardwert: „Info“)
--output-type (Zeichenfolge) – Format der Befehlsausgabe. Folgende Optionen sind verfügbar: „text“ und „json“. Der Standardwert lautet „text“. (Standardwert: „text“)
--output-level (Zeichenfolge): legt die Ausführlichkeit der Ausgabe fest. Verfügbare Ebenen: essential, quiet. (Standardwert: „default“)
--trusted-microsoft-suffixes (Zeichenfolge) Gibt weitere Domänensuffixe an, bei denen möglicherweise Microsoft Entra ID-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.