az storage blob

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 Anmeldeinformationen für die Authentifizierung 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 Sie die Zugriffssteuerungseigenschaften eines Blobs.

az storage blob copy

Verwalten von Blobkopiervorgängen Verwenden Sie az storage blob show , um die status der Blobs zu überprüfen.

az storage blob copy cancel

Abbrechen eines laufenden Kopiervorgangs.

az storage blob copy start

Kopieren Sie ein Blob asynchron. Verwenden Sie az storage blob show , um die status der Blobs zu überprüfen.

az storage blob copy start-batch

Kopieren Sie mehrere Blobs in einen Blobcontainer. Verwenden Sie az storage blob show , um die status der Blobs zu überprüfen.

az storage blob delete

Markieren Sie ein Blob oder Momentaufnahme zum Löschen.

az storage blob delete-batch

Löschen Sie Blobs rekursiv aus einem Blobcontainer.

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 Sie die Zugriffssteuerungseigenschaften eines Verzeichnisses.

az storage blob directory create

Erstellen Sie ein Speicherblobverzeichnis in einem Speichercontainer.

az storage blob directory delete

Löschen Sie ein Speicherblobverzeichnis in einem Speichercontainer.

az storage blob directory download

Laden Sie Blobs in einen lokalen Dateipfad herunter.

az storage blob directory exists

Überprüfen Sie, ob ein Blobverzeichnis in einem Speichercontainer vorhanden ist.

az storage blob directory list

Auflisten von Blobs und Blobunterverzeichnissen in einem Speicherverzeichnis.

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 mindestens ein Name-Wert-Paar fest.

az storage blob directory move

Verschieben eines Speicherverzeichnisses in ein anderes Speicherblobverzeichnis in einem Speichercontainer

az storage blob directory show

Zeigen Sie die Eigenschaften eines Speicherblobverzeichnisses in einem Speichercontainer an.

az storage blob directory upload

Laden Sie Blobs oder Unterverzeichnisse in ein Speicherblobverzeichnis hoch.

az storage blob download

Laden Sie ein Blob in einen Dateipfad herunter.

az storage blob download-batch

Rekursives Herunterladen von Blobs aus einem Blobcontainer.

az storage blob exists

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

az storage blob filter

Auflisten von Blobs in allen Containern, deren Tags mit einem bestimmten Suchausdruck übereinstimmen.

az storage blob generate-sas

Generieren Sie eine Shared Access Signature für das Blob.

az storage blob immutability-policy

Verwalten der Unveränderlichkeitsrichtlinie für Blobs.

az storage blob immutability-policy delete

Löschen Sie die Unveränderlichkeitsrichtlinie des Blobs.

az storage blob immutability-policy set

Legen Sie die Unveränderlichkeitsrichtlinie des Blobs fest.

az storage blob incremental-copy

Verwalten von inkrementellen Blobkopiervorgängen

az storage blob incremental-copy cancel

Bricht einen ausstehenden copy_blob Vorgang ab und belässt ein Zielblob mit der Länge null 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

Anfordern einer neuen Lease

az storage blob lease break

Unterbrechen Sie die Lease, wenn der Container oder Blob über eine aktive Lease verfügt.

az storage blob lease change

Ändern Sie die Lease-ID einer aktiven Lease.

az storage blob lease release

Geben Sie die Lease frei.

az storage blob lease renew

Erneuern Sie die Lease.

az storage blob list

Auflisten von Blobs in einem bestimmten Container.

az storage blob metadata

Verwalten von Blobmetadaten

az storage blob metadata show

Gibt alle benutzerdefinierten Metadaten für das angegebene Blob oder Momentaufnahme zurück.

az storage blob metadata update

Legt benutzerdefinierte Metadaten für das Blob als mindestens ein Name-Wert-Paar fest.

az storage blob move

Verschieben sie ein Blob in einen Speichercontainer.

az storage blob query

Ermöglichen Sie Benutzern das Auswählen/Projektieren von Blob- oder Blob-Momentaufnahme Daten, indem Sie einfache Abfrageausdrücke bereitstellen.

az storage blob restore

Stellen Sie Blobs in den angegebenen Blobbereichen wieder her.

az storage blob rewrite

Erstellen Sie ein neues Blockblob, 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 Richtlinie zum Löschen des Speicherblobs an.

az storage blob service-properties delete-policy update

Aktualisieren Sie die Löschrichtlinie des Speicherblobs.

az storage blob service-properties show

Ruft die Eigenschaften des Blobdiensts 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 Blobspeicher fest.

az storage blob set-tier

Legen Sie die Block- oder Seitenebenen für das 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 mit einem Speicherblobcontainer.

az storage blob tag

Verwalten von Blobtags

az storage blob tag list

Rufen Sie Tags für ein Blob oder eine bestimmte Blobversion oder Momentaufnahme ab.

az storage blob tag set

Legen Sie Tags für ein Blob oder eine bestimmte Blobversion fest, aber nicht Momentaufnahme.

az storage blob undelete

Stellen Sie vorläufig gelöschte Blobs oder Momentaufnahme wieder her.

az storage blob update

Legt Systemeigenschaften für den Blob fest.

az storage blob upload

Laden Sie eine Datei in ein Speicherblob 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 für den Zugriff auf ein Blob.

az storage blob delete

Markieren Sie ein Blob oder Momentaufnahme zum Löschen.

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

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

Beispiele

Löschen eines Blobs

az storage blob delete -c mycontainer -n MyBlob

Löschen Sie ein Blob mithilfe von Anmeldeinformationen.

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

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder dem Dienstendpunkt 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, wird das API-Kontingent möglicherweise erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Im Modus "Anmeldung" werden Ihre Anmeldeinformationen direkt für die Authentifizierung verwendet. 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 können jeden primären Endpunkt des Diensts mit az storage account showfinden. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL des Blobs, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann entweder der primäre Endpunkt oder der sekundäre Endpunkt sein, abhängig vom aktuellen location_mode.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--delete-snapshots

Erforderlich, wenn dem BLOB Momentaufnahmen zugeordnet sind. Zu den Werten gehören: "only": Löscht nur die Blobs-Momentaufnahmen. "include": Löscht das 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 wurden.

--if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn sie vorhanden ist.

--if-unmodified-since

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

--lease-id

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

--name -n

Der Blobname.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, den zu löschenden Blob-Momentaufnahme angibt.

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob delete-batch

Löschen Sie Blobs rekursiv aus einem Blobcontainer.

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 auf ".py" enden, in einem Container, die seit 10 Tagen nicht geändert wurden.

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 namens "mycontainer".

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

Löschen Sie die Blobs im 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 Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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 auszuführenden Vorgänge an, anstatt die Dateien tatsächlich zu löschen.

Standardwert: False
--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 wurden.

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*).

--if-unmodified-since

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

--lease-id

Die aktive Lease-ID für das Blob.

--pattern

Das Muster, das zum Globben von Dateien 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 Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob download

Laden Sie ein 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 ein Blob herunter.

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

Laden Sie einen Blobinhalt auf stdout(pipe-Unterstützung) 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 Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann abhängig vom aktuellen location_modeentweder der primäre Endpunkt oder der sekundäre Endpunkt 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 gegeben ist, muss start_range angegeben werden. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

--file -f

Pfad der Datei, in die geschrieben werden soll. 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 wurden.

--if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn sie vorhanden ist.

--if-unmodified-since

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

--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 Flag ein, um die Statusberichterstattung für den Befehl zu deaktivieren.

Standardwert: False
--open-mode

Modus, der beim Öffnen der Datei verwendet werden soll. Beachten Sie, dass die Angabe von append only 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 Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die abzurufende Blob-Momentaufnahme angibt.

--start-range

Anfang des Bytebereichs, der zum Herunterladen eines Abschnitts des Blobs verwendet werden soll. Wenn kein end_range angegeben wird, werden alle Bytes nach dem start_range heruntergeladen. Die start_range und end_range params sind inklusive. Beispiel: start_range=0, end_range=511 lädt die ersten 512 Bytes des Blobs herunter.

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

--validate-content

Wenn true, berechnet einen MD5-Hash für jeden Block des Blobs. Der Speicherdienst überprüft den Hash des Inhalts, der mit dem gesendeten Hash eingetroffen ist. Dies ist in erster Linie für die Erkennung von Bitflips im Netzwerk nützlich, wenn http anstelle von https verwendet wird, da https (standard) bereits überprüft wird. Beachten Sie, dass dieser MD5-Hash nicht mit dem BLOB gespeichert wird. Beachten Sie auch, dass der speichereffiziente Algorithmus bei Aktiviertem nicht verwendet wird, da das Berechnen des MD5-Hashs das Puffern ganzer Blöcke erfordert und dies den Zweck des speichereffizienten Algorithmus verfehlt.

Standardwert: False
--version-id

Eine optionale Blobversions-ID. Dieser Parameter ist nur für ein Konto mit aktivierter Versionsverwaltung vorgesehen.

az storage blob download-batch

Rekursives Herunterladen von Blobs aus einem Blobcontainer.

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

Herunterladen aller Blobs, 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 "mycontainer" herunter.

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

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

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

Laden Sie alle Blobs im Format "cli-201x-xx-xx.txt" außer cli-2018-xx-xx.txt" und "cli-2019-xx-xx.txt" im Container in 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 Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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.

--dryrun

Zeigen Sie die Zusammenfassung der auszuführenden Vorgänge an, anstatt die Datei(en) tatsächlich herunterzuladen.

Standardwert: False
--max-connections

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

Standardwert: 2
--no-progress

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

Standardwert: False
--overwrite

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

Zulässige Werte: false, true
Standardwert: False
--pattern

Das Muster, das zum Globben von Dateien 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 Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

az storage blob exists

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

az storage blob exists [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--name]
                       [--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

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 Zugehörige Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines der beiden vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, wird möglicherweise das API-Kontingent erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann abhängig vom aktuellen location_modeentweder der primäre Endpunkt oder der sekundäre Endpunkt sein.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--name -n

Der Blobname.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die Momentaufnahme angibt.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob filter

Auflisten von Blobs in allen Containern, deren Tags mit einem bestimmten Suchausdruck übereinstimmen.

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

Erforderliche Parameter

--tag-filter

Der Ausdruck zum Suchen von Blobs, deren Tags der angegebenen Bedingung entsprechen. Beispiel: ""yourtagname"='firsttag' und "yourtagname2"='secondtag'".

Optionale Parameter

--account-key

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

--account-name

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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.

--container-name -c

Wird verwendet, wenn Sie Blobs unter einem angegebenen Container auflisten möchten.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

az storage blob generate-sas

Generieren Sie eine Shared Access Signature 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 Shared Access Signature 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 Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--as-user

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

Standardwert: False
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann abhängig vom aktuellen location_modeentweder der primäre Endpunkt oder der sekundäre Endpunkt sein.

--cache-control

Antwortheaderwert für Cache-Control, wenn mithilfe dieser Shared Access Signature auf die Ressource zugegriffen wird.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--content-disposition

Antwortheaderwert für Content-Disposition, wenn mithilfe dieser Shared Access Signature auf die Ressource zugegriffen wird.

--content-encoding

Antwortheaderwert für Content-Encoding, wenn auf die Ressource mithilfe dieser Shared Access Signature zugegriffen wird.

--content-language

Antwortheaderwert für Content-Language, wenn auf die Ressource mithilfe dieser Shared Access Signature zugegriffen wird.

--content-type

Antwortheaderwert für Content-Type, wenn auf die Ressource mithilfe dieser Shared Access Signature zugegriffen wird.

--encryption-scope

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

--expiry

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

--full-uri

Gibt an, dass dieser Befehl den vollständigen Blob-URI und das Shared Access Signature-Token zurückgibt.

Standardwert: False
--https-only

Lassen Sie nur Anforderungen zu, die mit dem HTTPS-Protokoll durchgeführt werden. Wenn nicht angegeben, sind Anforderungen sowohl vom HTTP- als auch vom HTTPS-Protokoll zulässig.

--ip

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

--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. Undurchsichtiger DateTime-Wert, der, sofern vorhanden, die blob-Momentaufnahme angibt, die Berechtigung erteilt werden soll.

--start

Gibt die UTC-Datetime (Y-m-d'T'H:M'Z) an, ab der die SAS gültig wird. Verwenden Sie nicht, wenn auf eine gespeicherte Zugriffsrichtlinie mit --policy-name verwiesen wird, der diesen Wert angibt. Der Standardwert ist der Zeitpunkt der Anforderung.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob list

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

Listet alle Speicherblobs in einem Container auf, dessen 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 Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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.

--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 angibt, die beim nächsten Listenvorgang zurückgegeben werden sollen. Der Vorgang gibt den NextMarker-Wert im Antworttext zurück, wenn der Auflistungsvorgang nicht alle Container zurückgegeben hat, die mit der aktuellen Seite aufgeführt werden sollen. Falls angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen an dem Punkt, an dem der vorherige Generator angehalten wurde.

--num-results

Geben Sie die maximale Anzahl an, die zurückgegeben werden soll. Wenn die Anforderung num_results nicht angibt oder einen Wert größer als 5000 angibt, gibt der Server bis zu 5.000 Elemente zurück. Beachten Sie, dass der Dienst ein Fortsetzungstoken zum Abrufen der restlichen Ergebnisse zurückgibt, wenn der Auflistungsvorgang eine Partitionsgrenze überschreitet. 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 Shared Access Signature (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder dem Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

Wenn angegeben, zeigen Sie nextMarker im Ergebnis an.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob move

Verschieben sie ein Blob in einen 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 sie ein Blob in einen 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 Zielblobname. Es sollte sich um einen absoluten Pfad unter dem Container handeln. z.B. "topdir1/dirbar".

--source-blob -s

Der Name des Quellblobs. Es sollte sich um einen absoluten Pfad unter dem Container handeln. 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

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, wird das API-Kontingent möglicherweise erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Im Modus "Anmeldung" werden Ihre Anmeldeinformationen direkt für die Authentifizierung verwendet. 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
--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

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

--sas-token

Eine Shared Access Signature (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 Platzhalterwert ("*"). 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 muss über eine aktive Lease verfügen, und die Lease-ID muss übereinstimmen.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob query

Ermöglichen Sie Benutzern das Auswählen/Projektieren von Blob- oder Blob-Momentaufnahme Daten, indem Sie einfache Abfrageausdrücke bereitstellen.

az storage blob query --query-expression
                      [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--blob-endpoint]
                      [--blob-url]
                      [--connection-string]
                      [--container-name]
                      [--if-match]
                      [--if-modified-since]
                      [--if-none-match]
                      [--if-unmodified-since]
                      [--in-column-separator]
                      [--in-escape-char]
                      [--in-has-header]
                      [--in-line-separator]
                      [--in-quote-char]
                      [--in-record-separator]
                      [--input-format {csv, json}]
                      [--lease-id]
                      [--name]
                      [--out-column-separator]
                      [--out-escape-char]
                      [--out-has-header]
                      [--out-line-separator]
                      [--out-quote-char]
                      [--out-record-separator]
                      [--output-format {csv, json}]
                      [--result-file]
                      [--sas-token]
                      [--tags-condition]
                      [--timeout]

Beispiele

Ermöglichen Sie Benutzern das Auswählen/Projektieren von Blobs, indem Sie einfache Abfrageausdrücke bereitstellen.

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage"

Ermöglichen Sie Benutzern das Auswählen/Projektieren von Blobs, indem Sie einfache Abfrageausdrücke bereitstellen und in der Zieldatei speichern.

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage" --result-file result.csv

Erforderliche Parameter

--query-expression

Der Abfrageausdruck in SQL. Die maximale Größe des Abfrageausdrucks beträgt 256KiB. Weitere Informationen zur Ausdruckssyntax finden Sie unter https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder dem Dienstendpunkt 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, wird das API-Kontingent möglicherweise erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Im Modus "Anmeldung" werden Ihre Anmeldeinformationen direkt für die Authentifizierung verwendet. 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 können jeden primären Endpunkt des Diensts mit az storage account showfinden. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL des Blobs, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann entweder der primäre Endpunkt oder der sekundäre Endpunkt sein, abhängig vom aktuellen location_mode.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--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 Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

--if-unmodified-since

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

--in-column-separator

Die Zeichenfolge, die zum Trennen von Spalten verwendet wird.

Standardwert: ,
--in-escape-char

Die Zeichenfolge, die als Escapezeichen verwendet wird. Standardmäßig leer.

--in-has-header

Gibt an, ob die Blobdaten Header in der ersten Zeile enthalten. Der Standardwert ist False, was bedeutet, dass die Daten einschließlich der ersten Zeile zurückgegeben werden. Wenn sie auf True festgelegt ist, werden die Daten ohne die erste Zeile zurückgegeben.

Standardwert: False
--in-line-separator

Die Zeichenfolge, die zum Trennen von Datensätzen verwendet wird.

Standardwert:
--in-quote-char

Die Zeichenfolge, die zum Anführungszeichen eines bestimmten Felds verwendet wird.

Standardwert: "
--in-record-separator

Die Zeichenfolge, die zum Trennen von Datensätzen verwendet wird.

Standardwert:
--input-format

Serialisierungstyp der daten, die derzeit im Blob gespeichert sind. Standardmäßig werden die Blobdaten als CSV-Daten behandelt, die im Standarddialekt formatiert sind. Die Blobdaten werden entsprechend diesem Profil neu formatiert, wenn das Blobformat angegeben wird. Wenn Sie auswählen json, geben Sie dies entsprechend an Output Json Text Configuration Arguments . Wenn Sie auswählen csv, geben Output Delimited Text Configuration ArgumentsSie an.

Zulässige Werte: csv, json
--lease-id

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

--name -n

Der Blobname.

--out-column-separator

Die Zeichenfolge, die zum Trennen von Spalten verwendet wird.

Standardwert: ,
--out-escape-char

Die Zeichenfolge, die als Escapezeichen verwendet wird. Der Standardwert ist leer.

--out-has-header

Gibt an, ob die Blobdaten Header in der ersten Zeile enthalten. Der Standardwert ist False, was bedeutet, dass die Daten einschließlich der ersten Zeile zurückgegeben werden. Wenn dieser Wert auf True festgelegt ist, werden die Daten ausschließlich in der ersten Zeile zurückgegeben.

Standardwert: False
--out-line-separator

Die Zeichenfolge, die zum Trennen von Datensätzen verwendet wird.

Standardwert:
--out-quote-char

Die Zeichenfolge, die zum Anführungszeichen eines bestimmten Felds verwendet wird.

Standardwert: "
--out-record-separator

Die Zeichenfolge, die zum Trennen von Datensätzen verwendet wird.

Standardwert:
--output-format

Ausgabeserialisierungstyp für den Datenstrom. Standardmäßig werden die Daten so zurückgegeben, wie sie im Blob dargestellt werden. Durch Bereitstellen eines Ausgabeformats werden die Blobdaten entsprechend diesem Profil neu formatiert. Wenn Sie auswählen json, geben Sie dies entsprechend an Output Json Text Configuration Arguments . Wenn Sie auswählen csv, geben Output Delimited Text Configuration ArgumentsSie an.

Zulässige Werte: csv, json
--result-file

Geben Sie den Dateipfad an, um das Ergebnis zu speichern.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob restore

Stellen Sie Blobs in den angegebenen Blobbereichen wieder her.

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

Beispiele

Stellen Sie Blobs in zwei angegebenen Blobbereichen wieder her. Beispiele hierfür sind (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

Stellen Sie Blobs in den angegebenen Blobbereichen vom Kontostart bis zum Kontoende wieder her.

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

Stellen Sie Blobs im angegebenen Blobbereich wieder her.

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

Stellen Sie Blobs im angegebenen Blobbereich ohne Wartezeit wieder her, und fragen Sie die Blobwiederherstellung status mit "az storage account show" ab.

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 auf die angegebene Uhrzeit, die UTC datetime in (Y-m-d'T'H:M:S'Z) sein sollte.

Optionale Parameter

--blob-range -r

Wiederherzustellende Blobbereiche. Sie benötigen zwei Werte, um start_range und end_range für jeden Blobbereich anzugeben, z. B. -r blob1 blob2. Hinweis: Leer bedeutet, dass Kontostart als Startbereichswert und Kontoende für Endbereich bedeutet.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

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

az storage blob rewrite

Erstellen Sie ein neues Blockblob, 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 mit einer Länge von bis zu 2 KB, 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 Shared Access Signature authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich.

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 Zugehörige Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines der beiden vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, wird möglicherweise das API-Kontingent erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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.

--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 referenziert werden. Wenn im Container ein Standardverschlüsselungsbereich definiert wurde, überschreibt dieser Wert ihn, wenn der Bereich auf Containerebene so konfiguriert ist, dass Außerkraftsetzungen zugelassen werden. 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 dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z) geändert wurden.

--if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn sie vorhanden ist.

--if-unmodified-since

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

--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 Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--tier

Ein Standard-Blobebenenwert, auf den das Blob festgelegt werden soll. Für diese Version der Bibliothek gilt dies nur für Blockblobs in Standardspeicherkonten.

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

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Festlegen des zulässigen Blobspeichers.

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]

Konfigurieren sie die aufbewahrungsrechtliche Aufbewahrung von Blobs.

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

Löschen Sie die aufbewahrungsrechtliche Aufbewahrung von Blobs.

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

Der Containername

--legal-hold

Gibt an, ob für das Blob ein gesetzlicher Aufbewahrungsspeicher festgelegt werden soll.

Zulässige Werte: false, true
--name -n

Der Blobname.

--account-key

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

--account-name

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob set-tier

Legen Sie die Block- oder Seitenebenen für das Blob fest.

Für Blockblobs unterstützt dieser Befehl nur Blockblobs für Standardspeicherkonten. Für Seitenblobs unterstützt dieser Befehl nur Seitenblobs in Premium-Konten.

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

Beispiele

Legen Sie die Block- oder Seitenebenen für das Blob fest. (automatisch generiert)

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

Erforderliche Parameter

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

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann abhängig vom aktuellen location_modeentweder der primäre Endpunkt oder der sekundäre Endpunkt sein.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--name -n

Der Blobname.

--rehydrate-priority -r

Geben Sie die Priorität an, mit der ein archiviertes Blob aktiviert werden soll. Die Priorität kann für ein Blob nur einmal festgelegt werden, der Standardwert ist Standard.

Zulässige Werte: High, Standard
--sas-token

Eine Shared Access Signature (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 ausführen, und das Timeout gilt für jeden Aufruf einzeln.

--type -t

Der BLOB-Typ.

Zulässige Werte: block, page
Standardwert: block

az storage blob show

Rufen Sie die Details eines Blobs ab.

az storage blob show [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--blob-url]
                     [--connection-string]
                     [--container-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--name]
                     [--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

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 Zugehörige Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines der beiden vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, wird möglicherweise das API-Kontingent erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann abhängig vom aktuellen location_modeentweder der primäre Endpunkt oder der sekundäre Endpunkt sein.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

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

--if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn sie vorhanden ist.

--if-unmodified-since

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

--lease-id

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

--name -n

Der Blobname.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Der parameter Momentaufnahme ist ein undurchsichtiger DateTime-Wert, der, sofern vorhanden, die abzurufende Blob-Momentaufnahme angibt.

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob snapshot

Erstellt eine Momentaufnahme des Blobs.

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

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

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 Zugehörige Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines der beiden vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, wird möglicherweise das API-Kontingent erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann abhängig vom aktuellen location_modeentweder der primäre Endpunkt oder der sekundäre Endpunkt sein.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

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

--if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn sie vorhanden ist.

--if-unmodified-since

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

--lease-id

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

--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--name -n

Der Blobname.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob sync

Rekursives Synchronisieren von Blobs mit einem Speicherblobcontainer.

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]
                     [<EXTRA_OPTIONS>]

Beispiele

Synchronisieren eines einzelnen Blobs mit einem Container.

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

Synchronisieren eines Verzeichnisses mit einem Container.

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

Synchronisieren Sie ein Verzeichnis mit einem Container mit azcopy options pass-through (in diesem Fall wird das Uploadband auf 20 MBit/s beschränkt).

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

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

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

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--delete-destination

Definiert, ob zusätzliche Dateien aus dem Ziel gelöscht werden sollen, die nicht an 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 dem Blobnamen vorangestellt 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

Schließen Sie diese Dateien aus, wenn der Name mit der Musterliste übereinstimmt. Beispiel: .jpg;.pdf;exactName. Diese Option unterstützt Platzhalterzeichen (*).

--include-pattern

Schließen Sie nur diese Dateien ein, deren Name mit der Musterliste übereinstimmt. Beispiel: .jpg;.pdf;exactName. Diese Option unterstützt Platzhalterzeichen (*).

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

<EXTRA_OPTIONS>

Andere Optionen, die an azcopy übergeben werden, wie es ist. Fügen Sie alle zusätzlichen Optionen nach einem ein --.

az storage blob undelete

Stellen Sie vorläufig gelöschte Blobs oder Momentaufnahme wieder her.

Der Vorgang ist nur erfolgreich, wenn er innerhalb der angegebenen Anzahl von Tagen verwendet wird, die in der Aufbewahrungsrichtlinie für Löschvorgänge festgelegt ist. Der Versuch, ein Blob oder eine Momentaufnahme, die nicht vorläufig gelöscht wurde, wiederherstellen, ist ohne Änderungen erfolgreich.

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

Beispiele

Wiederherstellen eines Blobs.

az storage blob undelete -c mycontainer -n MyBlob

Wiederherstellen eines Blobs mithilfe von Anmeldeinformationen.

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

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 Zugehörige Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines der beiden vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, wird möglicherweise das API-Kontingent erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL zum Blob, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann abhängig vom aktuellen location_modeentweder der primäre Endpunkt oder der sekundäre Endpunkt sein.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

--name -n

Der Blobname.

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob update

Legt Systemeigenschaften für den Blob fest.

Wenn eine Eigenschaft für die content_settings festgelegt ist, werden alle Eigenschaften überschrieben.

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 Namen des Speicherkontos oder dem Dienstendpunkt 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, wird das API-Kontingent möglicherweise erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Im Modus "Anmeldung" werden Ihre Anmeldeinformationen direkt für die Authentifizierung verwendet. 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 können jeden primären Endpunkt des Diensts mit az storage account showfinden. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--clear-content-settings

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

Zulässige Werte: false, true
--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

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

Die Cachesteuerungszeichenfolge.

--content-disposition

Gibt zusätzliche Informationen zur Verarbeitung der Antwortnutzlast an 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 dem angegebenen UTC-Datum (Y-m-d'T'H:M'Z) geändert wurde.

--if-none-match

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

--if-unmodified-since

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

--lease-id

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

--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder dem Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

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

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob upload

Laden Sie eine Datei in ein Speicherblob hoch.

Erstellen Sie ein neues Blob aus einem Dateipfad, oder aktualisieren Sie den Inhalt eines vorhandenen Blobs mit automatischen Blöcken und Statusbenachrichtigungen.

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 in ein Blob hoch.

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

Laden Sie in ein 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 Speicherblob 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 eine Through-Pipe.

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 Namen des Speicherkontos oder dem Dienstendpunkt 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, wird das API-Kontingent möglicherweise erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Im Modus "Anmeldung" werden Ihre Anmeldeinformationen direkt für die Authentifizierung verwendet. 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 können jeden primären Endpunkt des Diensts mit az storage account showfinden. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

--blob-url

Die vollständige Endpunkt-URL des Blobs, einschließlich SAS-Token und Momentaufnahme, falls verwendet. Dies kann entweder der primäre Endpunkt oder der sekundäre Endpunkt sein, abhängig vom aktuellen location_mode.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--container-name -c

Der Containername

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

Die Cachesteuerungszeichenfolge.

--content-disposition

Gibt zusätzliche Informationen zur Verarbeitung der Antwortnutzlast an 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.

--data

Die hochzuladenden Blobdaten.

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

Ein ETag-Wert oder das Feldhalterzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Feldhalterzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlägt den Vorgang fehl, falls er vorhanden ist.

--if-unmodified-since

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

--lease-id

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

--length

Anzahl der Bytes, die aus dem Stream gelesen werden sollen. Dies ist optional, sollte aber für eine optimale Leistung bereitgestellt werden. Kooperieren Sie 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ügeblob zulässig ist.

--metadata

Metadaten in durch Leerzeichen getrennten Key=Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--name -n

Der Blobname.

--no-progress

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

Standardwert: False
--overwrite

Gibt an, ob das hochzuladende Blob die aktuellen Daten überschreiben soll. Bei True überschreibt der Blobuploadvorgang die vorhandenen Daten. Wenn auf False festgelegt ist, schlägt der Vorgang mit ResourceExistsError fehl. Die Ausnahme von oben besteht bei Anfügeblobtypen: Wenn auf 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ügeblob gelöscht und ein neues blob erstellt. Der Standardwert lautet „False“.

Zulässige Werte: false, true
--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--socket-timeout

Das Sockettimeout(Sek.), das vom Dienst zum Regeln des Datenflusses verwendet wird.

--tags

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

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll. Bei Seitenblobs 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. Dies gilt nur für Seitenblobs in Storage Premium-Konten. Für Blockblobs sind archive, Cool und Hot mögliche Werte. Dies gilt nur für Blockblobs in Standardspeicherkonten.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

--type -t

Standardmäßig wird "page" für *.vhd-Dateien oder andernfalls "block" verwendet.

Zulässige Werte: append, block, page
--validate-content

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

Standardwert: False

az storage blob upload-batch

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]
                             [--tags-condition]
                             [--tier]
                             [--timeout]
                             [--type {append, block, page}]
                             [--validate-content]

Beispiele

Laden Sie alle Dateien hoch, die mit .py enden, es sei denn, das 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 im Format "cli-2018-xx-xx.txt" oder "cli-2019-xx-xx.txt" in das Verzeichnis des lokalen Pfads 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 einen 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 hochzuladenden Dateien befinden.

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 Zugehörige Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines der beiden vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, wird möglicherweise das API-Kontingent erreicht.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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.

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

Die Cachesteuerungszeichenfolge.

--content-disposition

Vermittelt zusätzliche Informationen zur Verarbeitung 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.

--destination-path

Der Zielpfad, der dem Blobnamen vorangestellt wird.

--dryrun

Zeigen Sie die Zusammenfassung der auszuführenden Vorgänge an, anstatt die Datei(n) tatsächlich hochzuladen.

Standardwert: False
--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 wurden.

--if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*).

--if-unmodified-since

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

--lease-id

Die aktive Lease-ID für das Blob.

--max-connections

Maximale Anzahl von parallelen 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ügeblob zulässig ist.

--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--no-progress

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

Standardwert: False
--overwrite

Gibt an, ob das hochzuladende Blob die aktuellen Daten überschreiben soll. Bei True überschreibt der Blobuploadvorgang die vorhandenen Daten. Wenn dieser Wert auf False festgelegt ist, schlägt der Vorgang mit ResourceExistsError fehl. Die Ausnahme von den obigen Ist-Blobtypen: Wenn auf 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ügeblob gelöscht und ein neues blob erstellt. Der Standardwert lautet „False“.

Zulässige Werte: false, true
--pattern

Das Muster, das zum Globben von Dateien 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 Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--tags-condition

Geben Sie eine SQL where-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden soll.

--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll. Bei Seitenblobs 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. Dies gilt nur für Seitenblobs in Storage Premium-Konten. Für Blockblobs sind archive, Cool und Hot mögliche Werte. Dies gilt nur für Blockblobs in Standardspeicherkonten.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

--type -t

Standardmäßig wird "page" für *.vhd-Dateien oder andernfalls "block" verwendet. Die Einstellung überschreibt Blobtypen für jede Datei.

Zulässige Werte: append, block, page
--validate-content

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

Standardwert: False

az storage blob url

Erstellen Sie die URL für den Zugriff auf ein Blob.

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 Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der "Anmeldemodus" verwendet direkt Ihre Anmeldeinformationen 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 dem 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.

--protocol

Zu verwendende Protokoll.

Zulässige Werte: http, https
Standardwert: https
--sas-token

Eine Shared Access Signature (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

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