機械翻訳について

インベントリ・ソースの作成

post

/api/v2/inventory_sources/

次のインベントリ・ソース・フィールドを指定してこのリソースに対してPOSTリクエストを行って、新しいインベントリ・ソースを作成します。

  • name: このインベントリ・ソースの名前。(文字列、必須)
  • description: このインベントリ・ソースのオプションの説明。(文字列、デフォルト="")
  • source: (選択)
    • file: ファイル、ディレクトリまたはスクリプト
    • scm: プロジェクトからのソーシング
    • ec2: Amazon EC2
    • gce: Google Compute Engine
    • azure_rm: Microsoft Azure Resource Manager
    • vmware: VMware vCenter
    • satellite6: Red Hat Satellite 6
    • openstack: OpenStack
    • rhv: Red Hat Virtualization
    • controller: Red Hat Ansible自動化プラットフォーム
    • insights: Red Hat Insights
  • source_path: (文字列、デフォルト="")
  • source_vars: YAMLまたはJSON形式のインベントリ・ソース変数。(文字列、デフォルト="")
  • credential: インベントリの更新に使用するクラウド資格証明。(整数、デフォルト=None)
  • enabled_var: 対象となるホスト変数のディクショナリから有効状態を取得します。 有効化された変数は「foo.bar」のように指定でき、この場合は、ネストされた辞書を横断してルックアップが行われ、from_dict.get("foo", {}).get("bar", default) (文字列、デフォルト="")と同等になります
  • enabled_value: enabled_varが設定されている場合にのみ使用されます。 ホストが有効とみなされるときの値。 たとえば、enabled_var="status.power_state"およびenabled_value="powered_on"でホスト変数{ "status": { "power_state": "powered_on", "created": "2018-02-01T08:00:00.000000Z:00", "healthy": true }, "name": "foobar", "ip_address": "192.168.2.1"}を使用すると、ホストが有効とマークされます。 powered_on以外の値がpower_stateの場合、インポート時にホストは無効になります。 キーが見つからない場合、ホストは有効になります(文字列、デフォルト="")
  • host_filter: 一致するホストのみがインポートされる正規表現。(文字列、デフォルト="")
  • overwrite: リモート・インベントリ・ソースからローカル・グループおよびホストを上書きします。(ブール、デフォルト=False)
  • overwrite_vars: リモート・インベントリ・ソースからローカル変数を上書きします。(ブール、デフォルト=False)

  • timeout: タスクが取り消されるまでの実行時間(秒)。(整数、デフォルト=0)

  • verbosity: (選択)

    • 0: 0 (警告)
    • 1: 1 (情報) (デフォルト)
    • 2: 2 (デバッグ)
  • execution_environment: 実行に使用されるコンテナ・イメージ。(id、デフォルト=``)

  • inventory: (id、必須)
  • update_on_launch: (ブール、デフォルト=False)
  • update_cache_timeout: (整数、デフォルト=0)
  • source_project: ソースとして使用されるインベントリ・ファイルを含むプロジェクト。(id、デフォルト=``)
  • update_on_project_update: (ブール、デフォルト=False)

リクエスト

サポートされているメディア・タイプ
本文()
ルート・スキーマ : schema
例:
{
    "credential":1,
    "inventory":1,
    "name":"fobar",
    "source":"scm",
    "source_path":"",
    "source_project":1,
    "source_vars":"plugin: a.b.c"
}
先頭に戻る

レスポンス

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

201レスポンス

本文
レスポンスの例(application/json)
{
    "created":"2018-02-01T08:00:00.000000Z",
    "credential":1,
    "custom_virtualenv":null,
    "description":"",
    "enabled_value":"",
    "enabled_var":"",
    "execution_environment":null,
    "host_filter":"",
    "id":2,
    "inventory":1,
    "last_job_failed":false,
    "last_job_run":null,
    "last_update_failed":false,
    "last_updated":null,
    "modified":"2018-02-01T08:00:00.000000Z",
    "name":"fobar",
    "next_job_run":null,
    "overwrite":false,
    "overwrite_vars":false,
    "related":{
        "activity_stream":"/api/v2/inventory_sources/2/activity_stream/",
        "credential":"/api/v2/credentials/1/",
        "credentials":"/api/v2/inventory_sources/2/credentials/",
        "groups":"/api/v2/inventory_sources/2/groups/",
        "hosts":"/api/v2/inventory_sources/2/hosts/",
        "inventory":"/api/v2/inventories/1/",
        "inventory_updates":"/api/v2/inventory_sources/2/inventory_updates/",
        "notification_templates_error":"/api/v2/inventory_sources/2/notification_templates_error/",
        "notification_templates_started":"/api/v2/inventory_sources/2/notification_templates_started/",
        "notification_templates_success":"/api/v2/inventory_sources/2/notification_templates_success/",
        "schedules":"/api/v2/inventory_sources/2/schedules/",
        "source_project":"/api/v2/projects/1/",
        "update":"/api/v2/inventory_sources/2/update/"
    },
    "source":"scm",
    "source_path":"",
    "source_project":1,
    "source_vars":"plugin: a.b.c",
    "status":"never updated",
    "summary_fields":{
        "credential":{
            "cloud":true,
            "credential_type_id":1,
            "description":"",
            "id":1,
            "kind":"openstack",
            "name":"bar"
        },
        "credentials":[
            {
                "cloud":true,
                "credential_type_id":1,
                "description":"",
                "id":1,
                "kind":"openstack",
                "name":"bar"
            }
        ],
        "inventory":{
            "description":"",
            "has_active_failures":false,
            "has_inventory_sources":true,
            "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":1
        },
        "organization":{
            "description":"test-org-desc",
            "id":1,
            "name":"test-org"
        },
        "source_project":{
            "description":"test-proj-desc",
            "id":1,
            "name":"test-proj",
            "scm_type":"git",
            "status":"never updated"
        },
        "user_capabilities":{
            "delete":true,
            "edit":true,
            "schedule":true,
            "start":true
        }
    },
    "timeout":0,
    "type":"inventory_source",
    "update_cache_timeout":0,
    "update_on_launch":false,
    "update_on_project_update":false,
    "url":"/api/v2/inventory_sources/2/",
    "verbosity":1
}

400レスポンス

本文
レスポンスの例(application/json)
{
    "credential":[
        "Credentials of type insights and vault are disallowed for scm inventory sources."
    ]
}
先頭に戻る