QueueClient class

Cria uma instância de QueueClient.

new QueueClient(url: string, pipeline: Pipeline)

Parâmetros

Cria uma instância de QueueClient.

new QueueClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

Parâmetros

Cria uma instância de QueueClient.

new QueueClient(connectionString: string, queueName: string, options?: StoragePipelineOptions)

Parâmetros

accountName: string

Valor de Propriedade

O nome da fila.

string name

Valor de Propriedade

Valor da cadeia de caracteres de URL.

url: string

Valor de Propriedade

Clear exclui todas as mensagens de uma fila.

function clearMessages(options?: QueueClearMessagesOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de mensagens claras.

Cria uma nova fila na conta especificada.

function create(options?: QueueCreateOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de criação de fila.

Exemplo de uso:

const queueClient = queueServiceClient.getQueueClient("<new queue name>");
const createQueueResponse = await queueClient.create();

Cria uma nova fila na conta especificada se ela ainda não existir. Se a fila já existir, ela não será alterada.

function createIfNotExists(options?: QueueCreateOptions)

Parâmetros

Devoluções

Exclui a fila especificada permanentemente.

function delete(options?: QueueDeleteOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de exclusão de fila.

Exemplo de uso:

const deleteQueueResponse = await queueClient.delete();
console.log(
  "Delete queue successfully, service assigned request Id:", deleteQueueResponse.requestId
);

Exclui a fila especificada permanentemente se ela existir.

function deleteIfExists(options?: QueueDeleteOptions)

Parâmetros

Devoluções

deleteMessage remove permanentemente a mensagem especificada de sua fila.

function deleteMessage(messageId: string, popReceipt: string, options?: QueueDeleteMessageOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de exclusão de mensagem.

Retorna true se a fila especificada existir; falso caso contrário. NOTA: utilize esta função com cuidado, uma vez que uma fila existente pode ser eliminada por outros clientes ou aplicações. Vice-versa, novas filas podem ser adicionadas por outros clientes ou aplicativos após a conclusão dessa função.

function exists(options?: QueueExistsOptions)

Parâmetros

Devoluções

Disponível apenas para QueueClient construído com uma credencial de chave compartilhada. Gera um URI SAS (Service Shared Access Signature) com base nas propriedades do cliente e nos parâmetros passados. O SAS é assinado pela credencial de chave compartilhada do cliente.

function generateSasUrl(options: QueueGenerateSasUrlOptions)

Parâmetros

Devoluções

O URI SAS que consiste no URI para o recurso representado por este cliente, seguido pelo token SAS gerado.

Obtém detalhes sobre quaisquer políticas de acesso armazenado especificadas na fila que podem ser usadas com Assinaturas de Acesso Compartilhado. AVISO: JavaScript Date perderá a precisão ao analisar a cadeia de caracteres de início e expiração. Por exemplo, a nova Data("2018-12-31T03:44:23.8827891Z").toISOString() obterá "2018-12-31T03:44:23.882Z".

function getAccessPolicy(options?: QueueGetAccessPolicyOptions)

Parâmetros

Devoluções

Dados de resposta para a operação da política de acesso de obtenção de fila.

Obtém todos os metadados definidos pelo usuário e as propriedades do sistema para a fila especificada. Os metadados são associados à fila como pares nome-valores.

function getProperties(options?: QueueGetPropertiesOptions)

Parâmetros

Devoluções

Dados de resposta para a operação Queue get properties.

peekMessages recupera uma ou mais mensagens da frente da fila, mas não altera a visibilidade da mensagem.

function peekMessages(options?: QueuePeekMessagesOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de mensagens de visualização.

Exemplo de uso:

const peekMessagesResponse = await queueClient.peekMessages();
console.log("The peeked message is:", peekMessagesResponse.peekedMessageItems[0].messageText);

receiveMessages recupera uma ou mais mensagens da frente da fila.

function receiveMessages(options?: QueueReceiveMessageOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de recebimento de mensagens.

Exemplo de uso:

const response = await queueClient.receiveMessages();
if (response.receivedMessageItems.length == 1) {
  const receivedMessageItem = response.receivedMessageItems[0];
  console.log("Processing & deleting message with content:", receivedMessageItem.messageText);
  const deleteMessageResponse = await queueClient.deleteMessage(
    receivedMessageItem.messageId,
    receivedMessageItem.popReceipt
  );
  console.log(
    "Delete message successfully, service assigned request Id:",
    deleteMessageResponse.requestId
  );
}

sendMessage adiciona uma nova mensagem ao fim de uma fila. O tempo limite de visibilidade especifica por quanto tempo a mensagem deve ficar invisível para as operações Dequeue e Peek. O conteúdo da mensagem tem até 64 KB de tamanho e deve estar em um formato que possa ser incluído em uma solicitação XML com codificação UTF-8. Para incluir marcação na mensagem, o conteúdo da mensagem deve ser com escape de XML ou código Base64.

function sendMessage(messageText: string, options?: QueueSendMessageOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de envio de mensagens.

Exemplo de uso:

const sendMessageResponse = await queueClient.sendMessage("Hello World!");
console.log(
  "Sent message successfully, service assigned message Id:", sendMessageResponse.messageId,
  "service assigned request Id:", sendMessageResponse.requestId
);

Define políticas de acesso armazenado para a fila que podem ser usadas com Assinaturas de Acesso Compartilhado.

function setAccessPolicy(queueAcl?: SignedIdentifier[], options?: QueueSetAccessPolicyOptions)

Parâmetros

Devoluções

Dados de resposta para a operação da política de acesso do conjunto de filas.

Define um ou mais pares nome-valor definidos pelo usuário para a fila especificada. Se nenhuma opção for fornecida, ou nenhum metadados definido no parâmetro option, os metadados da fila serão removidos.

function setMetadata(metadata?: Metadata, options?: QueueSetMetadataOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de metadados do conjunto de filas.

A atualização altera o tempo limite de visibilidade e o conteúdo de uma mensagem. O conteúdo da mensagem tem até 64 KB de tamanho e deve estar em um formato que possa ser incluído em uma solicitação XML com codificação UTF-8. Para incluir marcação na mensagem, o conteúdo da mensagem deve ser com escape de XML ou código Base64.

function updateMessage(messageId: string, popReceipt: string, message?: string, visibilityTimeout?: number, options?: QueueUpdateMessageOptions)

Parâmetros

Devoluções

Dados de resposta para a operação de mensagem de atualização.