az storage message

Pré-visualizar

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie mensagens de armazenamento em fila.

Especifique um dos seguintes parâmetros de autenticação para seus comandos: --auth-mode, --account-key, --connection-string, --sas-token. Você também pode usar variáveis de ambiente correspondentes para armazenar suas credenciais de autenticação, por exemplo, AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING e AZURE_STORAGE_SAS_TOKEN.

Comandos

Name	Description	Tipo	Status
az storage message clear	Exclua todas as mensagens da fila especificada.	Core	Preview
az storage message delete	Exclua a mensagem especificada.	Core	Preview
az storage message get	Recupere uma ou mais mensagens da frente da fila.	Core	Preview
az storage message peek	Recupere uma ou mais mensagens da frente da fila, mas não altere a visibilidade da mensagem.	Core	Preview
az storage message put	Adicione uma nova mensagem à parte de trás da fila de mensagens.	Core	Preview
az storage message update	Atualize o tempo limite de visibilidade de uma mensagem.	Core	Preview

az storage message clear

Editar

Pré-visualizar

O grupo de comandos 'storage message' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua todas as mensagens da fila especificada.

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

Exemplos

Exclua todas as mensagens da fila especificada.

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

Parâmetros Obrigatórios

--queue-name -q

O nome da fila.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--account-name

Nome da conta de armazenamento. Variável de ambiente relacionada: AZURE_STORAGE_ACCOUNT. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Se nenhum dos dois estiver presente, o comando tentará consultar a chave da conta de armazenamento usando a conta autenticada do Azure. Se um grande número de comandos de armazenamento for executado, a cota da API poderá ser atingida.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--auth-mode

O modo no qual executar o comando. O modo "login" usará diretamente suas credenciais de login para a autenticação. O modo "chave" herdado tentará consultar uma chave de conta se nenhum parâmetro de autenticação para a conta for fornecido. Variável de ambiente: AZURE_STORAGE_AUTH_MODE.

Propriedade	Valor
Valores aceites:	key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--queue-endpoint

Ponto de extremidade do serviço de dados de armazenamento. Deve ser usado em conjunto com a chave da conta de armazenamento ou um token SAS. Você pode encontrar cada ponto de extremidade primário do serviço com az storage account showo . Variável de ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az storage message delete

Editar

Pré-visualizar

O grupo de comandos 'storage message' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua a mensagem especificada.

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

Exemplos

Exclua a mensagem especificada.

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

Parâmetros Obrigatórios

--id

O ID da mensagem que identifica a mensagem a ser excluída.

--pop-receipt

Um valor de recibo pop válido retornado de uma chamada anterior para a operação :func:~get_messages ou :func:~update_message.

--queue-name -q

O nome da fila.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--account-name

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--auth-mode

Propriedade	Valor
Valores aceites:	key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--queue-endpoint

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az storage message get

Editar

Pré-visualizar

O grupo de comandos 'storage message' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Recupere uma ou mais mensagens da frente da fila.

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]

Exemplos

Recupere uma mensagem da frente da fila e redefina o tempo limite de visibilidade para 5 minutos depois.

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

Parâmetros Obrigatórios

--queue-name -q

O nome da fila.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--account-name

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--auth-mode

Propriedade	Valor
Valores aceites:	key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--num-messages

Um valor inteiro diferente de zero que especifica o número de mensagens a serem recuperadas da fila, até um máximo de 32. Se menos estiverem visíveis, as mensagens visíveis serão retornadas. Por padrão, uma única mensagem é recuperada da fila com essa operação.

Propriedade	Valor
Default value:	1

--queue-endpoint

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

--visibility-timeout

Especifique o novo valor de tempo limite de visibilidade, em segundos, em relação ao tempo do servidor. O novo valor deve ser maior ou igual a 1 segundo e não pode ser maior que 7 dias. O tempo limite de visibilidade de uma mensagem pode ser definido como um valor posterior ao tempo de expiração.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az storage message peek

Editar

Pré-visualizar

O grupo de comandos 'storage message' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Recupere uma ou mais mensagens da frente da fila, mas não altere a visibilidade da mensagem.

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

Exemplos

Recupere 5 mensagens da frente da fila (não altere a visibilidade da mensagem).

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

Parâmetros Obrigatórios

--queue-name -q

O nome da fila.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--account-name

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--auth-mode

Propriedade	Valor
Valores aceites:	key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--num-messages

Um valor inteiro diferente de zero que especifica o número de mensagens a serem espiadas da fila, até um máximo de 32. Por padrão, uma única mensagem é espiada da fila com essa operação.

--queue-endpoint

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az storage message put

Editar

Pré-visualizar

O grupo de comandos 'storage message' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione uma nova mensagem à parte de trás da fila de mensagens.

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]

Exemplos

Adicione uma nova mensagem que viverá um dia.

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

Parâmetros Obrigatórios

--content

Conteúdo da mensagem, até 64 KB de tamanho.

--queue-name -q

O nome da fila.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--account-name

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--auth-mode

Propriedade	Valor
Valores aceites:	key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--queue-endpoint

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--time-to-live

Especifique o intervalo de tempo de vida da mensagem, em segundos. O tempo de vida pode ser qualquer número positivo ou -1 para o infinito. Se esse parâmetro for omitido, o tempo de vida padrão será de 7 dias.

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

--visibility-timeout

Se não for especificado, o valor padrão será 0. Especifique o novo valor de tempo limite de visibilidade, em segundos, em relação ao tempo do servidor. O valor deve ser maior ou igual a 0 e não pode ser maior que 7 dias. O tempo limite de visibilidade de uma mensagem não pode ser definido como um valor posterior ao tempo de expiração. visibility_timeout deve ser definido como um valor menor do que o valor time_to_live.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az storage message update

Editar

Pré-visualizar

O grupo de comandos 'storage message' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualize o tempo limite de visibilidade de uma mensagem.

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]

Exemplos

Atualize o tempo limite de visibilidade e o conteúdo de uma mensagem.

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

Parâmetros Obrigatórios

--id

O ID da mensagem que identifica a mensagem a ser excluída.

--pop-receipt

Um valor de recibo pop válido retornado de uma chamada anterior para a operação :func:~get_messages ou :func:~update_message.

--queue-name -q

O nome da fila.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-key

Chave da conta de armazenamento. Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_KEY.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--account-name

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--auth-mode

Propriedade	Valor
Valores aceites:	key, login

--connection-string

Cadeia de conexão da conta de armazenamento. Variável de ambiente: AZURE_STORAGE_CONNECTION_STRING.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--content

Conteúdo da mensagem, até 64 KB de tamanho.

--queue-endpoint

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--sas-token

Uma assinatura de acesso compartilhado (SAS). Deve ser usado em conjunto com o nome da conta de armazenamento ou o ponto de extremidade do serviço. Variável de ambiente: AZURE_STORAGE_SAS_TOKEN.

Propriedade	Valor
Grupo de parâmetros:	Storage Account Arguments

--timeout

Tempo limite de solicitação em segundos. Aplica-se a cada chamada para o serviço.

--visibility-timeout

Se não for especificado, o valor padrão será 0. Especifique o novo valor de tempo limite de visibilidade, em segundos, em relação ao tempo do servidor. O novo valor deve ser maior ou igual a 0 e não pode ser maior que 7 dias. O tempo limite de visibilidade de uma mensagem não pode ser definido como um valor posterior ao tempo de expiração. Uma mensagem pode ser atualizada até que tenha sido excluída ou tenha expirado.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

Feedback

Esta página foi útil?

Partilhar via

az storage message

Comandos

az storage message clear

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az storage message delete

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az storage message get

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az storage message peek

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az storage message put

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az storage message update

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Feedback