rhsmctl

A command-line tool to control resources using Red Hat Subscription Manager API.

API Token

In order to use rhsmctl you need to obtain an API token from the customer portal.

Usage

rhsmctl uses sub-commands to interact with RHSM API.

rhsmctl --api-token ${API_TOKEN} <sub-command> <options>

The current supported sub-commands are:

• account: Show the details of your account.
• allocation: Manage allocations.
• allocation-entitlements: Manage allocation entitlements.
• cloud-access: Manage cloud access.
• cloud-access-accounts: Manage cloud access accounts.
• errata: Manage errata.
• images: Manage images.
• organization: Show the details of your organization.
• packages: Manage packages.
• subscription: Manage subscriptions.
• system: Manage systems.
• system-entitlements: Manage entitlements of a system.

To get a sub-command's detailed description, options and usage, use the -h or --help option.

rhsmctl <sub-command> --help

Config File

To avoid having to use the --api-token option on every command, you can save it to a config file.

rhsmctl checks the following files for your API token:

1. $HOME/.config/rhsmctl/config.yml

The config file should be in YAML format.

api-token: "${API_TOKEN}"