Freigeben über


azcopy set-properties

Ä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.

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 Blob-Ebene in Kalt:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold

Ändern der Blob-Ebene von "Hot to Archive":

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive

Ä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 Sie die Ebene des Blobs von kühl in heiß, wobei die Priorität für rehydrate auf Standard festgelegt ist:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard

Ä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

Änderungsebene eines Seitenblobs:

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]

Ä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

Löschen Sie alle vorhandenen Metadaten aus allen Dateien:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --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.

Weitere Informationen