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" ] } }