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