GetActivityList

Prev Next

Classic/VPC環境で利用できます。

リソースの作業履歴を照会します。リソースは、ユーザーが NAVERクラウドプラットフォームで作成した資源の単位です。リソースは、識別できるように NRN(Ncloud Resource Names)という固有のキーで区別して管理するので、NRNを使用して呼び出すと特定のリソースに対する作業履歴を照会できます。

参考

NRN(Ncloud Resource Names)の概念と命名ルールの詳細は、Resource Managerご利用ガイドのResource Managerとはをご参照ください。

リクエスト

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

メソッド URI
POST /api/v1/activities

リクエストヘッダ

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

リクエストボディ

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

フィールド タイプ 必須の有無 説明
fromEventTime Integer Optional 照会期間の開始日時(Unix Timestamp) (ミリ秒)
  • 照会日時から30日前(デフォルト)
toEventTime Integer Optional 照会期間の終了日時(Unix Timestamp) (ミリ秒)
  • 照会日時(デフォルト)
nrn String Optional NAVERクラウドプラットフォームリソースの識別値
pageIndex Integer Optional ページ番号
  • 0~N (デフォルト: 0)
pageSize Integer Optional ページの出力数
  • 100以下(デフォルト: 20)

リクエスト例

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

curl --location --request POST 'https://cloudactivitytracer.apigw.ntruss.com/api/v1/activities' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
        "pageIndex": "0",
        "pageSize": "4"
 }'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
pageIndex Integer - ページ番号
pageSize Integer - ページ表示数
itemCount Integer - レスポンス結果数
hasMore Boolean - 追加ページは存在するかどうか
  • true | false
    • true: 存在する
    • false: 存在しない
items Array - 応答の結果

items

itemsの説明は次の通りです。

フィールド タイプ 必須の有無 説明
historyId String - リソース作業履歴の ID
nrn String - NAVERクラウドプラットフォームリソースの識別値
eventTime Integer - 作業の変更日時(Unix Timestamp) (ミリ秒)
platformType String - プラットフォーム区分
  • BOTH | VPC | Classic
    • BOTH: プラットフォーム共通環境
    • VPC: VPC環境
    • Classic: Classic環境
productName String - リソースのサービスコード
productDisplayName String - リソースのサービス名
regionCode String - リソースのリージョンコード
regionDispalyName String - リソースのリージョン名
resourceType String - リソースタイプ
resourceId String - リソース ID
resourceName String - リソース名
actionDisplayName String - ジョブ名
actionResultType String - 作業結果
  • SUCCESS | FAIL
    • SUCCESS: 成功
    • FAIL: 失敗
actionUserType String - 作業者タイプ
  • Customer | Sub
    • Customer: メインアカウント
    • Sub: サブアカウント
actionSubAccountNo Integer - サブアカウントの会員番号
  • actionUserTypeがSubの場合に表示
sourceType String - 作業をリクエストしたクライアントタイプ
  • API | CONSOLE | PORTAL | SYSTEM
sourceIp String - 作業をリクエストしたクライアント IPアドレス
  • sourceTypeがCONSOLEか、PORTALの場合に表示
productData Object - リソースの詳細情報
  • 各フィールド情報: リソース別 APIガイドを参照

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

Cloud Activity Tracer APIで共通して使用されるレスポンスステータスコードの詳細は、
Cloud Activity Tracerのレスポンスステータスコードをご参照ください。

レスポンス例

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

{
    "pageIndex": 0,
    "pageSize": 4,
    "itemCount": 3,
    "hasMore": true,
    "items": [
        {
            "historyId": "67074579e2a352720c5736d1",
            "nrn": "nrn:PUB:Account::****:Customer/static",
            "eventTime": 1728529785024,
            "platformType": "BOTH",
            "productName": "Account",
            "productDisplayName": "Account",
            "regionCode": "",
            "regionDisplayName": "共通",
            "resourceType": "Customer",
            "resourceId": "static",
            "actionDisplayName": "Login",
            "actionResultType": "SUCCESS",
            "actionUserType": "Customer",
            "sourceType": "PORTAL",
            "sourceIp": "***.***.***.***",
            "productData": {
                "twoFactorLoginType": "PHONE",
                "twoFactorLoginManagerName": "ホン*ドン",
                "twoFactorLoginInfo": "+82-010********",
                "clientIpCountry": "KR",
                "isTwoSetFactorLogin": "true",
                "isSuccess": "true",
                "clientIp": "***.***.***.***",
                "loginLevel": "2",
                "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36",
                "userType": "CUSTOMER",
                "userName": "honggildong@navercorp.com"
            }
        },
        {
            "historyId": "67068762e2a352720c56d28e",
            "nrn": "nrn:PUB:SecureZone:KR:****:Member/Standard/****",
            "eventTime": 1728481122336,
            "platformType": "Classic",
            "productName": "SecureZone",
            "productDisplayName": "Secure Zone",
            "regionCode": "KR",
            "regionDisplayName": "Korea",
            "resourceType": "Member",
            "resourceId": "Standard/****",
            "resourceName": "田中太郎",
            "actionDisplayName": "Add Member",
            "actionResultType": "SUCCESS",
            "actionUserType": "Customer",
            "sourceType": "CONSOLE",
            "sourceIp": "***.***.***.***",
            "productData": {
                "memberNo": "******",
                "instanceNo": "****",
                "memberName": "田中太郎",
                "secureZoneNo": "1",
                "secureZoneName": "Secure",
                "firewallType": "STANDARD",
                "zone": "KR2"
            }
        },
        {
            "historyId": "6706874376a86d3b2d5a64fe",
            "nrn": "nrn:PUB:CloudLogAnalytics:KR:****:Analytics/static",
            "eventTime": 1728481091000,
            "platformType": "BOTH",
            "productName": "CloudLogAnalytics",
            "productDisplayName": "Cloud Log Analytics",
            "regionCode": "KR",
            "regionDisplayName": "韓国",
            "resourceType": "Analytics",
            "resourceId": "static",
            "resourceName": "CloudLogAnalytics",
            "actionDisplayName": "Subscribe To Cloud Log Analytics",
            "actionResultType": "SUCCESS",
            "sourceType": "SYSTEM",
            "productData": {
                "memberNo": "******",
                "instanceNo": "26950604",
                "prodNo": "1",
                "startYmdt": "2024-10-08 22:38:10"
            }
        }
    ]
}