Create a new aggregate

新しい集合体(aggregate)を登録します。

APIエンドポイント

リージョン	APIエンドポイント
西日本リージョン3の場合	https://telemetry.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合	https://telemetry.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI

POST

/v4.0/aggregates

HTTPステータスコード

正常時：201

エラー時：400,401,404,500

リクエストパラメータの説明

名前	In	Type	デフォルト値 /必須指定	Description
X-Auth-Token	header	string	必須	認証のトークン
Content-Type	header	string	必須	「application/json」を指定します。
name	body	string	必須	集合体(aggregate)の名前。半角英数字記号100文字まで
description	body	string	任意	集合体の説明。255文字まで
object_list	body	List<string>	必須	集合体に含める仮想サーバのID リスト形式で指定します。

レスポンスボディ（正常系）の説明

名前	Type	Description
id	string	集合体(aggregate)のID
name	string	集合体(aggregate)の名前
description	string	集合体の説明
object_list	List<string>	集合体に含まれる仮想サーバのID リスト形式で表示されます。

リクエスト例

curl -X POST -H "Content-Type: application/json" \
-H "X-Auth-Token: ImFkbWluVVJMIjogImh0dHA6Ly8xMC4x..." \
-d <リクエストボディ> "https://telemetry.jp-west-3.cloud.global.fujitsu.com/v4.0/aggregates"

リクエストボディ(JSON形式)の例

{
  "aggregate": {
    "name": "web-servers",
    "description": "aggregates for web servers",
    "object_list": [
      "22c91117-08de-4894-9aa9-6ef382400985",
      "f5dc173b-6804-445a-a6d8-c705dad5b5eb"
    ]
  }
}

レスポンス例

{
  "aggregate": {
    "id": "c3f0e684-a685-3781-5f51-e5324d923d6b",
    "name": "web-servers",
    "description": "aggregates for web servers",
    "object_list": [
      "22c91117-08de-4894-9aa9-6ef382400985",
      "f5dc173b-6804-445a-a6d8-c705dad5b5eb"
    ]
  }
}