グループのホストの作成
post
/api/v2/groups/{id}/hosts/
次のホスト・フィールドを指定してこのリソースに対してPOSTリクエストを行って、このグループに関連付けられる新しいホストを作成します。
name
: このホストの名前。(文字列、必須)description
: このホストのオプションの説明。(文字列、デフォルト=""
)inventory
: (id、必須)enabled
: このホストがオンラインで、ジョブの実行に使用できるかどうか。(ブール、デフォルト=True
)instance_id
: ホストを一意に識別するためにリモート・インベントリ・ソースによって使用される値(文字列、デフォルト=""
)variables
: JSONまたはYAML形式のホスト変数。(json、デフォルト=``)
グループのホストの追加:
このグループに既存のホストを関連付けるには、id
フィールドのみを指定してこのリソースに対してPOSTリクエストを行います。
このグループからのホストの削除:
id
およびdisassociate
フィールドを指定してこのリソースに対してPOSTリクエストを行うと、ホストは削除されずに、このグループからホストが除去されます。
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
ルート・スキーマ : schema
例:
{
"id":1
}
レスポンス
サポートされているメディア・タイプ
- application/json
201レスポンス
レスポンスの例(application/json)
{
"ansible_facts_modified":null,
"created":"2018-02-01T08:00:00.000000Z",
"description":"Hello world",
"enabled":true,
"has_active_failures":false,
"has_inventory_sources":false,
"id":1,
"insights_system_id":null,
"instance_id":"",
"inventory":1,
"last_job":null,
"last_job_host_summary":null,
"modified":"2018-02-01T08:00:00.000000Z",
"name":"New name",
"related":{
"activity_stream":"/api/v2/hosts/1/activity_stream/",
"ad_hoc_command_events":"/api/v2/hosts/1/ad_hoc_command_events/",
"ad_hoc_commands":"/api/v2/hosts/1/ad_hoc_commands/",
"all_groups":"/api/v2/hosts/1/all_groups/",
"ansible_facts":"/api/v2/hosts/1/ansible_facts/",
"groups":"/api/v2/hosts/1/groups/",
"insights":"/api/v2/hosts/1/insights/",
"inventory":"/api/v2/inventories/1/",
"inventory_sources":"/api/v2/hosts/1/inventory_sources/",
"job_events":"/api/v2/hosts/1/job_events/",
"job_host_summaries":"/api/v2/hosts/1/job_host_summaries/",
"smart_inventories":"/api/v2/hosts/1/smart_inventories/",
"variable_data":"/api/v2/hosts/1/variable_data/"
},
"summary_fields":{
"groups":{
"count":0,
"results":[
]
},
"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
},
"recent_jobs":[
],
"user_capabilities":{
"delete":true,
"edit":true
}
},
"type":"host",
"url":"/api/v2/hosts/1/",
"variables":""
}
403レスポンス
レスポンスの例(application/json)
{
"detail":"You do not have permission to perform this action."
}