az storage message

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administrar mensajes de Queue Storage.

Especifique uno de los siguientes parámetros de autenticación para los comandos: --auth-mode, --account-key, --connection-string, --sas-token. También puede usar las variables de entorno correspondientes para almacenar las credenciales de autenticación, por ejemplo, AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING y AZURE_STORAGE_SAS_TOKEN.

Comandos

Nombre Description Tipo Estado
az storage message clear

Elimine todos los mensajes de la cola especificada.

Principal Vista previa
az storage message delete

Elimine el mensaje especificado.

Principal Vista previa
az storage message get

Recupere uno o varios mensajes desde la parte frontal de la cola.

Principal Vista previa
az storage message peek

Recupere uno o varios mensajes desde la parte frontal de la cola, pero no modifique la visibilidad del mensaje.

Principal Vista previa
az storage message put

Agregue un nuevo mensaje a la parte posterior de la cola de mensajes.

Principal Vista previa
az storage message update

Actualice el tiempo de espera de visibilidad de un mensaje.

Principal Vista previa

az storage message clear

Vista previa

El grupo de comandos "mensaje de almacenamiento" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine todos los mensajes de la cola especificada.

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

Ejemplos

Elimine todos los mensajes de la cola especificada.

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

Parámetros requeridos

--queue-name -q

Nombre de cola.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage message delete

Vista previa

El grupo de comandos "mensaje de almacenamiento" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine el mensaje especificado.

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

Ejemplos

Elimine el mensaje especificado.

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

Parámetros requeridos

--id

Identificador del mensaje que identifica el mensaje que se va a eliminar.

--pop-receipt

Valor de recibo pop válido devuelto de una llamada anterior a la operación :func:~get_messages o :func:~update_message .

--queue-name -q

Nombre de cola.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage message get

Vista previa

El grupo de comandos "mensaje de almacenamiento" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Recupere uno o varios mensajes desde la parte frontal de la cola.

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]

Ejemplos

Recupere un mensaje desde la parte frontal de la cola y restablezca el tiempo de espera de visibilidad a 5 minutos más tarde.

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

Parámetros requeridos

--queue-name -q

Nombre de cola.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Valor entero distinto de cero que especifica el número de mensajes que se van a recuperar de la cola, hasta un máximo de 32. Si hay menos visibles, se devuelven los mensajes visibles. De forma predeterminada, se recupera un único mensaje de la cola con esta operación.

valor predeterminado: 1
--queue-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--visibility-timeout

Especifique el nuevo valor de tiempo de espera de visibilidad, en segundos, en relación con la hora del servidor. El nuevo valor debe ser mayor o igual que 1 segundo y no puede ser mayor que 7 días. El tiempo de espera de visibilidad de un mensaje se puede establecer en un valor posterior a la hora de expiración.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage message peek

Vista previa

El grupo de comandos "mensaje de almacenamiento" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Recupere uno o varios mensajes desde la parte frontal de la cola, pero no modifique la visibilidad del mensaje.

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

Ejemplos

Recupere 5 mensajes desde la parte frontal de la cola (no modifique la visibilidad del mensaje).

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

Parámetros requeridos

--queue-name -q

Nombre de cola.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Valor entero distinto de cero que especifica el número de mensajes que se van a examinar de la cola, hasta un máximo de 32. De forma predeterminada, se muestra un único mensaje de la cola con esta operación.

--queue-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage message put

Vista previa

El grupo de comandos "mensaje de almacenamiento" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue un nuevo mensaje a la parte posterior de la cola de mensajes.

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]

Ejemplos

Agregue un nuevo mensaje que vivirá un día.

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

Parámetros requeridos

--content

Contenido del mensaje, de hasta 64 KB de tamaño.

--queue-name -q

Nombre de cola.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--time-to-live

Especifique el intervalo de tiempo de vida para el mensaje, en segundos. El período de vida puede ser cualquier número positivo o -1 para infinito. Si se omite este parámetro, el período de vida predeterminado es de 7 días.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--visibility-timeout

Si no se especifica, el valor predeterminado es 0. Especifique el nuevo valor de tiempo de espera de visibilidad, en segundos, en relación con la hora del servidor. El valor debe ser mayor o igual que 0 y no puede ser mayor que 7 días. El tiempo de espera de visibilidad de un mensaje no se puede establecer en un valor posterior a la hora de expiración. visibility_timeout debe establecerse en un valor menor que el valor de time_to_live.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage message update

Vista previa

El grupo de comandos "mensaje de almacenamiento" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice el tiempo de espera de visibilidad de un mensaje.

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]

Ejemplos

Actualice el tiempo de espera de visibilidad y el contenido de un mensaje.

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

Parámetros requeridos

--id

Identificador del mensaje que identifica el mensaje que se va a eliminar.

--pop-receipt

Valor de recibo pop válido devuelto de una llamada anterior a la operación :func:~get_messages o :func:~update_message .

--queue-name -q

Nombre de cola.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

valores aceptados: key, login
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--content

Contenido del mensaje, de hasta 64 KB de tamaño.

--queue-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

--visibility-timeout

Si no se especifica, el valor predeterminado es 0. Especifique el nuevo valor de tiempo de espera de visibilidad, en segundos, en relación con la hora del servidor. El nuevo valor debe ser mayor o igual que 0 y no puede ser mayor que 7 días. El tiempo de espera de visibilidad de un mensaje no se puede establecer en un valor posterior a la hora de expiración. Un mensaje se puede actualizar hasta que se haya eliminado o haya expirado.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.