グループのグループの作成
post
/api/v2/groups/{id}/children/
次のグループ・フィールドを指定してこのリソースに対してPOSTリクエストを行って、このグループに関連付けられる新しいグループを作成します。
name
: このグループの名前。(文字列、必須)description
: このグループのオプションの説明。(文字列、デフォルト=""
)inventory
: (id、必須)variables
: JSONまたはYAML形式のグループ変数。(json、デフォルト=``)
グループのグループの追加:
このグループに既存のグループを関連付けるには、id
フィールドのみを指定してこのリソースに対してPOSTリクエストを行います。
このグループからのグループの削除:
id
およびdisassociate
フィールドを指定してこのリソースに対してPOSTリクエストを行うと、グループは削除されずに、このグループからグループが除去されます。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
ルート・スキーマ : schema
例:
{
"id":2
}
レスポンス
サポートされているメディア・タイプ
- application/json
201レスポンス
レスポンスの例(application/json)
{
"created":"2018-02-01T08:00:00.000000Z",
"description":"Hello world",
"id":2,
"inventory":1,
"modified":"2018-02-01T08:00:00.000000Z",
"name":"New name",
"related":{
"activity_stream":"/api/v2/groups/2/activity_stream/",
"ad_hoc_commands":"/api/v2/groups/2/ad_hoc_commands/",
"all_hosts":"/api/v2/groups/2/all_hosts/",
"children":"/api/v2/groups/2/children/",
"hosts":"/api/v2/groups/2/hosts/",
"inventory":"/api/v2/inventories/1/",
"inventory_sources":"/api/v2/groups/2/inventory_sources/",
"job_events":"/api/v2/groups/2/job_events/",
"job_host_summaries":"/api/v2/groups/2/job_host_summaries/",
"potential_children":"/api/v2/groups/2/potential_children/",
"variable_data":"/api/v2/groups/2/variable_data/"
},
"summary_fields":{
"inventory":{
"description":"",
"has_active_failures":false,
"has_inventory_sources":false,
"hosts_with_active_failures":0,
"id":1,
"inventory_sources_with_failures":0,
"kind":"",
"name":"test-inv",
"organization_id":1,
"total_groups":0,
"total_hosts":0,
"total_inventory_sources":0
},
"user_capabilities":{
"copy":true,
"delete":true,
"edit":true
}
},
"type":"group",
"url":"/api/v2/groups/2/",
"variables":""
}
400レスポンス
レスポンスの例(application/json)
{
"error":"Cyclical Group association."
}
403レスポンス
レスポンスの例(application/json)
{
"detail":"You do not have permission to perform this action."
}