# リファレンス Insightsモデルエンドポイント

これらのRESTエンドポイントを使用して、Treasure Insightsデータモデルを構築および保守します。

- [Insightsモデルの作成/読み取り/削除](#createreaddelete-insights-models)
  - [アカウントのInsightsモデルのリストを取得](#get-a-list-of-the-accounts-insights-models)
  - [ビルドおよびクエリリソース制限サイズの取得](#get-the-build-and-query-resource-limit-sizes)
  - [特定のInsightsモデル設定の取得](#retrieve-a-specific-insights-model-configuration)
  - [新しいInsightsモデルの作成](#create-a-new-insights-model)
  - [既存のInsightsモデルの削除](#delete-an-existing-insights-model)
- [Insightsモデル共有の更新](#update-insights-model-share)
  - [ユーザーとInsightsモデルを共有](#share-the-insights-model-with-users)
- [データセットの作成/読み取り/削除](#createreaddelete-datasets)
  - [Insightsモデル内のデータセットのリストを取得](#get-a-list-of-the-datasets-in-the-insights-model)
  - [新しいInsightsモデルデータセットの作成](#create-a-new-insights-model-dataset)
  - [Insightsモデルデータセットの削除](#delete-an-insights-model-dataset)
- [テーブルの作成/読み取り/更新/削除](#createreadupdatedelete-tables)
  - [データセット内のテーブルのリストを取得](#get-a-list-of-tables-in-a-dataset)
  - [データセットに新しいテーブルを作成](#create-a-new-table-in-a-dataset)
  - [データセット内の既存のテーブルを更新](#update-an-existing-table-in-a-dataset)
  - [データセット内の既存のテーブルを削除](#delete-an-existing-table-in-a-dataset)
- [リレーションの作成/読み取り/削除](#createreaddelete-relations)
  - [Insightsモデルリレーションのリストを取得](#get-a-list-of-insights-model-relations)
  - [Insightsモデルの新しいリレーションを作成](#create-a-new-relation-for-an-insights-model)
  - [既存のリレーションを削除](#delete-an-existing-relation)
- [Insightsモデルビルドの作成/読み取り/削除](#createreaddelete-insights-model-builds)
  - [Insightsモデルビルドのリストを取得](#get-a-list-of-insights-model-builds)
  - [Insightsモデルのビルドステータスを取得](#get-the-insights-models-build-status)
  - [Insightsモデルのビルドをトリガー](#trigger-the-build-of-an-insights-model)
  - [Insightsモデルのビルドを停止](#stop-the-build-of-an-insights-model)


# Insightsモデルの作成/読み取り/削除

## アカウントのInsightsモデルのリストを取得


```text
GET /reporting/datamodels
```

## ビルドおよびクエリリソース制限サイズの取得

ElastiCubeデータモデル、ビルド、およびダッシュボード/クエリは、RAMとCPUの一定の上限(最大23 GB)に関連付けられているため、データモデルのビルドがその制限を超えると、ユーザーにエラーが表示されます。


```text
GET /reporting/account
```

### サンプルレスポンス

GBでのクエリとダッシュボードの制限を表示し、特に`build_size`と`query_size`パラメーターに注意してください。


```json
{
        "id": "10",
        "sisense_group_id": "5f7e73a8390cef002c916538",
        "td_account_id": "6233",
        "max_data_modelers": 5,
        "max_designers": 10,
        "max_viewers": 20,
        "storage_size": 20,
        "storage_threshold": 500,
        "build_threshold": 100,
        "query_threshold": 100,
        "sisense_datagroup_oid": "7e550d2c-68c0-4fb1-90b0-ac40c044b096",
        "sisense_hostname": "us01-01-development.reporting.treasuredata.com",
        "build_size": 23.0,
        "query_size": 23.0,
        "calculated_build_size": 23.0,
        "calculated_query_size": 23.0,
        "current_data_modelers": 4,
        "current_designers": 2,
        "current_viewers": 4
}
```

## 特定のInsightsモデル設定の取得


```text
GET /reporting/datamodels/{datamodel_id}
```

## 新しいInsightsモデルの作成


```text
POST /reporting/datamodels
```

## 既存のInsightsモデルの削除


```text
DELETE /reporting/datamodels/{datamodel_id}
```

# Insightsモデル共有の更新

## ユーザーとInsightsモデルを共有


```text
PUT /reporting/datamodels/{datamodel_id}/shares
```

# データセットの作成/読み取り/削除

## Insightsモデル内のデータセットのリストを取得


```text
GET /reporting/datamodels/{datamodel_id}/datasets
```

## 新しいInsightsモデルデータセットの作成


```text
POST /reporting/datamodels/{datamodel_id}/datasets
```

## Insightsモデルデータセットの削除


```text
DELETE /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}
```

# テーブルの作成/読み取り/更新/削除

## データセット内のテーブルのリストを取得


```text
GET /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables
```

## データセットに新しいテーブルを作成


```text
POST /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables
```

## データセット内の既存のテーブルを更新


```text
PUT|PATCH /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables/{table_id}
```

## データセット内の既存のテーブルを削除


```text
DELETE /reporting/datamodels/{datamodel_id}/datasets/{dataset_id}/tables/{table_id}
```

# リレーションの作成/読み取り/削除

## Insightsモデルリレーションのリストを取得


```text
GET /reporting/datamodels/{datamodel_id}/relations
```

## Insightsモデルの新しいリレーションを作成


```text
POST /reporting/datamodels/{datamodel_id}/relations
```

## 既存のリレーションを削除


```text
DELETE /reporting/datamodels/{datamodel_id}/relations/{relation_id}
```

# Insightsモデルビルドの作成/読み取り/削除

## Insightsモデルビルドのリストを取得


```text
GET /reporting/datamodels/{datamodel_id}/builds
```

## Insightsモデルのビルドステータスを取得


```text
GET /reporting/datamodels/{datamodel_id}/builds/{build_id}
```

## Insightsモデルのビルドをトリガー


```text
POST /reporting/datamodels/{datamodel_id}/builds
```

## Insightsモデルのビルドを停止


```text
DELETE /reporting/datamodels/{datamodel_id}/builds/{build_id}
```