Documentation

mc admin user svcacct info

Syntax

The mc admin user svcacct info command returns a description of the specified access key.

“Access Keys” have equivalent functionality to and replace the concept of “Service Accounts” in MinIO.

The description output includes the following details, as available:

  • Access Key

  • Parent user of the specified access key

  • Access key status (on or off)

  • Policy or policies

  • Comment

  • Expiration

Use --policy to view the attached policies.

The following command returns information on the specified access key:

mc admin user svcacct info myminio myuseraccesskey

The command has the following syntax:

mc [GLOBALFLAGS] admin user svcacct info           \
                                    [--policy]     \
                                    ALIAS          \
                                    ACCESSKEY
  • Brackets [] indicate optional parameters.

  • Parameters sharing a line are mutually dependent.

  • Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

ALIAS
Required

The alias of the MinIO deployment.

ACCESSKEY
Required

The service account access key to display.

--policy
Optional

Displays policies attached to the specified service account.

Global Flags

This command supports any of the global flags.

Examples

Display Service Account Details

Use mc admin user svcacct info to display details of a service account on a MinIO deployment:

   mc admin user svcacct info ALIAS ACCESSKEY
  • Replace ALIAS with the alias of the MinIO deployment.

  • Replace ACCESSKEY with the service account access key.

The output resembles the following:

AccessKey: myuserserviceaccount
ParentUser: myuser
Status: on
Comment:
Policy: implied
Expiration: no-expiry

Display Service Account Policy Details

Use mc admin user svcacct info to display the policies attached to service account:

   mc admin user svcacct info --policy ALIAS ACCESSKEY
  • Replace ALIAS with the alias of the MinIO deployment.

  • Replace ACCESSKEY with the service account access key.

The output resembles the following:

{
 "Version": "2012-10-17",
 "Statement": [
  {
   "Effect": "Allow",
   "Action": [
    "s3:*"
   ],
   "Resource": [
    "arn:aws:s3:::*"
   ]
  }
 ]
}

Behavior

S3 Compatibility

The mc commandline tool is built for compatibility with the AWS S3 API and is tested with MinIO and AWS S3 for expected functionality and behavior.

MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.