Mensagem Put
Recolher sumário
Expandir sumário
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Mensagem Put

 

A palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona. Um tempo limite de visibilidade também pode ser especificado para tornar a mensagem invisível até que o tempo limite de visibilidade expire. Uma mensagem deve estar em um formato que pode ser incluído em uma solicitação XML com codificação UTF-8. A mensagem codificada pode ter até 64 KB de tamanho para versões 2011-08-18 e mais recente, ou 8 KB de tamanho para versões anteriores.

A palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona. HTTPS é recomendado. Substitua myaccount com o nome da sua conta de armazenamento, e myqueue com o nome da fila:

Método

URI de solicitação

Versão de HTTP

POST

https://myaccount.queue.core.windows.net/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>

HTTP/1.1

Essa operação e opcional visibilitytimeout parâmetro têm suporte para o SDK 1.6 e versões mais recentes.

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome de host do emulador e a porta do serviço fila como 127.0.0.1:10001, seguido pelo nome da conta de armazenamento emulado:

Método

URI de solicitação

Versão de HTTP

POST

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>

HTTP/1.1

Os seguintes parâmetros podem ser especificados no URI de solicitação.

PARAMETER

Descrição

visibilitytimeout=<int=seconds>

Opcional. Se especificado, a solicitação deve ser feita usando um x-ms-version de 2011-08-18 ou mais recente. Se não for especificado, o valor padrão será 0. Especifica o novo valor de tempo limite de visibilidade, em segundos, em relação à hora do servidor. O novo valor deve ser maior ou igual a 0 e não pode ser maior que sete dias. O tempo limite de visibilidade de uma mensagem não pode ser definido como um valor posterior à data de expiração. visibilitytimeout deve ser definido como um valor menor que o valor time-to-live.

messagettl=<int-seconds>

Opcional. Especifica o intervalo de vida útil da mensagem, em segundos. A vida útil máxima permitida é sete dias. Se esse parâmetro for omitido, a vida útil padrão será sete dias.

timeout

Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte Definindo tempos limite para operações de serviço Fila.

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho de solicitação

Descrição

Authorization

Obrigatório. Especifica o esquema de autenticação, o nome da conta e a assinatura. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

Date or x-ms-date

Obrigatório. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

x-ms-version

Opcional. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão dos serviços Blob, Fila e Tabela no Windows Azure.

x-ms-client-request-id

Opcional. Fornece um valor opaco gerado pelo cliente com limite de caractere de 1 KB que será registrado nos logs de análise quando o registro em log da análise de armazenamento for habilitado. O uso desse cabeçalho é altamente recomendável para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o registro em log da Análise de Armazenamento e log do Azure: Usando Logs para rastrear solicitações de armazenamento.

O corpo da solicitação contém os dados da mensagem no seguinte formato XML. Observe que o conteúdo da mensagem deve estar em um formato que pode ser codificado com UTF-8.

<QueueMessage> <MessageText>message-content</MessageText> </QueueMessage>

Request: POST https://myaccount.queue.core.windows.net/messages?visibilitytimeout=30&timeout=30 HTTP/1.1 Headers: x-ms-version: 2011-08-18 x-ms-date: Tue, 30 Aug 2011 01:03:21 GMT Authorization: SharedKey myaccount:sr8rIheJmCd6npMSx7DfAY3L//V3uWvSXOzUBCV9wnk= Content-Length: 100 Body: <QueueMessage> <MessageText>PHNhbXBsZT5zYW1wbGUgbWVzc2FnZTwvc2FtcGxlPg==</MessageText> </QueueMessage>

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Uma operação bem-sucedida retorna o código de status 201 (Criado).

Para obter informações sobre códigos de status, consulte Status e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem a especificação de protocolo HTTP/1.1.

Cabeçalho de solicitação

Descrição

x-ms-request-id

Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. Para obter mais informações, consulte Solucionando problemas de operações de API.

x-ms-version

Indica a versão do serviço Fila usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recente.

Date

Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.

Essa operação poderá ser executada pelo proprietário da conta e por qualquer pessoa com uma assinatura de acesso compartilhado que tenha permissão para executar essa operação.

O tempo limite de visibilidade opcional especifica o tempo que a mensagem ficará invisível. Depois que o tempo limite expirar, a mensagem se tornará visível. Se um tempo limite de visibilidade não for especificado, o valor padrão de 0 será usado.

A vida útil opcional da mensagem especifica quanto tempo uma mensagem permanecerá na fila. A mensagem será excluída da fila quando o período de vida útil expirar.

Uma mensagem deve estar em um formato que pode ser incluído em uma solicitação XML com codificação UTF-8. Para incluir uma marcação na mensagem, os conteúdos da mensagem devem ser ignorados por XML ou codificados como Base64. Qualquer marcação XML na mensagem que não está ignorada ou codificada será removida antes da mensagem ser adicionada à fila.

Se a mensagem for muito grande, o serviço retornará o código de status 400 (Solicitação Incorreta).

Mostrar:
© 2016 Microsoft