hcp iam groups create

Command: hcp iam groups create

The hcp iam groups create command creates a new group.

Once a group is created, membership can be managed using the hcp iam groups members command group.

Usage

$ hcp iam groups create GROUP_NAME [Optional Flags]

Examples

Create a new group for the platform engineering team:

$ hcp iam groups create team-platform \
  --description "Team Platform engineering group"

Create a new group and specify the initial members:

$ hcp iam groups create team-platform \
  --description "Team Platform engineering group" \
  --member=7f8a81b2-1320-4e49-a2e5-44f628ec74c3 \
  --member=f74f44b9-414a-409e-a257-72805d2c067b

Positional arguments

• GROUP_NAME - The name of the group to create.

Flags

• --description=DESCRIPTION - An optional description for the group.

• --member=ID [Repeatable] - The ID of the principal to add to the group.