Getting Information About Your Groups

You can list the groups in your account, the users in a group, or the groups to which a user belongs.

To modify users in a group, see Adding or Removing a User from a Group. To modify the name or path of a group, see Modifying a Group.

Getting Information About Your Groups Using OSC CLI

Listing the Groups in Your Account

See the ListGroups command sample in the documentation of the EIM API.

Listing the Users in a Group

See the GetGroup command sample in the documentation of the EIM API.

Listing the Groups for a User

See the ListGroupsForUser command sample in the documentation of the EIM API.

Getting Information About Your Groups Using AWS CLI

Listing the Groups in Your Account

To list the groups in your account, use the list-groups command following this syntax:

Request sample
$ aws iam list-groups \
    --profile YOUR_PROFILE \
    --path-prefix / \
    --endpoint https://eim.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • (optional) path-prefix: The path prefix of the groups you want to list. If not specified, it is set to a slash (/), which lists all the groups.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The list-groups command returns the following elements:

  • Groups: Information about one or more groups. This element contains the following information:

    • Path: The path for the group.

    • CreateDate: The date and time of creation of the group.

    • GroupId: The group ID.

    • Arn: The OUTSCALE Resource Name (ORN) of the group.

    • GroupName: The group name.

Result sample
"Groups": [
  {
      "Path": "/",
      "CreateDate": "2016-05-12T06:30:24.165Z",
      "GroupId": "LMGPOKFGVV8K6LEXAMPLE",
      "Arn": "arn:aws:iam::123456789012:group/GROUP_NAME",
      "GroupName": "GROUP_NAME"
  },
  {
      "Path": "/",
      "CreateDate": "2016-05-24T16:01:32.124Z",
      "GroupId": "GTXCYYUIXZR2JD8YEXAMPLE",
      "Arn": "arn:aws:iam::123456789012:group/GROUP_NAME_2",
      "GroupName": "GROUP_NAME_2"
  },
]

Listing the Users in a Group

To get the list of users in a group, use the get-group command following this syntax:

Request sample
$ aws iam get-group \
    --profile YOUR_PROFILE \
    --group-name GROUP_NAME \
    --endpoint https://eim.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • group-name: The name of the group whose users you want to list.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The get-group command returns the following elements:

  • Group: Information about the group. This element contains the following information:

    • Path: The path for the group.

    • CreateDate: The date and time of creation of the group.

    • GroupId: The group ID.

    • Arn: The OUTSCALE Resource Name (ORN) of the group.

    • GroupName: The group name.

  • Users: Information about one or more users that are in the group. This element contains the following information:

    • UserName: The user name.

    • Path: The path for the user.

    • CreateDate: The date and time of creation of the user.

    • UserId: The user ID.

    • Arn: The OUTSCALE Resource Name (ORN) of the user.

Result sample
{
    "Group": {
      "Path": "/",
      "CreateDate": "2016-05-24T16:01:32.124Z",
      "GroupId": "GTXCYYUIXZR2JD8YEXAMPLE",
      "Arn": "arn:aws:iam::123456789012:group/GROUP_NAME",
      "GroupName": "GROUP_NAME"
    },
        "Users": [
            {
                "UserName": "Jane",
                "Path": "/division/subdivision/",
                "CreateDate": "2016-05-12T06:30:24.165Z",
                "UserId": "1234567890000",
                "Arn": "arn:aws:iam::123456789012:user/USER_NAME"
            },
            {
                "UserName": "John",
                "Path": "/division/subdivision/",
                "CreateDate": "2016-04-12T09:15:08Z",
                "UserId": "0000987654321",
                "Arn": "arn:aws:iam::123456789012:user/USER_NAME_2"
            }
]
}

Listing the Groups for a User

In Cockpit, the list of groups to which a user belongs is available on the Groups page, when you click Add/remove group . For more information, see Adding or Removing a User from a Group.

To get the list of groups to which a user belongs, use the list-groups-for-user command following this syntax:

Request sample
$ aws iam list-groups-for-user \
    --profile YOUR_PROFILE \
    --user-name USER_NAME \
    --endpoint https://eim.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • user-name: The name of the user.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The list-groups-for-user command returns the following elements:

  • Groups: Information about one or more groups the specified user belongs to. This element contains the following information:

    • Path: The path for the group.

    • CreateDate: The date and time of creation of the group.

    • GroupId: The group ID.

    • Arn: The OUTSCALE Resource Name (ORN) of the group.

    • GroupName: The group name.

Result sample
"Groups": [
  {
      "Path": "/",
      "CreateDate": "2016-05-12T06:30:24.165Z",
      "GroupId": "LMGPOKFGVV8K6LEXAMPLE",
      "Arn": "arn:aws:iam::123456789012:group/GROUP_NAME",
      "GroupName": "GROUP_NAME"
  },
  {
      "Path": "/",
      "CreateDate": "2016-05-24T16:01:32.124Z",
      "GroupId": "GTXCYYUIXZR2JD8YEXAMPLE",
      "Arn": "arn:aws:iam::123456789012:group/GROUP_NAME_2",
      "GroupName": "GROUP_NAME_2"
  },
]

Related Pages

Corresponding API Methods

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.