ファイルシステムのディレクトリクォータを照会します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 DescribeDirQuotas

実行する操作です。

値をDescribeDirQuotasに設定します。

FileSystemId String 必須 1ca404 ****

ファイルシステムの ID。

パス String 任意 /data/sub1

ディレクトリの絶対パス。

このパラメーターを指定しない場合、クォータが作成されたすべてのディレクトリが返されます。

PageSize Integer 任意 1

各ページで返されるエントリ数。 Default value: 10.

Valid values: 1 to 100.

PageNumber Integer 任意 1

返されるページ数。

ページ番号は 1 から始まります。 デフォルト値：1。

レスポンスパラメーター

パラメーター データ型 例 説明
TotalCount Integer 1

ディレクトリの総数。

DirQuotaInfos DirQuotaInfoの配列

すべてのディレクトリのクォータに関する情報。

ステータス String 通常

ディレクトリに対して作成されたクォータのステータス。

有効な値: InitializingとNormal。 初期化状態は、クォータが作成中であることを示します。 正常状態は、クォータが作成されたことを示します。

パス String /data/sub1

ディレクトリの絶対パス。

ディリノード String 1123

The inode number of the directory.

UserQuotaInfos UserQuotaInfoの配列

すべてのユーザーのクォータに関する情報。

FileCountReal Long 5100

ユーザーがディレクトリに作成したファイルの総数。

UserType String Uid

ユーザーIDのタイプ。 有効な値: Uid、Gid、およびAllUsers。

  • パラメーターがUidまたはGidに設定されている場合、UserIdパラメーターの値が返されます。
  • パラメーターがAllUsersに設定されている場合、UserIDパラメーターの値は空です。
FileCountLimit Long 10,000

ユーザーがディレクトリに作成できるファイルの最大数。

UserId String 500

ディレクトリのクォータを作成するために指定するユーザーのID。 この値は、UserTypeパラメーターの値によって異なります。 有効な値: UidとGid。

SizeLimit Long 1024

ユーザーがディレクトリに作成できるファイルの最大サイズ。 単位: GiB。

QuotaType String 会計

The type of the quota. 有効な値: 会計と執行。

SizeReal Long 800

ユーザーがディレクトリに作成したファイルの合計サイズ。 単位: GiB。

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

リクエストの ID です。

PageSize Integer 1

1 ページあたりで返されるエントリ数。

PageNumber Integer 1

返されたページの数です。

例

リクエストの例

http(s):// [エンドポイント]/?Action=DescribeDirQuotas
&FileSystemId=1ca404 ****
&パス=/data/sub1
&PageSize=1
&PageNumber=1
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

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

<DescribeDirQuotasResponse>
    <TotalCount>1</TotalCount>
    <DirQuotaInfos>
        <ステータス> 正常 </ステータス>
        <Path>/data/sub1</Path>
        <DirInode>1123</DirInode>
        <UserQuotaInfos>
            <FileCountReal>5100</FileCountReal>
            <UserType>Uid</UserType>
            <FileCountLimit>10000</FileCountLimit>
            <UserId>500</UserId>
            <SizeLimit>1024</SizeLimit>
            <QuotaType> 会計 </QuotaType>
            <SizeReal>800</SizeReal>
        </UserQuotaInfos>
    </DirQuotaInfos>
    <RequestId>5BC5CB97-9F28-42FE-84A4-0CD0DF42 ****</RequestId>
    <PageSize>1</PageSize>
    <PageNumber>1</PageNumber>
</DescribeDirQuotasResponse>

JSON 形式 

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

{
  "TotalCount" : 1、
  "DirQuotaInfos" : [ {
    "ステータス" : "正常" 、
    "パス" : "/data/sub1" 、
    "DirInode" : "1123" 、
    "UserQuotaInfos" : [ {
      "FileCountReal" : 5100、
      "UserType" : "Uid" 、
      "FileCountLimit" : 10000、
      "UserId" : "500" 、
      "SizeLimit" : 1024、
      "QuotaType" : "会計" 、
      "SizeReal" : 800
    } ]
  } ],
  "RequestId" : "5BC5CB97-9F28-42FE-84A4-0CD0DF42 ****" 、
  "PageSize" : 1、
  "PageNumber" : 1
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。