12.28. ironic node-set-provision-state


usage: ironic node-set-provision-state [--config-drive <config-drive>]
                                       [--clean-steps <clean-steps>]
                                       [--wait [WAIT_TIMEOUT]]
                                       <node> <provision-state>
Copy to Clipboard Toggle word wrap
Initiate a provisioning state change for a node.

Positional arguments

<node>


        Name or UUID of the node.

<provision-state>


        Supported states: 'deleted', 'provide', 'clean',
      'manage', 'active', 'rebuild', 'inspect', 'abort',
      'adopt'.

Optional arguments

--config-drive <config-drive>


      A gzipped, base64-encoded configuration drive string
      OR the path to the configuration drive file OR the
      path to a directory containing the config drive files.
      In case it's a directory, a config drive will be
      generated from it. This argument is only valid when
      setting provision-state to 'active'.

--clean-steps <clean-steps>


      The clean steps in JSON format. May be the path to a
      file containing the clean steps; OR '-', with the
      clean steps being read from standard input; OR a
      string. The value should be a list of clean-step
      dictionaries; each dictionary should have keys
      'interface' and 'step', and optional key 'args'. This
      argument must be specified (and is only valid) when
      setting provision-state to 'clean'.

--wait [WAIT_TIMEOUT]


      Wait for a node to reach the expected state. Not
      supported for 'abort'. Optionally takes a timeout in
      seconds. The default value is 0, meaning no timeout.
      Fails if the node reaches an unexpected stable state,
      a failure state or a state with last_error set.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat