Todos os produtos
Search
Central de documentação

File Storage NAS:Cota de diretório

Última atualização: Oct 09, 2026

As cotas de diretório e as cotas de usuário limitam o número de arquivos e a capacidade de armazenamento consumidos em um diretório de um sistema de arquivos NAS de uso geral. Defina uma cota para monitorar o uso de um diretório compartilhado ou para impedir que um único usuário ou grupo de usuários preencha o diretório.

Pré-requisitos

  • Você criou um sistema de arquivos NAS de uso geral. Para mais informações, consulte Crie um sistema de arquivos.

  • Você adicionou um destino de montagem. Para mais informações, consulte Crie um destino de montagem.

  • Você criou um grupo de permissões e regras. Para mais informações, consulte Procedure.

  • Você montou o sistema de arquivos de acordo com o cenário de montagem e criou um diretório no sistema de arquivos. Para mais informações, consulte Mounting scenarios.

Tipo de cota

Classificação

Tipo de cota

Escopo das estatísticas de cota

  • Cota de diretório: coleta o uso do sistema de arquivos por todos os usuários em um diretório.

  • Cota de usuário (grupo): coleta o uso do sistema de arquivos por um usuário (grupo) específico em um diretório.

Nota

Somente os sistemas de arquivos NAS de uso geral com protocolo NFS suportam o recurso de cota de usuário (grupo).

Nível de restrição das cotas

  • Cota de contabilização: apenas coleta o uso do sistema de arquivos para consulta.

  • Cota de imposição: se você configurar uma cota de imposição para um diretório específico e o uso do sistema de arquivos exceder a cota, as operações, como criar arquivos ou diretórios e anexar dados, falharão.

Limites

  • Instâncias de sistema de arquivos

    • Sistemas de arquivos NAS de uso geral com protocolo NFS suportam cota de diretório e cota de usuário (grupo).

    • Sistemas de arquivos NAS de uso geral com protocolo SMB suportam o recurso de cota de diretório.

    • O Extreme NAS não suporta a cota de diretório.

  • Cotas

    • Em um único sistema de arquivos, você pode definir cotas para até 500 diretórios, com profundidade máxima de 8 níveis. (Por exemplo, o diretório raiz / tem profundidade 0, /workspace tem profundidade 1, /workspace/dir1 tem profundidade 2, e assim por diante.)

    • Para uma única cota de diretório, o número máximo de combinações de UID/GID é 500. Caso o limite seja excedido, podem ocorrer falhas de configuração ou anomalias de leitura.

    Importante
    • Após a definição de uma cota de imposição, se o uso de arquivos exceder o limite, as operações de gravação (como aumentar o tamanho do arquivo, criar arquivos e diretórios, e mover arquivos para diretórios) falharão, e a camada de aplicação receberá um IOError. Para saber como resolver, consulte Why does writing data to the file system return aDisk quota exceedederror message?.

    • Devido ao alto risco das cotas de imposição, recomendamos avaliar e testar cuidadosamente antes de configurá-las em caminhos críticos de negócios.

    • Após criar uma cota de diretório, um processo de inicialização é executado e o status passa a ser Initializing. A duração da inicialização depende da quantidade de arquivos e diretórios no sistema de arquivos e pode levar várias horas ou mais. Quando a inicialização é concluída, o status muda para Running. Visualize o status das cotas de diretório pelo console do NAS ou chamando a API DescribeDirQuotas.

    • O NAS executa as configurações de cota de forma assíncrona. Por isso, as cotas de imposição entram em vigor e expiram com atraso (normalmente de 5 a 15 minutos).

  • Regiões

    • Sistemas de arquivos NAS de uso geral com protocolo NFS: todas as regiões.

    • Sistemas de arquivos NAS de uso geral com protocolo SMB: todas as regiões, exceto China South 1 Finance.

Criar uma cota de diretório

  1. Acesse o console do NAS.

  2. No painel de navegação à esquerda, escolha File System > File System List.

  3. Na barra de navegação superior, selecione o grupo de recursos e a região do seu sistema de arquivos.

  4. Encontre o sistema de arquivos de destino e clique no ID do sistema de arquivos ou em Manage para acessar a página Quota Management. Em seguida, clique em Create Directory Quota.

  5. Na caixa de diálogo Create Directory Quota, configure o Directory Path para adicionar o diretório.

    Importante
    • Você só pode definir cotas para diretórios que já existem no sistema de arquivos NAS de uso geral. O directory path da cota é o caminho absoluto do diretório no sistema de arquivos NAS de uso geral, e não o caminho local em um nó de computação (por exemplo, ECS ou contêiner).

    • Não há suporte para diretórios com caracteres chineses no nome do caminho.

    Por exemplo, se o caminho de montagem local do NAS de uso geral for /mnt, e o diretório raiz no sistema de arquivos for / com um subdiretório de primeiro nível /dir0 e um subdiretório de segundo nível /dir/subdir1, os caminhos para configurar cotas no diretório raiz e nos subdiretórios de primeiro e segundo nível são os seguintes:

    • Diretório raiz: /

    • Subdiretório de primeiro nível: /dir0

    • Subdiretório de segundo nível: /dir/subdir1

    Configure o file system ID e clique em OK. O NAS executa as configurações de cota de forma assíncrona. As cotas de imposição entram em vigor e expiram com atraso (normalmente de 5 a 15 minutos).

  6. Visualize o status da cota de diretório.

    Após criar uma cota de diretório, um processo de inicialização é executado e o status passa a ser Initializing. A duração da inicialização depende da quantidade de arquivos e diretórios no sistema de arquivos e pode levar várias horas ou mais. Quando a inicialização é concluída, o status muda para Running. Além disso, o sistema gera automaticamente uma entrada de cota de usuário na lista de cotas de usuário, com o tipo de usuário definido como All Users e o tipo de cota como Accounting. Nessa cota de usuário, você só pode modificar o tipo de cota, e não o tipo de usuário.

Adicionar uma cota de usuário

Quando o tipo de cota de usuário é de contabilização, o sistema coleta o uso e a contagem de arquivos de um usuário (grupo) no diretório. Quando o tipo é de imposição, a cota limita a capacidade e a contagem de arquivos que um usuário (grupo) pode usar no diretório.

Nota
  • Somente os sistemas de arquivos NAS de uso geral com protocolo NFS suportam o recurso de cota de usuário (grupo).

  • Você pode configurar apenas um tipo de cota para um único tipo de usuário.

Procedimento

Na seção Quota Management, encontre o caminho do diretório de destino e clique em Manage Quotas. No painel exibido, clique em Assign Quota to User e configure as informações relevantes na caixa de diálogo. Na caixa de diálogo Add User Quota, File System ID e Directory Path são campos somente leitura. Configure os parâmetros restantes conforme necessário.

Parâmetro

Obrigatório

Descrição

User Type

Sim

Especifique o tipo de ID de usuário, incluindo Uid, Gid e All Users, que restringem, respectivamente, usuários, grupos de usuários e todos os usuários. No mesmo caminho, você pode definir cotas diferentes para vários usuários.

ID

Não

Configure este parâmetro quando o User Type estiver definido como Uid ou Gid. Especifique o usuário ou grupo de usuários a ser restringido.

Por exemplo:

  • Para restringir o usuário com Uid=500, defina o tipo de usuário como Uid e o ID como 500.

  • Para restringir o grupo de usuários com Gid=100, defina o tipo de usuário como Gid e o ID como 100.

Quota Type

Sim

  • Statistical: apenas coleta o uso do sistema de arquivos no caminho de diretório especificado.

  • Restrictive: além de coletar e exibir estatísticas, restringe a E/S após a cota ser excedida.

Capacity Limit (GiB)

Não

Configure este parâmetro quando o Quota Type estiver definido como Restrictive. Especifique a capacidade máxima de armazenamento de arquivos e diretórios pertencentes ao usuário da cota no caminho da cota.

Nota
  • A capacidade mínima de armazenamento é 0 GiB e a máxima é 10.000.000 GiB.

  • Você deve especificar pelo menos um dos limites: capacidade ou contagem de arquivos.

File Limit

Não

Configure este parâmetro quando o Quota Type estiver definido como Restrictive. Especifique o número máximo de arquivos e diretórios pertencentes ao usuário da cota no caminho da cota.

Nota
  • Você deve especificar pelo menos um dos limites: capacidade ou contagem de arquivos.

  • A contagem mínima de arquivos é 1 e a máxima é 1.000.000.000.

Excluir uma única cota de usuário

Na lista de cotas de usuário, encontre a entrada da cota de destino e clique em Delete.

Importante

Ao excluir um diretório com cota configurada no sistema de arquivos, o NAS também exclui as entradas correspondentes nas listas de cotas de diretório e de usuário.

Editar uma única cota de usuário

Na lista de cotas de usuário, encontre a entrada da cota de destino e clique em Edit. As opções editáveis incluem tipo de cota, limite de capacidade e limite de contagem de arquivos.

Nota

Você só pode editar o limite de capacidade e o limite de contagem de arquivos quando o tipo de cota for de imposição, e deve editar pelo menos um deles.

API

O recurso de gerenciamento de cotas oferece as seguintes operações de API:

FAQ

Por que a gravação de dados no sistema de arquivos retorna a mensagem de erroDisk quota exceeded?

  • Causa

    O uso ou a contagem de arquivos do diretório de destino excedeu o limite da cota de usuário configurada. Como resultado, as operações de gravação (como aumentar o tamanho do arquivo, criar arquivos e diretórios, e mover arquivos para diretórios) falham, e o sistema retorna uma mensagem de erro semelhante a Disk quota exceeded.

  • Solução

    1. Recomendamos limpar os dados para liberar espaço ou aumentar o limite de capacidade do diretório o mais rápido possível. Para mais informações, consulte Edite uma única cota de usuário.

    2. Após concluir a limpeza, execute primeiro operações de gravação de teste no diretório com a cota (por exemplo, crie e grave dados em um arquivo de teste) para acionar a atualização assíncrona do cache de cota. Verifique se essas operações de gravação de teste foram bem-sucedidas antes de reiniciar o seu serviço.