Get File Info_API_Object Storage-CDNetworks ドキュメント

このインターフェースは、オブジェクトストレージプラットフォーム上のファイル情報（ファイル名、ファイルサイズ、ETag情報、アップロード日時、有効期限など）を取得するために使用します。

リクエスト説明

リクエスト形式

GET /stat/{param1}
Host:<MgrDomain>
Authorization:<AccessToken>

{param1} の生成ルールについては EncodeEntryURI format をご参照ください。

ヘッダー説明

パラメータ	必須	説明
Host	はい	管理ドメイン名。コンソールのバケット概要画面で取得可。
Authorization	はい	管理認証情報。

レスポンス説明

リクエストが成功した場合、下記のようなJSON文字列が返されます。

x-wcs-object-type: Appendable
x-wcs-next-append-positon: <Content-Length int64>
{
    "result":  "true",
    "code":  "200",
    "name":  "<ファイル名 string>",
    "message":  "<メッセージ string>",
    "fsize":     "<ファイルサイズ int>", 
    "hash":     "<ファイル ETag string>",
    "mimeType":  "<MimeType string>",
    "putTime":    "<アップロード時刻 int64>",
    "expirationDate":   "<有効期限 string>",
    "storageClass": "<ストレージタイプ>"
}

フィールド名	必須	説明
x-wcs-object-type	いいえ	オブジェクトタイプ条件：appendで保存されたオブジェクト時にこのヘッダーが「Appendable」固定値で返却されます。
x-wcs-next-append-position	いいえ	次回append位置（オブジェクトサイズ）。append型オブジェクト取得時のみ返却されます。
code	はい	リクエストのステータスコード。HTTP応答ステータスコード参照
name	はい	ファイル名
message	はい	正常取得時のメッセージ
fsize	はい	ファイルサイズ（単位: Byte）
hash	はい	ファイルのETag情報
mimeType	はい	MIMEファイルタイプ。MIME Media Types参照
putTime	はい	ファイルアップロード時のサーバー側エポックタイムスタンプ（ミリ秒単位）。例：`13603956734587420` ⇒ 2013-02-09 15:41:13
expirationDate	はい	ファイルの有効期限。書式: YYYYMMDDhhmmss ※有効期限後、実際のファイル削除タイミングはサーバー側の実行状況により1日程度のズレが発生する場合があります。
storageClass	はい	ファイルストレージタイプ（例：Standard＝標準、IA＝低頻度、Archive＝アーカイブ）
result	はい	処理の成否。`"true"` で成功を表します

リクエスト失敗時は、下記のようなJSON文字列が返却されます：

{
    "code":     "<code string>",
    "message":  "<ErrMsg string>"
}

フィールド名	必須	説明
code	はい	HTTPリクエストレスポンスコード。HTTP Response Status Codes参照
message	はい	ファイル情報取得失敗時のメッセージ

実行例

curl -v -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:OGZmYzQ0ZmM2MDU5N2FhZWRhMDhjNWNmZjcxZjE5MmEwNjUxOGU4Nw==" --url "http://mgrDomain/stat/aW1hZ2VzOmFmZGRkLnBuZw=="

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

Get File Info

リクエスト説明

レスポンス説明

実行例

目次