---
title: "PATCH /v2/infra-envs/{infra_env_id}/hosts/{host_id}"
method: PATCH
path: "/v2/infra-envs/{infra_env_id}/hosts/{host_id}"
tags: ["installer"]
---

# PATCH /v2/infra-envs/{infra_env_id}/hosts/{host_id}

`PATCH /v2/infra-envs/{infra_env_id}/hosts/{host_id}`

Update an Openshift host

## Path parameters

- `infra_env_id` string, uuid, required
- `host_id` string, uuid, required

## Request body

- HostUpdateParams
  - `host_role` 'auto-assign' | 'master' | 'arbiter' | 'worker', nullable
  - `host_name` string, nullable
  - `disks_selected_config` DiskConfigParams[], nullable
    - `id` string, required
    - `role` 'none' | 'install'
  - `disks_skip_formatting` DiskSkipFormattingParams[], nullable — Allows changing the host's skip_formatting_disks parameter
    - `disk_id` string, required — The ID of the disk that is being added to or removed from the host's skip_formatting_disks list
    - `skip_formatting` boolean, required — True if you wish to add the disk to the skip_formatting_disks list, false if you wish to remove it
  - `machine_config_pool_name` string, nullable
  - `ignition_endpoint_token` string, nullable — A string which will be used as Authorization Bearer token to fetch the ignition from ignition_endpoint_url.
  - `ignition_endpoint_http_headers` IgnitionEndpointHttpHeadersParams[], nullable — JSON-formatted string of additional HTTP headers when fetching the ignition.
    - `key` string, required — The key for the http header's key-value pair.
    - `value` string, required — The value for the http header's key-value pair.
  - `node_labels` NodeLabelParams[], nullable — Labels to be added to the corresponding node.
    - `key` string, required — The key for the label's key-value pair.
    - `value` string, required — The value for the label's key-value pair.
  - `fencing_credentials` FencingCredentialsParams
    - `address` string, required — The URL of the host's BMC, for example https://bmc1.example.com.
    - `username` string, required — The username to connect to the host's BMC.
    - `password` string, required — The password to connect to the host's BMC.
    - `certificate_verification` 'Enabled' | 'Disabled' — Whether to enable or disable certificate verification when connecting to the host's BMC.
    - `mac_address` string, nullable — The MAC address identifying the host for MAC-based fencing credentials.

## Response `201`

Success.

- Host
  - `kind` 'Host' | 'AddToExistingClusterHost', required — Indicates the type of this object. Will be 'Host' if this is a complete object or 'HostLink' if it is just a link, or 'AddToExistingClusterHost' for host being added to existing OCP cluster, or
  - `id` string, uuid, required — Unique identifier of the object.
  - `href` string, required — Self link.
  - `cluster_id` string, uuid, nullable — The cluster that this host is associated with.
  - `infra_env_id` string, uuid — The infra-env that this host is associated with.
  - `status` 'discovering' | 'known' | 'disconnected' | 'insufficient' | 'disabled' | 'preparing-for-installation' | 'preparing-failed' | 'preparing-successful' | 'pending-for-input' | 'installing' | 'installing-in-progress' | 'installing-pending-user-action' | 'resetting-pending-user-action' | 'installed' | 'error' | 'resetting' | 'added-to-existing-cluster' | 'cancelled' | 'binding' | 'unbinding' | 'unbinding-pending-user-action' | 'known-unbound' | 'disconnected-unbound' | 'insufficient-unbound' | 'disabled-unbound' | 'discovering-unbound' | 'reclaiming' | 'reclaiming-rebooting', required
  - `status_info` string, required
  - `validations_info` string — JSON-formatted string containing the validation results for each validation id grouped by category (network, hardware, etc.)
  - `logs_info` 'requested' | 'collecting' | 'completed' | 'timeout' | ''
  - `status_updated_at` string, date-time — The last time that the host status was updated.
  - `progress` HostProgressInfo
    - `installation_percentage` integer
    - `current_stage` 'Starting installation' | 'Waiting for control plane' | 'Waiting for bootkube' | 'Waiting for controller' | 'Installing' | 'Writing image to disk' | 'Copying registry data to disk' | 'Rebooting' | 'Waiting for ignition' | 'Configuring' | 'Joined' | 'Done' | 'Failed'
    - `progress_info` string
    - `stage_started_at` string, date-time — Time at which the current progress stage started.
    - `stage_updated_at` string, date-time — Time at which the current progress stage was last updated.
    - `stage_timed_out` boolean — Indicate of the current stage has been timed out.
  - `stage_started_at` string, date-time — Time at which the current progress stage started.
  - `stage_updated_at` string, date-time — Time at which the current progress stage was last updated.
  - `progress_stages` HostStage[], nullable
  - `connectivity` string
  - `api_vip_connectivity` string — Contains a serialized api_vip_connectivity_response
  - `tang_connectivity` string
  - `inventory` string
  - `free_addresses` string
  - `ntp_sources` string — The configured NTP sources on the host.
  - `disks_info` string — Additional information about disks, formatted as JSON.
  - `role` 'auto-assign' | 'master' | 'arbiter' | 'worker' | 'bootstrap'
  - `suggested_role` 'auto-assign' | 'master' | 'arbiter' | 'worker' | 'bootstrap'
  - `bootstrap` boolean
  - `logs_collected_at` string, date-time
  - `logs_started_at` string, date-time
  - `installer_version` string — Installer version.
  - `installation_disk_path` string — Contains the inventory disk path, This field is replaced by installation_disk_id field and used for backward compatability with the old UI.
  - `installation_disk_id` string — Contains the inventory disk id to install on.
  - `updated_at` string, date-time
  - `created_at` string, date-time
  - `checked_in_at` string, date-time — The last time the host's agent communicated with the service.
  - `connection_timed_out` boolean — Indicate that connection to assisted service was timed out when soft timeout is enabled.
  - `registered_at` string, date-time — The last time the host's agent tried to register in the service.
  - `discovery_agent_version` string
  - `requested_hostname` string
  - `user_name` string
  - `media_status` 'connected' | 'disconnected', nullable
  - `deleted_at` unknown
  - `ignition_config_overrides` string — Json formatted string containing the user overrides for the host's pointer ignition
  - `installer_args` string
  - `timestamp` integer — The time on the host as seconds since the Unix epoch.
  - `machine_config_pool_name` string
  - `images_status` string — Array of image statuses.
  - `domain_name_resolutions` string — The domain name resolution result.
  - `ignition_endpoint_token_set` boolean — True if the token to fetch the ignition from ignition_endpoint_url is set.
  - `node_labels` string — Json containing node's labels.
  - `disks_to_be_formatted` string — A comma-separated list of disks that will be formatted once installation begins, unless otherwise set to be skipped by skip_formatting_disks. This means that this list also includes disks that appear in skip_formatting_disks. This property is managed by the service and cannot be modified by the user.
  - `skip_formatting_disks` string — A comma-seperated list of host disks that the service will avoid formatting.
  - `fencing_credentials` string — The host's BMC credentials that will be used in TNF.

## Other responses

- `400` — Error.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Error.
- `405` — Method Not Allowed.
- `409` — Error.
- `500` — Error.

---

[API](https://skmtc.dev/openshift/apis/assistedinstall.md) · [All operations](https://skmtc.dev/openshift/apis/assistedinstall/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openshift/assistedinstall/revisions/bbead335db34/schema)