Update an Inventory Source
put
/api/v2/inventory_sources/{id}/
Make a PUT or PATCH request to this resource to update this inventory source. The following fields may be modified:
name
: Name of this inventory source. (string, required)description
: Optional description of this inventory source. (string, default=""
)source
: (choice)file
: File, Directory or Scriptscm
: Sourced from a Projectec2
: Amazon EC2gce
: Google Compute Engineazure_rm
: Microsoft Azure Resource Managervmware
: VMware vCentersatellite6
: Red Hat Satellite 6openstack
: OpenStackrhv
: Red Hat Virtualizationcontroller
: Red Hat Ansible Automation Platforminsights
: Red Hat Insights
source_path
: (string, default=""
)source_vars
: Inventory source variables in YAML or JSON format. (string, default=""
)credential
: Cloud credential to use for inventory updates. (integer, default=None
)enabled_var
: Retrieve the enabled state from the given dict of host variables. The enabled variable may be specified as "foo.bar", in which case the lookup will traverse into nested dicts, equivalent to: from_dict.get("foo", {}).get("bar", default) (string, default=""
)enabled_value
: Only used when enabled_var is set. Value when the host is considered enabled. For example if enabled_var="status.power_state"and enabled_value="powered_on" with host variables:{ "status": { "power_state": "powered_on", "created": "2018-02-01T08:00:00.000000Z:00", "healthy": true }, "name": "foobar", "ip_address": "192.168.2.1"}The host would be marked enabled. If power_state where any value other than powered_on then the host would be disabled when imported. If the key is not found then the host will be enabled (string, default=""
)host_filter
: Regex where only matching hosts will be imported. (string, default=""
)overwrite
: Overwrite local groups and hosts from remote inventory source. (boolean, default=False
)-
overwrite_vars
: Overwrite local variables from remote inventory source. (boolean, default=False
) -
timeout
: The amount of time (in seconds) to run before the task is canceled. (integer, default=0
) -
verbosity
: (choice)0
: 0 (WARNING)1
: 1 (INFO) (default)2
: 2 (DEBUG)
-
execution_environment
: The container image to be used for execution. (id, default=``) inventory
: (id, required)update_on_launch
: (boolean, default=False
)update_cache_timeout
: (integer, default=0
)source_project
: Project containing inventory file used as source. (id, default=``)update_on_project_update
: (boolean, default=False
)
For a PUT request, include all fields in the request.
Request
Supported Media Types
- application/json
Path Parameters
Query Parameters
-
search: string
A search term.
Root Schema : schema
Type:
Show Source
object
-
credential:
integer
Cloud credential to use for inventory updates.
-
description:
string
-
enabled_value:
string
Only used when enabled_var is set. Value when the host is considered enabled. For example if enabled_var="status.power_state"and enabled_value="powered_on" with host variables:{ "status": { "power_state": "powered_on", "created": "2018-02-01T08:00:00.000000Z:00", "healthy": true }, "name": "foobar", "ip_address": "192.168.2.1"}The host would be marked enabled. If power_state where any value other than powered_on then the host would be disabled when imported. If the key is not found then the host will be enabled
-
enabled_var:
string
Retrieve the enabled state from the given dict of host variables. The enabled variable may be specified as "foo.bar", in which case the lookup will traverse into nested dicts, equivalent to: from_dict.get("foo", {}).get("bar", default)
-
execution_environment:
integer
The container image to be used for execution.
-
host_filter:
string
Regex where only matching hosts will be imported.
-
inventory(required):
integer
-
name(required):
string
-
overwrite:
boolean
Overwrite local groups and hosts from remote inventory source.
-
overwrite_vars:
boolean
Overwrite local variables from remote inventory source.
-
source:
string
-
source_path:
string
-
source_project:
string
Project containing inventory file used as source.
-
source_vars:
string
Inventory source variables in YAML or JSON format.
-
timeout:
integer
The amount of time (in seconds) to run before the task is canceled.
-
update_cache_timeout:
integer
-
update_on_launch:
boolean
-
update_on_project_update:
boolean
-
verbosity:
string