user-mgmt get-group

Retrieve IBM Software Hub group details for the specified group.

Syntax

cpd-cli user-mgmt get-group <cpd-user-group-name> \
--profile=<profile-name> \
[--cpdconfig=<cpd-configuration-location>] \
[--include-members] \
[--output=json|yaml] \
[--verbose]

Arguments

Table 1: Command arguments
Argument Description
<cpd-user-group-name> The name of the IBM® Software Hub group to retrieve.

Options

Table 1: Command options
Option Description
--cpdconfig The IBM Software Hub
 configuration location. For example, $HOME/.cpd-cli/config.
Status
Optional.
Syntax
--cpdconfig=<cpd-configuration-location>
Default value
$HOME/.cpd-cli/config
Valid values
A valid IBM Software Hub configuration location.
--include-members Include members from the group API call.
Status
Optional.
Syntax
--include-members
Default value
Not applicable.
Valid values
Not applicable.

--help

-h

 Display command help.
Status
Optional.
Syntax
--help
Default value
No default.
Valid values
Not applicable.

--output

-o

 Specify an output format. Valid formats include YAML or JSON (the default format).
Status
Optional.
Syntax
--output=json|yaml
Default value
json
Valid values
json|yaml
--profile The name of the profile that you created to store information about an instance of IBM Software Hub and your credentials for the instance.
Status
Required.
Syntax
--profile=<profile-name>
Default value
No default.
Valid values

The name of the profile that you created.
--verbose Logs include more detailed messages.
Status
Optional.
Syntax
--verbose
Default value
No default.
Valid values
Not applicable.

Examples

Note: The following examples use the recommended installation environment variables.

It is strongly recommended that you use a script to create environment variables with the correct values for your environment. For more information, see Setting up installation environment variables.

Retrieve details on a IBM Software Hub user group.
cpd-cli user-mgmt get-group <cpd-user-group-name> \
--profile=${CPD_PROFILE_NAME}
Example *.json output.
{
  "created_at": "2022-09-22T21:36:26.946Z",
  "created_by": "admin",
  "description": "",
  "group_id": 10001,
  "misc": {},
  "name": "test",
  "roles": [
    {
      "role_id": "zen_administrator_role",
      "role_name": "Administrator"
    }
  ],
  "updated_at": "2021-09-22T21:36:26.946Z"
}