Feedback

az storage file

  • Referenz

Verwalten Sie Dateifreigaben, die das SMB 3.0-Protokoll verwenden.

Befehle

az storage file copy

Verwalten von Dateikopievorgängen.
az storage file copy cancel

Abbrechen eines laufenden Kopiervorgangs.
az storage file copy start

Kopieren Sie eine Datei asynchron.
az storage file copy start-batch

Kopieren Sie mehrere Dateien oder Blobs in eine Dateifreigabe.
az storage file delete

Markieren Sie die angegebene Datei zum Löschen.
az storage file delete-batch

Löschen sie Dateien aus einer Azure Storage File Share.
az storage file download

Laden Sie eine Datei auf einen Dateipfad mit automatischen Benachrichtigungen zum Abblocken und Fortschritt herunter.
az storage file download-batch

Laden Sie Dateien aus einer Azure Storage-Dateifreigabe in ein lokales Verzeichnis in einem Batchvorgang herunter.
az storage file exists

Überprüfen Sie das Vorhandensein einer Datei.
az storage file generate-sas

Generieren Sie eine freigegebene Zugriffssignatur für die Datei.
az storage file list

Listet Dateien und Verzeichnisse in einer Freigabe auf.
az storage file metadata

Verwalten von Dateimetadaten.
az storage file metadata show

Geben Sie alle benutzerdefinierten Metadaten für die Datei zurück.
az storage file metadata update

Aktualisieren von Dateimetadaten.
az storage file resize

Ändern der Größe einer Datei in die angegebene Größe.
az storage file show

Geben Sie alle benutzerdefinierten Metadaten, Standard-HTTP-Eigenschaften und Systemeigenschaften für die Datei zurück.
az storage file update

Legen Sie Systemeigenschaften für die Datei fest.
az storage file upload

Laden Sie eine Datei in eine Freigabe hoch, die das SMB 3.0-Protokoll verwendet.
az storage file upload-batch

Laden Sie Dateien aus einem lokalen Verzeichnis in eine Azure Storage File Share in einem Batchvorgang hoch.
az storage file url

Erstellen Sie die URL, um auf eine Datei zuzugreifen.

az storage file delete

Bearbeiten

Markieren Sie die angegebene Datei zum Löschen.

Die Datei wird später während der Garbage Collection gelöscht.

az storage file delete --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--sas-token]
                       [--timeout]

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

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

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

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

--timeout

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

az storage file delete-batch

Bearbeiten

Löschen sie Dateien aus einer Azure Storage File Share.

az storage file delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--dryrun]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

Beispiele

Löschen sie Dateien aus einer Azure Storage File Share. (automatisch generiert)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --source /path/to/file

Löschen sie Dateien aus einer Azure Storage File Share. (automatisch generiert)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --pattern *.py --source /path/to/file

Erforderliche Parameter

--source -s

Die Quelle des Dateilöschvorgangs. Die Quelle kann die Dateifreigabe-URL oder den Freigabenamen sein.

Optionale Parameter

--account-key

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

--account-name

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

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--dryrun

Listet die zu löschenden Dateien und Blobs auf. Es tritt keine tatsächliche Datenlöschung auf.

--pattern

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

--sas-token

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

--timeout

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

az storage file download

Bearbeiten

Laden Sie eine Datei in einen Dateipfad mit automatischen Benachrichtigungen für Blöcke und Fortschritt herunter.

Gibt eine Instanz von Datei mit Eigenschaften und Metadaten zurück.

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--connection-string]
                         [--dest]
                         [--end-range]
                         [--max-connections]
                         [--no-progress]
                         [--open-mode]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--timeout]
                         [--validate-content]

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

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

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--dest

Pfad der zu schreibenden Datei. Der Quelldateiname wird verwendet, wenn nicht angegeben.

--end-range

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

--max-connections

Wenn der Wert auf 2 oder höher festgelegt ist, wird für das erste Selbst ein anfänglicher Get ausgeführt. MAX_SINGLE_GET_SIZE Bytes der Datei. Wenn dies die gesamte Datei ist, gibt die Methode an diesem Punkt zurück. Wenn dies nicht der Grund ist, werden die verbleibenden Daten parallel mit der Anzahl der Threads heruntergeladen, die max_connections entsprechen. Jeder Teil wird selbst groß sein. MAX_CHUNK_GET_SIZE. Wenn dieser Wert auf 1 festgelegt ist, wird eine einzelne große Get-Anforderung ausgeführt. Dies wird nicht allgemein empfohlen, aber verfügbar, wenn sehr wenige Threads verwendet werden sollen, Netzwerkanforderungen sehr teuer sind, oder ein nicht suchbarer Datenstrom verhindert den parallelen Download. Dies kann auch hilfreich sein, wenn die Datei gleichzeitig geändert wird, um Die Atomität zu erzwingen, oder wenn viele Dateien erwartet werden, dass eine zusätzliche Anforderung für leere Dateien erforderlich ist, wenn max_connections größer als 1 ist.

Standardwert: 2
--no-progress

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

--open-mode

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

Standardwert: wb
--sas-token

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

--snapshot

Eine Zeichenfolge, die die Momentaufnahmeversion darstellt, sofern zutreffend.

--start-range

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

--timeout

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

--validate-content

Wenn dieser Wert auf "true" festgelegt ist, wird ein MD5-Hash für jeden abgerufenen Teil der Datei überprüft. Dies ist in erster Linie hilfreich, um Bitflips auf dem Draht zu erkennen, wenn http anstelle von https (standard) bereits überprüft wird. Beachten Sie, dass der Dienst nur transaktionsale MD5s für Blöcke mit 4 MB oder weniger zurückgibt, sodass die erste Anforderung selbst groß ist. MAX_CHUNK_GET_SIZE statt selbst. MAX_SINGLE_GET_SIZE. Wenn selbst. MAX_CHUNK_GET_SIZE auf mehr als 4 MB festgelegt wurde, wird ein Fehler ausgelöst. Da das Berechnen der MD5 Die Verarbeitungszeit erfordert und mehr Anforderungen aufgrund der reduzierten Blockgröße durchgeführt werden müssen, kann es zu einer Erhöhung der Latenz kommen.

az storage file download-batch

Bearbeiten

Laden Sie Dateien aus einer Azure Storage File Share in ein lokales Verzeichnis in einem Batchvorgang herunter.

az storage file download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--pattern]
                               [--sas-token]
                               [--snapshot]
                               [--validate-content]

Beispiele

Laden Sie Dateien aus einer Azure Storage File Share in ein lokales Verzeichnis in einem Batchvorgang herunter. (automatisch generiert)

az storage file download-batch --account-key 00000000 --account-name MyAccount --destination . --no-progress --source /path/to/file

Erforderliche Parameter

--destination -d

Das lokale Verzeichnis, in das die Dateien heruntergeladen werden. Dieses Verzeichnis muss bereits vorhanden sein.

--source -s

Die Quelle des Dateidownloadvorgangs. Die Quelle kann die Dateifreigabe-URL oder der Freigabename sein.

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, kann das API-Kontingent getroffen werden.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--dryrun

Listet die Dateien und Blobs auf, die heruntergeladen werden sollen. Es tritt keine tatsächliche Datenübertragung auf.

--max-connections

Die maximale Anzahl paralleler Verbindungen, die verwendet werden sollen. Der Standardwert ist 1.

Standardwert: 1
--no-progress

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

--pattern

Das Muster, das für die Datei-Globbing verwendet wird. Die unterstützten Muster sind "*", "?", "[seq]" und "[!seq]". Weitere Informationen finden Sie unter https://docs.python.org/3.7/library/fnmatch.html.

--sas-token

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

--snapshot

Eine Zeichenfolge, die die Momentaufnahmeversion darstellt, sofern zutreffend.

--validate-content

Wenn festgelegt, wird für jeden Bereich der Datei ein MD5-Hash für die Überprüfung berechnet.

az storage file exists

Bearbeiten

Überprüfen Sie das Vorhandensein einer Datei.

az storage file exists --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

Beispiele

Überprüfen Sie das Vorhandensein einer Datei. (automatisch generiert)

az storage file exists --account-key 00000000 --account-name MyAccount --path path/file.txt --share-name MyShare

Überprüfen Sie das Vorhandensein einer Datei. (automatisch generiert)

az storage file exists --connection-string $connectionString --path path/file.txt --share-name MyShare

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

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, kann das API-Kontingent getroffen werden.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

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

--snapshot

Eine Zeichenfolge, die die Momentaufnahmeversion darstellt, sofern zutreffend.

--timeout

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

az storage file generate-sas

Bearbeiten

Generieren Sie eine freigegebene Zugriffssignatur für die Datei.

az storage file generate-sas --path
                             --share-name
                             [--account-key]
                             [--account-name]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--expiry]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--start]

Beispiele

Generieren Sie ein Sas-Token für eine Datei.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage file generate-sas -p path/file.txt -s MyShare --account-name MyStorageAccount --permissions rcdw --https-only --expiry $end

Generieren Sie eine freigegebene Zugriffssignatur für die Datei. (automatisch generiert)

az storage file generate-sas --account-name MyStorageAccount --expiry 2037-12-31T23:59:00Z --path path/file.txt --permissions rcdw --share-name MyShare --start 2019-01-01T12:20Z

Generieren Sie eine freigegebene Zugriffssignatur für die Datei. (automatisch generiert)

az storage file generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2037-12-31T23:59:00Z --https-only --path path/file.txt --permissions rcdw --share-name myshare

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

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

--cache-control

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

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--content-disposition

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

--content-encoding

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

--content-language

Antwortheaderwert für Inhaltssprache, wenn auf die Ressource mit dieser freigegebenen Zugriffssignatur zugegriffen wird.

--content-type

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

--expiry

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

--https-only

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

--ip

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

--permissions

Die Berechtigungen, die die SAS gewährt. Zulässige Werte: (c)reate (d)elete (r)ead (w)rite. Verwenden Sie nicht, wenn 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.

--start

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

az storage file list

Bearbeiten

Listet Dateien und Verzeichnisse in einer Freigabe auf.

az storage file list --share-name
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--exclude-dir]
                     [--exclude-extended-info]
                     [--marker]
                     [--num-results]
                     [--path]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

Beispiele

Listet Dateien und Verzeichnisse in einer Freigabe auf. (automatisch generiert)

az storage file list --share-name MyShare

Erforderliche Parameter

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

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

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--exclude-dir

Listet nur Dateien in der angegebenen Freigabe auf.

--exclude-extended-info

Geben Sie an, um "Timestamps", "Etag", "Attribute", "PermissionKey"-Informationen aus der Antwort auszuschließen.

--marker

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

--num-results

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

Standardwert: 5000
--path -p

Der Verzeichnispfad innerhalb der Dateifreigabe.

--sas-token

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

--snapshot

Eine Zeichenfolge, die die Momentaufnahmeversion darstellt, falls zutreffend.

--timeout

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

az storage file resize

Bearbeiten

Ändern der Größe einer Datei in die angegebene Größe.

Wenn der angegebene Byte-Wert kleiner als die aktuelle Größe der Datei ist, werden alle Bereiche über dem angegebenen Byte-Wert gelöscht.

az storage file resize --path
                       --share-name
                       --size
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--sas-token]
                       [--timeout]

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

--size

Größe, um die Größe der Datei auf (in Bytes) zu ändern.

Optionale Parameter

--account-key

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

--account-name

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

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

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

--timeout

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

az storage file show

Bearbeiten

Geben Sie alle benutzerdefinierten Metadaten, Standard-HTTP-Eigenschaften und Systemeigenschaften für die Datei zurück.

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

Beispiele

Eigenschaften der Dateifreigabe anzeigen.

az storage file show -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

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

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

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

--snapshot

Eine Zeichenfolge, die die Momentaufnahmeversion darstellt, sofern zutreffend.

--timeout

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

az storage file update

Bearbeiten

Legen Sie systemeigenschaften für die Datei fest.

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

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

Beispiele

Legen Sie systemeigenschaften für die Datei fest.

az storage file update -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000 --content-type test/type

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

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

--clear-content-settings

Wenn dieses Flag festgelegt ist, dann wird eine oder mehrere der folgenden Eigenschaften (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-language, --content-md5, --content-type) festgelegt, dann werden alle diese Eigenschaften zusammen festgelegt. Wenn ein Wert für eine bestimmte Eigenschaft nicht angegeben wird, wenn mindestens eine der unten aufgeführten Eigenschaften festgelegt wird, 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 Cachesteuerelementzeichenfolge.

--content-disposition

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

--content-encoding

Der Inhaltscodierungstyp.

--content-language

Die Inhaltssprache.

--content-md5

Der MD5-Hash des Inhalts.

--content-type

Der INHALTS-MIME-Typ.

--file-endpoint

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

--sas-token

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

--timeout

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

az storage file upload

Bearbeiten

Laden Sie eine Datei in eine Freigabe hoch, die das SMB 3.0-Protokoll verwendet.

Erstellt oder aktualisiert eine Azure-Datei aus einem Quellpfad mit automatischen Blöcken und Statusbenachrichtigungen.

az storage file upload --share-name
                       --source
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--file-endpoint]
                       [--max-connections]
                       [--metadata]
                       [--no-progress]
                       [--path]
                       [--sas-token]
                       [--timeout]
                       [--validate-content]

Beispiele

Laden Sie in eine lokale Datei in eine Freigabe hoch.

az storage file upload -s MyShare --source /path/to/file

Laden Sie eine Datei in eine Freigabe hoch, die das SMB 3.0-Protokoll verwendet. (automatisch generiert)

az storage file upload --account-key 00000000 --account-name MyStorageAccount --path path/file.txt --share-name MyShare --source /path/to/file

Erforderliche Parameter

--share-name -s

Der Dateifreigabename.

--source

Pfad der lokalen Datei, die als Dateiinhalt hochgeladen werden soll.

Optionale Parameter

--account-key

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

--account-name

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

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

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

Die Cachesteuerelementzeichenfolge.

--content-disposition

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

--content-encoding

Der Inhaltscodierungstyp.

--content-language

Die Inhaltssprache.

--content-md5

Der MD5-Hash des Inhalts.

--content-type

Der INHALTS-MIME-Typ.

--file-endpoint

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

--max-connections

Maximale Anzahl paralleler Verbindungen, die verwendet werden sollen.

Standardwert: 2
--metadata

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

--no-progress

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

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe. Wenn der Dateiname nicht angegeben wird, wird der Quelldateiname verwendet.

--sas-token

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

--timeout

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

--validate-content

Wenn true, berechnet ein MD5-Hash für jeden Bereich der Datei. Der Speicherdienst überprüft den Hash der Inhalte, die mit dem gesendeten Hash eingetroffen wurden. Dies ist in erster Linie hilfreich, um Bitflips auf dem Draht zu erkennen, wenn http anstelle von https (standard) bereits überprüft wird. Beachten Sie, dass dieser MD5-Hash nicht mit der Datei gespeichert wird.

az storage file upload-batch

Bearbeiten

Laden Sie Dateien aus einem lokalen Verzeichnis in eine Azure Storage File Share in einem Batchvorgang hoch.

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--dryrun]
                             [--max-connections]
                             [--metadata]
                             [--no-progress]
                             [--pattern]
                             [--sas-token]
                             [--validate-content]

Beispiele

Laden Sie Dateien aus einem lokalen Verzeichnis in eine Azure Storage File Share in einem Batchvorgang hoch.

az storage file upload-batch --destination myshare --source . --account-name myaccount --account-key 00000000

Laden Sie Dateien aus einem lokalen Verzeichnis in eine Azure Storage File Share mit URL in einem Batchvorgang hoch.

az storage file upload-batch --destination https://myaccount.file.core.windows.net/myshare --source . --account-key 00000000

Erforderliche Parameter

--destination -d

Das Ziel des Uploadvorgangs.

--source -s

Das Verzeichnis, aus dem Dateien hochgeladen werden sollen.

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, kann das API-Kontingent getroffen werden.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

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

Die Cachesteuerelementzeichenfolge.

--content-disposition

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

--content-encoding

Der Inhaltscodierungstyp.

--content-language

Die Inhaltssprache.

--content-md5

Der MD5-Hash des Inhalts.

--content-type

Der INHALTS-MIME-Typ.

--destination-path

Das Verzeichnis, in das die Quelldaten kopiert werden. Wenn nicht angegeben, werden Daten in das Stammverzeichnis kopiert.

--dryrun

Listet die Dateien und Blobs auf, die hochgeladen werden sollen. Es tritt keine tatsächliche Datenübertragung auf.

--max-connections

Die maximale Anzahl paralleler Verbindungen, die verwendet werden sollen. Der Standardwert ist 1.

Standardwert: 1
--metadata

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

--no-progress

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

--pattern

Das Muster, das für die Datei-Globbing verwendet wird. Die unterstützten Muster sind "*", "?", "[seq]" und "[!seq]". Weitere Informationen finden Sie unter https://docs.python.org/3.7/library/fnmatch.html.

--sas-token

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

--validate-content

Wenn festgelegt, wird für jeden Bereich der Datei ein MD5-Hash für die Überprüfung berechnet.

az storage file url

Bearbeiten

Erstellen Sie die URL, um auf eine Datei zuzugreifen.

az storage file url --path
                    --share-name
                    [--account-key]
                    [--account-name]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]

Beispiele

Erstellen Sie die URL, um auf eine Datei zuzugreifen. (automatisch generiert)

az storage file url --account-key 00000000 --account-name mystorageaccount --path path/file.txt --share-name myshare

Erforderliche Parameter

--path -p

Der Pfad zur Datei/des Verzeichnisses innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

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, kann das API-Kontingent getroffen werden.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--protocol

Zu verwendende Protokoll.

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

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