Statistics_API_Object Storage-CDNetworks ドキュメント

機能説明

統計APIインターフェースには以下の機能があります。

1分単位でPUT/POSTリクエストの成功件数を取得できます。
1分単位でアップロード成功時の帯域幅を取得できます。
1時間単位でストレージ使用量およびオブジェクト数を取得できます。
リクエストパラメータをURL経由で渡すことができます。

リクエスト形式

GET /bucketname?statistics&type=requests&method=PUT&startTime=201707200244 HTTP/1.1
Host: Bucket.Endpoint
Date: Date
Authorization: Authorization

リクエストパラメータ

インターフェースのパラメータは以下の通りです。

名前	説明	必須
type	統計の種別。指定可能値：requests（リクエスト数）、bandwidth、ObjectNum（オブジェクト数）	Yes
startTime	統計の開始時刻（分単位で指定）。 endTimeを指定する場合、startTimeからendTimeまでを統計します。startTimeとendTimeの間隔は1週間以内である必要があります。形式：YYYYMMDDhhmmss	Yes
endTime	統計対象の終了時刻。形式：YYYYMMDDhhmmss	no
method	監視対象のリクエストメソッド。このパラメータはオブジェクト数を問合せる場合には効果がありません。指定可能値：PUT /POST	Yes

リクエストヘッダー

共通リクエストヘッダーをご利用ください。

リクエストボディ

リクエストボディは不要です。

レスポンス形式

HTTP/1 status_code
x-amz-request-id: request id
Date: date
Content-Type: type
Content-Length: length

<?xml version=”0” encoding=”UTF-8” standalone=”yes”?>
<StatisticsResult xmlns=” http://wcs.chinanetcenter.com/document”>
	<Owner>Owner<Owner>
	<Bucket>Bucket</Bucket>
		<Type>Type</Type>
		<Operation >Operation </Operation >
		<StartTime>StartTime</StartTime>
		<EndTime>EndTime</EndTime>
		<Results time="2017-07-23 02:44">2472</Results>
		<Results time="2017-07-23 02:45">2546</Results>
……
</StatisticsResult>

レスポンスヘッダー

共通レスポンスヘッダーをご利用ください。

レスポンスボディ

レスポンスに含まれる各要素の説明は以下の通りです。

フィールド名	説明
StatisticsResult	レスポンスのルートノード。子ノード：Owner、Bucket、Type、StartTime、EndTime、Results 型：XML 親ノード：なし
Owner	バケットオーナー。子ノード：なし親ノード：StatisticsResult 型：文字列
Bucket	バケット名。子ノード：なし親ノード：StatisticsResult 型：文字列
Type	統計の種別。子ノード：なし親ノード：StatisticsResult 型：文字列（requests/bandwidth/ObjectNum）
Operation	リクエストメソッド。子ノード：なし親ノード：StatisticsResult 型：文字列（PUT/POST） ※オブジェクト数取得時は空
StartTime	統計の開始時刻。子ノード：なし親ノード：StatisticsResult 型：文字列（形式：YYYYMMDDhhmm）
EndTime	統計の終了時刻。子ノード：なし親ノード：StatisticsResult 型：文字列（形式：YYYYMMDDhhmm）
Results	統計結果。子ノード：なし親ノード：StatisticsResult 型：文字列

特殊なレスポンスコード

シナリオ	HTTPステータスコード	エラーコード	メッセージ
必須パラメータがリクエストに含まれていない場合	400 Bad Request	InvalidArgument	Please provide parameter {parameter name}
リクエスト時にサブリソースが誤記または未指定の場合	405 Method Not Allowed	MethodNotAllowed	MethodNotAllowed
リクエスト内のMethodが GET, HEAD, POST, PATCH, DELETE, OPTIONS, TRACE 以外の場合	400 Bad Request	InvalidArgument	Method is invalid
startTime／endTimeパラメータ形式が不正な場合	400 Bad Request	InvalidArgument	{parameter name} is Invalid
リクエスト内の開始時刻が現在時刻より後の場合	400 Bad Request	InvalidArgument	{parameter name} is invalid
リクエスト内の開始時刻が終了時刻より後の場合	400 Bad Request	InvalidArgument	The startTIme must be less than endTime
リクエスト内の終了時刻が現在時刻より後の場合	400 Bad Request	InvalidArgument	{parameter name} is invalid
URLの有効期限切れ	403 Forbidden	RequestTimeTooSkewed	The difference between the request time and the current time is too large.
リクエストで指定した期間が1週間を超えている場合	400 Bad Request	InvalidArgument	The difference between the startTime and endTime must be less than one week.
リクエストの「type」パラメータがサポート対象外（綴り間違いや未対応の検索含む）	400 Bad Request	InvalidArgument	Parameter Type only support requests and bandwidth
1分以内に同一リクエストを複数回送信した場合	429 Too Many Requests	TooManyRequests	You have sent too many requests in a given amount of time.

Media Delivery

Cloud Security

Web Performance

Enterprise Application

Storage

Edge Computing

Console Guide

API Docs

Statistics

機能説明

リクエスト形式

リクエストパラメータ

リクエストヘッダー

リクエストボディ

レスポンス形式

レスポンスヘッダー

レスポンスボディ

特殊なレスポンスコード

目次