DescribeDirQuotas - File Storage NAS: Central de Documentação do Alibaba Cloud

Consulta os detalhes das cotas de diretório em um sistema de arquivos.

Descrição da operação

Apenas os sistemas de arquivos NFS do NAS de uso geral suportam o recurso de cota de diretório.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

nas:DescribeDirQuotas

list

*FileSystem.

acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
FileSystemId	string	Sim	O ID do sistema de arquivos.	1ca404****
Path	string	Não	O caminho absoluto do diretório no sistema de arquivos. Se este parâmetro for deixado em branco, todos os diretórios para os quais as cotas estão configuradas no sistema de arquivos serão retornados.	/data/sub1
PageSize	integer	Não	O número de diretórios por página. Valor padrão: 10. Valores válidos: 1 a 100.	1
PageNumber	integer	Não	O número da página. Valor padrão: 1.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalCount	integer	O número total de diretórios.	1
DirQuotaInfos	array<object>	As informações de cota de cada diretório.
	array<object>
Status	string	O status estatístico do diretório. Valores válidos: Initializing: O diretório está sendo inicializado. Normal: O diretório está em um estado normal.	Normal
Path	string	O caminho absoluto do diretório no sistema de arquivos.	/data/sub1
DirInode	string	O número do inode do diretório.	1123
UserQuotaInfos	array<object>	As informações de cota de cada usuário.
	object
FileCountReal	integer	O número real de arquivos do usuário no diretório.	5100
UserType	string	O tipo de ID do usuário. Valores válidos: Uid: O ID do usuário é um UID. Se este valor for retornado, o parâmetro UserId terá um valor. Gid: O ID do usuário é um GID. Se este valor for retornado, o parâmetro UserId terá um valor. AllUsers: A cota se aplica a todos os usuários. Se este valor for retornado, o parâmetro UserId estará vazio.	Uid
FileCountLimit	integer	O limite do número de arquivos do usuário no diretório.	10000
UserId	string	O UID ou GID ao qual a cota se aplica. O valor depende do parâmetro UserType.	500
SizeLimit	integer	O limite do tamanho total dos arquivos do usuário no diretório. Unidade: GiB.	1024
QuotaType	string	O tipo de cota. Valores válidos: Accounting: cota estatística. Enforcement: cota de restrição.	Accounting
SizeReal	integer	O tamanho total real dos arquivos do usuário no diretório. Unidade: GiB.	800
SizeRealInByte	integer	O tamanho total real dos arquivos do usuário no diretório. Unidade: bytes.	858995833870
RequestId	string	O ID da solicitação.	5BC5CB97-9F28-42FE-84A4-0CD0DF42****
PageSize	integer	O número de diretórios por página.	1
PageNumber	integer	O número da página.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 1,
  "DirQuotaInfos": [
    {
      "Status": "Normal",
      "Path": "/data/sub1",
      "DirInode": "1123",
      "UserQuotaInfos": [
        {
          "FileCountReal": 5100,
          "UserType": "Uid",
          "FileCountLimit": 10000,
          "UserId": "500",
          "SizeLimit": 1024,
          "QuotaType": "Accounting",
          "SizeReal": 800,
          "SizeRealInByte": 858995833870
        }
      ]
    }
  ],
  "RequestId": "5BC5CB97-9F28-42FE-84A4-0CD0DF42****",
  "PageSize": 1,
  "PageNumber": 1
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.