Jump to

• Request
• Response

Update an Inventory

put

/api/v2/constructed_inventories/{id}/

Make a PUT or PATCH request to this resource to update this inventory. The following fields may be modified:

• name: Name of this inventory. (string, required)
• description: Optional description of this inventory. (string, default="")

• organization: Organization containing this inventory. (id, required)

• variables: Inventory variables in JSON or YAML format. (json, default=``)

• prevent_instance_group_fallback: If enabled, the inventory will prevent adding any organization instance groups to the list of preferred instances groups to run associated job templates on.If this setting is enabled and you provided an empty list, the global instance groups will be applied. (boolean, default=False)

• source_vars: The source_vars for the related auto-created inventory source, special to constructed inventory. (string, default="")
• update_cache_timeout: The cache timeout for the related auto-created inventory source, special to constructed inventory (integer, default=None)
• limit: The limit to restrict the returned hosts for the related auto-created inventory source, special to constructed inventory. (string, default="")
• verbosity: The verbosity level for the related auto-created inventory source, special to constructed inventory (integer, default=None)

For a PUT request, include all fields in the request.

Request

Supported Media Types

• application/json

Path Parameters

• id(required): string

Body ()

Root Schema : ConstructedInventory

Type: object

Show Source

• created: string
  Title: Created

  Read Only: true
• description: string
  Title: Description
• has_active_failures: boolean
  Title: Has active failures

  Read Only: true

  This field is deprecated and will be removed in a future release. Flag indicating whether any hosts in this inventory have failed.
• has_inventory_sources: boolean
  Title: Has inventory sources

  Read Only: true

  This field is deprecated and will be removed in a future release. Flag indicating whether this inventory has any external inventory sources.
• hosts_with_active_failures: integer
  Title: Hosts with active failures

  Read Only: true

  Minimum Value: 0

  This field is deprecated and will be removed in a future release. Number of hosts in this inventory with active failures.
• id: integer
  Title: ID

  Read Only: true
• inventory_sources_with_failures: integer
  Title: Inventory sources with failures

  Read Only: true

  Minimum Value: 0

  Number of external inventory sources in this inventory with failures.
• kind: string
  Title: Kind

  Read Only: true

  Allowed Values: [ "", "smart", "constructed" ]

  Kind of inventory being represented.
• limit: string
  Title: Limit

  The limit to restrict the returned hosts for the related auto-created inventory source, special to constructed inventory.
• modified: string
  Title: Modified

  Read Only: true
• name(required): string
  Title: Name

  Minimum Length: 1

  Maximum Length: 512
• organization(required): integer
  Title: Organization

  Organization containing this inventory.
• pending_deletion: boolean
  Title: Pending deletion

  Read Only: true

  Flag indicating the inventory is being deleted.
• prevent_instance_group_fallback: boolean
  Title: Prevent instance group fallback

  If enabled, the inventory will prevent adding any organization instance groups to the list of preferred instances groups to run associated job templates on.If this setting is enabled and you provided an empty list, the global instance groups will be applied.
• related: string
  Title: Related

  Read Only: true
• source_vars: string
  Title: Source vars

  The source_vars for the related auto-created inventory source, special to constructed inventory.
• summary_fields: string
  Title: Summary fields

  Read Only: true
• total_groups: integer
  Title: Total groups

  Read Only: true

  Minimum Value: 0

  This field is deprecated and will be removed in a future release. Total number of groups in this inventory.
• total_hosts: integer
  Title: Total hosts

  Read Only: true

  Minimum Value: 0

  This field is deprecated and will be removed in a future release. Total number of hosts in this inventory.
• total_inventory_sources: integer
  Title: Total inventory sources

  Read Only: true

  Minimum Value: 0

  Total number of external inventory sources configured within this inventory.
• type: string
  Title: Type

  Read Only: true
• update_cache_timeout: integer
  Title: Update cache timeout

  Minimum Value: 0

  The cache timeout for the related auto-created inventory source, special to constructed inventory
• url: string
  Title: Url

  Read Only: true
• variables: string
  Title: Variables

  Inventory variables in JSON or YAML format.
• verbosity: integer
  Title: Verbosity

  Minimum Value: 0

  Maximum Value: 2

  The verbosity level for the related auto-created inventory source, special to constructed inventory

{
    "properties":{
        "created":{
            "readOnly":true,
            "title":"Created",
            "type":"string"
        },
        "description":{
            "title":"Description",
            "type":"string",
            "x-nullable":true
        },
        "has_active_failures":{
            "description":"This field is deprecated and will be removed in a future release. Flag indicating whether any hosts in this inventory have failed.",
            "readOnly":true,
            "title":"Has active failures",
            "type":"boolean"
        },
        "has_inventory_sources":{
            "description":"This field is deprecated and will be removed in a future release. Flag indicating whether this inventory has any external inventory sources.",
            "readOnly":true,
            "title":"Has inventory sources",
            "type":"boolean"
        },
        "hosts_with_active_failures":{
            "description":"This field is deprecated and will be removed in a future release. Number of hosts in this inventory with active failures.",
            "minimum":"0",
            "readOnly":true,
            "title":"Hosts with active failures",
            "type":"integer"
        },
        "id":{
            "readOnly":true,
            "title":"ID",
            "type":"integer"
        },
        "inventory_sources_with_failures":{
            "description":"Number of external inventory sources in this inventory with failures.",
            "minimum":"0",
            "readOnly":true,
            "title":"Inventory sources with failures",
            "type":"integer"
        },
        "kind":{
            "description":"Kind of inventory being represented.",
            "enum":[
                "",
                "smart",
                "constructed"
            ],
            "readOnly":true,
            "title":"Kind",
            "type":"string",
            "x-nullable":true
        },
        "limit":{
            "description":"The limit to restrict the returned hosts for the related auto-created inventory source, special to constructed inventory.",
            "title":"Limit",
            "type":"string"
        },
        "modified":{
            "readOnly":true,
            "title":"Modified",
            "type":"string"
        },
        "name":{
            "maxLength":"512",
            "minLength":"1",
            "title":"Name",
            "type":"string",
            "x-nullable":true
        },
        "organization":{
            "description":"Organization containing this inventory.",
            "title":"Organization",
            "type":"integer",
            "x-nullable":true
        },
        "pending_deletion":{
            "description":"Flag indicating the inventory is being deleted.",
            "readOnly":true,
            "title":"Pending deletion",
            "type":"boolean"
        },
        "prevent_instance_group_fallback":{
            "description":"If enabled, the inventory will prevent adding any organization instance groups to the list of preferred instances groups to run associated job templates on.If this setting is enabled and you provided an empty list, the global instance groups will be applied.",
            "title":"Prevent instance group fallback",
            "type":"boolean",
            "x-nullable":true
        },
        "related":{
            "readOnly":true,
            "title":"Related",
            "type":"string"
        },
        "source_vars":{
            "description":"The source_vars for the related auto-created inventory source, special to constructed inventory.",
            "title":"Source vars",
            "type":"string"
        },
        "summary_fields":{
            "readOnly":true,
            "title":"Summary fields",
            "type":"string"
        },
        "total_groups":{
            "description":"This field is deprecated and will be removed in a future release. Total number of groups in this inventory.",
            "minimum":"0",
            "readOnly":true,
            "title":"Total groups",
            "type":"integer"
        },
        "total_hosts":{
            "description":"This field is deprecated and will be removed in a future release. Total number of hosts in this inventory.",
            "minimum":"0",
            "readOnly":true,
            "title":"Total hosts",
            "type":"integer"
        },
        "total_inventory_sources":{
            "description":"Total number of external inventory sources configured within this inventory.",
            "minimum":"0",
            "readOnly":true,
            "title":"Total inventory sources",
            "type":"integer"
        },
        "type":{
            "readOnly":true,
            "title":"Type",
            "type":"string"
        },
        "update_cache_timeout":{
            "description":"The cache timeout for the related auto-created inventory source, special to constructed inventory",
            "minimum":"0",
            "title":"Update cache timeout",
            "type":"integer",
            "x-nullable":true
        },
        "url":{
            "readOnly":true,
            "title":"Url",
            "type":"string"
        },
        "variables":{
            "description":"Inventory variables in JSON or YAML format.",
            "title":"Variables",
            "type":"string",
            "x-nullable":true
        },
        "verbosity":{
            "description":"The verbosity level for the related auto-created inventory source, special to constructed inventory",
            "maximum":"2",
            "minimum":"0",
            "title":"Verbosity",
            "type":"integer",
            "x-nullable":true
        }
    },
    "required":[
        "name",
        "organization"
    ],
    "type":"object"
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Body ()

Root Schema : ConstructedInventory

Type: object

Show Source

• created: string
  Title: Created

  Read Only: true
• description: string
  Title: Description
• has_active_failures: boolean
  Title: Has active failures

  Read Only: true

  This field is deprecated and will be removed in a future release. Flag indicating whether any hosts in this inventory have failed.
• has_inventory_sources: boolean
  Title: Has inventory sources

  Read Only: true

  This field is deprecated and will be removed in a future release. Flag indicating whether this inventory has any external inventory sources.
• hosts_with_active_failures: integer
  Title: Hosts with active failures

  Read Only: true

  Minimum Value: 0

  This field is deprecated and will be removed in a future release. Number of hosts in this inventory with active failures.
• id: integer
  Title: ID

  Read Only: true
• inventory_sources_with_failures: integer
  Title: Inventory sources with failures

  Read Only: true

  Minimum Value: 0

  Number of external inventory sources in this inventory with failures.
• kind: string
  Title: Kind

  Read Only: true

  Allowed Values: [ "", "smart", "constructed" ]

  Kind of inventory being represented.
• limit: string
  Title: Limit

  The limit to restrict the returned hosts for the related auto-created inventory source, special to constructed inventory.
• modified: string
  Title: Modified

  Read Only: true
• name(required): string
  Title: Name

  Minimum Length: 1

  Maximum Length: 512
• organization(required): integer
  Title: Organization

  Organization containing this inventory.
• pending_deletion: boolean
  Title: Pending deletion

  Read Only: true

  Flag indicating the inventory is being deleted.
• prevent_instance_group_fallback: boolean
  Title: Prevent instance group fallback

  If enabled, the inventory will prevent adding any organization instance groups to the list of preferred instances groups to run associated job templates on.If this setting is enabled and you provided an empty list, the global instance groups will be applied.
• related: string
  Title: Related

  Read Only: true
• source_vars: string
  Title: Source vars

  The source_vars for the related auto-created inventory source, special to constructed inventory.
• summary_fields: string
  Title: Summary fields

  Read Only: true
• total_groups: integer
  Title: Total groups

  Read Only: true

  Minimum Value: 0

  This field is deprecated and will be removed in a future release. Total number of groups in this inventory.
• total_hosts: integer
  Title: Total hosts

  Read Only: true

  Minimum Value: 0

  This field is deprecated and will be removed in a future release. Total number of hosts in this inventory.
• total_inventory_sources: integer
  Title: Total inventory sources

  Read Only: true

  Minimum Value: 0

  Total number of external inventory sources configured within this inventory.
• type: string
  Title: Type

  Read Only: true
• update_cache_timeout: integer
  Title: Update cache timeout

  Minimum Value: 0

  The cache timeout for the related auto-created inventory source, special to constructed inventory
• url: string
  Title: Url

  Read Only: true
• variables: string
  Title: Variables

  Inventory variables in JSON or YAML format.
• verbosity: integer
  Title: Verbosity

  Minimum Value: 0

  Maximum Value: 2

  The verbosity level for the related auto-created inventory source, special to constructed inventory

{
    "properties":{
        "created":{
            "readOnly":true,
            "title":"Created",
            "type":"string"
        },
        "description":{
            "title":"Description",
            "type":"string",
            "x-nullable":true
        },
        "has_active_failures":{
            "description":"This field is deprecated and will be removed in a future release. Flag indicating whether any hosts in this inventory have failed.",
            "readOnly":true,
            "title":"Has active failures",
            "type":"boolean"
        },
        "has_inventory_sources":{
            "description":"This field is deprecated and will be removed in a future release. Flag indicating whether this inventory has any external inventory sources.",
            "readOnly":true,
            "title":"Has inventory sources",
            "type":"boolean"
        },
        "hosts_with_active_failures":{
            "description":"This field is deprecated and will be removed in a future release. Number of hosts in this inventory with active failures.",
            "minimum":"0",
            "readOnly":true,
            "title":"Hosts with active failures",
            "type":"integer"
        },
        "id":{
            "readOnly":true,
            "title":"ID",
            "type":"integer"
        },
        "inventory_sources_with_failures":{
            "description":"Number of external inventory sources in this inventory with failures.",
            "minimum":"0",
            "readOnly":true,
            "title":"Inventory sources with failures",
            "type":"integer"
        },
        "kind":{
            "description":"Kind of inventory being represented.",
            "enum":[
                "",
                "smart",
                "constructed"
            ],
            "readOnly":true,
            "title":"Kind",
            "type":"string",
            "x-nullable":true
        },
        "limit":{
            "description":"The limit to restrict the returned hosts for the related auto-created inventory source, special to constructed inventory.",
            "title":"Limit",
            "type":"string"
        },
        "modified":{
            "readOnly":true,
            "title":"Modified",
            "type":"string"
        },
        "name":{
            "maxLength":"512",
            "minLength":"1",
            "title":"Name",
            "type":"string",
            "x-nullable":true
        },
        "organization":{
            "description":"Organization containing this inventory.",
            "title":"Organization",
            "type":"integer",
            "x-nullable":true
        },
        "pending_deletion":{
            "description":"Flag indicating the inventory is being deleted.",
            "readOnly":true,
            "title":"Pending deletion",
            "type":"boolean"
        },
        "prevent_instance_group_fallback":{
            "description":"If enabled, the inventory will prevent adding any organization instance groups to the list of preferred instances groups to run associated job templates on.If this setting is enabled and you provided an empty list, the global instance groups will be applied.",
            "title":"Prevent instance group fallback",
            "type":"boolean",
            "x-nullable":true
        },
        "related":{
            "readOnly":true,
            "title":"Related",
            "type":"string"
        },
        "source_vars":{
            "description":"The source_vars for the related auto-created inventory source, special to constructed inventory.",
            "title":"Source vars",
            "type":"string"
        },
        "summary_fields":{
            "readOnly":true,
            "title":"Summary fields",
            "type":"string"
        },
        "total_groups":{
            "description":"This field is deprecated and will be removed in a future release. Total number of groups in this inventory.",
            "minimum":"0",
            "readOnly":true,
            "title":"Total groups",
            "type":"integer"
        },
        "total_hosts":{
            "description":"This field is deprecated and will be removed in a future release. Total number of hosts in this inventory.",
            "minimum":"0",
            "readOnly":true,
            "title":"Total hosts",
            "type":"integer"
        },
        "total_inventory_sources":{
            "description":"Total number of external inventory sources configured within this inventory.",
            "minimum":"0",
            "readOnly":true,
            "title":"Total inventory sources",
            "type":"integer"
        },
        "type":{
            "readOnly":true,
            "title":"Type",
            "type":"string"
        },
        "update_cache_timeout":{
            "description":"The cache timeout for the related auto-created inventory source, special to constructed inventory",
            "minimum":"0",
            "title":"Update cache timeout",
            "type":"integer",
            "x-nullable":true
        },
        "url":{
            "readOnly":true,
            "title":"Url",
            "type":"string"
        },
        "variables":{
            "description":"Inventory variables in JSON or YAML format.",
            "title":"Variables",
            "type":"string",
            "x-nullable":true
        },
        "verbosity":{
            "description":"The verbosity level for the related auto-created inventory source, special to constructed inventory",
            "maximum":"2",
            "minimum":"0",
            "title":"Verbosity",
            "type":"integer",
            "x-nullable":true
        }
    },
    "required":[
        "name",
        "organization"
    ],
    "type":"object"
}

Back to Top