Definir metadados de fila
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

Definir metadados de fila

 

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. Os metadados são associados à fila como pares de nome-valor.

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.

Método

URI de solicitação

Versão de HTTP

PUT

https://myaccount.queue.core.windows.net/myqueue?comp=metadata

HTTP/1.1

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

PUT

http://127.0.0.1:10001/devstoreaccount1/myqueue?comp=metadata

HTTP/1.1

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

PARAMETER

Descrição

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 ou 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-meta-name:string-value

Opcional. Um par de nome-valor a ser associado à fila como metadados.

Cada chamada para essa operação substitui todos os metadados existentes anexados à fila. Para remover todos os metadados da fila, chame essa operação sem cabeçalhos de metadados.

Observe que a partir da versão 2009-09-19, os nomes de metadados devem aderir às regras de nomenclatura para identificadores c#.

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.

Request Syntax: PUT https://myaccount.queue.core.windows.net/myqueue?comp=metadata HTTP/1.1 Request Headers: x-ms-version: 2011-08-18 x-ms-date: Fri, 16 Sep 2011 01:47:14 GMT x-ms-meta-meta-sample1: sample1 x-ms-meta-meta-sample2: sample2 Authorization: SharedKey myaccount:u6PSIebDltGW5xHpO77epRpiUhcsTkWMvcM4GTmfqqA=

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 204 (Sem conteúdo).

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 resposta

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.

Somente o proprietário da conta pode chamar essa operação.

Para excluir metadados da fila, chame Set Queue Metadata sem especificar nenhum cabeçalho de metadados.

Mostrar:
© 2016 Microsoft