Todos os produtos
Search
Central de documentação

:DescribeDirQuotas

Última atualização: Jun 27, 2026

Consulta as cotas de diretório de um sistema de arquivos.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeDirQuotas

A operação que você deseja executar.

Defina o valor como DescribeDirQuotas.

FileSystemId

String

Sim

1ca404****

O ID do sistema de arquivos.

Path

String

Não

/data/sub1

O caminho absoluto de um diretório.

Caso você não especifique este parâmetro, todos os diretórios com cotas criadas serão retornados.

PageSize

Integer

Não

1

O número de entradas a serem retornadas em cada página. Valor padrão: 10.

Valores válidos: 1 a 100.

PageNumber

Integer

Não

1

O número da página a ser retornada.

A numeração começa na página 1. Valor padrão: 1.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
TotalCount Integer 1

O número total de diretórios.

DirQuotaInfos Array of DirQuotaInfo

As informações sobre as cotas de todos os diretórios.

Status String Normal

O status da cota criada para o diretório.

Valores válidos: Initializing e Normal. O estado Initializing indica que a cota está sendo criada. O estado Normal indica que a cota foi criada.

Path String /data/sub1

O caminho absoluto de um diretório.

DirInode String 1123

O número do inode do diretório.

UserQuotaInfos Array of UserQuotaInfo

As informações sobre as cotas de todos os usuários.

FileCountReal Long 5100

O número total de arquivos que um usuário criou no diretório.

UserType String Uid

O tipo de ID do usuário. Valores válidos: Uid, Gid e AllUsers.

  • Se o parâmetro for definido como Uid ou Gid, o valor do parâmetro UserId será retornado.
  • Se o parâmetro for definido como AllUsers, o valor do parâmetro UserID estará vazio.
FileCountLimit Long 10000

O número máximo de arquivos que um usuário pode criar no diretório.

UserId String 500

O ID do usuário especificado para criar uma cota no diretório. O valor depende do valor do parâmetro UserType. Valores válidos: Uid e Gid.

SizeLimit Long 1024

O tamanho máximo dos arquivos que um usuário pode criar no diretório. Unidade: GiB.

QuotaType String Accounting

O tipo da cota. Valores válidos: Accounting e Enforcement.

SizeReal Long 800

O tamanho total dos arquivos que um usuário criou no diretório. Unidade: GiB.

RequestId String 5BC5CB97-9F28-42FE-84A4-0CD0DF42****

O ID da solicitação.

PageSize Integer 1

O número de entradas retornadas por página.

PageNumber Integer 1

O número da página retornada.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DescribeDirQuotas
&FileSystemId=1ca404****
&Path=/data/sub1
&PageSize=1
&PageNumber=1
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDirQuotasResponse>
    <TotalCount>1</TotalCount>
    <DirQuotaInfos>
        <Status>Normal</Status>
        <Path>/data/sub1</Path>
        <DirInode>1123</DirInode>
        <UserQuotaInfos>
            <FileCountReal>5100</FileCountReal>
            <UserType>Uid</UserType>
            <FileCountLimit>10000</FileCountLimit>
            <UserId>500</UserId>
            <SizeLimit>1024</SizeLimit>
            <QuotaType>Accounting</QuotaType>
            <SizeReal>800</SizeReal>
        </UserQuotaInfos>
    </DirQuotaInfos>
    <RequestId>5BC5CB97-9F28-42FE-84A4-0CD0DF42****</RequestId>
    <PageSize>1</PageSize>
    <PageNumber>1</PageNumber>
</DescribeDirQuotasResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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
    } ]
  } ],
  "RequestId" : "5BC5CB97-9F28-42FE-84A4-0CD0DF42****",
  "PageSize" : 1,
  "PageNumber" : 1
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.