getHourlyTrafficUsageList

Prev Next

Classic環境で利用できます。

Secure Zone Firewallで発生した1時間当たりのトラフィックの最高使用量を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /{type}/{zone}/getHourlyTrafficUsageList

リクエストヘッダ

Secure Zone APIで共通して使用されるヘッダの詳細は、Secure Zoneのリクエストヘッダをご参照ください。

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
type String Required Secure Zoneで提供するファイアウォールタイプ
  • szfw | psfw
    • szfw: Secure Zone Standard
    • psfw: Secure Zone Advanced
zone String Required Secure Zoneを構成したゾーン
  • kr1 | kr2
    • kr1: KR-1ゾーン
    • kr2: KR-2ゾーン

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
status String Optional ユーザーの状態
  • USE | END
page Integer Optional ページインデックス
  • 0(デフォルト)
countPerPage Integer Optional ページごとの項目数
  • 0(デフォルト)
fromDate Date Required 照会期間の開始日
toDate Date Required 照会期間の終了日
timeZone String Optional タイムゾーン
  • +09:00(デフォルト)

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://securezonefirewall.apigw.ntruss.com/api/v2/szfw/kr2/getHourlyTrafficUsageList'
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-mbr_no: {User number}' \
--header 'Content-Type: application/json' \
--data '{
  "status": "USE",
  "page": 0,
  "countPerPage": 20,
  "fromDate": "2024-07-01T00:32:14.953Z",
  "toDate": "2024-07-02T00:32:14.953Z",
  "timeZone": "+09:00"
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
action String - リクエストタイプ
returnCode Integer - レスポンスコード
returnMessage String - レスポンスメッセージ
trafficUsageList[] Array - トラフィック使用量データリスト
trafficUsageList[].memberNo String - ユーザーの NAVERクラウドプラットフォーム会員番号
trafficUsageList[].instanceNo String - インスタンス作成時に付与された契約番号
trafficUsageList[].secureZoneName String - Secure Zone名
trafficUsageList[].checkDate String - メンテナンス日(yyyy-MM-dd)
trafficUsageList[].checkTime String - メンテナンス時点(hh:mm:ss)
trafficUsageList[].checkHour String - メンテナンス時間(hh)
trafficUsageList[].checkDateTime Long - トラフィック登録日(Unix timestamp)
trafficUsageList[].peakTraffic Long - 最高トラフィック
trafficUsageList[].regYmdt Date - 使用しない
trafficUsageList[].status String - ユーザーの状態
trafficUsageList[].memberLastModifyYmdt Long - ユーザー情報の最終更新日(Unix timestamp)
totalCount Integer - トラフィック使用量データ数

レスポンスステータスコード

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "action": "getHourlyTrafficUsage",
    "returnCode": 0,
    "returnMessage": "success",
    "trafficUsageList": [
        {
            "memberNo": "27***85",
            "instanceNo": "25****11",
            "secureZoneName": "Secure",
            "checkDate": "2024-07-03",
            "checkTime": "13:40:12",
            "checkHour": "13",
            "checkDateTime": 1719981612000,
            "peakTraffic": 0,
            "regYmdt": null,
            "status": "USE",
            "memberLastModifyYmdt": 1719379274000
        },
        {
            "memberNo": "27***85",
            "instanceNo": "25****11",
            "secureZoneName": "Secure",
            "checkDate": "2024-07-03",
            "checkTime": "14:00:16",
            "checkHour": "14",
            "checkDateTime": 1719982816000,
            "peakTraffic": 277,
            "regYmdt": null,
            "status": "USE",
            "memberLastModifyYmdt": 1719379274000
        }
    ],
    "totalCount": 2
}