Unified Endpoint は、Unified Endpoint を利用できるデバイス から、Unified Endpoint の対象サービス にデータを送信するための エントリポイント を提供するサービスです。Unified Endpoint の特徴は以下のとおりです。
| 項目 | Unified Endpoint を利用する場合 | Unified Endpoint を利用しない場合 |
|---|---|---|
| デバイスがデータを送信する宛先、およびデータの転送先 | Unified Endpoint のエントリポイント に送信すると、Beam、Funk、Funnel、Harvest Data のうち、グループ設定で有効化されているサービスにデータが転送される | 利用するサービスのエントリポイントに送信する |
| 1 つのデータを複数のサービスに送信する場合 | Unified Endpoint のエントリポイントに 1 回送信すると、Unified Endpoint でコピーされて複数のサービスに転送される | 利用するサービスの数だけ複数回送信する |
| データの種類に合わせて、利用するサービスをきめ細かく変更するには | 不要なデータは、転送先のサービスで無視するように実装する。デバイスでは制御できません | 以下のいずれかの方式で対応する
|
HTTP/TCP/UDP セッションは切断されることがあります
SORACOM のメンテナンスに伴い、任意のタイミングで HTTP/TCP/UDP セッションが切断される場合があります。メンテナンスに伴うセッション切断は、SORACOM Status Dashboard などで告知されません。ご了承ください。
サービスやプロダクト開発の進捗に応じて柔軟にデータの送信先を変更できます
サービスやプロダクト開発の進捗に応じて、データの送信先が変わることがよくあります。たとえば初期段階では、デバイスがデータを正しく送信できることを確認したり、素早くデータを可視化するために、Harvest Data を利用できます。その後、開発が進むにつれて、次のような取り組みを実施することが考えられます。
データを Unified Endpoint に送信するようにデバイスを開発しておくことで、データの送信先が変わる場合でも、デバイスごとにデータの送信先を変更する必要はありません。
Unified Endpoint にデータを送信できるデバイス
Unified Endpoint は、以下のサービスを利用しているデバイスから利用できます。
Unified Endpoint からデータを転送できるサービス
Unified Endpoint のエントリポイントに送信したデータを、以下のサービスに転送できます。
| サービス | 制限 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SORACOM Beam | Unified Endpoint に送信するときの通信プロトコルに応じて、転送先の Beam のエントリポイントが決定されます。
Beam の以下のエントリポイントは、Unified Endpoint を経由して利用することはできません。 | ||||||||||||
| SORACOM Funk | 制限はありません。 | ||||||||||||
| SORACOM Funnel | 制限はありません。 | ||||||||||||
| SORACOM Harvest Data | 制限はありません。 |
SORACOM Harvest Files には対応していません
Unified Endpoint を利用して、SORACOM Harvest Files に転送することはできません
SORACOM のエントリポイントに送信したデータの処理順序
Unified Endpoint や Beam など、SORACOM のエントリポイントに送信したデータは、SORACOM Binary Format v1、バイナリパーサー、Orbit で処理されてから、Beam、Funnel、Funk、Harvest Data で処理されます。各機能の処理順序は以下のとおりです。なお、利用する機能の設定は、エントリポイントごとに行います。
- (*1) SORACOM Binary Format v1 は、TCP でデータを送信した場合のみ利用できます。
- (*2) Orbit は、Unified Endpoint に送信した場合のみ利用できます。Beam など、Unified Endpoint 以外のエントリポイントに送信した場合は、Orbit は利用できません。
- (*3) については、以下のページを参照してください。
データのタイムスタンプについて
データのタイムスタンプは、Unified Endpoint では付与されず転送先のサービスで付与されます。そのため、各サービスごとに異なる場合があります。
Beam / Funnel / Funk / Harvest Data ではデータ形式によって処理が異なります
Beam / Funnel / Funk / Harvest Data ではデータ形式によって処理が異なるため、各サービスでデータを正しく扱うために Unified Endpoint に送信したデータのデータ形式に注意してください。
Unified Endpoint は、複数のエントリポイントを提供しています。エントリポイントによって、Beam / Funnel / Funk / Harvest Data に出力する際のデータ形式が異なります。エントリポイントについて詳しくは、エントリポイント一覧 を参照してください。
Unified Endpoint に送信したデータは、バイナリパーサー や Orbit で処理すると、エントリポイントに関わらず JSON 形式のデータとして出力できます。
