メジャーメント

概要

メジャーメントインターフェースは次の三つの要素で構成されています。

注記:すべてのPUT / POSTリクエストに対して「accept」ヘッダーを使用する必要があります。そうでない場合は、空の応答本体が返されます。

単位のシステム

注記:すべてのGETリクエストは「X-Cumulocity-System-Of-Units」ヘッダーをサポートしており、応答で使用される単位システムを設定することができます。指定できる値は、「imperial」または「metric」です。「単位」特性を含む全てのメジャーメントフラグメントは、必要な単位システムを使用するように変換されます。

一般的な変換:

メーター、キログラム法 ヤード、ポンド法
m (meter) ft (foot)
km (kilometer) mi (mile)
cm (centimeter) in (inch)
°C (degree Celsius) °F (degree Fahrenheit)
"K (Kelvin) °R (degree Rankine)
g (gram) oz (ounce)
kg (kilogram) lb (pound)

メジャーメント例:

...
{
    ....
     "c8y_Temperature": {
         "T": {
             "unit": "ºC",
             "value": 2.0791169082
         }
     }
}
...

リクエスト例:

GET /measurement/measurements?valueFragmentType=c8y_Temperature&valueFragmentSeries=T&source=663951
Host: ...
Authorization: Basic ...
X-Cumulocity-System-Of-Units: imperial

応答例:

...
{
    ....
     "c8y_Temperature": {
        "T": {
            "unit": "°F",
            "value": 35.742410434759904
        }
    }
}
...

メジャーメントAPI

メジャーメントAPI [application/vnd.com.nsn.cumulocity.measurementApi+json

名称 タイプ 発生回数 説明
self URL 1 このリソースへのリンク
measurements Measurement Collection 1 すべてのメジャーメントのコレクション
measurementsForDate MeasurementCollection URI template 1 特定の期間からのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{dateFrom}、{dateTo})
measurementsForDateAndType MeasurementCollection URI template 1 特定の種別を含む、特定の期間からのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{type}、{dateFrom}、{dateTo})
measurementsForDateAndValueFragmentType MeasurementCollection URI template 1 値のある特定のフラグメントタイプを含む、特定の期間からのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{dateFrom}、{dateTo})
measurementsForDateAndValueFragmentType AndType MeasurementCollection URI template 1 値のある特定のフラグメントタイプを含む、特定の期間およびオブジェクトタイプからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{dateFrom}、{dateTo}、{type})
measurementsForDateAndValueFragmentType AndValueFragmentSeries MeasurementCollection URI template 1 値のある特定のフラグメントタイプとフラグメントシリーズを含む、特定の期間からのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{dateFrom}、{dateTo}、{type})
measurementsForDateAndValueFragmentType AndValueFragmentSeriesAndType MeasurementCollection URI template 1 値のある特定のフラグメントタイプとフラグメントシリーズを含む、特定の期間およびオブジェクトタイプからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー {valueFragmentType},{valueFragmentSeries}、{dateFrom}、{dateTo}、{type})
measurementsForSource MeasurementCollection URI template 1 特定のソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{source})
measurementsForSourceAndDate MeasurementCollection URI template 1 特定の期間および特定のソースオブジェクトからのイベントすべてから成る読み取り専用コレクション(プレースホルダー{dateFrom}、{dateTo}、{source})
measurementsForSourceAnd DateAndType MeasurementCollection URI template 1 特定のタイプを含む、特定の期間および特定のソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{type}、{dateFrom}、{dateTo}、{source})
measurementsForSourceAndDate AndValueFragmentType MeasurementCollection URI template 1 特定のフラグメントタイプを含む、特定の期間および特定のソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{dateFrom}、{dateTo}、{source})
measurementsForSourceAnd DateAndValueFragmentTypeAndType MeasurementCollection URI template 1 特定のフラグメントタイプおよびオブジェクトタイプを含む、特定の期間およびソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{dateFrom}、{dateTo}、{type}、{source})
measurementsForSourceAndDateAnd ValueFragmentTypeAndValueFragmentSeries MeasurementCollection URI template 1 値のある特定のフラグメントタイプおよびフラグメントシリーズを含む、特定の期間およびソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{valueFragmentSeries}、{dateFrom}、{dateTo}、{source})
measurementsForSourceAndDateAndValueFragmentType AndValueFragmentSeriesAndType MeasurementCollection URI template 1 値とタイプオブジェクトのある特定のフラグメントタイプおよびフラグメントシリーズを含む、特定の期間およびソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、 {valueFragmentSeries}、{dateFrom}、{dateTo}、{type}、{source})
measurementsForSourceAndType MeasurementCollection URI template 1 特定のタイプを含む、特定のソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{type}、{source})
measurementsForSourceAndValueFragmentType MeasurementCollection URI template 1 特定のフラグメントタイプを含む、特定のソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{source})
measurementsForSourceAndValueFragmentTypeAndType MeasurementCollection URI template 1 特定のフラグメントタイプを含む、特定のタイプおよびソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{type}、{source})
measurementsForSourceAndValueFragmentType AndValueFragmentSeries MeasurementCollection URI template 1 値のある特定のフラグメントタイプおよびフラグメントシリーズを含む、特定のソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、{valueFragmentSeries}、 {source})
measurementsForSourceAndValueFragmentType AndValueFragmentSeriesAndType MeasurementCollection URI template 1 値のある特定のフラグメントタイプとフラグメントシリーズを含む、特定のタイプおよびソースオブジェクトからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、 {valueFragmentSeries}、{type}、{source})
measurementsForType MeasurementCollection URI template 1 値のある特定のタイプを含むメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{type})
measurementsForValueFragmentType MeasurementCollection URI template 1 値のある特定のフラグメントタイプを含むメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー {valueFragmentType})
measurementsForValueFragmentTypeAndType MeasurementCollection URI template 1 値のある特定のタイプおよび特定のフラグメントタイプを含むメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{type}、{valueFragmentType})
measurementsForValueFragmentType AndValueFragmentSeries MeasurementCollection URI template 1 値のある特定のフラグメントタイプとシリーズを含むメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{valueFragmentType}、 {valueFragmentSeries})
measurementsForValueFragmentTypeAndValueFragmentSeriesAndType MeasurementCollection URI template 1 値のある特定のフラグメントタイプとシリーズを含む、特定のタイプからのメジャーメントすべてから成る読み取り専用コレクション(プレースホルダー{type}、{valueFragmentType}、{valueFragmentSeries}).

queryパラメータである「fragmentType」は廃止されました。APIでは引き続き使用できますが、クライアントはパラメータを「valueFragmentType」および「valueFragmentSeries」に置き換えることを推奨します。これにより、クエリのパフォーマンスが大幅に向上します。これらのパラメータを持つ標準測定値を持つフラグメントのみを照会できることに注意してください。他の形式は照会できません。

大規模なメジャメントコレクションの場合、フィルタを使用しない最新ページのクエリは、結果を返す前に入力結果セットの先頭からサーバーがスキャンする必要があるため、時間がかかることがあります。最新の測定値を取得する必要がある場合に備えて、Things Cloudでは、デバイスによって報告されたタイムスタンプ上で時間範囲クエリとベースクエリを使用して範囲を狭めることを推奨しています。また、ソースごとにクエリを実行することで、クエリの範囲を大幅に縮小することもできます。

GET - メジャーメントAPIリソースの取得

応答本体: application/vnd.com.nsn.cumulocity.measurementApi+json

要求されるロール: ROLE_MEASUREMENT_READ

リクエスト例:

GET /measurement
Host: ...
Authorization: Basic ...

応答例:

HTTP/1.1 200 OK
Content-Type: application/vnd.com.nsn.cumulocity.measurementApi+json;ver=...
Content-Length: ...
{
  "self" : "<<Measurement API URL>>",
  "measurements" : { "self" : "<<MeasurementCollection URL>>" },
  "measurementsForDate" : "<<MeasurementCollection URL>>?dateFrom={dateFrom}&dateTo={dateTo}",
  "measurementsForDateAndType" : "<<MeasurementCollection URL>>?dateFrom={dateFrom}&dateTo={dateTo}&type={type}",
  "measurementsForDateAndValueFragmentType" : "<<MeasurementCollection URL>>?dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}",
  "measurementsForDateAndValueFragmentTypeAndType" : "<<MeasurementCollection URL>>?dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}&type={type}",
  "measurementsForDateAndValueFragmentTypeAndValueFragmentSeries" : "<<MeasurementCollection URL>>?dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}",
  "measurementsForDateAndValueFragmentTypeAndValueFragmentSeriesAndType" : "<<MeasurementCollection URL>>?dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}&type={type}",
  "measurementsForSource" : "<<MeasurementCollection URL>>?source={source}",
  "measurementsForSourceAndDate" : "<<MeasurementCollection URL>>?source={source}&dateFrom={dateFrom}&dateTo={dateTo}",
  "measurementsForSourceAndDateAndType" : "<<MeasurementCollection URL>>?source={source}&dateFrom={dateFrom}&dateTo={dateTo}&type={type}",
  "measurementsForSourceAndDateAndValueFragmentType" : "<<MeasurementCollection URL>>?source={source}&dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}",
  "measurementsForSourceAndDateAndValueFragmentTypeAndType" : "<<MeasurementCollection URL>>?source={source}&dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}&type={type}",
  "measurementsForSourceAndDateAndValueFragmentTypeAndValueFragmentSeries" : "<<MeasurementCollection URL>>?source={source}&dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}",
  "measurementsForSourceAndDateAndValueFragmentTypeAndValueFragmentSeriesAndType" : "<<MeasurementCollection URL>>?source={source}&dateFrom={dateFrom}&dateTo={dateTo}&valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}&type={type}",
  "measurementsForSourceAndType" : "<<MeasurementCollection URL>>?source={source}&type={type}",
  "measurementsForSourceAndValueFragmentType" : "<<MeasurementCollection URL>>?source={source}&valueFragmentType={valueFragmentType}",
  "measurementsForSourceAndValueFragmentTypeAndType" : "<<MeasurementCollection URL>>?source={source}&valueFragmentType={valueFragmentType}&type={type}",
  "measurementsForSourceAndValueFragmentTypeAndValueFragmentSeries" : "<<MeasurementCollection URL>>?source={source}&valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}",
  "measurementsForSourceAndValueFragmentTypeAndValueFragmentSeriesAndType" : "<<MeasurementCollection URL>>?source={source}&valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}&type={type}",
  "measurementsForType" : "<<MeasurementCollection URL>>?type={type}",
  "measurementsForValueFragmentType" : "<<MeasurementCollection URL>>?valueFragmentType={valueFragmentType}",
  "measurementsForValueFragmentTypeAndType" : "<<MeasurementCollection URL>>?valueFragmentType={valueFragmentType}&type={type}",
  "measurementsForValueFragmentTypeAndValueFragmentSeries" : "<<MeasurementCollection URL>>?valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}",
  "measurementsForValueFragmentTypeAndValueFragmentSeriesAndType" : "<<MeasurementCollection URL>>?valueFragmentType={valueFragmentType}&valueFragmentSeries={valueFragmentSeries}&type={type}"
}

メジャーメントコレクション

メジャーメントコレクション [application/vnd.com.nsn.cumulocity.measurementCollection+json]

名称 タイプ 発生回数 説明
self URL 1 このリソースへのリンク
measurements Measurement 0..n メジャーメントのリスト(下記参照)
statistics PagingStatistics 1 ページング統計に関する情報
prev URI 0..1 メジャーメントの前のページへのリンク(あれば)
next URI 0..1 メジャーメントの次のページへのリンク(あれば)

GET - メジャーメントコレクションの取得

応答本体: MeasurementCollection

要求されるロール: ROLE_MEASUREMENT_READ

リクエスト例: 電力使用量を読み出す

 GET /measurement/measurements
 Host: ...
 Authorization: Basic ...
 Accept: application/vnd.com.nsn.cumulocity.measurementCollection+json;ver=...

応答例:

HTTP/1.1 200 OK
Content-Type: application/vnd.com.nsn.cumulocity.measurementCollection+json;ver=...
Content-Length: ...
{

メジャーメントAPIに対して範囲のクエリ、例えばdateFromおよびdateToによるクエリを実行する場合、メジャーメントは古いものから順に返されます。クエリパラメータ「revert=true」をリクエストURLに追加することにより、順序を変えることができます。 多くの場合、デバイスから送信された最新のメジャーメントを取得する必要があります。例えば1年前からのdateFromや将来からのdateToを渡すといったように、日付によって結果をソートできるよう、「dateFrom」および「dateTo」のパラメータと併せて「revert」パラメータを渡すことによって可能です。

GET - メジャーメントシリーズの全部または一部の取得

このエンドポイントは、シリーズ(すべてまたは指定された名称にマッチするもの。シリーズとは「value」プロパティを持つメジャーメントの任意のフラグメント)と指定された期間内の値のリストを返します。必須パラメータはdateFrom、dateTo、sourceです。ページングは使用されません。 さらに、以下のパラメータを渡すことにより、取得したメジャーメントを集計することができます: aggregationType(DAILY、HOURLY、MINUTELY)。集計パラメータが指定されない場合、結果に含まれる値は5000件以下になります。

重要事項: 集計を適正に行うため、デバイスが日付を送信する際に必ず同じタイムゾーンを使用する必要があります。

要求されるロール: ROLE_MEASUREMENT_READ

リクエスト例: すべてのシリーズを読み出す

 GET /measurement/measurements/series...
 Authorization: Basic ...
 Accept: application/json

応答例:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: ...

シリーズは、メジャーメントタイプ、シリーズ名を共に含む「series」パラメータを追加することでフィルタリングできます。 さらに「series」パラメータを追加することで、フィルタリングされるシリーズを追加できます。例:…series=c8y_AccelerationMeasurement.acceleration&series=c8y_SpeedMeasurement.velocity… このユースケースのため、メジャーメントフラグメントでもシリーズでもドットは使用しないでください。

リクエスト例: 特定のシリーズのみを取得

 GET /measurement/measurements/series?series=c8y_AccelerationMeasurement.acceleration&dateFrom=...
 Authorization: Basic ...
 Accept: application/json

応答例:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: ...
{

オブジェクト内の個々の値はメジャーメントから取得される日付であり、その日付の範囲内に最小値と最大値のペアのリストが存在します。各ペアはシリーズオブジェクトにおける単一のシリーズの定義に呼応します。集計を使用しない場合、すべてのペアにおいて最小値と最大値は同じです。

「Truncated」フラグは、値が5000件を超えたことにより最終結果が切り捨てられていることを示します。

POST - 新規メジャーメントの作成

リクエスト本体: Measurement

応答本体: Measurement

要求されるロール: ROLE_MEASUREMENT_ADMIN またはソースオブジェクトの所有権

リクエスト例:

POST /measurement/measurements
Host: ...
Authorization: Basic ...
Content-Length: ...
Content-Type: application/vnd.com.nsn.cumulocity.measurement+json;ver=...
{
  "time" : "2011-09-19T12:03:27.845Z",
  "type" : "KamstrupA220Reading",
  "source" : { "id": "12345" },
  "com_cumulocity_model_energy_measurement_SinglePhaseElectricityMeasurement": {
    "A+:1": { "value": 1234, "unit": "kWh" },
    "A-:1": { "value": 2, "unit": "kWh" }
  },
  "com_cumulocity_model_energy_measurement_ThreePhaseElectricityMeasurement": {
    "A+:1": { "value": 1234, "unit": "kWh" },
    "A+:2": { "value": 1234, "unit": "kWh" },
    "A+:3": { "value": 1234, "unit": "kWh" }
  }
}

応答例:

HTTP/1.1 201 Created
Content-Type: application/vnd.com.nsn.cumulocity.measurement+json;ver=...
Content-Length: ...
{

POSTリクエストの場合、ソースパラメータはIDのみ有することを要求されます。

新規メジャーメントの「id」はサーバーによって生成され、応答においてPOSTオペレーションへ返されます。

注記:メジャーメントシリーズをUIグラフ上で適正に可視化するため、フラグメントおよびシリーズに使用されるプロパティ名は、空白や特殊文字(例:[],*.)を含んではなりません。

POST - 複数のメジャーメントの作成

POST /measurement/measurements
Host: ...
Authorization: Basic ...
Content-Length: ...
Content-Type: application/vnd.com.nsn.cumulocity.measurementCollection+json;ver=...
{
"measurements": [
    {
     "c8y_SpeedMeasurement": {
     	"speed": { 
     		"value": 25,
     		"unit": "km/h" }
            },
     "time":"2013-06-22T17:03:14.000+02:00", 
     "source": {
     	"id":"10200" }, 
     "type": "c8y_SpeedMeasurement"
    },
    {
     "c8y_SpeedMeasurement": {
   	 	"speed": { 
        	"value": 22,
            "unit": "km/h" }
            },
     "time":"2013-06-22T17:05:14.000+02:00", 
     "source": {
     	"id":"10200" }, 
     "type": "c8y_SpeedMeasurement"
    }
]
}

応答例:

HTTP/1.1 201 Created
Content-Type: application/vnd.com.nsn.cumulocity.measurementCollection+json;ver=...
Content-Length: ...
{

DELETE - メジャーメントコレクションの削除

DELETEメソッドはメジャーメントコレクションの削除を可能にします。適用可能なクエリパラメータは次の通りです。

名称 タイプ 説明
fragmentType String メジャーメントのフラグメント名
source String ソースデバイスのID
dateFrom DateTime メジャーメントが発生した日付や時間
dateTo DateTime メジャーメントが完了した日付や時間
type String メジャーメントのタイプ

リクエスト本体: N/A

応答本体: N/A

要求されるロール: ROLE_MEASUREMENT_ADMIN

リクエスト例:

 DELETE: /measurement/measurements....
 Host: ...
 Authorization: Basic ...

応答例:

HTTP/1.1  204 NO CONTENT

重要事項:: パラメーターなしでのこのエンドポイントの呼び出し、またはサポートされていないパラメーターを渡すと、使用可能なすべてのメジャーメントが削除されますのでご注意ください。

メジャーメント

メジャーメント [application/vnd.com.nsn.cumulocity.measurement+json]

名称 タイプ 発生回数 説明 PUT/POST
id String 1 メジャーメントを固有に識別します なし
self URI 1 このリソースへのリンク なし
time String 1 メジャーメントの時間 必須
type String 1 このメジャーメントタイプを端的に示すタイプ名 必須
source ManagedObject 1 このメジャーメントのソースであるマネージドオブジェクト。オブジェクトは「id」および「self」のプロパティを含みます 必須
* * 0..n メジャーメントフラグメントのリスト 任意

各メジャーメントフラグメントは実際のメジャーメントをプロパティとして含むオブジェクトです。プロパティ名はメジャーメントの名称に相当し、プロパティ値は以下のように構造化されます。

名称 タイプ 発生回数 説明 PUT/POST
value Number 1 個々のメジャーメント値。 浮動小数点の最大精度は64ビットIEEE 754です。整数の場合、64ビットの2の補数整数です 必須
unit String 1 メジャーメントの単位、「Wh」または「C」など 任意

GET - メジャーメントの取得

応答本体: Measurement

要求されるロール: ROLE_MEASUREMENT_READ

リクエスト例:

GET /measurement/measurements/<<measurementId>>
Host: ...
Authorization: Basic ...

応答例:

Content-Type: application/vnd.com.nsn.cumulocity.measurement+json;ver=...
Content-Length: ...
{
  "id" : "43",
  "self" : "<<URL of the measurement>>",
  "time" : "2011-09-19T12:03:27.845Z",
  "type" : "KamstrupA220Reading",
  "source" : { "id": "12345", "self": "..." },
  "com_cumulocity_model_energy_measurement_SinglePhaseElectricityMeasurement": {
    "A+:1": { "value": 1234, "unit": "kWh" },
    "A-:1": { "value": 2, "unit": "kWh" }
  },
  "com_cumulocity_msrmts_ThreePhaseReading": {
    "A+:1": { "value": 1234, "unit": "kWh" },
    "A+:2": { "value": 1234, "unit": "kWh" },
    "A+:3": { "value": 1234, "unit": "kWh" }
  }
}

DELETE - メジャーメントの削除

リクエスト本体: N/A.

応答メッセージ本体: N/A.

要求されるロール: ROLE_MEASUREMENT_ADMIN またはソースオブジェクトの所有権

リクエスト例: メジャーメントを削除する

DELETE /measurement/measurements/<<measurementID>>
 Host: [hostname]
 Authorization: Basic xxxxxxxxxxxxxxxxxxx

応答例:

HTTP/1.1  204 NO CONTENT

データストリーミング

メジャーメントコレクションAPIにより、データをデータストリーム形式で取得できます。応答形式は同じですが、データはサーバーによってデータベースから要素ごとに直接送信され、同じ方法で受信できます。 java jsonjavascript json パーサーのようなストリームJSON解析を使用すると単一要求で大容量のデータを転送することができます。 ストリーミングを利用するには、Accept ヘッダーにapplication/json-streamを設定します。

例:

 GET /measurement/measurements
 Host: [hostname]
 Authorization: Basic xxxxxxxxxxxxxxxxxxx
 Accept application/json-stream

他の応答形式

JSON以外の形式でメジャーメントを取得した場合、Accept ヘッダーに次のサポートされた形式を使用してください。

通知

メジャーメント通知APIを使用すると、特定のデバイスに関するすべてのメジャーメントの更新を受信することができます。 通知を受信するための基本プロトコルは「リアルタイム通知」セクションに記載されています。URLは以下の通りです。

/cep/realtime

すべてのデバイスのメジャーメントに関する通知を受信するには、接続チャネルに、デバイスのマネージドオブジェクトID、またはプレースホルダとして「 * 」を含む必要があります。

/measurements/<<deviceId>>

さらに、メジャーメントオブジェクトへの応答には「realtimeAction」が含まれ、指定されたオブジェクトになったアクション(CREATE、UPDATE、またはDELETE)を識別します。削除(DELETE)の場合、データは、削除されたメジャーメントのIDのみ包含することになります。

応答例:

HTTP/1.1 200 OK
Content-Type: application/json
[
  {
    "channel": "/measurement/12345",
    "successful": true,
    "error": "",
    "data": [{
      "realtimeAction": "CREATE",
      "data": {
        "id": "1",
        "self": "...",
        "source": {
          "12345"
        },
        "creationTime": "2011-09-06T12:03:27.927+02:00",
        "c8y_TemperatureMeasurement": {
          "T": {
            "value": 25,
            "unit": "C"
          }
        },
        "time":"2011-09-06T12:03:17.927+02:00",
        "type": "TemperatureMeasurement"
      }
    }],
    "clientId": "Un1q31d3nt1f13r"
  }
]

要求されるロール: ROLE_MEASUREMENT_READ