az storage message

Vista previa
Referencia

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.	Núcleo	Versión preliminar
az storage message delete	Elimine el mensaje especificado.	Núcleo	Versión preliminar
az storage message get	Recupere uno o varios mensajes desde la parte frontal de la cola.	Núcleo	Versión preliminar
az storage message peek	Recupere uno o varios mensajes desde la parte frontal de la cola, pero no modifique la visibilidad del mensaje.	Núcleo	Versión preliminar
az storage message put	Agregue un nuevo mensaje a la parte posterior de la cola de mensajes.	Núcleo	Versión preliminar
az storage message update	Actualice el tiempo de espera de visibilidad de un mensaje.	Núcleo	Versión preliminar

az storage message clear

Editar

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

Parámetros opcionales

--account-key

Clave de 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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az storage message delete

Editar

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 desde una llamada anterior a :func:~get_messages o :func:~update_message operación.

--queue-name -q

Nombre de la cola.

Parámetros opcionales

--account-key

Clave de 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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az storage message get

Editar

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

Parámetros opcionales

--account-key

Clave de 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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az storage message peek

Editar

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

Parámetros opcionales

--account-key

Clave de 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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az storage message put

Editar

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

Parámetros opcionales

--account-key

Clave de 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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

az storage message update

Editar

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 desde una llamada anterior a :func:~get_messages o :func:~update_message operación.

--queue-name -q

Nombre de la cola.

Parámetros opcionales

--account-key

Clave de 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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Compartir a través de

az storage message

Comandos

az storage message clear

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage message delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage message get

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage message peek

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage message put

Ejemplos

Parámetros requeridos

Parámetros opcionales

az storage message update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios