Partilhar via

Desenvolver aplicações usando Azure Files com Java

Saiba como desenvolver aplicativos Java que usam Arquivos do Azure para armazenar dados. O Azure Files é um serviço de compartilhamento de arquivos gerenciado na nuvem. Ele fornece compartilhamentos de arquivos totalmente gerenciados que podem ser acessados por meio dos protocolos SMB (Server Message Block) e NFS (Network File System) padrão do setor. Os Arquivos do Azure também fornecem uma API REST para acesso programático a compartilhamentos de arquivos.

Neste artigo, você aprenderá sobre as diferentes abordagens para desenvolver com Arquivos do Azure em Java e como escolher a abordagem que melhor se adapta às necessidades do seu aplicativo. Você também aprende a criar um aplicativo de console básico que interage com os recursos do Azure Files.

Aplica-se a

Modelo de gestão Modelo de faturação Nível de média Redundancy SMB NFS
Microsoft.Storage Provisionado v2 HDD (padrão) Localização (LRS) Yes No
Microsoft.Storage Provisionado v2 HDD (padrão) Zona (ZRS) Yes No
Microsoft.Storage Provisionado v2 HDD (padrão) Geo (GRS) Yes No
Microsoft.Storage Provisionado v2 HDD (padrão) GeoZona (GZRS) Yes No
Microsoft.Storage Provisionado versão 1 SSD (de qualidade superior) Localização (LRS) Yes No
Microsoft.Storage Provisionado versão 1 SSD (de qualidade superior) Zona (ZRS) Yes No
Microsoft.Storage Pay-as-you-go HDD (padrão) Localização (LRS) Yes No
Microsoft.Storage Pay-as-you-go HDD (padrão) Zona (ZRS) Yes No
Microsoft.Storage Pay-as-you-go HDD (padrão) Geo (GRS) Yes No
Microsoft.Storage Pay-as-you-go HDD (padrão) GeoZona (GZRS) Yes No

Sobre o desenvolvimento de aplicativos Java com Arquivos do Azure

Os Arquivos do Azure oferecem várias maneiras para os desenvolvedores Java acessarem dados e gerenciarem recursos nos Arquivos do Azure. A tabela a seguir lista as abordagens, resume como elas funcionam e fornece orientação sobre quando usar cada abordagem:

Abordagem Como funciona Quando utilizar
Bibliotecas de E/S de arquivo padrão Usa chamadas de API no nível do sistema operacional por meio de compartilhamentos de arquivos do Azure montados usando SMB ou NFS. Ao montar um compartilhamento de arquivos usando SMB/NFS, você pode usar bibliotecas de E/S de arquivos para uma linguagem de programação ou estrutura, como java.io e java.nio para Java. Você tem aplicativos de linha de negócios com código existente que usa E/S de arquivo padrão e não deseja reescrever o código para que o aplicativo funcione com um compartilhamento de arquivos do Azure.
FileREST API Chama endpoints HTTPS diretamente para interagir com os dados armazenados em Arquivos do Azure. Fornece controle programático sobre recursos de compartilhamento de arquivos. O SDK do Azure fornece a biblioteca de cliente de Compartilhamentos de Arquivos (com.azure.storage.file.share) que se baseia na API FileREST, permitindo que você interaja com operações da API FileREST por meio de paradigmas familiares de linguagem de programação Java. Você está criando aplicativos e serviços de nuvem de valor agregado para clientes e deseja usar recursos avançados não disponíveis por meio de bibliotecas de E/S de arquivos padrão.
API REST do provedor de recursos de armazenamento Usa o Azure Resource Manager (ARM) para gerenciar contas de armazenamento e compartilhamentos de arquivos. Chama endereços da API REST para várias operações de gestão de recursos. Seu aplicativo ou serviço precisa executar tarefas de gerenciamento de recursos, como criar, excluir ou atualizar contas de armazenamento ou compartilhamentos de arquivos.

Para obter informações gerais sobre essas abordagens, consulte Visão geral do desenvolvimento de aplicativos com arquivos do Azure.

Este artigo se concentra em trabalhar com recursos do Azure Files usando as seguintes abordagens:

Pré-requisitos

Configurar o ambiente

Observação

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.

Use o Maven para criar um novo aplicativo de console ou abrir um projeto existente. Siga estas etapas para instalar pacotes e adicionar as diretivas necessárias import .

Instalar pacotes

Abra o ficheiro pom.xml no seu editor de texto. Instale os pacotes incluindo o arquivo BOM ou incluindo uma dependência direta.

Incluir o arquivo BOM

Adicione azure-sdk-bom para depender da versão mais recente da biblioteca. No trecho a seguir, substitua o espaço reservado {bom_version_to_target} pelo número da versão. Usar azure-sdk-bom evita que você precise especificar a versão de cada dependência individual. Para saber mais sobre a BOM, consulte o Leia-me da BOM do SDK do Azure.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure</groupId>
            <artifactId>azure-sdk-bom</artifactId>
            <version>{bom_version_to_target}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Adicione os seguintes elementos de dependência ao grupo de dependências. A dependência azure-identity é necessária para conexões sem senha com os serviços do Azure. Observe que os artefatos do gerenciador de recursos não estão incluídos no arquivo BOM, portanto, você precisa adicioná-los como dependências diretas.

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-file-share</artifactId>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-identity</artifactId>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-management</artifactId>
</dependency>
<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager</artifactId>
  <version>{package_version_to_target}</version>
</dependency>
<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-storage</artifactId>
  <version>{package_version_to_target}</version>
</dependency>

Incluir uma dependência direta

Para assumir uma dependência de uma versão específica da biblioteca, adicione a dependência direta ao seu projeto:

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-file-share</artifactId>
  <version>{package_version_to_target}</version>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-identity</artifactId>
  <version>{package_version_to_target}</version>
</dependency>
<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager</artifactId>
  <version>{package_version_to_target}</version>
</dependency>
<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-storage</artifactId>
  <version>{package_version_to_target}</version>
</dependency>
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core-management</artifactId>
  <version>{package_version_to_target}</version>
</dependency>

Incluir diretivas de importação

Em seguida, abra o arquivo de código e adicione as diretivas necessárias import . Neste exemplo, adicionamos as seguintes diretivas no arquivo App.java :

import com.azure.identity.*;
import com.azure.storage.file.share.*;
import com.azure.resourcemanager.*;
import com.azure.resourcemanager.storage.models.*;
import com.azure.core.management.*;
import com.azure.core.management.profile.*;

Se você planeja usar as bibliotecas de E/S de arquivos Java, também precisará adicionar as seguintes diretivas de importação:

import java.io.*;
import java.nio.file.*;

Trabalhar com arquivos do Azure usando bibliotecas de E/S de arquivos Java

As bibliotecas de E/S de arquivo padrão são a maneira mais comum de acessar e trabalhar com recursos do Azure Files. Quando você monta um compartilhamento de arquivos usando SMB ou NFS, seu sistema operacional redireciona as solicitações de API para o sistema de arquivos local. Essa abordagem permite que você use bibliotecas de E/S de arquivo padrão, como java.io e java.nio, para interagir com arquivos e diretórios no compartilhamento.

Considere o uso de bibliotecas de E/S de arquivos Java quando seu aplicativo exigir:

  • Compatibilidade de aplicativos: Ideal para aplicativos de linha de negócios com código existente que já usa bibliotecas de E/S de arquivos Java. Você não precisa reescrever o código para que o aplicativo funcione com um compartilhamento de arquivos do Azure.
  • Facilidade de utilização: As bibliotecas de E/S de arquivos Java são bem conhecidas pelos desenvolvedores e fáceis de usar. Uma proposta de valor fundamental dos Arquivos do Azure é que ele expõe APIs nativas do sistema de arquivos por meio de SMB e NFS.

Nesta seção, você aprenderá a usar bibliotecas de E/S de arquivos Java para trabalhar com recursos do Azure Files.

Para obter mais informações e exemplos, consulte o seguinte recurso:

Montar um compartilhamento de arquivos

Para usar bibliotecas de E/S de arquivos Java, você deve primeiro montar um compartilhamento de arquivos. Consulte os seguintes recursos para obter orientação sobre como montar um compartilhamento de arquivos usando SMB ou NFS:

Neste artigo, usamos o seguinte caminho para fazer referência a um compartilhamento de arquivos SMB montado no Windows:

String fileSharePath = "Z:\\file-share";

Exemplo: Conectar-se a um compartilhamento de arquivos e enumerar diretórios usando bibliotecas de E/S de arquivos Java

O exemplo de código a seguir mostra como se conectar a um compartilhamento de arquivos e listar os diretórios no compartilhamento:

import java.io.*;
import java.nio.file.*;

// Add the following code to a new or existing function

String fileSharePath = "Z:\\file-share";

try {
    File directory = new File(fileSharePath);
    File[] dirs = directory.listFiles(File::isDirectory);
            
    if (dirs != null) {
        for (File dir : dirs) {
            System.out.println(dir.getName());
        }
        System.out.println(dirs.length + " directories found.");
    }
} catch (Exception e) {
    System.out.println("Error: " + e.getMessage());
}

Exemplo: Gravar num ficheiro num compartilhamento de ficheiros usando bibliotecas de E/S de ficheiros Java

O exemplo de código a seguir mostra como escrever e acrescentar texto a um arquivo:

import java.io.*;
import java.nio.file.*;
import java.util.Arrays;

// Add the following code to a new or existing function

String fileSharePath = "Z:\\file-share";
String fileName = "test.txt";

try {
    String textToWrite = "First line" + System.lineSeparator();
    Path filePath = Paths.get(fileSharePath, fileName);
        
    // Write initial content to file
    Files.write(filePath, textToWrite.getBytes());
    System.out.println("Initial text written to file");
        
    // Append additional lines to the file
    String[] textToAppend = { "Second line", "Third line" };
    Files.write(filePath, 
                Arrays.asList(textToAppend),
                StandardOpenOption.APPEND);
    System.out.println("Additional lines appended to file");
} catch (IOException ex) {
    System.out.println("Error writing to file: " + ex.getMessage());
}

Exemplo: Bloquear um arquivo em um compartilhamento de arquivos usando bibliotecas de E/S de arquivos Java

Os clientes SMB que montam compartilhamentos de arquivos podem usar mecanismos de bloqueio do sistema de arquivos para gerenciar o acesso a arquivos compartilhados.

O exemplo de código a seguir mostra como bloquear um arquivo em um compartilhamento de arquivos:

import java.io.*;
import java.nio.channels.FileChannel;
import java.nio.channels.FileLock;
import java.nio.file.*;

// Add the following code to a new or existing function

String fileSharePath = "Z:\\file-share";
String fileName = "test.txt";
String filePath = Paths.get(fileSharePath, fileName).toString();

try (
    FileOutputStream fos = new FileOutputStream(filePath);
    FileChannel fileChannel = fos.getChannel()) {

    // Acquire an exclusive lock on this file
    FileLock lock = fileChannel.lock();

    System.out.println("File is locked.");

    // Perform file operations here

    // Release the lock
    lock.release();
    System.out.println("File lock released.");

} catch (Exception e) {
    e.printStackTrace();
}

Ao usar o SMB e a API FileREST, lembre-se de que a API FileREST usa concessões para gerenciar bloqueios de arquivos, enquanto o SMB usa bloqueios do sistema de arquivos gerenciados pelo sistema operacional. Para saber mais sobre como gerenciar interações de bloqueio de arquivos entre o SMB e a API FileREST, consulte Gerenciar bloqueios de arquivos.

Exemplo: enumerar ACLs de arquivo usando bibliotecas de E/S de arquivo Java

O exemplo de código a seguir mostra como enumerar listas de controle de acesso (ACLs) para um arquivo:

import java.nio.file.*;
import java.nio.file.attribute.AclEntry;
import java.nio.file.attribute.AclFileAttributeView;
import java.util.List;

// Add the following code to a new or existing function

String fileSharePath = "Z:\\file-share";
String fileName = "test.txt";
String filePath = Paths.get(fileSharePath, fileName).toString();

try {
    Path path = Paths.get(filePath);

    // Get the ACL view for the file
    AclFileAttributeView aclView = Files.getFileAttributeView(
            path, AclFileAttributeView.class);

    // Get the ACL entries
    List<AclEntry> aclEntries = aclView.getAcl();

    // List all access rules for the file
    for (AclEntry entry : aclEntries) {
        System.out.println("Identity: " + entry.principal().getName());
        System.out.println("Access Control Type: " + entry.type());
        System.out.println("File System Rights: " + entry.permissions());
        System.out.println();
    }

    System.out.println(aclEntries.size() + " ACL entries found.");
} catch (Exception ex) {
    System.out.println("Error: " + ex.getMessage());
}

Trabalhar com Arquivos do Azure usando a biblioteca de cliente de Compartilhamentos de Arquivos para Java

A API FileREST fornece acesso programático aos Arquivos do Azure. Permite ao utilizador aceder aos endpoints HTTPS para realizar operações em partilhas de ficheiros, diretórios e ficheiros. A API FileREST foi projetada para alta escalabilidade e recursos avançados que podem não estar disponíveis por meio de protocolos nativos. O SDK do Azure fornece bibliotecas de cliente, como a biblioteca de cliente de Compartilhamentos de Arquivos para Java, que se baseiam na API FileREST.

Considere usar a API FileREST e a biblioteca de cliente de compartilhamento de arquivos se seu aplicativo exigir:

  • Funcionalidades avançadas: Aceda a operações e funcionalidades que não estão disponíveis através de protocolos nativos.
  • Integrações personalizadas na nuvem: Crie serviços personalizados de valor agregado, como backup, antivírus ou gerenciamento de dados, que interagem diretamente com os Arquivos do Azure.
  • Otimização de desempenho: Beneficie-se das vantagens de desempenho em cenários de alta escala usando operações de plano de dados.

A API FileREST modela os Arquivos do Azure como uma hierarquia de recursos e é recomendada para operações executadas no nível de diretório ou arquivo . Você deve preferir a API REST do provedor de recursos de armazenamento para operações executadas no nível de serviço de arquivo ou compartilhamento de arquivos .

Nesta seção, você aprenderá a usar a biblioteca de cliente de Compartilhamentos de Arquivos para Java para trabalhar com recursos de Arquivos do Azure.

Para obter mais informações e exemplos, consulte os seguintes recursos:

Autorizar o acesso e criar um cliente

Para conectar um aplicativo aos Arquivos do Azure, crie um ShareClient objeto. Este objeto é o seu ponto de partida para trabalhar com recursos do Azure Files. Os exemplos de código a seguir mostram como criar um ShareClient objeto usando diferentes mecanismos de autorização.

Para autorizar com o Microsoft Entra ID, você precisará usar uma entidade de segurança. O tipo de entidade de segurança de que necessita depende de onde a sua aplicação é executada. Para saber mais sobre cenários de autenticação, consulte Autenticação do Azure com Java e Identidade do Azure.

Para trabalhar com os exemplos de código neste artigo, atribua a função interna do Azure RBAC Contribuidor Privilegiado de Dados do Arquivo de Armazenamento à entidade de segurança. Essa função fornece acesso completo de leitura, gravação, modificação de ACLs e exclusão em todos os dados nos compartilhamentos para todas as contas de armazenamento configuradas, independentemente das permissões NTFS de nível de arquivo/diretório definidas. Para obter mais informações, consulte Aceder a partilhas de ficheiros do Azure usando a ID do Microsoft Entra com o Azure Files OAuth sobre REST.

Autorizar o acesso usando DefaultAzureCredential

Uma maneira fácil e segura de autorizar o acesso e se conectar aos Arquivos do Azure é obter um token OAuth criando uma instância DefaultAzureCredential . Em seguida, você pode usar essa credencial para criar um ShareClient objeto.

O exemplo a seguir cria um objeto ShareClient autorizado com DefaultAzureCredential, e, em seguida, cria um objeto ShareDirectoryClient para trabalhar com um diretório na partilha:

import com.azure.core.credential.TokenCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.storage.file.share.*;

// Add the following code to a new or existing function

String accountName = "<account-name>";
String shareName = "<share-name>";
TokenCredential defaultAzureCredential = new DefaultAzureCredentialBuilder().build();

// Create the ShareClient
ShareClient shareClient = new ShareClientBuilder()
    .endpoint(String.format("https://%s.file.core.windows.net", accountName))
    .shareName(shareName)
    .credential(defaultAzureCredential)
    .buildClient();

// Create a client to interact with a directory in the share
ShareDirectoryClient directoryClient = shareClient.getDirectoryClient("sample-directory");

Se você souber exatamente qual tipo de credencial usa para autenticar usuários, poderá obter um token OAuth usando outras classes na biblioteca de cliente do Azure Identity para Java. Essas classes derivam da classe TokenCredential .

Para saber mais sobre cada um desses mecanismos de autorização, consulte Escolher como autorizar o acesso aos dados do arquivo.

Exemplo: Copiar arquivos usando a biblioteca de cliente de compartilhamentos de arquivos

Você pode copiar arquivos dentro de um compartilhamento de arquivos ou entre compartilhamentos de arquivos usando o seguinte método:

Você pode copiar um arquivo para um blob de destino usando o seguinte método de um BlockBlobClient objeto:

O exemplo de código a seguir mostra como copiar um arquivo para um arquivo em outro compartilhamento de arquivos:

import java.time.*;
import java.util.*;

import com.azure.core.credential.TokenCredential;
import com.azure.core.util.polling.*;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.storage.file.share.*;
import com.azure.storage.file.share.models.*;

// Add the following code to a new or existing function

String accountName = "<account-name>";
String srcShareName = "src-file-share";
String destShareName = "dest-file-share";
String srcFilePath = "src/path/to/file";
String destFilePath = "dest/path/to/file";

TokenCredential tokenCredential = new DefaultAzureCredentialBuilder().build();

ShareFileClient srcShareFileClient = new ShareFileClientBuilder()
    .endpoint(String.format("https://%s.file.core.windows.net", accountName))
    .shareName(srcShareName)
    .shareTokenIntent(ShareTokenIntent.BACKUP)
    .resourcePath(srcFilePath)
    .credential(defaultAzureCredential)
    .buildFileClient();

ShareFileClient destShareFileClient = new ShareFileClientBuilder()
    .endpoint(String.format("https://%s.file.core.windows.net", accountName))
    .shareName(destShareName)
    .shareTokenIntent(ShareTokenIntent.BACKUP)
    .resourcePath(destFilePath)
    .credential(defaultAzureCredential)
    .buildFileClient();

// Copy the file from the source share to the destination share
SyncPoller<ShareFileCopyInfo, Void> poller = destShareFileClient
        .beginCopy(srcShareFileClient.getFileUrl(),
                Collections.singletonMap("file", "metadata"),
                Duration.ofSeconds(2));

final PollResponse<ShareFileCopyInfo> pollResponse = poller.poll();
final ShareFileCopyInfo value = pollResponse.getValue();
System.out.printf("Copy source: %s. Status: %s.%n", value.getCopySourceUrl(), value.getCopyStatus());

Exemplo: Conceder um arquivo usando a biblioteca de cliente de Compartilhamentos de Arquivos

Uma concessão cria um bloqueio em um arquivo gerenciado pelo Azure por meio de uma ID de concessão. A concessão fornece um mecanismo para coordenar o acesso a arquivos em vários clientes em um sistema distribuído. Uma concessão em um arquivo fornece acesso exclusivo de gravação e exclusão. Para saber mais sobre estados e ações de concessão, consulte Arquivo de concessão.

O exemplo de código a seguir mostra como criar um cliente de concessão, adquirir uma concessão de duração infinita em um arquivo e liberar a concessão:

import com.azure.core.credential.TokenCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.storage.file.share.*;
import com.azure.storage.file.share.models.*;
import com.azure.storage.file.share.specialized.*;

// Add the following code to a new or existing function

String accountName = "<account-name>";
String shareName = "sample-file-share";
String filePath = "path/to/file";
        
TokenCredential defaultAzureCredential = new DefaultAzureCredentialBuilder().build();

ShareFileClient fileClient = new ShareFileClientBuilder()
    .endpoint(String.format("https://%s.file.core.windows.net", accountName))
    .shareName(shareName)
    .shareTokenIntent(ShareTokenIntent.BACKUP)
    .resourcePath(filePath)
    .credential(defaultAzureCredential)
    .buildFileClient();

// Get a ShareLeaseClient
ShareLeaseClient fileLeaseClient = new ShareLeaseClientBuilder()
        .fileClient(fileClient)
        .shareTokenIntent(ShareTokenIntent.BACKUP)
        .buildClient();
        
try {
    // Acquire a lease on the file with infinite duration
    fileLeaseClient.acquireLease();
    System.out.println("Lease acquired successfully");
            
    // Do something with the file

} catch (Exception e) {
    System.err.println("Error: " + e.getMessage());
} finally {
    // Release the lease when finished
    try {
        fileLeaseClient.releaseLease();
        System.out.println("Lease released successfully.");
    } catch (Exception e) {
        System.err.println(e.getMessage());
    }
}

Ao usar o SMB e a API FileREST, lembre-se de que a API FileREST usa concessões para gerenciar bloqueios de arquivos, enquanto o SMB usa bloqueios do sistema de arquivos gerenciados pelo sistema operacional. Para saber mais sobre como gerenciar interações de bloqueio de arquivos entre o SMB e a API FileREST, consulte Gerenciar bloqueios de arquivos.

Exemplo: Criar e listar instantâneos de compartilhamento usando a biblioteca de cliente de Compartilhamentos de Arquivos

Os instantâneos de partilha são cópias só de leitura de uma partilha de ficheiros num determinado momento. Você pode criar um instantâneo de um compartilhamento de arquivos e, em seguida, usá-lo para acessar os dados no compartilhamento no momento em que o instantâneo foi criado. Você também pode listar todos os instantâneos numa partilha de ficheiros e eliminar instantâneos de partilha.

O exemplo de código a seguir mostra como criar um instantâneo de compartilhamento, listar os instantâneos em um compartilhamento de arquivos e percorrer a árvore de diretórios em um instantâneo de compartilhamento:

import com.azure.storage.file.share.*;
import com.azure.storage.file.share.models.*;

// Add the following code to a new or existing function

public static void main(String[] args) {
    String connectionString = "<connection-string>";

    // Create a ShareServiceClient from which you can create clients for specific shares
    ShareServiceClient shareServiceClient = new ShareServiceClientBuilder()
    .connectionString(connectionString)
        .buildClient();
        
    // Get a client for a specific share
    ShareClient shareClient = shareServiceClient.getShareClient("sample-file-share");

    try {
        // Create a snapshot
        ShareSnapshotInfo snapshotInfo = shareClient.createSnapshot();
        System.out.println("Snapshot created: " + snapshotInfo.getSnapshot());

        // List snapshots in a share
        ListSharesOptions options = new ListSharesOptions()
            .setIncludeSnapshots(true);
                
        for (ShareItem shareItem : shareServiceClient.listShares(options, null, null)) {
            if (shareItem.getSnapshot() != null) {
                System.out.println("Share: " + shareItem.getName() + 
                    " (Snapshot: " + shareItem.getSnapshot() + ")");
            }
        }

        // List directories and files in a share snapshot
        String snapshotTimestamp = snapshotInfo.getSnapshot();
        ShareClient shareSnapshot = shareClient.getSnapshotClient(snapshotTimestamp);
        ShareDirectoryClient rootDir = shareSnapshot.getRootDirectoryClient();

        listDirectoryTree(rootDir);
            
    } catch (Exception e) {
        System.err.println("Error: " + e.getMessage());
    }
 }
    
private static void listDirectoryTree(ShareDirectoryClient directory) {
    // List all files and directories in current directory
    for (ShareFileItem fileItem : directory.listFilesAndDirectories()) {
        if (fileItem.isDirectory()) {
            System.out.println("Directory: " + fileItem.getName());
            // Recursively list subdirectory contents
            listDirectoryTree(directory.getSubdirectoryClient(fileItem.getName()));
        } else {
            System.out.println("File: " + fileItem.getName());
        }
    }
}

Observação

Os tokens OAuth, como os obtidos ao utilizar DefaultAzureCredential, não são permitidos para operações na camada de dados ao nível de partilha de ficheiros. Para trabalhar com instantâneos de compartilhamento, o objeto cliente deve ser autorizado usando a chave de conta. O ShareClient objeto criado neste exemplo de código usa uma cadeia de conexão, que inclui a chave de conta.

O armazenamento de chaves de conta ou cadeias de conexão representa um risco de segurança. Você só deve usá-los quando a autenticação do Microsoft Entra não estiver disponível. Para saber mais sobre como armazenar chaves de conta com segurança no Cofre de Chaves do Azure, consulte Sobre chaves de conta de armazenamento gerenciado do Cofre de Chaves do Azure.

Gerir recursos de Ficheiros do Azure usando as bibliotecas de gestão do Armazenamento do Azure

As bibliotecas de gerenciamento de Armazenamento do Azure são criadas na API REST do provedor de recursos de Armazenamento do Azure. O provedor de recursos do Armazenamento do Azure é um serviço baseado no Gerenciador de Recursos do Azure e dá suporte aos métodos declarativo (modelos) e imperativo (chamada direta de API). A API REST do provedor de recursos do Armazenamento do Azure fornece acesso programático aos recursos do Armazenamento do Azure, incluindo compartilhamentos de arquivos. O SDK do Azure fornece bibliotecas de gerenciamento que se baseiam na API REST do provedor de recursos de Armazenamento do Azure.

As bibliotecas de gerenciamento são recomendadas para operações executadas no nível de serviço oucompartilhamento de arquivos . Nesta seção, você aprenderá a usar as bibliotecas de gerenciamento do Armazenamento do Azure para gerenciar recursos do Azure Files.

As bibliotecas de gerenciamento de Armazenamento do Azure são criadas na API REST do provedor de recursos de Armazenamento do Azure. O provedor de recursos do Armazenamento do Azure é um serviço baseado no Gerenciador de Recursos do Azure e dá suporte aos métodos declarativo (modelos) e imperativo (chamada direta de API). A API REST do provedor de recursos do Armazenamento do Azure fornece acesso programático aos recursos do Armazenamento do Azure, incluindo compartilhamentos de arquivos. O SDK do Azure fornece bibliotecas de gerenciamento que se baseiam na API REST do provedor de recursos de Armazenamento do Azure.

As bibliotecas de gerenciamento são recomendadas para operações executadas no nível de serviço oucompartilhamento de arquivos . Nesta seção, você aprenderá a usar as bibliotecas de gerenciamento do Armazenamento do Azure para gerenciar recursos do Azure Files.

Exemplo: Criar um compartilhamento de arquivos usando a biblioteca de gerenciamento de Armazenamento do Azure

O exemplo de código a seguir mostra como criar um objeto de nível AzureResourceManager superior, registrar o provedor de recursos de armazenamento com uma assinatura e criar um compartilhamento de arquivos usando a biblioteca de gerenciamento de armazenamento do Azure:

import com.azure.identity.*;
import com.azure.resourcemanager.*;
import com.azure.resourcemanager.storage.fluent.*;
import com.azure.resourcemanager.storage.fluent.models.*;

import com.azure.core.credential.TokenCredential;
import com.azure.core.management.*;
import com.azure.core.management.profile.*;

// Add the following code to a new or existing function

String subscriptionID = "<subscription-id>";
String rgName = "<resource-group-name>";
String saName = "<storage-account-name>";
TokenCredential credential = new DefaultAzureCredentialBuilder().build();
AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);

AzureResourceManager armClient = AzureResourceManager
        .configure()
        .authenticate(credential, profile)
        .withSubscription(subscriptionID);

// Check the registration state of the resource provider and register, if needed
if (armClient.providers().getByName("Microsoft.Storage").registrationState() == "NotRegistered")
    armClient.providers().register("Microsoft.Storage");

// Create a new file share

StorageManagementClient storageManagementClient = armClient.storageAccounts().manager().serviceClient();
FileSharesClient fileShare = storageManagementClient.getFileShares();

String shareName = "sample-file-share";
int quotaInGB = 1;
        
// Create the file share
fileShare.create(
    rgName,
    saName,
    shareName,
    new FileShareInner()
        .withShareQuota(quotaInGB)
);

Você pode configurar as propriedades de compartilhamento de arquivos usando a classe FileShareInner . O exemplo anterior mostra como definir a cota de compartilhamento ao criar o compartilhamento de arquivos. Para atualizar um compartilhamento de arquivos existente, chame fileShare.update() e passe o FileShareInner objeto com as propriedades que você deseja atualizar.

Observação

Para executar a operação de registro, você precisa de permissões para a seguinte ação do RBAC do Azure: Microsoft.Storage/register/action. Essa permissão está incluída nas funções predefinidas de Colaborador e Proprietário.

Exemplo: Listar partilhas de ficheiros e instantâneos usando a biblioteca de gestão de Armazenamento do Azure

O exemplo de código a seguir mostra como listar compartilhamentos de arquivos e instantâneos em uma conta de armazenamento:

import com.azure.identity.*;
import com.azure.resourcemanager.*;
import com.azure.resourcemanager.storage.fluent.*;
import com.azure.resourcemanager.storage.fluent.models.*;

import com.azure.core.credential.TokenCredential;
import com.azure.core.http.rest.PagedIterable;
import com.azure.core.management.*;
import com.azure.core.management.profile.*;
import com.azure.core.util.Context;

// Add the following code to a new or existing function

String subscriptionID = "<subscription-id>";
String rgName = "<resource-group-name>";
String saName = "<storage-account-name>";
TokenCredential credential = new DefaultAzureCredentialBuilder().build();
AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);

AzureResourceManager armClient = AzureResourceManager
        .configure()
        .authenticate(credential, profile)
        .withSubscription(subscriptionID);

// Check the registration state of the resource provider and register, if needed
if (armClient.providers().getByName("Microsoft.Storage").registrationState() == "NotRegistered")
    armClient.providers().register("Microsoft.Storage");

StorageManagementClient storageManagementClient = armClient.storageAccounts().manager().serviceClient();
FileSharesClient fileShare = storageManagementClient.getFileShares();

// List all file shares and include snapshots

PagedIterable<FileShareItemInner> fileShares = fileShare.list(
    rgName,               // resource group name
    saName,               // storage account name
    null,                 // maxpagesize
    null,                 // filter
    "snapshots",          // expand to include snapshots
    Context.NONE);        // context

for (FileShareItemInner fileShareItem : fileShares) {
    System.out.println("File share name: " + fileShareItem.name());
    System.out.println("File share quota: " + fileShareItem.shareQuota());
}

Próximos passos

Para obter mais informações sobre como desenvolver com o Azure Files, consulte os seguintes recursos:

  • Last updated on