サブアカウントの最終アクセス情報の照会

Prev Next

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

サブアカウントの最終アクセス情報を照会します。サブアカウントの最終ログイン日時、最終 Gitログイン(Source Commit)日時、Access Key最終使用日時を確認できます。

リクエスト

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

メソッド URI
GET /api/v1/users/{subAccountId}/last-access-summary

リクエストヘッダ

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

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

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
subAccountId String Required サブアカウント ID

リクエスト例

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

curl --location --request GET 'https://subaccount.apigw.ntruss.com/api/v1/users/dfafe250-****-****-****-246e96591594/last-access-summary' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Accept: application/json'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
subAccountId String - サブアカウント ID
lastLogin String - サブアカウントの最終ログイン日時
lastGitLogin String - 最終 Git(Source Commit)ログイン日時
lastAccessKeyUsed String - 最終 Access Key使用日時
unusedDays String - サブアカウント未使用日数

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

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

レスポンス例

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

{
  "idNo": "dfafe250-****-****-****-246e96591594",
  "lastLogin": "2025-12-10T04:44:29.467Z",
  "lastGitLogin": "2025-12-10T04:44:29.467Z",
  "lastAccessKeyUsed": [
    {
      "accessKey": "ncp_iam_BGAS********",
      "lastUsed": "2025-12-10T04:44:29.467Z"
    }
  ],
  "lastUsedTime": "2025-12-10T04:44:29.467Z",
  "unusedDays": 0
}