グループのグループの作成

post

/api/v2/groups/{id}/children/

次のグループ・フィールドを指定してこのリソースに対してPOSTリクエストを行って、このグループに関連付けられる新しいグループを作成します。

name: このグループの名前。(文字列、必須)
description: このグループのオプションの説明。(文字列、デフォルト="")
inventory: (id、必須)
variables: JSONまたはYAML形式のグループ変数。(json、デフォルト=``)

グループのグループの追加:

このグループに既存のグループを関連付けるには、idフィールドのみを指定してこのリソースに対してPOSTリクエストを行います。

このグループからのグループの削除:

idおよびdisassociateフィールドを指定してこのリソースに対してPOSTリクエストを行うと、グループは削除されずに、このグループからグループが除去されます。

リクエスト

サポートされているメディア・タイプ

application/json

パス・パラメータ

id: 文字列

ルート・スキーマ : 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."
}

先頭に戻る