Crie e gerencie concessões de blob com Java
Este artigo mostra como criar e gerenciar concessões de blob usando a biblioteca de cliente do Armazenamento do Azure para Java. Você pode usar a biblioteca de cliente para adquirir, renovar, liberar e quebrar concessões de blob.
Pré-requisitos
- Subscrição do Azure - crie uma gratuitamente
- Conta de armazenamento do Azure - criar uma conta de armazenamento
- Java Development Kit (JDK) versão 8 ou posterior (recomendamos a versão 17 para a melhor experiência)
- O Apache Maven é usado para gerenciamento de projetos neste exemplo
Configurar o ambiente
Se você não tiver um projeto existente, esta seção mostra como configurar um projeto para trabalhar com a biblioteca de cliente do Armazenamento de Blobs do Azure para Java. Para obter mais informações, consulte Introdução ao Armazenamento de Blobs do Azure e Java.
Para trabalhar com os exemplos de código neste artigo, siga estas etapas para configurar seu projeto.
Nota
Este artigo usa a ferramenta de compilação Maven para criar e executar o código de exemplo. Outras ferramentas de compilação, como o Gradle, também funcionam com o SDK do Azure para Java.
Instalar pacotes
Abra o arquivo no editor de pom.xml texto. Instale os pacotes incluindo o arquivo BOM ou incluindo uma dependência direta.
Adicionar instruções de importação
Adicione as seguintes instruções import:
import com.azure.storage.blob.*;
import com.azure.storage.blob.specialized.*;
Autorização
O mecanismo de autorização deve ter as permissões necessárias para trabalhar com uma concessão de blob. Para autorização com o Microsoft Entra ID (recomendado), você precisa da função interna do RBAC do Azure RBAC Storage Blob Data Contributor ou superior. Para saber mais, consulte as diretrizes de autorização para Blob de Concessão (API REST).
Criar um objeto cliente
Para conectar um aplicativo ao Armazenamento de Blob, crie uma instância de BlobServiceClient.
O exemplo a seguir usa BlobServiceClientBuilder para criar um BlobServiceClient objeto usando DefaultAzureCredentialo , e mostra como criar clientes de contêiner e blob, se necessário:
// Azure SDK client builders accept the credential as a parameter
// TODO: Replace <storage-account-name> with your actual storage account name
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
.endpoint("https://<storage-account-name>.blob.core.windows.net/")
.credential(new DefaultAzureCredentialBuilder().build())
.buildClient();
// If needed, you can create a BlobContainerClient object from the BlobServiceClient
BlobContainerClient containerClient = blobServiceClient
.getBlobContainerClient("<container-name>");
// If needed, you can create a BlobClient object from the BlobContainerClient
BlobClient blobClient = containerClient
.getBlobClient("<blob-name>");
Para saber mais sobre como criar e gerenciar objetos de cliente, consulte Criar e gerenciar objetos de cliente que interagem com recursos de dados.
Sobre locações de blob
Uma concessão cria e gerencia um bloqueio em um blob para operações de gravação e exclusão. A duração do bloqueio pode ser de 15 a 60 segundos, ou pode ser infinita. Uma concessão em um blob fornece acesso exclusivo de gravação e exclusão ao blob. Para gravar em um blob com uma concessão ativa, um cliente deve incluir o ID de concessão ativo com a solicitação de gravação.
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.
Todas as operações de contêiner são permitidas em um contêiner que inclui blobs com uma concessão ativa, incluindo Excluir Contêiner. Portanto, um contêiner pode ser excluído mesmo se os blobs dentro dele tiverem concessões ativas. Use a operação Lease Container para controlar os direitos de exclusão de um contêiner.
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 contêiner usando a biblioteca de cliente, consulte Criar e gerenciar concessões de contêiner com Java.
Adquira um contrato de arrendamento
Ao adquirir uma concessão de blob, você obtém uma ID de concessão que seu código pode usar para operar no blob. Se o blob já tiver uma concessão ativa, você só poderá solicitar uma nova concessão usando o ID de concessão ativo. 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 o seguinte método:
O exemplo a seguir adquire uma concessão de 30 segundos para um blob:
public BlobLeaseClient acquireBlobLease(BlobClient blob) {
// Create the lease client
BlobLeaseClient leaseClient = new BlobLeaseClientBuilder()
.blobClient(blob)
.buildClient();
// Acquire the lease - specify duration between 15 and 60 seconds, or -1 for
// infinite duration
String leaseID = leaseClient.acquireLease(30);
System.out.printf("Acquired lease ID: %s%n", leaseID);
return leaseClient;
}
Renovar um contrato de arrendamento
Você pode renovar uma concessão de blob se a ID de concessão especificada na solicitação corresponder à ID de concessão associada ao blob. O contrato de arrendamento pode ser renovado mesmo que tenha expirado, desde que o blob não tenha sido modificado ou arrendado 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 existente, use o seguinte método:
O exemplo a seguir renova uma concessão para um blob:
public void renewBlobLease(BlobLeaseClient leaseClient) {
leaseClient.renewLease();
}
Liberar um contrato de arrendamento
Você pode liberar uma concessão de blob se a ID de concessão especificada na solicitação corresponder à ID de concessão associada ao blob. A liberação de uma locação permite que outro cliente adquira uma locação para o blob imediatamente após a conclusão da liberação.
Você pode liberar uma concessão usando o seguinte método:
O exemplo a seguir libera a concessão em um blob:
public void releaseBlobLease(BlobLeaseClient leaseClient) {
leaseClient.releaseLease();
System.out.println("Release lease operation completed");
}
Quebrar um contrato de arrendamento
Você pode quebrar uma concessão de blob se o blob 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 por um período de tempo até que o contrato original expire ou seja liberado.
Você pode quebrar uma concessão usando o seguinte método:
O exemplo a seguir quebra a concessão em um blob:
public void breakBlobLease(BlobLeaseClient leaseClient) {
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 blob seja modificado ou alugado novamente. Um cliente pode tentar renovar ou liberar a concessão usando o ID de concessão expirado. Se essa operação for bem-sucedida, o cliente saberá que o blob não foi alterado desde a última vez que o ID de concessão foi válido. Se a solicitação falhar, o cliente sabe que o blob foi modificado ou que o blob foi alugado novamente desde que a concessão foi ativada pela última vez. O cliente deve então adquirir uma nova locação no blob.
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 blob. No entanto, o cliente pode renovar a concessão com seu ID de concessão imediatamente se o blob não tiver sido modificado.
Uma concessão não pode ser concedida para um instantâneo de blob, pois os instantâneos são somente leitura. Solicitar uma concessão em relação a um instantâneo resulta em código 400 (Bad Request)de status .
Recursos
Para saber mais sobre como gerenciar concessões de blob usando a biblioteca de cliente do Armazenamento de Blob do Azure para Java, consulte os recursos a seguir.
Amostras de código
Operações da API REST
O SDK do Azure para Java 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 Java familiares. Os métodos de biblioteca de cliente para gerenciar concessões de blob usam a seguinte operação de API REST:
- Lease Blob (Blob de Concessão)
Recursos da biblioteca do cliente
Consulte também
Conteúdos relacionados
- Este artigo faz parte do guia do desenvolvedor do Armazenamento de Blobs para Java. Para saber mais, consulte a lista completa de artigos do guia do desenvolvedor em Build your Java app.