az storage message

Préversion
Référence

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Gère les messages de stockage de file d’attente.

Spécifiez l’un des paramètres d’authentification suivants pour vos commandes : --auth-mode, --account-key, --connection-string, --sas-token. Vous pouvez également utiliser des variables d’environnement correspondantes pour stocker vos informations d’identification d’authentification, par exemple AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING et AZURE_STORAGE_SAS_TOKEN.

Commandes

Nom	Description	Type	État
az storage message clear	Supprimez tous les messages de la file d’attente spécifiée.	Core	Aperçu
az storage message delete	Supprimez le message spécifié.	Core	Aperçu
az storage message get	Récupérez un ou plusieurs messages à partir de l’avant de la file d’attente.	Core	Aperçu
az storage message peek	Récupérez un ou plusieurs messages à partir de l’avant de la file d’attente, mais ne modifiez pas la visibilité du message.	Core	Aperçu
az storage message put	Ajoutez un nouveau message à l’arrière de la file d’attente de messages.	Core	Aperçu
az storage message update	Mettez à jour le délai d’expiration de visibilité d’un message.	Core	Aperçu

az storage message clear

Modifier

Préversion

Le groupe de commandes « message de stockage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez tous les messages de la file d’attente spécifiée.

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

Exemples

Supprimez tous les messages de la file d’attente spécifiée.

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

Paramètres obligatoires

--queue-name -q

le nom de la file d’attente ;

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

Nom du compte de stockage. Variable d’environnement associée : AZURE_STORAGE_ACCOUNT. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Si aucune d’elles n’est présente, la commande tente d’interroger la clé du compte de stockage à l’aide du compte Azure authentifié. Si un grand nombre de commandes de stockage sont exécutées, le quota d’API peut être atteint.

--auth-mode

Mode dans lequel exécuter la commande. Le mode « connexion » utilise directement vos informations d’identification de connexion pour l’authentification. Le mode « clé » hérité tente d’interroger une clé de compte si aucun paramètre d’authentification pour le compte n’est fourni. Variable d’environnement : AZURE_STORAGE_AUTH_MODE.

Valeurs acceptées: key, login

--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Stockage point de terminaison du service de données. Doit être utilisé conjointement avec la clé de compte de stockage ou un jeton SAP. Vous pouvez trouver chaque point de terminaison principal de service avec az storage account show. Variable d’environnement : AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage message delete

Modifier

Préversion

Le groupe de commandes « message de stockage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez le message spécifié.

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

Exemples

Supprimez le message spécifié.

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

Paramètres obligatoires

--id

ID de message identifiant le message à supprimer.

--pop-receipt

Valeur de réception contextuelle valide retournée par un appel antérieur à l’opération :func :~get_messages ou :func :~update_message .

--queue-name -q

le nom de la file d’attente ;

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valeurs acceptées: key, login

--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage message get

Modifier

Préversion

Le groupe de commandes « message de stockage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Récupérez un ou plusieurs messages à partir de l’avant de la file d’attente.

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]

Exemples

Récupérez un message à partir de l’avant de la file d’attente et réinitialisez le délai d’expiration de visibilité jusqu’à 5 minutes plus tard.

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

Paramètres obligatoires

--queue-name -q

le nom de la file d’attente ;

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valeurs acceptées: key, login

--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Valeur entière différente de zéro qui spécifie le nombre de messages à récupérer à partir de la file d’attente, jusqu’à un maximum de 32. Si moins de messages sont visibles, les messages visibles sont retournés. Par défaut, un message unique est récupéré à partir de la file d’attente avec cette opération.

Valeur par défaut: 1

--queue-endpoint

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

--visibility-timeout

Spécifiez la nouvelle valeur de délai d’expiration de visibilité, en secondes, par rapport à l’heure du serveur. La nouvelle valeur doit être supérieure ou égale à 1 seconde et ne peut pas être supérieure à 7 jours. Le délai de visibilité d’un message peut être défini sur une valeur ultérieure à l’heure d’expiration.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage message peek

Modifier

Préversion

Le groupe de commandes « message de stockage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Récupérez un ou plusieurs messages à partir de l’avant de la file d’attente, mais ne modifiez pas la visibilité du message.

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

Exemples

Récupérez 5 messages à partir de l’avant de la file d’attente (ne modifiez pas la visibilité du message).

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

Paramètres obligatoires

--queue-name -q

le nom de la file d’attente ;

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valeurs acceptées: key, login

--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Valeur entière différente de zéro qui spécifie le nombre de messages à afficher à partir de la file d’attente, jusqu’à un maximum de 32. Par défaut, un seul message est aperçu de la file d’attente avec cette opération.

--queue-endpoint

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage message put

Modifier

Préversion

Le groupe de commandes « message de stockage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Ajoutez un nouveau message à l’arrière de la file d’attente de messages.

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]

Exemples

Ajoutez un nouveau message qui sera en direct un jour.

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

Paramètres obligatoires

--content

Contenu du message, jusqu’à 64 Ko de taille.

--queue-name -q

le nom de la file d’attente ;

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valeurs acceptées: key, login

--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--time-to-live

Spécifiez l’intervalle de temps de vie pour le message, en secondes. Le temps de vie peut être n’importe quel nombre positif ou -1 pour l’infini. Si ce paramètre est omis, la durée de vie par défaut est de 7 jours.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

--visibility-timeout

Si elle n’est pas spécifiée, la valeur par défaut est 0. Spécifiez la nouvelle valeur de délai d’expiration de visibilité, en secondes, par rapport à l’heure du serveur. La valeur doit être supérieure ou égale à 0 et ne peut pas être supérieure à 7 jours. Le délai de visibilité d’un message ne peut pas être défini sur une valeur ultérieure à l’heure d’expiration. visibility_timeout doit être définie sur une valeur inférieure à la valeur time_to_live.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az storage message update

Modifier

Préversion

Le groupe de commandes « message de stockage » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour le délai d’expiration de visibilité d’un message.

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]

Exemples

Mettez à jour le délai d’expiration de visibilité et le contenu d’un message.

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

Paramètres obligatoires

--id

ID de message identifiant le message à supprimer.

--pop-receipt

Valeur de réception contextuelle valide retournée par un appel antérieur à l’opération :func :~get_messages ou :func :~update_message .

--queue-name -q

le nom de la file d’attente ;

Paramètres facultatifs

--account-key

Clé du compte de stockage. Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_KEY.

--account-name

--auth-mode

Valeurs acceptées: key, login

--connection-string

Stockage chaîne de connexion de compte. Variable d’environnement : AZURE_STORAGE_CONNECTION_STRING.

--content

Contenu du message, jusqu’à 64 Ko de taille.

--queue-endpoint

--sas-token

Signature d’accès partagé (SAP). Doit être utilisé conjointement avec le nom du compte de stockage ou le point de terminaison de service. Variable d’environnement : AZURE_STORAGE_SAS_TOKEN.

--timeout

Délai d’expiration de la demande en secondes. S’applique à chaque appel au service.

--visibility-timeout

Si elle n’est pas spécifiée, la valeur par défaut est 0. Spécifiez la nouvelle valeur de délai d’expiration de visibilité, en secondes, par rapport à l’heure du serveur. La nouvelle valeur doit être supérieure ou égale à 0 et ne peut pas être supérieure à 7 jours. Le délai de visibilité d’un message ne peut pas être défini sur une valeur ultérieure à l’heure d’expiration. Un message peut être mis à jour jusqu’à ce qu’il ait été supprimé ou qu’il ait expiré.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

Valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

Partager via

az storage message

Commandes

az storage message clear

Exemples

Paramètres obligatoires

Paramètres facultatifs

az storage message delete

Exemples

Paramètres obligatoires

Paramètres facultatifs

az storage message get

Exemples

Paramètres obligatoires

Paramètres facultatifs

az storage message peek

Exemples

Paramètres obligatoires

Paramètres facultatifs

az storage message put

Exemples

Paramètres obligatoires

Paramètres facultatifs

az storage message update

Exemples

Paramètres obligatoires

Paramètres facultatifs

Ressources supplémentaires