az storage message

Opslagberichten voor wachtrijen beheren.

Geef een van de volgende verificatieparameters op voor uw opdrachten: --auth-mode, --account-key, --connection-string, --sas-token. U kunt ook bijbehorende omgevingsvariabelen gebruiken om uw verificatiereferenties op te slaan, AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING en AZURE_STORAGE_SAS_TOKEN.

Opdracht

az storage message clear

Hiermee verwijdert u alle berichten uit de opgegeven wachtrij.

az storage message delete

Hiermee verwijdert u het opgegeven bericht.

az storage message get

Hiermee haalt u een of meer berichten aan de voorzijde van de wachtrij op.

az storage message peek

Haalt een of meer berichten aan de voorzijde van de wachtrij op, maar wijzigt de zichtbaarheid van het bericht niet.

az storage message put

Voegt een nieuw bericht toe aan de achterkant van de berichtenwachtrij.

az storage message update

Werkt de time-out voor zichtbaarheid van een bericht bij.

az storage message clear

Hiermee verwijdert u alle berichten uit de opgegeven wachtrij.

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

Vereiste parameters

--queue-name -q

De naam van de wachtrij.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. In de aanmeldingsmodus worden uw aanmeldingsreferenties rechtstreeks gebruikt voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren voor een accountsleutel als er geen verificatieparameters voor het account zijn opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage message delete

Hiermee verwijdert u het opgegeven bericht.

Normaal gesproken nadat een client een bericht met de get_messages opgehaald, wordt verwacht dat de client het bericht verwerkt en verwijdert. Als u het bericht wilt verwijderen, moet u twee gegevensitems hebben: id en pop_receipt. De id wordt geretourneerd uit de vorige get_messages bewerking. De pop_receipt wordt geretourneerd uit de meest recente bewerking get_messages() of update_message(). Om de bewerking delete_message te laten slagen, moet de pop_receipt die is opgegeven in de aanvraag overeenkomen met de pop_receipt die is geretourneerd door de bewerking get_messages() of update_message().

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

Vereiste parameters

--id

De bericht-id die het bericht identificeert dat moet worden verwijderd.

--pop-receipt

Een geldige waarde voor een pop-ontvangstbewijs die wordt geretourneerd door een eerdere aanroep van get_messages() of update_message().

--queue-name -q

De naam van de wachtrij.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. In de aanmeldingsmodus worden uw aanmeldingsreferenties rechtstreeks gebruikt voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren voor een accountsleutel als er geen verificatieparameters voor het account zijn opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage message get

Hiermee haalt u een of meer berichten aan de voorzijde van de wachtrij op.

Wanneer een bericht uit de wachtrij wordt opgehaald, bevat het antwoord de inhoud van het bericht en een pop_receipt waarde, die vereist is om het bericht te verwijderen. Het bericht wordt niet automatisch verwijderd uit de wachtrij, maar nadat het is opgehaald, is het niet zichtbaar voor andere clients voor het tijdsinterval dat is opgegeven door de parameter visibility_timeout. Als het veld sleutelversleutelingssleutel of resolver is ingesteld op het lokale serviceobject, worden de berichten ontsleuteld voordat ze worden geretourneerd.

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

Vereiste parameters

--queue-name -q

De naam van de wachtrij.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. In de aanmeldingsmodus worden uw aanmeldingsreferenties rechtstreeks gebruikt voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren voor een accountsleutel als er geen verificatieparameters voor het account zijn opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Een geheel getal dat geen waarde van het type geheel getal is dat het aantal berichten aangeeft dat uit de wachtrij moet worden opgehaald, tot een maximum van 32. Als er minder zichtbaar zijn, worden de zichtbare berichten geretourneerd. Standaard wordt één bericht uit de wachtrij opgehaald met deze bewerking.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

--visibility-timeout

Hiermee geeft u de nieuwe time-outwaarde voor zichtbaarheid op, in seconden, ten opzichte van de servertijd. De nieuwe waarde moet groter zijn dan of gelijk zijn aan 1 seconde en mag niet langer zijn dan 7 dagen. De time-out voor zichtbaarheid van een bericht kan worden ingesteld op een waarde die later is dan de verlooptijd.

az storage message peek

Haalt een of meer berichten aan de voorzijde van de wachtrij op, maar wijzigt de zichtbaarheid van het bericht niet.

Alleen berichten die zichtbaar zijn, kunnen worden opgehaald. Wanneer een bericht voor het eerst wordt opgehaald met een aanroep naar get_messages, wordt de eigenschap dequeue_count ingesteld op 1. Als deze niet wordt verwijderd en vervolgens opnieuw wordt opgehaald, wordt dequeue_count eigenschap incrementeel verhoogd. De client kan deze waarde gebruiken om te bepalen hoe vaak een bericht is opgehaald. Houd er rekening mee dat een peek_messages de waarde van DequeueCount niet verhoogt, maar deze waarde retourneert zodat de client deze kan lezen. Als het veld sleutelversleutelingssleutel of resolver is ingesteld op het lokale serviceobject, worden de berichten ontsleuteld voordat ze worden geretourneerd.

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

Vereiste parameters

--queue-name -q

De naam van de wachtrij.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. In de aanmeldingsmodus worden uw aanmeldingsreferenties rechtstreeks gebruikt voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren voor een accountsleutel als er geen verificatieparameters voor het account zijn opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Een geheel getal dat geen waarde van het type geheel getal is dat het aantal berichten aangeeft dat uit de wachtrij moet worden gekeken, tot een maximum van 32. Standaard wordt één bericht uit de wachtrij gekeken met deze bewerking.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

az storage message put

Voegt een nieuw bericht toe aan de achterkant van de berichtenwachtrij.

De time-out voor zichtbaarheid geeft de tijd aan dat het bericht onzichtbaar zal zijn. Nadat de time-out is verlopen, wordt het bericht zichtbaar. Als er geen time-out voor zichtbaarheid is opgegeven, wordt de standaardwaarde 0 gebruikt. De time-to-live van het bericht geeft aan hoelang een bericht in de wachtrij blijft. Het bericht wordt verwijderd uit de wachtrij wanneer de time-to-live-periode verloopt. Als het veld sleutelversleutelingssleutel is ingesteld op het lokale serviceobject, wordt met deze methode de inhoud versleuteld voordat de inhoud wordt geüpload.

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

Vereiste parameters

--content

Berichtinhoud, maximaal 64 kB groot.

--queue-name -q

De naam van de wachtrij.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. In de aanmeldingsmodus worden uw aanmeldingsreferenties rechtstreeks gebruikt voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren voor een accountsleutel als er geen verificatieparameters voor het account zijn opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--time-to-live

Hiermee geeft u het time-to-live-interval voor het bericht op, in seconden. De time-to-live kan een positief getal of -1 voor oneindig zijn. Als deze parameter wordt weggelaten, is de standaard time-to-live 7 dagen.

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.

--visibility-timeout

Als dit niet wordt opgegeven, is de standaardwaarde 0. Hiermee geeft u de nieuwe time-outwaarde voor zichtbaarheid op, in seconden, ten opzichte van de servertijd. De waarde moet groter zijn dan of gelijk zijn aan 0 en mag niet groter zijn dan 7 dagen. De time-out voor zichtbaarheid van een bericht kan niet worden ingesteld op een waarde die later is dan de verlooptijd. visibility_timeout moet worden ingesteld op een waarde die kleiner is dan de time-to-live-waarde.

az storage message update

Werkt de time-out voor zichtbaarheid van een bericht bij.

U kunt deze bewerking ook gebruiken om de inhoud van een bericht bij te werken. Deze bewerking kan worden gebruikt om de onzichtbaarheid van een wachtrijbericht voortdurend uit te breiden. Deze functionaliteit kan handig zijn als u wilt dat een werkrol een wachtrijbericht 'leaset'. Als een werkrol bijvoorbeeld get_messages aanroept en herkent dat er meer tijd nodig is om een bericht te verwerken, kan de onzichtbaarheid van het bericht voortdurend worden uitgebreid totdat het wordt verwerkt. Als de werkrol mislukt tijdens de verwerking, wordt het bericht uiteindelijk weer zichtbaar en kan een andere werkrol dit verwerken. Als het veld sleutelversleutelingssleutel is ingesteld op het lokale serviceobject, wordt met deze methode de inhoud versleuteld voordat de inhoud wordt geüpload.

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

Vereiste parameters

--id

De bericht-id die het bij te werken bericht identificeert.

--pop-receipt

Een geldige waarde voor een pop-ontvangstbewijs die wordt geretourneerd door een eerdere aanroep van de bewerking get_messages() of update_message().

--queue-name -q

De naam van de wachtrij.

--visibility-timeout

Hiermee geeft u de nieuwe time-outwaarde voor zichtbaarheid op, in seconden, ten opzichte van de servertijd. De nieuwe waarde moet groter zijn dan of gelijk zijn aan 0 en mag niet groter zijn dan 7 dagen. De time-out voor zichtbaarheid van een bericht kan niet worden ingesteld op een waarde die later is dan de verlooptijd. Een bericht kan worden bijgewerkt totdat het is verwijderd of verlopen.

Optionele parameters

--account-key

Storage accountsleutel. Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_KEY.

--account-name

Naam van opslagaccount. Gerelateerde omgevingsvariabele: AZURE_STORAGE_ACCOUNT. Moet worden gebruikt in combinatie met een opslagaccountsleutel of een SAS-token. Als geen van beide aanwezig is, probeert de opdracht een query uit te voeren op de sleutel van het opslagaccount met behulp van het geverifieerde Azure-account. Als een groot aantal opslagopdrachten wordt uitgevoerd, kan het API-quotum worden bereikt.

--auth-mode

De modus waarin de opdracht moet worden uitgevoerd. In de aanmeldingsmodus worden uw aanmeldingsreferenties rechtstreeks gebruikt voor de verificatie. De verouderde sleutelmodus probeert een query uit te voeren voor een accountsleutel als er geen verificatieparameters voor het account zijn opgegeven. Omgevingsvariabele: AZURE_STORAGE_AUTH_MODE.

geaccepteerde waarden: key, login
--connection-string

Storage account connection string. Omgevingsvariabele: AZURE_STORAGE_CONNECTION_STRING.

--content

Berichtinhoud, maximaal 64 kB groot.

--sas-token

Een Shared Access Signature (SAS). Moet worden gebruikt in combinatie met de naam van het opslagaccount. Omgevingsvariabele: AZURE_STORAGE_SAS_TOKEN.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--timeout

Time-out aanvragen in seconden. Is van toepassing op elke aanroep naar de service.