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

/v3.0/aggregates

HTTPステータスコード#

正常時:200

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

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

名前 In Type デフォルト値
/必須指定
Description
X-Auth-Token header string 必須 認証のトークン
X-Auth-Type header string 必須 認証のプラットフォーム
「openstack」を指定します。
Content-Type header string 必須 「application/json」を指定します。
Name body string 必須 集合体(aggregate)の名前
Id body string 任意 集合体(aggregate)のID
指定しない場合はランダムなIDを払い出します。
ObjectList body List<string> 必須 集合体に含む対象のID
リスト形式で指定します。
Type body string 必須 対象の種別
「instance」を指定します。
Metadata body string 任意 集合体の付帯情報

レスポンスボディ(正常系)の説明#

名前 Type Description
task_id string 処理を判別するためのタスクID

リクエスト例#

curl -X POST -H "Content-Type: application/json" \
-H "X-Auth-Token: ImFkbWluVVJMIjogImh0dHA6Ly8xMC4x..." \
-H "X-Auth-Type: openstack" \
-d <リクエストボディ> "https://<host>:<port>/v3.0/aggregates"
【リクエストボディ(JSON形式)】
{
  "Name": "aggregate_name",
  "Type": "instance",
  "id": "aggregate_id",
  "Metadata": "Optional setting",
  "ObjectList": [
    "instance_id_01",
    "instance_id_02"
  ]
}

レスポンス例#

{
  "task_id": "12313694-fe79-4ea3-a370-2d3c2e709a59"
}