Freigeben über

az storage file metadata

  • Referenz

Hinweis

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Dateimetadaten verwalten.

Befehle

Name Beschreibung Typ Status
az storage file metadata show

Gibt alle benutzerdefinierten Metadaten für die Datei zurück.

 Kern GA
az storage file metadata show (storage-preview Erweiterung)

Gibt alle benutzerdefinierten Metadaten für die Datei zurück.

 Erweiterung GA
az storage file metadata update

Aktualisieren von Dateimetadaten.

 Kern GA
az storage file metadata update (storage-preview Erweiterung)

Aktualisieren von Dateimetadaten.

 Erweiterung GA

az storage file metadata show

Bearbeiten

Gibt alle benutzerdefinierten Metadaten für die Datei zurück.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Beispiele

Anzeigen von Metadaten für die Datei

az storage file metadata show -s MyShare --path /path/to/file

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Speicherkontoname. 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 erreicht werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Zulässige Werte: false, true
Standardwert: False
--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 zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Eine Zeichenfolge, die ggf. die Momentaufnahmeversion darstellt.

--timeout

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az storage file metadata show (storage-preview Erweiterung)

Gibt alle benutzerdefinierten Metadaten für die Datei zurück.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Beispiele

Anzeigen von Metadaten für die Datei

az storage file metadata show -s MyShare --path /path/to/file

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

Speicherkontoname. 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 erreicht werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

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

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Eine Zeichenfolge, die ggf. die Momentaufnahmeversion darstellt.

--timeout

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az storage file metadata update

Bearbeiten

Aktualisieren von Dateimetadaten.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--file-endpoint]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Beispiele

Aktualisieren von Metadaten für die Datei

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Speicherkontoname. 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 erreicht werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Zulässige Werte: false, true
Standardwert: False
--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.

--metadata

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

--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az storage file metadata update (storage-preview Erweiterung)

Aktualisieren von Dateimetadaten.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Beispiele

Aktualisieren von Metadaten für die Datei

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Erforderliche Parameter

--path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--share-name -s

Der Dateifreigabename.

Optionale Parameter

--account-key

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

--account-name

Speicherkontoname. 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 erreicht werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

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

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

--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.