---
title: "POST /v1/{+parent}/hostGroups"
method: POST
path: "/v1/{+parent}/hostGroups"
tags: ["projects"]
---

# POST /v1/{+parent}/hostGroups

`POST /v1/{+parent}/hostGroups`

Creates a new host group.

## Path parameters

- `parent` string, required

## Query parameters

- `hostGroupId` string

## Request body

- HostGroup — Host group is a collection of hosts that can be used for accessing a Block Volume.
  - `osType` 'OS_TYPE_UNSPECIFIED' | 'LINUX' | 'WINDOWS' | 'ESXI' — Required. The OS type of the host group. It indicates the type of operating system used by all of the hosts in the HostGroup. All hosts in a HostGroup must be of the same OS type. This can be set only when creating a HostGroup.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'UPDATING' | 'DELETING' | 'DISABLED' — Output only. State of the host group.
  - `hosts` string[] — Required. The list of hosts associated with the host group.
  - `description` string — Optional. Description of the host group.
  - `name` string — Identifier. The resource name of the host group. Format: `projects/{project_number}/locations/{location_id}/hostGroups/{host_group_id}`.
  - `createTime` string, google-datetime — Output only. Create time of the host group.
  - `type` 'TYPE_UNSPECIFIED' | 'ISCSI_INITIATOR' — Required. Type of the host group.
  - `labels` object — Optional. Labels of the host group.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/netapp.md) · [All operations](https://skmtc.net/google/apis/netapp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/netapp/versions/fa9ebea9e9dc/schema)