Auf Englisch lesen

Freigeben über


az storage queue

Verwalten von Speicherwarteschlangen

Befehle

Name Beschreibung Typ Status
az storage queue create

Erstellen Sie eine Warteschlange unter dem angegebenen Konto.

Core Allgemein verfügbar
az storage queue delete

Löschen Sie die angegebene Warteschlange und alle darin enthaltenen Nachrichten.

Core Allgemein verfügbar
az storage queue exists

Gibt einen booleschen Wert zurück, der angibt, ob die Warteschlange vorhanden ist.

Core Allgemein verfügbar
az storage queue generate-sas

Generieren Sie eine freigegebene Zugriffssignatur für die Warteschlange. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token von QueueService.

Core Allgemein verfügbar
az storage queue list

Listen Sie Warteschlangen in einem Speicherkonto auf.

Core Allgemein verfügbar
az storage queue metadata

Verwalten der Metadaten für eine Speicherwarteschlange

Core Allgemein verfügbar
az storage queue metadata show

Gibt alle benutzerdefinierten Metadaten für die angegebene Warteschlange zurück.

Core Allgemein verfügbar
az storage queue metadata update

Legen Sie benutzerdefinierte Metadaten für die angegebene Warteschlange fest.

Core Allgemein verfügbar
az storage queue policy

Verwalten von SAS-Richtlinien für eine Speicherwarteschlange

Core Allgemein verfügbar
az storage queue policy create

Erstellen Sie eine gespeicherte Zugriffsrichtlinie für das enthaltende Objekt.

Core Allgemein verfügbar
az storage queue policy delete

Löschen einer gespeicherten Zugriffsrichtlinie für ein enthaltenes Objekt.

Core Allgemein verfügbar
az storage queue policy list

Auflisten gespeicherter Zugriffsrichtlinien für ein enthaltenes Objekt.

Core Allgemein verfügbar
az storage queue policy show

Anzeigen einer gespeicherten Zugriffsrichtlinie für ein enthaltenes Objekt.

Core Allgemein verfügbar
az storage queue policy update

Legen Sie eine gespeicherte Zugriffsrichtlinie für ein enthaltenes Objekt fest.

Core Allgemein verfügbar
az storage queue stats

Abrufen von Statistiken im Zusammenhang mit der Replikation für den Warteschlangendienst. Sie ist nur verfügbar, wenn die georedundierte Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

Core Allgemein verfügbar

az storage queue create

Erstellen Sie eine Warteschlange unter dem angegebenen Konto.

Azure CLI
az storage queue create --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-on-exist]
                        [--metadata]
                        [--sas-token]
                        [--timeout]

Beispiele

Erstellen Sie eine Warteschlange unter dem angegebenen Konto mit Metadaten.

Azure CLI
az storage queue create -n myqueue --metadata key1=value1 key2=value2 --account-name mystorageaccount

Erforderliche Parameter

--name -n

Der Warteschlangenname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen 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 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 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

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--fail-on-exist

Gibt an, ob eine Ausnahme ausgelöst werden soll, wenn die Warteschlange bereits vorhanden ist.

Standardwert: False
--metadata

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

--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, 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

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--verbose

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

az storage queue delete

Löschen Sie die angegebene Warteschlange und alle darin enthaltenen Nachrichten.

Azure CLI
az storage queue delete --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-not-exist]
                        [--sas-token]
                        [--timeout]

Beispiele

Löschen Sie die angegebene Warteschlange, lösen Sie eine Ausnahme aus, wenn die Warteschlange nicht vorhanden ist.

Azure CLI
az storage queue delete -n myqueue --fail-not-exist --account-name mystorageaccount

Erforderliche Parameter

--name -n

Der Warteschlangenname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen 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 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 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

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--fail-not-exist

Gibt an, ob eine Ausnahme ausgelöst werden soll, wenn die Warteschlange nicht vorhanden ist.

Standardwert: False
--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, 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

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--verbose

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

az storage queue exists

Gibt einen booleschen Wert zurück, der angibt, ob die Warteschlange vorhanden ist.

Azure CLI
az storage queue exists --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--sas-token]
                        [--timeout]

Beispiele

Überprüfen Sie, ob die Warteschlange vorhanden ist.

Azure CLI
az storage queue exists -n myqueue --account-name mystorageaccount

Erforderliche Parameter

--name -n

Der Warteschlangenname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen 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 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 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

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, 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

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--verbose

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

az storage queue generate-sas

Generieren Sie eine freigegebene Zugriffssignatur für die Warteschlange. Verwenden Sie die zurückgegebene Signatur mit dem parameter sas_token von QueueService.

Azure CLI
az storage queue generate-sas --name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--expiry]
                              [--https-only]
                              [--ip]
                              [--permissions]
                              [--policy-name]
                              [--sas-token]
                              [--start]

Beispiele

Generieren Sie ein Sas-Token für die Warteschlange mit schreibgeschützten Berechtigungen.

Azure CLI
end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --permissions r --expiry $end --https-only

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

Azure CLI
end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

Erforderliche Parameter

--name -n

Der Warteschlangenname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen 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 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 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

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--expiry

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

--https-only

Nur Genehmigungsanforderungen, die mit dem HTTPS-Protokoll vorgenommen wurden. Wenn diese Angabe nicht angegeben wird, sind Anforderungen sowohl vom HTTP- als auch vom HTTPS-Protokoll zulässig.

--ip

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

--permissions

Die Berechtigungen, die die SAS gewährt. Zulässige Werte: (a)dd (a)dd (p)rocess (p)rocess (r)ead (r)ead (u)pdate (u)pdate (u)pdate. 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 der Freigabe.

--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--start

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

Globale Parameter
--debug

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--verbose

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

az storage queue list

Listen Sie Warteschlangen in einem Speicherkonto auf.

Azure CLI
az storage queue list [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--connection-string]
                      [--include-metadata]
                      [--marker]
                      [--num-results]
                      [--prefix]
                      [--sas-token]
                      [--timeout]

Beispiele

Listenwarteschlangen, deren Namen mit "myprefix" beginnen, unter dem Speicherkonto "mystorageaccount"(Kontoname)

Azure CLI
az storage queue list --prefix myprefix --account-name mystorageaccount

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen 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 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 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

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--include-metadata

Gibt an, dass Containermetadaten in der Antwort zurückgegeben werden.

Standardwert: False
--marker

Ein undurchsichtiges Fortsetzungstoken. Dieser Wert kann aus dem feld next_marker eines vorherigen Generatorobjekts abgerufen werden, wenn num_results angegeben wurde und der Generator die Aufzählung der Ergebnisse abgeschlossen hat. Wenn angegeben, beginnt dieser Generator mit der Rückgabe von Ergebnissen vom Punkt, an dem der vorherige Generator beendet wurde.

--num-results

Die maximale Anzahl der zurückzugebenden Warteschlangen.

--prefix

Filtert die Ergebnisse, um nur Warteschlangen mit Namen zurückzugeben, die mit dem angegebenen Präfix beginnen.

--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, 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

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--verbose

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

az storage queue stats

Abrufen von Statistiken im Zusammenhang mit der Replikation für den Warteschlangendienst. Sie ist nur verfügbar, wenn die georedundierte Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

Azure CLI
az storage queue stats [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--sas-token]
                       [--timeout]

Beispiele

Zeigen Sie Statistiken zur Replikation für den Warteschlangendienst an.

Azure CLI
az storage queue stats --account-name mystorageaccount

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen 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 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 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

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, 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

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--verbose

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