Exportar (0) Imprimir
Expandir Tudo

Definir metadados de fila (REST API)

Atualizado: setembro de 2011

A operação Set Queue Metadata determina os metadados definidos pelo usuário na fila especificada. Os metadados são associados à fila como pares de nome-valor.

A solicitação Set Queue Metadata pode ser criada da seguinte maneira. 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

URI de serviço de armazenamento emulado

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

Para obter mais informações, consulte About Development Storage.

Parâmetros URI

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

 

Parameter Descrição

timeout

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

Cabeçalhos de solicitação

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 Windows 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 Windows 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 atender às regras de nomenclatura para identificadores C#.

x-ms-client-request-id

Opcional. Fornece um valor opaco, gerado pelo cliente, com um limite de caractere de 1 KB que é registrado nos logs analíticos quando o log analítico de armazenamento está habilitado. É altamente recomendável usar este cabeçalho para correlacionar atividades 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 Windows Azure: Usando logs para rastrear solicitações de armazenamento.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

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.

Código de status

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.

Cabeçalhos de resposta

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

Corpo da resposta

Nenhum.

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:
© 2014 Microsoft