---
title: "Updates a host."
method: PATCH
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/hosts/{hostName}"
tags: ["Hosts"]
---

# Updates a host.

`PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ConnectedVMwarevSphere/hosts/{hostName}`

API to update certain properties of the host resource.

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `hostName` string, required

## Query parameters

- `api-version` string, required

## Request body

- ResourcePatch — Object containing updates for patch operations.
  - `tags` object — Resource tags.

## Response `200`

Arm resource update successful.

- Host — Define the host.
  - `properties` HostProperties, required — Describes the properties of a Host.
    - `uuid` string — Gets or sets a unique identifier for this resource.
    - `vCenterId` string — Gets or sets the ARM Id of the vCenter resource in which this host resides.
    - `moRefId` string — Gets or sets the vCenter MoRef (Managed Object Reference) ID for the host.
    - `inventoryItemId` string — Gets or sets the inventory Item ID for the host.
    - `moName` string — Gets or sets the vCenter Managed Object name for the host.
    - `statuses` ResourceStatus[] — The resource status information.
      - `type` string — The type of the condition.
      - `status` string — Status of the condition.
      - `reason` string — The reason for the condition's status.
      - `message` string — A human readable message indicating details about the status.
      - `severity` string — Severity with which to treat failures of this type of condition.
      - `lastUpdatedAt` string, date-time — The last update time for this condition.
    - `customResourceName` string — Gets the name of the corresponding resource in Kubernetes.
    - `overallMemoryUsageGB` integer — Gets the used physical memory on the host in GB.
    - `memorySizeGB` integer — Gets the total amount of physical memory on the host in GB.
    - `overallCpuUsageMHz` integer — Gets the used CPU usage across all cores in MHz.
    - `cpuMhz` integer — Gets the max CPU usage across all cores in MHz.
    - `datastoreIds` string[] — Gets the datastore ARM ids.
    - `networkIds` string[] — Gets the network ARM ids.
    - `provisioningState` 'Succeeded' | 'Failed' | 'Canceled' | 'Provisioning' | 'Updating' | 'Deleting' | 'Accepted' | 'Created' — The current deployment state of resource.
  - `location` string, required — Gets or sets the location.
  - `extendedLocation` ExtendedLocation — The extended location.
    - `type` string — The extended location type.
    - `name` string — The extended location name.
  - `systemData` SystemData — unresolved $ref
  - `tags` object — Gets or sets the Resource tags.
  - `name` string — Gets or sets the name.
  - `id` string — Gets or sets the Id.
  - `type` string — Gets or sets the type of the resource.
  - `kind` string — Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type; e.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.dev/azure/apis/connectedvmware-microsoft-connectedvmwarevsphere.md) · [All operations](https://skmtc.dev/azure/apis/connectedvmware-microsoft-connectedvmwarevsphere/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/connectedvmware-microsoft-connectedvmwarevsphere/revisions/81d67c5b52dd/schema)