メインコンテンツまでスキップ

6.3.11 STATUS コマンド

引数 (Arguments):

  • メールボックス名
  • ステータスデータ項目名

応答 (Responses): 必須のタグなし応答:STATUS

結果 (Result):

  • OK - status 完了
  • NO - status 失敗:その名前のステータスがありません
  • BAD - コマンド不明または引数が無効

STATUS コマンドは、指定されたメールボックスのステータスを要求します。現在選択されているメールボックスは変更されず、クエリされたメールボックス内のメッセージの状態にも影響しません。

STATUS コマンドは、2 番目の IMAP4rev2 接続を開いてメールボックスに対して EXAMINE コマンドを実行し、最初の IMAP4rev2 接続で現在のメールボックスの選択を解除せずにそのメールボックスのステータスをクエリする代替手段を提供します。

LIST コマンドとは異なり、STATUS コマンドは応答が高速であることは保証されません。特定の状況下では、非常に遅くなる可能性があります。

現在定義されているステータスデータ項目:

MESSAGES - メールボックス内のメッセージ数。

UIDNEXT - メールボックスの次の一意識別子値。

UIDVALIDITY - メールボックスの一意識別子有効性値。

UNSEEN - \Seen フラグが設定されていないメッセージ数。

DELETED - \Deleted フラグが設定されているメッセージ数。

SIZE - メールボックスの合計サイズ (オクテット単位)。

例:

C: A042 STATUS blurdybloop (UIDNEXT MESSAGES)
S: * STATUS blurdybloop (MESSAGES 231 UIDNEXT 44292)
S: A042 OK STATUS completed