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.

If you exceed the number of identical requests allowed for a configured time period, the Throttling error message is returned.



Listing the Groups in Your Account

This procedure uses AWS CLI only. Information about these resources is also available from Cockpit. For more information, see EIM User Interface > Groups Page.


  • 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

This feature is not available from Cockpit. This documentation only describes the procedure using AWS CLI.


  • 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 in 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 get-group \
        --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"
      },
     ]



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