az storage queue

Verwalten von Speicherwarteschlangen

Befehle

az storage queue create

Erstellen Sie eine Warteschlange unter dem angegebenen Konto.

az storage queue delete

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

az storage queue exists

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

az storage queue generate-sas

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

az storage queue list

Listenwarteschlangen in einem Speicherkonto.

az storage queue metadata

Verwalten der Metadaten für eine Speicherwarteschlange

az storage queue metadata show

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

az storage queue metadata update

Legen Sie benutzerdefinierte Metadaten in der angegebenen Warteschlange fest.

az storage queue policy

Verwalten von SAS-Richtlinien für eine Speicherwarteschlange

az storage queue policy create

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

az storage queue policy delete

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

az storage queue policy list

Listet gespeicherte Zugriffsrichtlinien für ein enthaltenes Objekt auf.

az storage queue policy show

Anzeigen einer gespeicherten Zugriffsrichtlinie für ein enthaltenes Objekt.

az storage queue policy update

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

az storage queue stats

Abrufen von Statistiken zur Replikation für den Warteschlangendienst. Es ist nur verfügbar, wenn die geo redundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

az storage queue create

Erstellen Sie eine Warteschlange unter dem angegebenen Konto.

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

Beispiele

Erstellen Sie eine Warteschlange unter dem angegebenen Konto mit Metadaten.

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 in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

Zulässige Werte: key, login
--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--fail-on-exist

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

--metadata

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

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

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

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

Beispiele

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

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 in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

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

--auth-mode

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

Zulässige Werte: key, login
--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--fail-not-exist

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

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

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

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

Beispiele

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

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

Erforderliche Parameter

--name -n

Der Warteschlangenname.

Optionale Parameter

--account-key

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

--account-name

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

--auth-mode

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

Zulässige Werte: key, login
--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--queue-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 queue generate-sas

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

az storage queue generate-sas --name
                              [--account-key]
                              [--account-name]
                              [--connection-string]
                              [--expiry]
                              [--https-only]
                              [--ip]
                              [--permissions]
                              [--policy-name]
                              [--queue-endpoint]
                              [--start]

Beispiele

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

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 dem angegebenen IP-Bereich.

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

--expiry

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

--https-only

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

--ip

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

--permissions

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

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

--start

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

az storage queue list

Listenwarteschlangen in einem Speicherkonto.

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

Beispiele

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

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

Optionale Parameter

--account-key

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

--account-name

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

--auth-mode

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

Zulässige Werte: key, login
--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--include-metadata

Geben Sie an, dass Warteschlangenmetadaten in der Antwort zurückgegeben werden.

--marker

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

--num-results

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

Standardwert: 5000
--prefix

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

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

--show-next-marker

"NextMarker" im Ergebnis anzeigen, wenn angegeben.

--timeout

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

az storage queue stats

Abrufen von Statistiken zur Replikation für den Warteschlangendienst. Es ist nur verfügbar, wenn die geo redundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.

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

Beispiele

Anzeigen von Statistiken im Zusammenhang mit der Replikation für den Warteschlangendienst.

az storage queue stats --account-name mystorageaccount

Optionale Parameter

--account-key

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

--account-name

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

--auth-mode

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

Zulässige Werte: key, login
--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

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