Sdílet prostřednictvím

az storage message

  • Preview
  • Reference

Tato skupina příkazů je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Správa zpráv úložiště front

Zadejte jeden z následujících parametrů ověřování pro vaše příkazy: --auth-mode, --account-key, --connection-string, --sas-token. K uložení přihlašovacích údajů pro ověřování můžete použít také odpovídající proměnné prostředí, například AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING a AZURE_STORAGE_SAS_TOKEN.

Příkazy

Name Description Typ Stav
az storage message clear

Odstraňte všechny zprávy ze zadané fronty.

 Základ Preview
az storage message delete

Odstraňte zadanou zprávu.

 Základ Preview
az storage message get

Načtěte jednu nebo více zpráv z přední části fronty.

 Základ Preview
az storage message peek

Načtěte jednu nebo více zpráv z přední části fronty, ale nemění viditelnost zprávy.

 Základ Preview
az storage message put

Přidejte novou zprávu do zadní části fronty zpráv.

 Základ Preview
az storage message update

Aktualizujte časový limit viditelnosti zprávy.

 Základ Preview

az storage message clear

Upravit
Preview

Skupina příkazů "zpráva úložiště" je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Odstraňte všechny zprávy ze zadané fronty.

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

Příklady

Odstraňte všechny zprávy ze zadané fronty.

az storage message clear -q myqueue --account-name mystorageaccount

Povinné parametry

--queue-name -q

Název fronty.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Přípustné hodnoty: key, login
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage message delete

Upravit
Preview

Skupina příkazů "zpráva úložiště" je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Odstraňte zadanou zprávu.

az storage message delete --id
                          --pop-receipt
                          --queue-name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--connection-string]
                          [--queue-endpoint]
                          [--sas-token]
                          [--timeout]

Příklady

Odstraňte zadanou zprávu.

az storage message delete --id messageid --pop-receipt popreceiptreturned -q myqueue --account-name mystorageaccount

Povinné parametry

--id

ID zprávy identifikující zprávu, která se má odstranit.

--pop-receipt

Platná hodnota příjmu pop vrácená z dřívějšího volání operace :func:~get_messages nebo :func:~update_message

--queue-name -q

Název fronty.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Přípustné hodnoty: key, login
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage message get

Upravit
Preview

Skupina příkazů "zpráva úložiště" je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Načtěte jednu nebo více zpráv z přední části fronty.

az storage message get --queue-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--num-messages]
                       [--queue-endpoint]
                       [--sas-token]
                       [--timeout]
                       [--visibility-timeout]

Příklady

Načtěte jednu zprávu z fronty a resetujte časový limit viditelnosti na 5 minut později.

az storage message get -q myqueue --visibility-timeout 300 --account-name mystorageaccount

Povinné parametry

--queue-name -q

Název fronty.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Přípustné hodnoty: key, login
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Nenulová celočíselná hodnota, která určuje počet zpráv, které se mají načíst z fronty, maximálně 32. Pokud je jich méně, vrátí se viditelné zprávy. Ve výchozím nastavení se jedna zpráva načte z fronty s touto operací.

Default value: 1
--queue-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

--visibility-timeout

Zadejte novou hodnotu časového limitu viditelnosti v sekundách vzhledem k času serveru. Nová hodnota musí být větší nebo rovna 1 sekundě a nesmí být větší než 7 dní. Časový limit viditelnosti zprávy je možné nastavit na hodnotu později, než je čas vypršení platnosti.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage message peek

Upravit
Preview

Skupina příkazů "zpráva úložiště" je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Načtěte jednu nebo více zpráv z přední části fronty, ale nemění viditelnost zprávy.

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

Příklady

Načtení 5 zpráv z přední části fronty (nemění viditelnost zprávy).

az storage message peek -q myqueue --num-messages 5 --account-name mystorageaccount

Povinné parametry

--queue-name -q

Název fronty.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Přípustné hodnoty: key, login
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Nenulová celočíselná hodnota, která určuje počet zpráv pro náhled z fronty, maximálně 32. Ve výchozím nastavení se jedna zpráva zobrazí z fronty pomocí této operace.

--queue-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage message put

Upravit
Preview

Skupina příkazů "zpráva úložiště" je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Přidejte novou zprávu do zadní části fronty zpráv.

az storage message put --content
                       --queue-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--queue-endpoint]
                       [--sas-token]
                       [--time-to-live]
                       [--timeout]
                       [--visibility-timeout]

Příklady

Přidejte novou zprávu, která bude žít jeden den.

az storage message put -q myqueue --content mymessagecontent --time-to-live 86400 --account-name mystorageaccount

Povinné parametry

--content

Obsah zprávy o velikosti až 64 kB

--queue-name -q

Název fronty.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Přípustné hodnoty: key, login
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--time-to-live

Zadejte interval mezi časem pro zprávu v sekundách. Hodnota time-to-live může být libovolné kladné číslo nebo -1 pro nekonečno. Pokud tento parametr vynecháte, výchozí hodnota time-to-live je 7 dní.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

--visibility-timeout

Pokud není zadáno, výchozí hodnota je 0. Zadejte novou hodnotu časového limitu viditelnosti v sekundách vzhledem k času serveru. Hodnota musí být větší než nebo rovna 0 a nesmí být větší než 7 dní. Časový limit viditelnosti zprávy nelze nastavit na hodnotu později než čas vypršení platnosti. visibility_timeout by měla být nastavena na hodnotu menší než hodnota time_to_live.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az storage message update

Upravit
Preview

Skupina příkazů "zpráva úložiště" je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte časový limit viditelnosti zprávy.

az storage message update --id
                          --pop-receipt
                          --queue-name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--connection-string]
                          [--content]
                          [--queue-endpoint]
                          [--sas-token]
                          [--timeout]
                          [--visibility-timeout]

Příklady

Aktualizujte časový limit viditelnosti a obsah zprávy.

az storage message update --id messageid --pop-receipt popreceiptreturned -q myqueue
--visibility-timeout 3600 --content newmessagecontent --account-name mystorageaccount

Povinné parametry

--id

ID zprávy identifikující zprávu, která se má odstranit.

--pop-receipt

Platná hodnota příjmu pop vrácená z dřívějšího volání operace :func:~get_messages nebo :func:~update_message

--queue-name -q

Název fronty.

Volitelné parametry

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

--account-name

Název účtu úložiště. Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Přípustné hodnoty: key, login
--connection-string

připojovací řetězec účtu úložiště. Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

--content

Obsah zprávy o velikosti až 64 kB

--queue-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

--timeout

Časový limit požadavku v sekundách Platí pro každé volání služby.

--visibility-timeout

Pokud není zadáno, výchozí hodnota je 0. Zadejte novou hodnotu časového limitu viditelnosti v sekundách vzhledem k času serveru. Nová hodnota musí být větší nebo rovna 0 a nesmí být větší než 7 dní. Časový limit viditelnosti zprávy nelze nastavit na hodnotu později než čas vypršení platnosti. Zprávu je možné aktualizovat, dokud nebude odstraněna nebo nevypršela jeho platnost.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.