---
title: "HTTP SDK"
slug: "elsa2-sdk-http"
updated: 2026-09-17T09:28:51Z
published: 2026-09-17T09:28:51Z
canonical: "guide.ncloud-docs.com/elsa2-sdk-http"
---

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

# HTTP SDK

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

HTTPSプロトコルを使用して JSON形式のログデータを Effective Log Search & Analytics 2.0収集サーバに転送できます。

## ログ転送情報

HTTPS/JSONの方式でログを転送するため、以下の事項を確認してください。

[API URL](/docs/ja/elsa2-sdk-http#APIURL) [呼び出し方式](/docs/ja/elsa2-sdk-http#%ED%98%B8%EC%B6%9C%EB%B0%A9%EC%8B%9D) [リクエストボディ(JSON形式)とフィールド](/docs/ja/elsa2-sdk-http#%EC%9A%94%EC%B2%AD%EB%B0%94%EB%94%94%EB%B0%8F%ED%95%84%EB%93%9C) [ログ転送のユースケース](/docs/ja/elsa2-sdk-http#HTTPSDK%EB%A1%9C%EA%B7%B8%EC%A0%84%EC%86%A1%EC%98%88%EC%A0%9C)

### API URL

HTTPSで Effective Log Search & Analytics 2.0サーバにログを転送する際、以下のアドレスを使用します。

```
https://elsa-v2-col.ncloud.com/_store
```

## 呼び出し方式

呼び出し方式(Method)は、PUTと POST方式を使用します。

### リクエストボディとフィールド

リクエストボディは以下のように JSON形式で作成します。

```
{
    "txtToken": "2xxxx10e221b4d06a870a06e9c5axxxx",
    "projectName": "72356c50401b8e20_testproject",
    "projectVersion": "1.0.0",
    "body": "This log message come from HTTPS client.",
    "host": "localhost",
    "logType": "nelo2-log"
}
```

JSON形式のリクエストボディに入力可能なフィールドは、次の通りです。

| フィールド | タイプ | 必須有無 | 説明 |
| --- | --- | --- | --- |
| `txtToken` | string | 必須 | プロジェクトの作成時に NELOに登録された txtToken([プロジェクト詳細情報確認](/docs/ja/elsa2-project#%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%EC%83%81%EC%84%B8%EC%A0%95%EB%B3%B4%ED%99%95%EC%9D%B8)を参照) |
| `projectName` | string | 必須 | プロジェクトの作成時に NELOに登録されたプロジェクトキー([プロジェクト詳細情報確認](/docs/ja/elsa2-project#%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%EC%83%81%EC%84%B8%EC%A0%95%EB%B3%B4%ED%99%95%EC%9D%B8)を参照) |
| `projectVersion` | string | 必須 | プロジェクトバージョン(デフォルト値: 1.0.0) - 英数字、ハイフン(-)、句点(.)、アンダースコア(_)のみ入力可能 |
| `body` | string | 必須 | ログメッセージ - UTF-8を使用し、スペースは入力不可 |
| `host` | string | オプション | ログ転送場所(デフォルト値: TCPの peer-adrress) |
| `logType` | string | オプション | ログタイプの識別(デフォルト値: nelo2-log) |

              参考

              

- シンボリケーションファイルを適用するには、そのバージョンと `projectVersion` キーの値が一致する必要があります。
- `logTime`、 `sendTime` パラメータは Effective Log Search & Analytics 2.0サービスのシステムで使用します。2つのパラメータを入力しても適用されません。

## HTTP SDKログ転送のユースケース

HTTPSログの送信は PUTと POST方式のみサポートします。以下のメソッドごとのログ転送のユースケースを参照し、ログを転送します。 ログ転送が失敗しないようにログを転送する前に、API URLとフィールドなどの転送情報が正しいかどうか確認します。

### POSTメソッドのユースケース

POSTメソッドを使用したユースケースは、次の通りです。

```
$ curl -XPOST 'https://elsa-v2-col.ncloud.com/_store' -d '{
    "txtToken": "2xxxx10e221b4d06a870a06e9c5axxxx",
    "projectName": "72356c50401b8e20_testproject",
    "projectVersion": "1.0.0",
    "body": "This log message come from HTTPS client.",
    "host": "localhost",
    "logType": "nelo2-log"
}'
```

### PUTメソッドのユースケース

PUTメソッドを使用したユースケースは、次の通りです。

```
$ curl -XPUT 'https://elsa-v2-col.ncloud.com/_store' -d '{
    "txtToken": "2xxxx10e221b4d06a870a06e9c5axxxx",
    "projectName": "72356c50401b8e20_testproject",
    "projectVersion": "1.0.0",
    "body": "This log message come from HTTPS client.",
    "host": "localhost",
    "logType": "nelo2-log"
}'
```