---
title: "Update host info"
method: PUT
path: "/resources/host"
tags: ["resource"]
---

# Update host info

`PUT /resources/host`

update host information

## Request body

- MessageUpdateHostInfoReq
  - `newHostInfo` StructsHostInfo
    - `arch` string — x86 or arm64
    - `availableDiskCount` integer — available disk count which could be used for allocation
    - `az` string
    - `clusterType` string — What cluster is the host used for? [database/data migration]
    - `cpuCores` integer — Host cpu cores spec, init while importing
    - `createTime` integer
    - `diskType` string — Disk type of this host [SATA/SSD/NVMeSSD]
    - `disks` StructsDiskInfo[]
      - `capacity` integer — Disk size, Unit: GB
      - `diskId` string
      - `hostId` string
      - `name` string — [sda/sdb/nvmep0...]
      - `path` string — Disk mount path: [/data1]
      - `status` string — Disk Status, 0 for available, 1 for inused
      - `type` string — Disk type: [nvme-ssd/ssd/sata]
    - `hostId` string
    - `hostName` string
    - `instances` object
    - `ip` string
    - `kernel` string
    - `loadStat` string — Host load stat, Loadless, Inused, Exhaust, etc
    - `memory` integer — Host memory, init while importing
    - `nic` string — Host network type: 1GE or 10GE
    - `os` string
    - `passwd` string
    - `purpose` string — What Purpose is the host used for? [compute/storage/schedule]
    - `rack` string
    - `region` string
    - `reserved` boolean — Whether this host is reserved - will not be allocated
    - `spec` string — Host Spec, init while importing
    - `sshPort` integer
    - `status` string — Host status, Online, Offline, Failed, Deleted, etc
    - `sysLabels` string[]
    - `traits` integer — Traits of labels
    - `updateTime` integer
    - `usedCpuCores` integer — Unused CpuCore, used for allocation
    - `usedMemory` integer — Unused memory size, Unit:GiB, used for allocation
    - `userName` string
    - `vendor` string

## Response `200`

OK

- object
  - `code` integer
  - `data` object
  - `message` string

---

[API](https://skmtc.net/pingcap/apis/em-ui-api.md) · [All operations](https://skmtc.net/pingcap/apis/em-ui-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pingcap/em-ui-api/revisions/631e4b26b7e8/schema)