Criar e gerenciar concessões de contêiner com JavaScript ou TypeScript
Este artigo mostra como criar e gerenciar concessões de contêiner usando a biblioteca de cliente do Armazenamento do Azure para JavaScript. Você pode usar a biblioteca de cliente para adquirir, renovar, liberar e interromper concessões de contêiner.
Pré-requisitos
- Os exemplos neste artigo pressupõem que você já tenha um projeto configurado para trabalhar com a biblioteca de cliente do Armazenamento de Blobs do Azure para JavaScript. Para saber mais sobre como configurar seu projeto, incluindo instalação de pacotes, importação de módulos e criação de um objeto de cliente autorizado para trabalhar com recursos de dados, consulte Introdução ao Armazenamento de Blobs do Azure e JavaScript.
- O mecanismo de autorização deve ter permissões para trabalhar com uma concessão de contêiner. Para saber mais, consulte as diretrizes de autorização para a seguinte operação da API REST:
Sobre locações de contêineres
Uma concessão estabelece e gerencia um bloqueio em um contêiner para operações de exclusão. A duração do bloqueio pode ser de 15 a 60 segundos, ou pode ser infinita. Uma locação em um contêiner fornece acesso exclusivo de exclusão ao contêiner. Uma concessão de contêiner controla apenas a capacidade de excluir o contêiner usando a operação Excluir API REST de contêiner . Para excluir um contêiner com uma concessão ativa, um cliente deve incluir a ID de concessão ativa com a solicitação de exclusão. Todas as outras operações de contêiner são bem-sucedidas em um contêiner alugado sem o ID de locação. Se você tiver habilitado a exclusão suave de contêiner, poderá restaurar contêineres excluídos.
Para saber mais sobre estados de concessão e quando você pode executar uma determinada ação em uma concessão, consulte Estados e ações de concessão.
As operações de leasing são tratadas pela classe BlobLeaseClient , que fornece um cliente contendo todas as operações de concessão para blobs e contêineres. Para saber mais sobre concessões de blob usando a biblioteca de cliente, consulte Criar e gerenciar concessões de blob com JavaScript.
Adquira um contrato de arrendamento
Ao adquirir uma concessão de contêiner, você obtém uma ID de concessão que seu código pode usar para operar no contêiner. Se o contêiner já tiver uma concessão ativa, você só poderá solicitar uma nova concessão usando a ID de concessão ativa. No entanto, você pode especificar uma nova duração de concessão.
Para adquirir uma concessão, crie uma instância da classe BlobLeaseClient e use um dos seguintes métodos:
O exemplo a seguir adquire uma concessão de 30 segundos para um contêiner:
async function acquireContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.acquireLease(30);
return leaseClient;
}
Renovar um contrato de arrendamento
Você pode renovar uma concessão de contêiner se a ID de concessão especificada na solicitação corresponder à ID de concessão associada ao contêiner. O contrato de arrendamento pode ser renovado mesmo que expire, desde que o contentor não tenha sido alugado novamente desde a expiração desse contrato. Quando você renova uma locação, a duração da concessão é redefinida.
Para renovar uma concessão, use um dos seguintes métodos em uma instância BlobLeaseClient :
O exemplo a seguir renova uma locação de contêiner:
async function renewContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.renewLease();
}
Liberar um contrato de arrendamento
Você pode liberar uma concessão de contêiner se a ID de concessão especificada na solicitação corresponder à ID de concessão associada ao contêiner. A liberação de uma locação permite que outro cliente adquira uma locação para o contêiner imediatamente após a conclusão da liberação.
Você pode liberar uma concessão usando um dos seguintes métodos em uma instância BlobLeaseClient :
O exemplo a seguir libera uma concessão em um contêiner:
async function releaseContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.releaseLease();
}
Quebrar um contrato de arrendamento
Você pode interromper uma concessão de contêiner se o contêiner tiver uma concessão ativa. Qualquer pedido autorizado pode quebrar o contrato de arrendamento; a solicitação não é necessária para especificar um ID de concessão correspondente. Um contrato de arrendamento não pode ser renovado depois de quebrado, e quebrar um contrato impede que um novo contrato seja adquirido até que o contrato original expire ou seja liberado.
Você pode quebrar uma concessão usando um dos seguintes métodos em uma instância BlobLeaseClient :
O exemplo a seguir quebra uma concessão em um contêiner:
async function breakContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.breakLease();
}
Estados e ações de arrendamento
O diagrama a seguir mostra os cinco estados de uma concessão e os comandos ou eventos que causam alterações de estado de concessão.
A tabela a seguir lista os cinco estados de concessão, fornece uma breve descrição de cada um e lista as ações de concessão permitidas em um determinado estado. Essas ações de concessão causam transições de estado, conforme mostrado no diagrama.
| Estado de arrendamento | Description | Ações de arrendamento permitidas |
|---|---|---|
| Disponível | O contrato de arrendamento está desbloqueado e pode ser adquirido. | acquire |
| Arrendado | A locação está bloqueada. | acquire (apenas o mesmo ID de concessão), renew, change, release, e break |
| Expirada | A duração da locação expirou. | acquire, renew, release, e break |
| Quebrando | O contrato de arrendamento foi quebrado, mas o contrato continuará bloqueado até que o período de interrupção tenha expirado. | release e break |
| Quebrado | O contrato de arrendamento foi quebrado e o período de interrupção expirou. | acquire, release, e break |
Quando uma concessão expira, a ID da concessão é mantida pelo serviço de Blob até que o contêiner seja modificado ou alugado novamente. Um cliente pode tentar renovar ou liberar a concessão usando o ID de concessão expirado. Se a solicitação falhar, o cliente saberá que o contêiner foi alugado novamente ou que o contêiner foi excluído desde que a concessão foi ativada pela última vez.
Se uma concessão expirar em vez de ser explicitamente liberada, um cliente pode precisar esperar até um minuto antes que uma nova concessão possa ser adquirida para o contêiner. No entanto, o cliente pode renovar a concessão com o ID de concessão expirado imediatamente.
Recursos
Para saber mais sobre como gerenciar concessões de contêiner usando a biblioteca de cliente do Armazenamento de Blobs do Azure para JavaScript, consulte os recursos a seguir.
Amostras de código
- Veja exemplos de código JavaScript e TypeScript deste artigo (GitHub)
Operações da API REST
O SDK do Azure para JavaScript contém bibliotecas que se baseiam na API REST do Azure, permitindo que você interaja com operações da API REST por meio de paradigmas JavaScript familiares. Os métodos de biblioteca de cliente para gerenciar concessões de contêiner usam a seguinte operação de API REST:
Recursos da biblioteca do cliente
Consulte também
Conteúdos relacionados
- Este artigo faz parte do guia do desenvolvedor do Blob Storage para JavaScript/TypeScript. Para saber mais, consulte a lista completa de artigos do guia do desenvolvedor em Crie seu aplicativo JavaScript/TypeScript.