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:
$ 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.
-
"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:
$ 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.
-
{
"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:
$ 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.
-
"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.