Exportar (0) Imprimir
Expandir Tudo

Criar fila

Atualizado: novembro de 2013

A operação Create Queue cria uma fila abaixo da conta especificada.

A solicitação Create Queue pode ser criada da seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da sua conta de armazenamento:

 

Método URI de solicitação Versão de HTTP

PUT

https://myaccount.queue.core.windows.net/myqueue

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

HTTP/1.1

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

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

 

Parâmetro 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.

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

 

Cabeçalho de solicitação Descrição

Authorization

Obrigatória. 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ória. 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 para os Serviços de Armazenamento do Azure.

x-ms-meta-name:value

Opcional. Um par de nome-valor a ser associado à fila como 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 Azure: Usando logs para rastrear solicitações de armazenamento.

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 à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

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.

Response Status:
HTTP/1.1 201 Created

Response Headers:
Transfer-Encoding: chunked
Date: Fri, 16 Sep 2011 01:20:22 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

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

Você pode especificar metadados definidos pelo usuário como pares de nome/valor na fila no momento da criação.

Quando uma fila com o nome especificado já existir, o serviço Fila verifica os metadados associados à fila existente. Se os metadados existentes forem idênticos aos metadados especificados na solicitação Create Queue, o código de status 204 (Nenhum Conteúdo) será retornado. Se os metadados existentes não corresponderem aos metadados fornecidos com a solicitação Create Queue, ocorrerá uma falha na operação, e o código de status 409 (Conflito) será retornado. Os clientes podem aproveitar esse comportamento para evitar uma chamada adicional para verificar se uma determinada fila já existe.

Para obter orientação sobre nomes válidos de fila, consulte Nomeando filas e metadados. Se o nome especificado da fila não for um nome válido, a operação Create Queue retornará o código de status 400 (Solicitação Incorreta), juntamente com informações adicionais sobre o erro, conforme mostrado no exemplo a seguir.

HTTP/1.1 400 One of the request inputs is out of range.
Connection: Keep-Alive
Content-Length: 226
Via: 1.1 TK5-PRXY-22
Date: Wed, 02 May 2012 17:47:54 GMT
Content-Type: application/xml
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
x-ms-version: 2011-08-18

<?xml version="1.0" encoding="utf-8"?>
<Error>
   <Code>OutOfRangeInput</Code>
   <Message>One of the request inputs is out of range.
   RequestId:fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
   Time:2012-05-02T17:47:55.4334169Z</Message>
</Error>

Mostrar:
© 2014 Microsoft