メインコンテンツまでスキップ

Post Assets

アセットを新規作成するAPIです。アセット名が既に存在する場合、更新を行います。

Header Parameters
Authorization string REQUIRED

NewtZeroのアカウントで発行されるAPIキーです。

Request Body REQUIRED

新規アセットのデータを送信します。配列にして複数のアセットを送信することも可能です。

name string REQUIRED

アセット名です。nameはアセット間で一意となるよう指定してください。

tags array REQUIRED

アセットのタグです。タグがアセット間で一意である必要があります。

userNoText string

アセットの作成者のアカウントNoです。

contractorNo string

コントラクタ名。契約時に設定されます。通常会社名を示すユニークな名称が発行されます。

timeFieldMetric string

時系列データのメトリックを指定します。TopDataのデータを並列的に更新する場合に、データが常に最新になるように担保する機能です。timeFieldMetricが指定されている場合、データの更新時に、更新データと更新前のデータの指定したメトリックの値を比較して、更新データが更新前のデータより古いデータであれば、更新をブロックします。

readers array

アセットデータの読み込み権限を設定します。配列に存在するユーザのみデータの読み込みを許可します。*はワイルドカードであり、全てのユーザに対してデータの読み込みを許可します。

writers array

アセットへのデータの書き込み権限を設定します。配列に存在するユーザのみデータの書き込みを許可します。*はワイルドカードであり、全てのユーザに対してデータの書き込みを許可します。

Responses
200

アセットの新規作成もしくは更新に成功しました。messageに対象のアセットのIDを返します。

400

指定したアセットが既に存在し、アセットに書き込み権限がない場合に400エラーを返します。

500

APIキーが無効の場合、もしくはアセットのデータが無効な場合に500エラーを返します。