az storage blob

Referenz

Verwalten des Objektspeichers für unstrukturierte Daten (Blobs)

Geben Sie einen der folgenden Authentifizierungsparameter für Ihre Befehle an: --auth-mode, --account-key, --connection-string, --sas-token. Sie können auch entsprechende Umgebungsvariablen verwenden, um Ihre Authentifizierungsanmeldeinformationen zu speichern, z. B. AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING und AZURE_STORAGE_SAS_TOKEN.

Befehle

az storage blob access	Verwalten der Zugriffssteuerungseigenschaften eines Blobs, wenn der hierarchische Namespace aktiviert ist
az storage blob access set	Legen Sie die Zugriffssteuerungseigenschaften eines Blobs fest.
az storage blob access show	Zeigen Sie die Zugriffssteuerungseigenschaften eines Blobs an.
az storage blob access update	Aktualisieren der Zugriffssteuerungseigenschaften eines Blobs.
az storage blob copy	Verwalten von Blobkopiervorgängen Verwenden Sie `az storage blob show` zum Überprüfen des Status der Blobs.
az storage blob copy cancel	Abbrechen eines laufenden Kopiervorgangs.
az storage blob copy start	Kopieren Sie einen Blob asynchron. Verwenden Sie `az storage blob show` zum Überprüfen des Status der Blobs.
az storage blob copy start-batch	Kopieren Sie mehrere Blobs in einen Blobcontainer. Verwenden Sie `az storage blob show` zum Überprüfen des Status der Blobs.
az storage blob delete	Markieren eines Blobs oder einer Momentaufnahme zum Löschen.
az storage blob delete-batch	Löschen Sie Blobs aus einem Blobcontainer rekursiv.
az storage blob directory	Verwalten von Blobverzeichnissen im Speicherkontocontainer.
az storage blob directory access	Verwalten der Zugriffssteuerungseigenschaften eines Verzeichnisses, wenn der hierarchische Namespace aktiviert ist
az storage blob directory access set	Legen Sie die Zugriffssteuerungseigenschaften eines Verzeichnisses fest.
az storage blob directory access show	Zeigen Sie die Zugriffssteuerungseigenschaften eines Verzeichnisses an.
az storage blob directory access update	Aktualisieren der Zugriffssteuerungseigenschaften eines Verzeichnisses.
az storage blob directory create	Erstellen Sie ein Speicher-Blob-Verzeichnis in einem Speichercontainer.
az storage blob directory delete	Löschen Eines Speicher-Blob-Verzeichnisses in einem Speichercontainer.
az storage blob directory download	Laden Sie Blobs in einen lokalen Dateipfad herunter.
az storage blob directory exists	Überprüfen Sie die Existenz eines Blob-Verzeichnisses in einem Speichercontainer.
az storage blob directory list	Listen-Blobs und Blob-Unterverzeichnisse in einem Speicherverzeichnis auf.
az storage blob directory metadata	Verwalten von Verzeichnismetadaten
az storage blob directory metadata show	Alle benutzerdefinierten Metadaten für das angegebene Blobverzeichnis anzeigen.
az storage blob directory metadata update	Legen Sie benutzerdefinierte Metadaten für das angegebene Blobverzeichnis als ein oder mehrere Namenwertpaare fest.
az storage blob directory move	Verschieben Sie ein Speicherverzeichnis in ein anderes Speicher-Blob-Verzeichnis in einem Speichercontainer.
az storage blob directory show	Anzeigen einer Speicher-Blob-Verzeichniseigenschaften in einem Speichercontainer.
az storage blob directory upload	Laden Sie Blobs oder Unterverzeichnisse in ein Speicher-Blob-Verzeichnis hoch.
az storage blob download	Laden Sie einen Blob auf einen Dateipfad herunter.
az storage blob download-batch	Laden Sie Blobs aus einem Blobcontainer rekursiv herunter.
az storage blob exists	Suchen Sie nach der Existenz eines Blobs in einem Container.
az storage blob filter	Listen-Blobs in allen Containern auf, deren Tags einem bestimmten Suchausdruck entsprechen.
az storage blob generate-sas	Generieren Sie eine freigegebene Zugriffssignatur für den Blob.
az storage blob immutability-policy	Verwalten der Blob-Unveränderlichkeitsrichtlinie.
az storage blob immutability-policy delete	Löschen sie die Unveränderlichkeitsrichtlinie des Blobs.
az storage blob immutability-policy set	Legen Sie die Unveränderbarkeitsrichtlinie des Blobs fest.
az storage blob incremental-copy	Verwalten von inkrementellen Blobkopiervorgängen
az storage blob incremental-copy cancel	Abbricht einen ausstehenden copy_blob-Vorgang ab und verlässt einen Ziel-Blob mit null Länge und vollständigen Metadaten.
az storage blob incremental-copy start	Kopiert eine inkrementelle Kopie eines Blobs asynchron.
az storage blob lease	Verwalten von Speicherblob-Leases
az storage blob lease acquire	Fordern Sie eine neue Lease an.
az storage blob lease break	Unterbrechen Sie die Lease, wenn der Container oder blob über einen aktiven Lease verfügt.
az storage blob lease change	Ändern Sie die Lease-ID eines aktiven Leases.
az storage blob lease release	Geben Sie die Lease frei.
az storage blob lease renew	Erneuern Sie die Lease.
az storage blob list	Listen-Blobs in einem bestimmten Container auf.
az storage blob metadata	Verwalten von Blobmetadaten
az storage blob metadata show	Geben Sie alle benutzerdefinierten Metadaten für das angegebene Blob oder die Momentaufnahme zurück.
az storage blob metadata update	Legt benutzerdefinierte Metadaten für den Blob als ein oder mehrere Namenwertpaare fest.
az storage blob move	Verschieben eines Blobs in einem Speichercontainer.
az storage blob restore	Wiederherstellen von Blobs in den angegebenen Blobbereichen.
az storage blob rewrite	Erstellen Sie einen neuen Block-Blob, in dem der Inhalt des Blobs aus einer bestimmten URL gelesen wird.
az storage blob service-properties	Verwalten der Speicherblobdienst-Eigenschaften
az storage blob service-properties delete-policy	Verwalten der Eigenschaften für die Löschungsrichtlinie des Speicherblobdiensts
az storage blob service-properties delete-policy show	Zeigen Sie die Speicher-Blob-Delete-Policy an.
az storage blob service-properties delete-policy update	Aktualisieren Sie die Speicher-Blob-Delete-Policy.
az storage blob service-properties show	Ruft die Eigenschaften des Blob-Diensts eines Speicherkontos ab, einschließlich Azure Storage Analytics.
az storage blob service-properties update	Aktualisiert die Speicherblobdienst-Eigenschaften.
az storage blob set-legal-hold	Legen Sie den zulässigen Blob-Haltestand fest.
az storage blob set-tier	Legen Sie die Block- oder Seitenebenen im Blob fest.
az storage blob show	Rufen Sie die Details eines Blobs ab.
az storage blob snapshot	Erstellt eine Momentaufnahme des Blobs.
az storage blob sync	Synchronisieren Sie Blobs rekursiv zu einem Speicher-Blobcontainer.
az storage blob tag	Verwalten von Blobtags.
az storage blob tag list	Rufen Sie Tags auf einer Blob- oder bestimmten Blobversion oder Momentaufnahme ab.
az storage blob tag set	Legen Sie Tags auf einer Blob- oder bestimmten Blob-Version fest, aber keine Momentaufnahme.
az storage blob undelete	Stellen Sie einen weich gelöschten Blob oder eine Momentaufnahme wiederhergestellt.
az storage blob update	Legt Systemeigenschaften für den Blob fest.
az storage blob upload	Laden Sie eine Datei in ein Speicher-Blob hoch.
az storage blob upload-batch	Laden Sie Dateien aus einem lokalen Verzeichnis in einen Blobcontainer hoch.
az storage blob url	Erstellen Sie die URL, um auf ein Blob zuzugreifen.

az storage blob delete

Bearbeiten

Markieren eines Blobs oder einer Momentaufnahme zum Löschen.

Das Blob wird für die spätere Löschung während der Garbage Collection markiert. Um ein Blob zu löschen, müssen auch alle Momentaufnahmen gelöscht werden. Beide können gleichzeitig entfernt werden.

az storage blob delete --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--connection-string]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]

Beispiele

Löschen eines Blobs

az storage blob delete -c mycontainer -n MyBlob

Löschen eines Blobs mithilfe von Anmeldeinformationen.

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der ältere "Schlüssel"-Modus versucht, einen Kontoschlüssel zu abfragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login

--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie können jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--delete-snapshots

Erforderlich, wenn dem BLOB Momentaufnahmen zugeordnet sind. Werte sind: "only": Löscht nur die Blobs-Momentaufnahmen. "include": Löscht den Blob zusammen mit allen Momentaufnahmen.

Zulässige Werte: include, only

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z' geändert wurde).

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--if-unmodified-since

Beginnen Sie nur, wenn seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z) nicht geändert wurde.

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der Momentaufnahmeparameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, die blob-Momentaufnahme angibt, die gelöscht werden soll.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob delete-batch

Bearbeiten

Löschen von Blobs aus einem Blobcontainer rekursiv.

az storage blob delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--delete-snapshots {include, only}]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

Beispiele

Löschen Sie alle Blobs, die mit ".py" in einem Container enden, der seit 10 Tagen nicht geändert wurde.

date=`date -d "10 days ago" '+%Y-%m-%dT%H:%MZ'`
az storage blob delete-batch -s mycontainer --account-name mystorageaccount --pattern *.py --if-unmodified-since $date --auth-mode login

Löschen Sie alle Blobs in einem Verzeichnis namens "dir" in einem Container mit dem Namen "mycontainer".

az storage blob delete-batch -s mycontainer --pattern dir/*

Löschen Sie die Blobs mit dem Format "cli-2018-xx-xx.txt" oder "cli-2019-xx-xx.txt" in einem Container.

az storage blob delete-batch -s mycontainer --pattern cli-201[89]-??-??.txt

Löschen Sie alle Blobs mit dem Format "cli-201x-xx-xx.txt", außer cli-2018-xx-xx.txt" und "cli-2019-xx-xx.txt" in einem Container.

az storage blob delete-batch -s mycontainer --pattern cli-201[!89]-??-??.txt

Erforderliche Parameter

--source -s

Der Blobcontainer, aus dem die Dateien gelöscht werden.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacymodus "Schlüssel" versucht, einen Kontoschlüssel abzufragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login

--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--delete-snapshots

Erforderlich, wenn dem BLOB Momentaufnahmen zugeordnet sind.

Zulässige Werte: include, only

--dryrun

Zeigen Sie die Zusammenfassung der Vorgänge an, die ausgeführt werden sollen, anstatt die Datei(n) tatsächlich zu löschen.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z' geändert wurde).

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*).

--if-unmodified-since

Beginnen Sie nur, wenn seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z) nicht geändert wurde.

--lease-id

Die aktive Lease-ID für das Blob.

--pattern

Das Muster, das für Globbingdateien oder Blobs in der Quelle verwendet wird. Die unterstützten Muster sind "*", "?", "[seq]" und "[!seq]". Weitere Informationen finden Sie unter https://docs.python.org/3.7/library/fnmatch.html.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob download

Bearbeiten

Laden Sie einen Blob in einen Dateipfad herunter.

az storage blob download [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--end-range]
                         [--file]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--max-connections]
                         [--name]
                         [--no-progress]
                         [--open-mode]
                         [--overwrite {false, true}]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--tags-condition]
                         [--timeout]
                         [--validate-content]
                         [--version-id]

Beispiele

Laden Sie einen Blob herunter.

az storage blob download -f /path/to/file -c mycontainer -n MyBlob

Laden Sie einen BLOB-Inhalt auf stdout(pipe support) herunter.

az storage blob download -c mycontainer -n myblob --account-name mystorageaccount --account-key myaccountkey

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme bei Verwendung. Dies kann entweder der primäre Endpunkt oder der sekundäre Endpunkt je nach aktuellem location_modeEndpunkt sein.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--end-range

Ende des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn end_range angegeben wird, muss start_range bereitgestellt werden. Die start_range und end_range Params sind inklusive. Ex: start_range=0, end_range=511 lädt zuerst 512 Bytes blob herunter.

--file -f

Pfad der Datei zum Schreiben in. Wenn nicht angegeben, wird stdout verwendet, und max_connections wird auf 1 festgelegt.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z' geändert wurde).

--if-none-match

--if-unmodified-since

Beginnen Sie nur, wenn seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z) nicht geändert wurde.

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

--max-connections

Die Anzahl der parallelen Verbindungen, mit denen heruntergeladen werden soll.

Standardwert: 2

--name -n

Der Blobname.

--no-progress

Fügen Sie dieses Kennzeichen ein, um die Statusberichterstellung für den Befehl zu deaktivieren.

--open-mode

Modus, der beim Öffnen der Datei verwendet werden soll. Beachten Sie, dass das Angeben von anfügen nur open_mode den parallelen Download verhindert. Daher muss max_connections auf 1 festgelegt werden, wenn diese open_mode verwendet wird.

Standardwert: wb

--overwrite

Überschreiben Sie eine vorhandene Datei, wenn sie angegeben ist. Der Standardwert ist true.

Zulässige Werte: false, true

Standardwert: 1

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der Momentaufnahmeparameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, die Blob-Momentaufnahme angibt, die abgerufen werden soll.

--start-range

Anfang des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn keine end_range angegeben wird, werden alle Bytes nach dem herunterladen start_range heruntergeladen. Die start_range und end_range Params sind inklusive. Ex: start_range=0, end_range=511 lädt zuerst 512 Bytes blob herunter.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

--validate-content

Wenn true, berechnet ein MD5-Hash für jeden Teil des Blobs. Der Speicherdienst überprüft den Hash der Inhalte, die mit dem gesendeten Hash eingetroffen wurden. Dies ist in erster Linie für die Erkennung von Bitflips auf dem Draht hilfreich, wenn http anstelle von https verwendet wird, als https (standard), wird bereits überprüft. Beachten Sie, dass dieser MD5-Hash nicht mit dem BLOB gespeichert wird. Beachten Sie auch, dass der speichereffiziente Algorithmus nicht verwendet wird, da das Berechnen des MD5-Hashs die Pufferung vollständiger Blöcke erfordert und dadurch den Zweck des speichereffizienten Algorithmus besiegt.

--version-id

Eine optionale BLOB-Versions-ID. Dieser Parameter gilt nur für das aktivierte Versionsverwaltungskonto.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob download-batch

Bearbeiten

Laden Sie Blobs aus einem BLOB-Container rekursiv herunter.

az storage blob download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--overwrite {false, true}]
                               [--pattern]
                               [--sas-token]

Beispiele

Laden Sie alle Blobs herunter, die mit .py enden

az storage blob download-batch -d . --pattern *.py -s mycontainer --account-name mystorageaccount --account-key 00000000

Laden Sie alle Blobs in einem Verzeichnis namens "dir" aus dem Container mit dem Namen "mycontainer" herunter.

az storage blob download-batch -d . -s mycontainer --pattern dir/*

Laden Sie alle Blobs mit dem Format "cli-2018-xx-xx.txt" oder "cli-2019-xx-xx.txt" im Container auf den aktuellen Pfad herunter.

az storage blob download-batch -d . -s mycontainer --pattern cli-201[89]-??-??.txt

Laden Sie alle Blobs mit dem Format "cli-201x-xx-xx.txt" außer cli-2018-xx-xx.txt" und "cli-2019-xx-xx.txt" im Container auf den aktuellen Pfad herunter.

az storage blob download-batch -d . -s mycontainer --pattern cli-201[!89]-??-??.txt

Erforderliche Parameter

--destination -d

Der vorhandene Zielordner für diesen Downloadvorgang.

--source -s

Der Blobcontainer, aus dem die Dateien heruntergeladen werden.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--dryrun

Zeigen Sie die Zusammenfassung der Vorgänge an, die ausgeführt werden sollen, anstatt die Datei(n) tatsächlich herunterzuladen.

--max-connections

Die Anzahl der parallelen Verbindungen, mit denen heruntergeladen werden soll.

Standardwert: 2

--no-progress

Fügen Sie dieses Kennzeichen ein, um die Statusberichterstellung für den Befehl zu deaktivieren.

--overwrite

Überschreiben Sie eine vorhandene Datei, wenn sie angegeben ist. Der Standardwert ist „false“.

Zulässige Werte: false, true

--pattern

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob exists

Bearbeiten

Überprüfen Sie, ob ein Blob in einem Container vorhanden ist.

az storage blob exists --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--connection-string]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

Beispiele

Überprüfen Sie, ob ein Blob in einem Container vorhanden ist. (automatisch generiert)

az storage blob exists --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der Momentaufnahmeparameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, die Momentaufnahme angibt.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob filter

Auflisten von Blobs in allen Containern, deren Tags einem bestimmten Suchausdruck entsprechen.

Filtern von Blobs durchsucht alle Container innerhalb eines Speicherkontos, kann jedoch innerhalb des Ausdrucks auf einen einzelnen Container festgelegt werden.

az storage blob filter --tag-filter
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--sas-token]

Erforderliche Parameter

--tag-filter

Der Ausdruck zum Suchen von Blobs, deren Tags der angegebenen Bedingung entsprechen. Beispiel: ""yourtagname"='firsttag' and "yourtagname2"='secondtag'" To specify a container, z. B. "@container='containerName' und "Name"='C'".

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob generate-sas

Bearbeiten

Generieren Sie eine freigegebene Zugriffssignatur für das Blob.

az storage blob generate-sas [--account-key]
                             [--account-name]
                             [--as-user]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--blob-url]
                             [--cache-control]
                             [--connection-string]
                             [--container-name]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--encryption-scope]
                             [--expiry]
                             [--full-uri]
                             [--https-only]
                             [--ip]
                             [--name]
                             [--permissions]
                             [--policy-name]
                             [--snapshot]
                             [--start]
                             [--timeout]

Beispiele

Generieren Sie ein SAS-Token für ein Blob mit schreibgeschützten Berechtigungen.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

Generieren Sie ein Sas-Token für ein Blob mit angegebenem IP-Bereich.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Generieren Sie eine freigegebene Zugriffssignatur für das Blob. (automatisch generiert)

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--as-user

Gibt an, dass dieser Befehl das SAS zurückgibt, das mit dem Benutzerdelegierungsschlüssel signiert ist. Der Ablaufparameter und die Anmeldung im "--auth-mode"-Modus sind erforderlich, wenn dieses Argument angegeben wird.

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--blob-url

--cache-control

Antwortheaderwert für Cache-Control, wenn auf die Ressource mithilfe dieser freigegebenen Zugriffssignatur zugegriffen wird.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--content-disposition

Antwortheaderwert für Die Inhaltsverfügung, wenn auf die Ressource mithilfe dieser freigegebenen Zugriffssignatur zugegriffen wird.

--content-encoding

Antwortheaderwert für Inhaltscodierung, wenn auf die Ressource mithilfe dieser freigegebenen Zugriffssignatur zugegriffen wird.

--content-language

Antwortheaderwert für Content-Language, wenn auf die Ressource mithilfe dieser freigegebenen Zugriffssignatur zugegriffen wird.

--content-type

Antwortheaderwert für Inhaltstyp, wenn auf die Ressource mithilfe dieser freigegebenen Zugriffssignatur zugegriffen wird.

--encryption-scope

Ein vordefinierter Verschlüsselungsbereich, der zum Verschlüsseln der Daten im Dienst verwendet wird.

--expiry

Gibt die UTC-Datumszeit (Y-m-d'T:M'Z') an, bei der das SAS ungültig wird. Verwenden Sie nicht, wenn auf eine gespeicherte Zugriffsrichtlinie mit dem Namen "-policy-name" verwiesen wird, der diesen Wert angibt.

--full-uri

Gibt an, dass dieser Befehl den vollständigen Blob-URI und das Signaturtoken für den freigegebenen Zugriff zurückgibt.

--https-only

Nur Anforderungen zulassen, die mit dem HTTPS-Protokoll vorgenommen wurden. Wenn nicht angegeben, sind Anforderungen aus dem HTTP- und HTTPS-Protokoll zulässig.

--ip

Gibt die IP-Adresse oder den Bereich der IP-Adressen an, von denen Anforderungen akzeptiert werden sollen. Unterstützt nur IPv4-Formatadressen.

--name -n

Der Blobname.

--permissions

Die Berechtigungen, die die SAS gewährt. Zulässige Werte: (a)dd (c)reate (d)elete (e)xecute (i)set_immutability_policy (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete. Verwenden Sie nicht, wenn auf eine gespeicherte Zugriffsrichtlinie mit --id verwiesen wird, die diesen Wert angibt. Kann kombiniert werden.

--policy-name

Der Name einer gespeicherten Zugriffsrichtlinie innerhalb der ACL des Containers.

--snapshot

Eine optionale Blob-Momentaufnahme-ID. Opaque DateTime-Wert, der, wenn vorhanden, die Blob-Momentaufnahme angibt, um Berechtigungen zu erteilen.

--start

Gibt die UTC-Datumszeit (Y-m-d'T:M'Z') an, bei der das SAS gültig wird. Verwenden Sie nicht, wenn auf eine gespeicherte Zugriffsrichtlinie mit dem Namen "-policy-name" verwiesen wird, der diesen Wert angibt. Standardwert für die Uhrzeit der Anforderung.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob list

Bearbeiten

Auflisten von Blobs in einem bestimmten Container.

az storage blob list --container-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--connection-string]
                     [--delimiter]
                     [--include]
                     [--marker]
                     [--num-results]
                     [--prefix]
                     [--sas-token]
                     [--show-next-marker]
                     [--timeout]

Beispiele

Alle Speicher-Blobs in einem Container auflisten, deren Namen mit "foo" beginnen; entspricht Namen wie "foo", "foobar" und "foo/bar"

az storage blob list -c mycontainer --prefix foo

Erforderliche Parameter

--container-name -c

Der Containername

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--delimiter

Wenn die Anforderung diesen Parameter enthält, gibt der Vorgang ein BlobPrefix-Element in der Ergebnisliste zurück, das als Platzhalter für alle Blobs fungiert, deren Namen mit derselben Teilzeichenfolge beginnen, bis zur Darstellung des Trennzeichens. Das Trennzeichen kann ein einzelnes Zeichen oder eine Zeichenfolge sein.

--include

Geben Sie mindestens ein zusätzliches Dataset an, das in die Antwort eingeschlossen werden soll. Optionen sind: (c)opy, (d)eleted, (m)etadata, (s)napshots, (v)ersions, (t)ags, (i)mmutabilitypolicy, (l)egalhold, (d)eletedwithversions. Kann kombiniert werden.

--marker

Ein Zeichenfolgenwert, der den Teil der Liste der Container identifiziert, die mit dem nächsten Eintragsvorgang zurückgegeben werden sollen. Der Vorgang gibt den NextMarker-Wert innerhalb des Antworttexts zurück, wenn der Eintragsvorgang nicht alle Container zurückgibt, die mit der aktuellen Seite aufgelistet werden sollen. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen aus dem Punkt, an dem der vorherige Generator beendet wurde.

--num-results

Geben Sie die maximale Zahl an, die zurückgegeben werden soll. Wenn die Anforderung nicht num_results angibt oder einen Wert größer als 5000 angibt, gibt der Server bis zu 5000 Elemente zurück. Beachten Sie, dass der Eintragsvorgang eine Partitionsgrenze überschreitet, dann gibt der Dienst ein Fortsetzungstoken zum Abrufen der verbleibenden Ergebnisse zurück. Geben Sie "*" an, um alle zurückzugeben.

Standardwert: 5000

--prefix

Filtern Sie die Ergebnisse, um nur Blobs zurückzugeben, deren Name mit dem angegebenen Präfix beginnt.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

"NextMarker" im Ergebnis anzeigen, wenn angegeben.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob move

Verschieben eines Blobs in einem Speichercontainer

az storage blob move --container-name
                     --destination-blob
                     --source-blob
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--lease-id]
                     [--sas-token]
                     [--source-if-match]
                     [--source-if-modified-since]
                     [--source-if-none-match]
                     [--source-if-unmodified-since]
                     [--source-lease-id]
                     [--timeout]

Beispiele

Verschieben eines Blobs in einem Speichercontainer

az storage blob move -c MyContainer -d DestinationBlobPath -s SourceBlobPath --account-name MyStorageAccount

Erforderliche Parameter

--container-name -c

Der Containername

--destination-blob -d

Der Ziel-BLOB-Name. Es sollte ein absoluter Pfad unter dem Container sein. z.B.'topdir1/dirbar'.

--source-blob -s

Der Quell-Blobname. Es sollte ein absoluter Pfad unter dem Container sein. z.B.'topdir1/dirsubfoo'.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

Optional. Eine Lease-ID für die new_path. Die new_path müssen über eine aktive Lease verfügen, und die Lease-ID muss übereinstimmen.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--source-if-match

Optional. Ein ETag-Wert. Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn das ETag der Quelle mit dem angegebenen Wert übereinstimmt.

--source-if-modified-since

Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn die Quelle seit dem angegebenen Datum und der angegebenen Uhrzeit geändert wurde.

--source-if-none-match

Optional. Ein ETag-Wert oder der spezielle Wildcardwert ("*") Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn das ETag der Quelle nicht mit dem angegebenen Wert übereinstimmt.

--source-if-unmodified-since

Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Umbenennungsvorgang nur auszuführen, wenn die Quelle seit dem angegebenen Datum und der angegebenen Uhrzeit nicht geändert wurde.

--source-lease-id

Optional. Eine Lease-ID für die source_path. Die source_path müssen über eine aktive Lease verfügen, und die Lease-ID muss übereinstimmen.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob restore

Bearbeiten

Wiederherstellen von Blobs in den angegebenen Blobbereichen

az storage blob restore --account-name
                        --time-to-restore
                        [--blob-range]
                        [--no-wait]
                        [--resource-group]

Beispiele

Wiederherstellen von Blobs in zwei angegebenen Blobbereichen. Beispiele: (container1/blob1, container2/blob2) und (container2/blob3.). container2/blob4).

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r container1/blob1 container2/blob2 -r container2/blob3 container2/blob4

Wiederherstellen von Blobs in den angegebenen Blobbereichen von Kontoanfang bis Kontoende.

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r "" ""

Wiederherstellen von Blobs im angegebenen Blobbereich.

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2

Wiederherstellen von Blobs im angegebenen Blobbereich ohne Warten und Abfragen des Blob-Wiederherstellungsstatus mit "az storage account show".

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2 --no-wait

Erforderliche Parameter

--account-name -n

Der Name des Speicherkontos.

--time-to-restore -t

Wiederherstellen des Blobs zur angegebenen Uhrzeit, die UTC-Datumszeit in (Y-m-d'T:M:M:S'Z').

Optionale Parameter

--blob-range -r

Blobbereiche, die wiederhergestellt werden sollen. Sie müssen zwei Werte angeben, um start_range und end_range für jeden Blobbereich anzugeben, z. B. -r blob1 blob2. Hinweis: Leer bedeutet, dass das Konto als Startbereichswert beginnt und das Kontoende für den Endbereich bedeutet.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob rewrite

Bearbeiten

Erstellen Sie einen neuen Block-Blob, in dem der Inhalt des Blobs aus einer bestimmten URL gelesen wird.

Der Inhalt eines vorhandenen Blobs wird mit dem neuen Blob überschrieben.

az storage blob rewrite --container-name
                        --name
                        --source-uri
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--encryption-scope]
                        [--if-match]
                        [--if-modified-since]
                        [--if-none-match]
                        [--if-unmodified-since]
                        [--lease-id]
                        [--sas-token]
                        [--tags-condition]
                        [--tier {Archive, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80}]
                        [--timeout]

Beispiele

Aktualisieren des Verschlüsselungsbereichs für vorhandene Blobs.

az storage blob rewrite --source-uri https://srcaccount.blob.core.windows.net/mycontainer/myblob?<sastoken> --encryption-scope newscope -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

--source-uri -u

Eine URL von bis zu 2 KB Länge, die eine Datei oder ein Blob angibt. Der Wert sollte so URL-codiert sein, wie er in einem Anforderungs-URI verwendet wird. Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder über eine freigegebene Zugriffssignatur authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--encryption-scope

Ein vordefinierter Verschlüsselungsbereich, der zum Verschlüsseln der Daten im Dienst verwendet wird. Ein Verschlüsselungsbereich kann mithilfe der Verwaltungs-API erstellt und hier anhand des Namens verwiesen werden. Wenn ein Standardverschlüsselungsbereich im Container definiert wurde, überschreibt dieser Wert ihn, wenn der Bereich auf Containerebene so konfiguriert ist, dass Außerkraftsetzungen zulässig sind. Andernfalls wird ein Fehler ausgelöst.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt. Der Wert kann ein BlobLeaseClient-Objekt oder die Lease-ID als Zeichenfolge sein.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--tier

Ein Standard-Blob-Ebenenwert, auf den das Blob festgelegt wird. Für diese Version der Bibliothek gilt dies nur für blockende Blobs auf Standardspeicherkonten.

Zulässige Werte: Archive, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob set-legal-hold

Bearbeiten

Legen Sie den zulässigen Blob-Haltestand fest.

az storage blob set-legal-hold --container-name
                               --legal-hold {false, true}
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]

Beispiele

Konfigurieren sie den zulässigen Blob-Haltestand.

az storage blob set-legal-hold --legal-hold -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Löschen Sie den zulässigen Blob-Haltestand.

az storage blob set-legal-hold --legal-hold false -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Erforderliche Parameter

--container-name -c

Der Containername

--legal-hold

Angegeben, wenn ein rechtlicher Haltestand auf dem Blob festgelegt werden soll.

Zulässige Werte: false, true

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob set-tier

Bearbeiten

Legen Sie die Block- oder Seitenebenen im Blob fest.

Für block blob unterstützt dieser Befehl nur block blob für Standardspeicherkonten. Für das Seiten-Blob unterstützt dieser Befehl nur Seiten-Blobs für Premiumkonten.

az storage blob set-tier --container-name
                         --name
                         --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--connection-string]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--timeout]
                         [--type {block, page}]

Beispiele

Legen Sie die Block- oder Seitenebenen im Blob fest. (automatisch generiert)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--rehydrate-priority -r

Geben Sie die Priorität an, mit der ein archiviertes Blob rehydratiert werden soll. Die Priorität kann nur einmal auf einem Blob festgelegt werden, standardwert ist Standard.

Zulässige Werte: High, Standard

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Der timeout-Parameter wird in Sekunden angegeben. Diese Methode kann mehrere Aufrufe an den Azure-Dienst vornehmen, und das Timeout gilt für jeden Aufruf einzeln.

--type -t

Der BLOB-Typ.

Zulässige Werte: block, page

Standardwert: block

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob show

Bearbeiten

Rufen Sie die Details eines Blobs ab.

az storage blob show --container-name
                     --name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--connection-string]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--sas-token]
                     [--snapshot]
                     [--tags-condition]
                     [--timeout]

Beispiele

Alle Eigenschaften eines Blobs anzeigen.

az storage blob show -c mycontainer -n MyBlob

Abrufen der Details eines Blobs (automatisch generiert)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der Momentaufnahmeparameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, die Blob-Momentaufnahme angibt, die abgerufen werden soll.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob snapshot

Bearbeiten

Erstellt eine Momentaufnahme des Blobs.

Eine Momentaufnahme ist eine schreibgeschützte Version eines Blobs, die zu einem bestimmten Zeitpunkt erstellt wird. Es kann gelesen, kopiert oder gelöscht werden, aber nicht geändert werden. Momentaufnahmen bieten eine Möglichkeit, um ein Blob so zu sichern, wie es zu einem bestimmten Zeitpunkt dargestellt wird. Eine Momentaufnahme eines Blobs hat denselben Namen wie das Basis-Blob, aus dem die Momentaufnahme aufgenommen wird, wobei ein DateTime-Wert angefügt wird, um die Uhrzeit anzugeben, zu der die Momentaufnahme aufgenommen wurde.

az storage blob snapshot --container-name
                         --name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--connection-string]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--metadata]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

--metadata

Metadaten in leer getrennten Schlüssel=Wertpaaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob sync

Bearbeiten

Synchronisieren Sie Blobs rekursiv zu einem Speicher-Blobcontainer.

az storage blob sync --container
                     --source
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--delete-destination {false, prompt, true}]
                     [--destination]
                     [--exclude-path]
                     [--exclude-pattern]
                     [--include-pattern]
                     [--sas-token]

Beispiele

Synchronisieren Eines einzelnen Blobs mit einem Container.

az storage blob sync -c mycontainer -s "path/to/file" -d NewBlob

Synchronisieren Sie ein Verzeichnis mit einem Container.

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory"

Erforderliche Parameter

--container -c

Der Synchronisierungszielcontainer.

--source -s

Der Quelldateipfad, aus dem synchronisiert werden soll.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--delete-destination

Definiert, ob zusätzliche Dateien aus dem Ziel gelöscht werden sollen, die nicht in der Quelle vorhanden sind. Könnte auf „true“, „false“ oder „prompt“ festgelegt werden. Wenn sie auf „prompt“ festgelegt wurde, wird dem Benutzer eine Frage gestellt, bevor Dateien und Blobs zum Löschen geplant werden.

Zulässige Werte: false, prompt, true

Standardwert: true

--destination -d

Der Zielpfad, der vor dem Blobnamen vorgestellt wird.

--exclude-path

Schließen Sie diese Pfade aus. Diese Option unterstützt keine Platzhalterzeichen (*). Überprüft das Präfix des relativen Pfads. Beispiel: myFolder;myFolder/subDirName/file.pdf

--exclude-pattern

Ausschließen Sie diese Dateien, in denen der Name der Musterliste entspricht. Beispiel: *.jpg;*.pdf;exactName. Diese Option unterstützt Platzhalterzeichen (*).

--include-pattern

Fügen Sie nur diese Dateien hinzu, in denen der Name der Musterliste entspricht. Beispiel: *.jpg;*.pdf;exactName. Diese Option unterstützt Platzhalterzeichen (*).

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob undelete

Bearbeiten

Stellen Sie einen weich gelöschten Blob oder eine Momentaufnahme wiederhergestellt.

Der Vorgang ist nur erfolgreich, wenn innerhalb der angegebenen Anzahl von Tagen, die in der Aufbewahrungsrichtlinie für löschen festgelegt sind, verwendet wird. Der Versuch, ein Blob oder eine Momentaufnahme zu deaktivieren, die nicht weich gelöscht wird, ist ohne Änderungen erfolgreich.

az storage blob undelete --container-name
                         --name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--connection-string]
                         [--sas-token]
                         [--timeout]

Beispiele

Rückgängigmachen eines Blobs.

az storage blob undelete -c mycontainer -n MyBlob

Rückgängigmachen eines Blobs mithilfe von Anmeldeinformationen.

az storage blob undelete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob update

Bearbeiten

Legt Systemeigenschaften für den Blob fest.

Wenn eine Eigenschaft für die content_settings festgelegt ist, werden alle Eigenschaften außer Kraft gesetzt.

az storage blob update --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--sas-token]
                       [--tags-condition]
                       [--timeout]

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--clear-content-settings

Wenn dieses Flag festgelegt ist, werden dann mindestens eine der folgenden Eigenschaften (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-language, --content-md5, --content-type) festgelegt, dann werden alle diese Eigenschaften zusammen festgelegt. Wenn ein Wert für eine bestimmte Eigenschaft nicht bereitgestellt wird, wenn mindestens eine der unten aufgeführten Eigenschaften festgelegt ist, wird diese Eigenschaft gelöscht.

Zulässige Werte: false, true

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--content-cache --content-cache-control

Die Cachesteuerelementzeichenfolge.

--content-disposition

Vermittelt zusätzliche Informationen zum Verarbeiten der Antwortnutzlast und kann auch zum Anfügen zusätzlicher Metadaten verwendet werden.

--content-encoding

Der Inhaltscodierungstyp.

--content-language

Die Inhaltssprache.

--content-md5

Der MD5-Hash des Inhalts.

--content-type

Der Inhalts-MIME-Typ.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit der angegebenen UTC-Datumszeit geändert wurden (Y-m-d'T'H:M'Z').

--if-none-match

--if-unmodified-since

Beginnen Sie nur, wenn nicht geändert wurde, seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z').

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob upload

Bearbeiten

Laden Sie eine Datei in ein Speicher-Blob hoch.

Erstellen Sie ein neues Blob aus einem Dateipfad oder aktualisiert den Inhalt eines vorhandenen Blobs mit automatischen Benachrichtigungen zum Abbruch und Fortschritt.

az storage blob upload [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--data]
                       [--encryption-scope]
                       [--file]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--length]
                       [--max-connections]
                       [--maxsize-condition]
                       [--metadata]
                       [--name]
                       [--no-progress]
                       [--overwrite {false, true}]
                       [--sas-token]
                       [--socket-timeout]
                       [--tags]
                       [--tags-condition]
                       [--tier]
                       [--timeout]
                       [--type {append, block, page}]
                       [--validate-content]

Beispiele

Laden Sie einen Blob hoch.

az storage blob upload -f /path/to/file -c mycontainer -n MyBlob

Laden Sie einen Blob mit blob sas-URL hoch.

az storage blob upload -f /path/to/file --blob-url https://mystorageaccount.blob.core.windows.net/mycontainer/myblob?sv=2019-02-02&st=2020-12-22T07%3A07%3A29Z&se=2020-12-23T07%3A07%3A29Z&sr=b&sp=racw&sig=redacted

Laden Sie eine Datei in ein Speicher-Blob hoch. (automatisch generiert)

az storage blob upload --account-name mystorageaccount --account-key 0000-0000 --container-name mycontainer --file /path/to/file --name myblob

Laden Sie eine Zeichenfolge in ein Blob hoch.

az storage blob upload --data "teststring" -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Hochladen in ein Durchlaufrohr.

echo $data | az storage blob upload --data @- -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, wenn sie verwendet wird. Dies könnte entweder der primäre Endpunkt oder der sekundäre Endpunkt sein, je nach aktuellem location_mode.

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--content-cache --content-cache-control

Die Cachesteuerelementzeichenfolge.

--content-disposition

Vermittelt zusätzliche Informationen zum Verarbeiten der Antwortnutzlast und kann auch verwendet werden, um zusätzliche Metadaten anzufügen.

--content-encoding

Der Inhaltscodierungstyp.

--content-language

Die Inhaltssprache.

--content-md5

Der MD5-Hash des Inhalts.

--content-type

Der INHALTS-MIME-Typ.

--data

Die blob-Daten, die hochgeladen werden sollen.

--encryption-scope

Ein vordefinierter Verschlüsselungsbereich, der zum Verschlüsseln der Daten im Dienst verwendet wird.

--file -f

Pfad der Datei, die als Blobinhalt hochgeladen werden soll.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z' geändert wurde).

--if-none-match

--if-unmodified-since

Beginnen Sie nur, wenn seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z) nicht geändert wurde.

--lease-id

Erforderlich, wenn das BLOB über eine aktive Lease verfügt.

--length

Anzahl der Bytes, die aus dem Datenstrom gelesen werden sollen. Dies ist optional, sollte jedoch für eine optimale Leistung bereitgestellt werden. Zusammenarbeit mit --data.

--max-connections

Maximale Anzahl paralleler Verbindungen, die verwendet werden sollen, wenn die Blobgröße 64 MB überschreitet.

Standardwert: 2

--maxsize-condition

Die maximale Länge in Bytes, die für ein Anfüge-Blob zulässig ist.

--metadata

Metadaten in leer getrennten Schlüssel=Wertpaaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--name -n

Der Blobname.

--no-progress

Fügen Sie dieses Kennzeichen ein, um die Statusberichterstellung für den Befehl zu deaktivieren.

--overwrite

Gibt an, ob das hochzuladende Blob die aktuellen Daten überschreiben soll. Wenn True, überschreibt der Blob-Uploadvorgang die vorhandenen Daten. Wenn dieser Wert auf "False" festgelegt ist, schlägt der Vorgang mit "ResourceExistsError" fehl. Die Ausnahme der obigen Ist-Blob-Typen: Wenn "False" festgelegt ist und die Daten bereits vorhanden sind, wird kein Fehler ausgelöst, und die Daten werden an das vorhandene Blob angefügt. Wenn "overwrite=True" festgelegt ist, wird das vorhandene Anfüge-Blob gelöscht und eine neue erstellt. Der Standardwert lautet „False“.

Zulässige Werte: false, true

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--socket-timeout

Das Sockettimeout(Sek.), das vom Dienst verwendet wird, um den Datenfluss zu regeln.

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll. Bei Seiten-Blob korreliert die Ebene mit der Größe des Blobs und der Anzahl der zulässigen IOPS. Mögliche Werte sind P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 und dies gilt nur für Seiten-Blobs auf Premiumspeicherkonten; Bei Block-Blob sind mögliche Werte "Archiv", "Cool" und "Hot" angegeben. Dies gilt nur für Block-Blobs in Standardspeicherkonten.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

--type -t

Standardeinstellung für "page" für *.vhd-Dateien oder "Blockieren" andernfalls.

Zulässige Werte: append, block, page

--validate-content

Geben Sie an, dass ein MD5-Hash für jeden Teil des Blobs berechnet und vom Dienst überprüft wird, wenn der Block eingetroffen ist.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob upload-batch

Bearbeiten

Laden Sie Dateien aus einem lokalen Verzeichnis in einen Blobcontainer hoch.

az storage blob upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--max-connections]
                             [--maxsize-condition]
                             [--metadata]
                             [--no-progress]
                             [--overwrite {false, true}]
                             [--pattern]
                             [--sas-token]
                             [--socket-timeout]
                             [--tags-condition]
                             [--tier]
                             [--timeout]
                             [--type {append, block, page}]
                             [--validate-content]

Beispiele

Laden Sie alle Dateien hoch, die mit .py enden, es sei denn, blob ist vorhanden und wurde seit dem angegebenen Datum geändert.

az storage blob upload-batch -d mycontainer --account-name mystorageaccount --account-key 00000000 -s <path-to-directory> --pattern *.py --if-unmodified-since 2018-08-27T20:51Z

Laden Sie alle Dateien aus dem lokalen Pfadverzeichnis in einen Container namens "mycontainer" hoch.

az storage blob upload-batch -d mycontainer -s <path-to-directory>

Laden Sie alle Dateien mit dem Format "cli-2018-xx-xx.txt" oder "cli-2019-xx-xx.txt" im lokalen Pfadverzeichnis hoch.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern cli-201[89]-??-??.txt

Laden Sie alle Dateien mit dem Format "cli-201x-xx-xx.txt" außer cli-2018-xx-xx.txt" und "cli-2019-xx-xx.txt" in einem Container hoch.

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern cli-201[!89]-??-??.txt

Erforderliche Parameter

--destination -d

Der Blobcontainer, in den die Dateien hochgeladen werden.

--source -s

Das Verzeichnis, in dem sich die zu hochladenden Dateien befinden.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--content-cache --content-cache-control

Die Cachesteuerelementzeichenfolge.

--content-disposition

Vermittelt zusätzliche Informationen zum Verarbeiten der Antwortnutzlast und kann auch verwendet werden, um zusätzliche Metadaten anzufügen.

--content-encoding

Der Inhaltscodierungstyp.

--content-language

Die Inhaltssprache.

--content-md5

Der MD5-Hash des Inhalts.

--content-type

Der INHALTS-MIME-Typ.

--destination-path

Der Zielpfad, der dem Blobnamen vorangestellt wird.

--dryrun

Zeigen Sie die Zusammenfassung der Vorgänge an, die ausgeführt werden sollen, anstatt die Datei(n) tatsächlich hochzuladen.

--if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Beginnen Sie nur, wenn sie seit dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z' geändert wurde).

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*).

--if-unmodified-since

Beginnen Sie nur, wenn seit der angegebenen UTC-Datumszeit (Y-m-d'T'H:M'Z) nicht geändert wurde.

--lease-id

Die aktive Lease-ID für das Blob.

--max-connections

Maximale Anzahl paralleler Verbindungen, die verwendet werden sollen, wenn die Blobgröße 64 MB überschreitet.

Standardwert: 2

--maxsize-condition

Die maximale Länge in Bytes, die für ein Anfüge-Blob zulässig ist.

--metadata

Metadaten in leer getrennten Schlüssel=Wertpaaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--no-progress

Fügen Sie dieses Kennzeichen ein, um die Statusberichterstellung für den Befehl zu deaktivieren.

--overwrite

Zulässige Werte: false, true

--pattern

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--socket-timeout

Das Sockettimeout(Sek.), das vom Dienst verwendet wird, um den Datenfluss zu regeln.

--tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur auf Blobs mit einem übereinstimmenden Wert ausgeführt werden sollen.

--tier

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

--type -t

Standardmäßig wird 'page' für *.vhd-Dateien oder andernfalls 'block' festgelegt. Die Einstellung überschreiben BLOB-Typen für jede Datei.

Zulässige Werte: append, block, page

--validate-content

Gibt an, dass ein MD5-Hash für jeden Teil des Blobs berechnet und vom Dienst überprüft wird, wenn der Block eingetroffen ist.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob url

Bearbeiten

Erstellen Sie die URL, um auf ein Blob zuzugreifen.

az storage blob url --container-name
                    --name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--blob-endpoint]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]
                    [--snapshot]

Beispiele

Erstellen der URL für den Zugriff auf ein Blob (automatisch generiert)

az storage blob url --connection-string $connectionString --container-name container1 --name blob1

Erstellen der URL für den Zugriff auf ein Blob (automatisch generiert)

az storage blob url --account-name storageacct --account-key 00000000 --container-name container1 --name blob1

Erforderliche Parameter

--container-name -c

Der Containername

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

--auth-mode

Zulässige Werte: key, login

--blob-endpoint

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--protocol

Zu verwendende Protokoll.

Zulässige Werte: http, https

Standardwert: https

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Ein Zeichenfolgenwert, der die Momentaufnahme eindeutig identifiziert. Der Wert dieses Abfrageparameters gibt die Momentaufnahmeversion an.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.