Getting Information About EIM Users Using OKS

You can use OKS to list the EIM users created in a project and view the available EIM user types and their associated permissions.

Listing Available EIM User Types Using OKS CLI

The user types command allows you to list the available EIM user types and their associated permissions.

Request sample
$ oks-cli user types \
    --profile-name "default" \
    --project-name NAME_OF_PROJECT \
    --output json

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

  • (optional) profile-name: The name of the configuration profile to use.

  • project-name: The name of the project for which you want to list the available EIM user types.

  • (optional) output: The output format for the response (json | yaml). If not specified, the response is in table format.

The user types command returns the following elements:

  • User Type: The name of the available EIM user types.

  • Description: A description of the permission associated with the EIM user type.

Result sample
[
    {
        "UserType": "OKSSnapshotsManager",
        "Description": "OKS user with full access to snapshots"
    },
    {
        "UserType": "OKSVolumesManager",
        "Description": "OKS user with management access to volumes BSU"
    }
]

Listing EIM Users Using OKS CLI

The user list command allows you to list the EIM users created in a project and view their associated access keys.

Request sample
$ oks-cli user list \
    --profile-name "default" \
    --project-name NAME_OF_PROJECT \
    --output json

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

  • (optional) profile-name: The name of the profile that you want to use to list EIM users from.

  • project-name: The name of the project in which the EIM users were created.

  • (optional) output: The output format for the response (json | yaml). By default, the response format is in a table format.

The user list command returns the following elements:

  • UserName: The name of the predefined role selected when creating the users. Returned values can be OKSVolumesManager and/or OKSSnapshotsManager.

  • AccessKeys: The ID of the access keys associated with returned user roles.

    • State: The status of the access keys, always ACTIVE.

    • CreationDate: The time when the access keys were created.

    • ExpirationDate: The time when the access keys expire.

Result sample
[
    {
        "UserName": "OKSSnapshotsManager",
        "AccessKeys": [
            {
                "State": "ACTIVE",
                "AccessKeyId": "5MJETB8DH2RBA42PODW6",
                "CreationDate": "2026-04-15T09:27:41.138+0000",
                "ExpirationDate": "2026-04-15T10:27:40.878+0000"
            }
        ]
    },
    {
        "UserName": "OKSVolumesManager",
        "AccessKeys": [
            {
                "State": "ACTIVE",
                "AccessKeyId": "1P9XXOA9LOVBX535TXA3",
                "CreationDate": "2026-04-15T09:22:37.227+0000",
                "ExpirationDate": "2026-04-22T09:22:37.025+0000"
            }
        ]
    }
]

Related Pages

Corresponding API Method