Ficheiros do Azure API REST

  • Artigo

Ficheiros do Azure fornece partilhas de ficheiros na cloud alojadas às quais pode aceder (montar) através de protocolos de sistema de ficheiros padrão da indústria, como SMB e NFS. Quando monta uma partilha de ficheiros no seu computador através de SMB ou NFS, o seu sistema operativo redireciona pedidos de API para o sistema de ficheiros local. O redirecionamento inclui pedidos de API locais que efetua com interfaces .NET System.IO ou métodos de leitura, leitura ou escrita do Python. Isto significa que os utilizadores destas aplicações não precisam de fazer nada de especial ou mesmo saber que os respetivos dados estão numa partilha de ficheiros remota em vez do armazenamento local.

Ficheiros do Azure também fornece uma API REST, que é frequentemente denominada API FileREST. Para utilizar a API FileREST, crie pedidos HTTPS nos pontos finais HTTPS fileREST. Pode escrever código para criar pedidos HTTPS, mas fornecemos SDKs do Azure que utilizam a API FileREST para si, fornecendo um wrapper de idioma idiomático através da API FileREST em idiomas populares como C#, Java, Python, JavaScript e Go.

Uma vez que a API FileREST foi concebida especificamente para Ficheiros do Azure, permite-lhe aceder a funcionalidades de Ficheiros do Azure às quais não pode aceder através de SMB ou NFS. Também lhe permite efetuar determinadas operações, como copiar, de forma mais eficiente do que pode através de SMB ou NFS.

A natureza sem estado do HTTPS torna a API FileREST útil para serviços cloud ou aplicações que precisam de aceder a muitas partilhas de ficheiros do Azure. Por exemplo, pode anexar serviços ou aplicações de valor acrescentado a uma partilha de ficheiros do Azure para adicionar uma capacidade. Estes serviços ou aplicações podem incluir produtos antivírus, cópia de segurança, gestão de dados ou replicação. Azure File Sync e Azure Backup são serviços Microsoft notáveis que utilizam extensivamente a API FileREST para adicionar valor a uma partilha de ficheiros do Azure pertencente ao cliente.

Considere utilizar a API FileREST se estiver a criar serviços ou aplicações de valor acrescentado, especialmente se estiver a fornecer esses serviços aos clientes. Se estiver a construir uma aplicação de linha de negócio, especialmente uma que os utilizadores utilizarão numa partilha de ficheiros do Azure montada, pode utilizar SMB/NFS ou FileREST. No entanto, poderá considerar que a utilização de SMB ou NFS fornece um caminho mais fácil, uma vez que esses protocolos lhe permitem utilizar APIs nativas do sistema de ficheiros.

Se tiver uma aplicação existente escrita com APIs do sistema de ficheiros nativo, não precisa de reescrevê-la para tirar partido das Ficheiros do Azure. A proposta de valor chave do Ficheiros do Azure é expor APIs nativas do sistema de ficheiros através da utilização de SMB ou NFS.

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

Plano de controlo

No Azure, o plano de controlo é fornecido através do Azure Resource Manager, que fornece uma forma comum de expor os recursos do Azure que o cliente irá gerir. A unidade de gestão de nível superior é a conta de armazenamento. A conta de armazenamento é um recurso controlado no Ficheiros do Azure e noutros serviços de armazenamento, como Armazenamento de Blobs do Azure.

A conta de armazenamento é gerida pelo fornecedor de recursos de armazenamento, que tem o espaço de nomes Microsoft.Storage. O fornecedor de recursos de armazenamento também expõe a gestão de recursos subordinados, ou recursos proxy, que permitem a gestão dos serviços de armazenamento agrupados na conta de armazenamento. Para Ficheiros do Azure, existem dois recursos de proxy relevantes:

  • O FileService recurso. Fornece definições específicas para Ficheiros do Azure que se aplicam a todas as partilhas de ficheiros na conta de armazenamento. O FileService recurso é um subordinado da conta de armazenamento. Uma conta de armazenamento tem sempre apenas um FileService recurso: default.

  • O FileShare recurso. Representa uma partilha de ficheiros ou um instantâneo de uma partilha de ficheiros. O FileShare recurso é subordinado do FileService recurso e pode conter um número infinito de partilhas de ficheiros.

Embora um FileService recurso possa conter um número infinito de recursos, a utilização de FileShare um número muito grande não é uma boa ideia, porque tudo numa conta de armazenamento partilha um conjunto definido de E/S, largura de banda e outros limites. Para obter mais informações, veja Ficheiros do Azure metas de escalabilidade e desempenho.

Para saber como chamar as APIs do plano de controlo, consulte:

As operações nos FileService objetos e FileShare também podem ser efetuadas através do plano de dados. Trata-se de um artefacto de Ficheiros do Azure pré-Resource Manager do Azure. Embora estas APIs sejam totalmente suportadas, na maioria dos casos deve utilizar as APIs do fornecedor de recursos de armazenamento para gerir Ficheiros do Azure por estes motivos:

  • As operações expostas através do Azure Resource Manager utilizam Microsoft Entra ID para autenticação e autorização, para que possa gerir Ficheiros do Azure com o controlo de acesso baseado em funções (RBAC). Pode autorizar a sua aplicação ou serviço a chamar estas APIs através de programação com um principal de serviço Microsoft Entra.

  • Pode chamar as APIs Resource Manager do Azure de forma imperativa através da API REST diretamente ou através de um SDK. Em alternativa, pode chamá-los declarativamente ao declarar que recursos precisam de ser implementados através de modelos do Azure. Para recursos que precisam de ser criados repetidamente em conjunto (por exemplo, em implementações de serviços), a utilização de modelos pode simplificar consideravelmente o trabalho necessário.

  • Embora recomendemos a utilização do fornecedor de recursos de armazenamento para gerir recursos de armazenamento, a utilização das APIs de gestão de planos de dados FileREST irá proporcionar-lhe um melhor desempenho em casos que exijam uma escala elevada. Um exemplo deste caso é uma carga de trabalho que cria ou modifica milhares de partilhas de ficheiros na mesma conta de armazenamento.

    • Microsoft.Storage storageAccounts/fileServices/shares aciona uma operação de plano de controlo através do fornecedor de recursos de armazenamento.
    • Microsoft.Storage storageAccounts/fileServices/fileshares é uma operação de plano de dados. Definir funções ao nível da partilha, como o Leitor de Partilha SMB de Dados de Ficheiros de Armazenamento , deve ser uma operação de plano de dados e tem de utilizar este recurso.

Plano de dados

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

Ver também