インスタンス・グループの更新
patch
/api/v2/instance_groups/{id}/
このリソースに対してPUTまたはPATCHリクエストを行って、このインスタンス・グループを更新します。 次のフィールドを変更できます。
-
name
: このインスタンス・グループの名前。(文字列、必須) -
credential
: (id、デフォルト=``) policy_instance_percentage
: 新しいインスタンスがオンラインになると、このグループに自動的に割り当てられるすべてのインスタンスの最小パーセント。(整数、デフォルト=0
)policy_instance_minimum
: 新しいインスタンスがオンラインになると、このグループに自動的に割り当てられるインスタンスの静的最小数。(整数、デフォルト=0
)policy_instance_list
: このグループに割り当てられる完全一致インスタンスのリスト(json、デフォルト=``)pod_spec_override
: (文字列、デフォルト=""
)
PATCHリクエストの場合は、変更中のフィールドのみを含めます。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
問合せパラメータ
- search(オプション): 文字列
検索条件。
ルート・スキーマ : schema
例:
{
"name":"foobar"
}
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
レスポンスの例(application/json)
{
"capacity":0,
"committed_capacity":0,
"consumed_capacity":0,
"controller":null,
"created":"2018-02-01T08:00:00.000000Z",
"credential":null,
"id":2,
"instances":0,
"is_containerized":false,
"is_controller":false,
"is_isolated":false,
"jobs_running":0,
"jobs_total":0,
"modified":"2018-02-01T08:00:00.000000Z",
"name":"foobar",
"percent_capacity_remaining":0,
"pod_spec_override":"",
"policy_instance_list":[
],
"policy_instance_minimum":0,
"policy_instance_percentage":0,
"related":{
"instances":"/api/v2/instance_groups/2/instances/",
"jobs":"/api/v2/instance_groups/2/jobs/"
},
"summary_fields":{
"user_capabilities":{
"delete":true,
"edit":true
}
},
"type":"instance_group",
"url":"/api/v2/instance_groups/2/"
}
400レスポンス
レスポンスの例(application/json)
{
"policy_instance_list":[
"Containerized instances may not be managed via the API"
]
}