Compartilhar via


API REST Arquivos do Azure

Arquivos do Azure fornece compartilhamentos de arquivos de nuvem hospedados que você pode acessar (montagem) usando protocolos de sistema de arquivos padrão do setor, como SMB e NFS. Quando você monta um compartilhamento de arquivos em seu computador usando SMB ou NFS, seu sistema operacional redireciona solicitações de API para o sistema de arquivos local. O redirecionamento inclui solicitações de API locais que você faz usando interfaces .NET System.IO ou métodos de abertura, leitura ou gravação do Python. Isso significa que os usuários desses aplicativos não precisam fazer nada especial ou mesmo saber que seus dados estão em um compartilhamento de arquivos remoto em vez de armazenamento local.

Arquivos do Azure também fornece uma API REST, que geralmente é chamada de API FileREST. Para usar a API FileREST, crie solicitações HTTPS nos pontos de extremidade HTTPS FileREST. Você pode escrever código para criar solicitações HTTPS por conta própria, mas fornecemos SDKs do Azure que usam a API FileREST para você, fornecendo um wrapper de linguagem idiomática sobre a API FileREST em linguagens populares como C#, Java, Python, JavaScript e Go.

Como a API FileREST foi projetada especificamente para Arquivos do Azure, ela permite que você acesse recursos de Arquivos do Azure que você não pode acessar por SMB ou NFS. Ele também permite que você execute determinadas operações, como copiar, com mais eficiência do que você pode por meio de SMB ou NFS.

A natureza sem estado do HTTPS torna a API FileREST útil para serviços de nuvem ou aplicativos que precisam acessar muitos compartilhamentos de arquivos do Azure. Por exemplo, você pode anexar serviços ou aplicativos de valor agregado a um compartilhamento de arquivos do Azure para adicionar uma funcionalidade. Esses serviços ou aplicativos podem incluir produtos antivírus, backup, gerenciamento de dados ou replicação. Sincronização de Arquivos do Azure e Backup do Azure são serviços notáveis da Microsoft que usam extensivamente a API FileREST para adicionar valor sobre um compartilhamento de arquivos do Azure de propriedade do cliente.

Considere usar a API FileREST se você estiver criando serviços ou aplicativos com valor agregado, especialmente se você estiver fornecendo esses serviços aos clientes. Se você estiver construindo um aplicativo de linha de negócios, particularmente um que os usuários usarão em um compartilhamento de arquivos do Azure montado, você poderá usar SMB/NFS ou FileREST. No entanto, você pode descobrir que o uso de SMB ou NFS fornece um caminho mais fácil porque esses protocolos permitem que você use APIs nativas do sistema de arquivos.

Se você tiver um aplicativo existente escrito com APIs nativas do sistema de arquivos, não precisará reescrevê-lo para aproveitar Arquivos do Azure. A proposta de valor-chave de Arquivos do Azure é expor APIs nativas do sistema de arquivos por meio do uso de SMB ou NFS.

Para saber mais sobre Arquivos do Azure, incluindo implantação, rede e configuração de identidade, consulte:

Painel de controle

No Azure, o plano de controle é fornecido por meio do Resource Manager do Azure, que fornece uma maneira comum de expor os recursos do Azure que o cliente gerenciará. A unidade de gerenciamento de nível superior é a conta de armazenamento. A conta de armazenamento é um recurso rastreado em Arquivos do Azure e em outros serviços de armazenamento, como Armazenamento de Blobs do Azure.

A conta de armazenamento é gerenciada pelo provedor de recursos de armazenamento, que tem o namespace Microsoft.Storage. O provedor de recursos de armazenamento também expõe o gerenciamento de recursos filho ou de proxy que permitem o gerenciamento dos serviços de armazenamento agrupados na conta de armazenamento. Para Arquivos do Azure, há dois recursos de proxy relevantes:

  • O recurso FileService. Ele fornece configurações específicas para Arquivos do Azure que se aplicam a todos os compartilhamentos de arquivos na conta de armazenamento. O FileService recurso é um filho da conta de armazenamento. Uma conta de armazenamento sempre tem apenas um FileService recurso: default.

  • O recurso FileShare. Ele representa um compartilhamento de arquivo ou um instantâneo de um compartilhamento de arquivos. O FileShare recurso é um filho do FileService recurso e pode conter um número infinito de compartilhamentos de arquivos.

Embora um FileService recurso possa conter um número infinito de FileShare recursos, usar um número muito grande não é uma boa ideia porque tudo em uma conta de armazenamento compartilha um pool definido de E/S, largura de banda e outros limites. Para obter mais informações, confira Metas de desempenho e escalabilidade de Arquivos do Azure.

Para saber como chamar as APIs do painel de controle, confira:

As operações nos FileService objetos e FileShare também podem ser feitas por meio do plano de dados. Este é um artefato de Arquivos do Azure antes da Resource Manager do Azure. Embora essas APIs tenham suporte total, na maioria dos casos você deve usar as APIs do provedor de recursos de armazenamento para gerenciar Arquivos do Azure por estes motivos:

  • As operações expostas por meio do Azure Resource Manager usam Microsoft Entra ID para autenticação e autorização, para que você possa gerenciar Arquivos do Azure usando o RBAC (controle de acesso baseado em função). Você pode autorizar seu aplicativo ou serviço a chamar programaticamente essas APIs com uma entidade de serviço Microsoft Entra.

  • Você pode chamar as APIs de Resource Manager do Azure de forma imperativa por meio da API REST diretamente ou por meio de um SDK. Ou você pode chamá-los declarativamente, declarando quais recursos precisam ser implantados por meio de modelos do Azure. Para recursos que precisam ser criados juntos repetidamente (por exemplo, em implantações de serviço), o uso de modelos pode simplificar consideravelmente o trabalho necessário.

  • Embora seja recomendável usar o provedor de recursos de armazenamento para gerenciar recursos de armazenamento, o uso das APIs de gerenciamento do plano de dados FileREST fornecerá melhor desempenho em casos que exigem alta escala. Um exemplo desse caso é uma carga de trabalho que cria ou modifica milhares de compartilhamentos de arquivos na mesma conta de armazenamento.

    • Microsoft.Storage storageAccounts/fileServices/shares dispara uma operação do plano de controle por meio do provedor de recursos de armazenamento.
    • Microsoft.Storage storageAccounts/fileServices/fileshares é uma operação de plano de dados. Definir funções de nível de compartilhamento, como Leitor de Compartilhamento SMB de Dados de Arquivo de Armazenamento , deve ser uma operação de plano de dados e deve usar esse recurso.

Plano de dados

Arquivos do Azure fornece um sistema de arquivos hierárquico para dados não estruturados. A API FileREST modela os dois objetos importantes no espaço do sistema de arquivos: arquivos e diretórios. Para saber como chamar as APIs FileREST, confira:

Confira também