# Groups

## Overview

### About this task

Groups in HPE Morpheus Enterprise define what resources a user has access to. Group access is defined by User Roles. Clouds are added to groups, and a User can only access the Clouds that are in the Groups their Role(s) gives them access to. Resources such as Networks, Datastores, Resources Pools, and Folders have additional Group access settings.

Policies applied to a Group will be enforced on all Instances provisioned or moved into that Group.

NOTE

Groups are not multi-tenant. A group only exists in the tenant is it is created in.

The Groups view displays all current groups, includes search feature, and also enables the addition of new groups.

To View Groups:

### Procedure

1. Select the Infrastructure link in the navigation bar
2. Click the Groups link

## UI

1. Select the Infrastructure link in the navigation bar
2. Click the Groups link

## CLI

View all groups: `groups list` To use the group: `groups use <id>` or `groups use "group name"` Json output of a specific group: `groups get <id> -j` or `groups get "group name" -j`

## API

View all groups: `curl https://api.gomorpheus.com/api/groups -H "Authorization: BEARER access_token"` View a specific group: `curl https://api.gomorpheus.com/api/groups/:id -H "Authorization: BEARER access_token"`

## Adding Groups

### About this task

![../../_images/add_group.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-314860C2-E6E2-4F71-9AC0-AEE0E9E53A08-high.png)

To add a group:

### Procedure

1. Select the Infrastructure link in the navigation bar
2. Click the Groups link
3. Click the Create Group button
4. Input out the Name and Location (optional) fields
5. Click the Save Changes button to save

## Managing Groups

### About this task

![../../_images/group_view.png](https://support.hpe.com/hpesc/public/api/document/sd00008375en_us/GUID-4D1622A4-0DFF-47E7-AFF2-B9CBC2298957-high.png)

To view a Group:

### Procedure

1. Select the Infrastructure link in the navigation bar
2. Click the Groups link
3. Click the Group name to view/modify

### Results

Available tabs in group view

Hosts
:   Lists available hosts in the group and displays power, os, name, type, cloud, ip address, nodes, disc space, memory, and status. You can add a host from this tab panel by clicking Add Host.

Virtual Machines
:   List all Virtual Machines in the Group.

Bare Metal
:   List all Bare Metal Hosts added to the Group

Clouds
:   Lists Clouds added to the Group. Existing Clouds or new Clouds can be added from the Group by clicking Add Cloud.

Policies
:   Lists and allows creation or management of Policies applied to the Group.

## Edit Group

### About this task

To edit a group:

### Procedure

1. Select the Infrastructure link in the navigation bar.
2. Click the Groups link.
3. Click the name of the group you wish to edit.
4. Click the Edit button.
5. From the Edit Group Wizard modify information as needed.
6. Click the Save Changes button to save.

## Delete Group

### About this task

To delete a group:

### Procedure

1. Select the Infrastructure link in the navigation bar.
2. Click the Groups link.
3. Click the name of the group you wish to delete.
4. Click the Delete button.
5. Confirm

## User Access

IMPORTANT

User access to Groups is determined by their user Role(s). Group access for Roles can be configured in the Group Access section of a Roles Settings.
