インベントリ更新の取得
get
/api/v2/inventory_updates/{id}/
このリソースに対してGETリクエストを行って、次のフィールドを含む単一のインベントリ更新レコードを取得します。
id
: このインベントリ更新のデータベースID。(整数)type
: このインベントリ更新のデータ型。(選択)url
: このインベントリ更新のURL。(文字列)related
: 関連リソースのURLを含むデータ構造。(オブジェクト)summary_fields
: 関連リソースの名前/説明を含むデータ構造。 一部のオブジェクトの出力は、パフォーマンス上の理由によって制限される場合があります。(オブジェクト)created
: このインベントリ更新が作成されたときのタイムスタンプ。(日時)modified
: このインベントリ更新が最後に変更されたときのタイムスタンプ。(日時)name
: このインベントリ更新の名前。(文字列)description
: このインベントリ更新のオプションの説明。(文字列)source
: (選択)file
: ファイル、ディレクトリまたはスクリプトscm
: プロジェクトからのソーシングec2
: Amazon EC2gce
: Google Compute Engineazure_rm
: Microsoft Azure Resource Managervmware
: VMware vCentersatellite6
: Red Hat Satellite 6openstack
: OpenStackrhv
: Red Hat Virtualizationtower
: Ansible Towercustom
: カスタム・スクリプト
source_path
: (文字列)source_script
: (id)source_vars
: YAMLまたはJSON形式のインベントリ・ソース変数。(文字列)credential
: インベントリの更新に使用するクラウド資格証明。(整数)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"}を使用すると、ホストが有効とマークされます。 power_stateがpowered_on以外の値である場合、Towerにインポートされるときにホストは無効になります。 キーが見つからない場合、ホストは有効になります(文字列)host_filter
: 一致するホストのみがTowerにインポートされる正規表現。(文字列)overwrite
: リモート・インベントリ・ソースからローカル・グループおよびホストを上書きします。(ブール)overwrite_vars
: リモート・インベントリ・ソースからローカル変数を上書きします。(ブール)custom_virtualenv
: (文字列)timeout
: タスクが取り消されるまでの実行時間(秒)。(整数)verbosity
: (選択)0
: 0 (警告)1
: 1 (情報)2
: 2 (デバッグ)
unified_job_template
: (id)launch_type
: (選択)manual
: 手動relaunch
: 再起動callback
: コールバックscheduled
: スケジュール済dependency
: 依存性workflow
: ワークフローwebhook
: Webフックsync
: 同期scm
: SCM更新
status
: (選択)new
: 新規pending
: 保留中waiting
: 待機中running
: 実行中successful
: 成功failed
: 失敗error
: エラーcanceled
: 取消し済
failed
: (ブール)started
: ジョブが開始のためにキューに入れられた日時。(日時)finished
: ジョブの実行が終了した日時。(日時)canceled_on
: 取消しリクエストが送信された日時。(日時)elapsed
: ジョブが実行された経過時間(秒)。(10進)job_args
: (文字列)job_cwd
: (文字列)job_env
: (json)job_explanation
: stdoutを実行および取得できなかった場合のジョブの状態を示すステータス・フィールド(文字列)execution_node
: ジョブが実行されたノード。(文字列)result_traceback
: (文字列)event_processing_finished
: この統合ジョブによって生成されたすべてのイベントがデータベースに保存されたかどうかを示します。(ブール)inventory
: (id)inventory_source
: (id)license_error
: (ブール)org_host_limit_error
: (ブール)source_project_update
: このプロジェクト更新のインベントリ・ファイルがインベントリ更新に使用されました。(id)source_project
: このジョブに使用されたプロジェクト。(フィールド)
リクエスト
サポートされているメディア・タイプ
- application/json
パス・パラメータ
問合せパラメータ
- search(オプション): 文字列
検索条件。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
レスポンスの例(application/json)
{
"canceled_on":null,
"created":"2018-02-01T08:00:00.000000Z",
"credential":null,
"custom_virtualenv":null,
"description":"",
"elapsed":0,
"enabled_value":"",
"enabled_var":"",
"event_processing_finished":false,
"execution_node":"",
"failed":false,
"finished":null,
"host_filter":"",
"id":3,
"inventory":null,
"inventory_source":3,
"job_args":"",
"job_cwd":"",
"job_env":{
},
"job_explanation":"",
"launch_type":"manual",
"license_error":false,
"modified":"2018-02-01T08:00:00.000000Z",
"name":"",
"org_host_limit_error":false,
"overwrite":false,
"overwrite_vars":false,
"related":{
"cancel":"/api/v2/inventory_updates/3/cancel/",
"credentials":"/api/v2/inventory_updates/3/credentials/",
"events":"/api/v2/inventory_updates/3/events/",
"inventory_source":"/api/v2/inventory_sources/3/",
"notifications":"/api/v2/inventory_updates/3/notifications/",
"stdout":"/api/v2/inventory_updates/3/stdout/",
"unified_job_template":"/api/v2/inventory_sources/3/"
},
"result_traceback":"",
"source":"ec2",
"source_path":"",
"source_project":null,
"source_project_update":null,
"source_script":null,
"source_vars":"",
"started":null,
"status":"new",
"summary_fields":{
"credentials":[
],
"inventory_source":{
"source":"ec2",
"status":"never updated"
},
"unified_job_template":{
"description":"",
"id":3,
"name":"single-inv-src",
"unified_job_type":"inventory_update"
},
"user_capabilities":{
"delete":true,
"start":false
}
},
"timeout":0,
"type":"inventory_update",
"unified_job_template":3,
"url":"/api/v2/inventory_updates/3/",
"verbosity":1
}