---
title: "fields"
slug: "effective-log-search-analytics-fields"
updated: 2026-10-08T07:25:00Z
published: 2026-10-08T07:25:00Z
canonical: "api.ncloud-docs.com/effective-log-search-analytics-fields"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# fields

## 概要

Effective Log Search & Analyticsのプロジェクトごとのログのフィールドを照会できます。

その APIを通じて指定期間内に存在したログのフィールドを照会できます。 「.raw」`は、/api/v1/logs/searchの sorts機能を利用する場合にのみ、フィールド名の後ろに付けて使用します。

## リクエスト

### API URL

```
GET
https://elsa.apigw.ntruss.com/api/v1/fields
```

### リクエストヘッダ

共通の設定に明示されたリクエストヘッダが必要です。

[NAVERクラウドプラットフォームの認証キーおよび Signature作成ガイドへ](https://api.ncloud-docs.com/beta/docs/ja/ko/common-ncpapi)

```
x-ncp-apigw-timestamp: {current timestamp}
x-ncp-iam-access-key: {your iam access key}
x-ncp-apigw-signature-v2: {generated signature}
```

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

| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
| --- | --- | --- | --- | --- |
| projectKey | Yes | string | 1-53 | プロジェクトキー 例: "projectKey":"Pxxxxxx_test" |
| projectId | Yes | int |  | Project Id 例: “projectId”:8181 |
| from | Yes | int |  | 検索を開始するタイムスタンプ(UTC milliseconds)。 例: “from”:1381190400000 |
| to | Yes | int |  | 検索を終了するタイムスタンプ(UTC milliseconds)。 例: “to”:1381190400000 |

### リクエストボディ

```
?projectKey=Pbxxxxx_elsa-test&projectId=8171&from=1381190400000&to=1381190400000
```

### リクエスト例

```
import hashlib
import hmac
import base64
import time
import requests

def make_signature(access_key, secret_key, timestamp, url):
    timestamp = str(timestamp)
    secret_key = bytes(secret_key, 'UTF-8')
    method = "GET"

    message = method + " " + url + "\n" + timestamp + "\n" + access_key
    message = bytes(message, 'UTF-8')
    signingKey = base64.b64encode(hmac.new(secret_key, message, digestmod=hashlib.sha256).digest())
    return signingKey.decode('UTF-8')

def fields():
    baseurl = "https://elsa.apigw.ntruss.com" #{OpenAPI endpoint}
    url = "/api/v1/fields?projectKey=Pbxxxxx_elsa-test&projectId=8171&from=1381190400000&to=1381190400000"

    access_key = "accessKey" #{Main / Sub Account Access Key}
    secret_key = "secretKey" #{Main / Sub Account Secret Key}
    timestamp = int(time.time() * 1000)

    signature = make_signature(access_key, secret_key, timestamp, url)

    url = baseurl + url
    headers = {
        "x-ncp-apigw-timestamp": str(timestamp),
        "x-ncp-iam-access-key": access_key,
        "x-ncp-apigw-signature-v2": str(signature)
    }

    response = requests.get(url=url,
                  verify=True,
                  headers=headers
                  )
```

## レスポンス

### レスポンスボディ

```
{
"data":[
	"Platform.raw","projectKey","body.raw"
	],
"status":200
}
```