Managing discovery of Linux subscriptions - Amazon License Manager
Enabling discoveryStatus reasonsDisabling discovery
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Managing discovery of Linux subscriptions

You can manage the discovery of Linux subscriptions using the License Manager console. When you enable discovery of Linux subscriptions for the Amazon Web Services Regions you specify, you can optionally extend this discovery to your accounts in Amazon Organizations. If you no longer want to track subscription utilization, you can also disable discovery.

Note

You can discover and display up to 5,000 resources per account per Amazon Web Services Region by default. To request an increase to these limits, use the limit increase form.

Enabling discovery of Linux subscriptions

To enable the discovery of Linux subscriptions, you need to configure the required settings in License Manager. From the settings page, you can create the service-linked role, specify which Amazon Web Services Regions to enable discovery in, and whether to discover resources across your accounts in Amazon Organizations.

To enable discovery for Linux subscriptions

  1. Open the License Manager console at https://console.amazonaws.cn/license-manager/.

  2. In the left navigation pane, choose Settings.

  3. On the Settings page, choose the Linux subscriptions tab and choose Configure.

  4. For Source Amazon Web Services Regions, choose the Regions for which you want to discover Linux subscriptions.

  5. If you want to aggregate subscription data across your accounts in Amazon Organizations, select Link Amazon Organizations.

  6. Review and acknowledge the option which grants Amazon License Manager permission to create a service-linked role for Linux subscriptions.

  7. Choose Save configuration.

Resource discovery status reasons

Amazon License Manager will display a status and a corresponding status reason for each Amazon Web Services Region you choose to enable discovery for Linux subscriptions. The status reason will vary if you have linked Linux subscriptions with Amazon Organizations:

  • In progress

  • Successful

  • Failed

The status reason that displays for each Region you choose will show up to two status reasons at a time. The following table provides more detail:

Status reason action Description

Account-onboard

 Onboarding a single account.

Account-offboard

 Offboarding a single account.

Org-onboard

 Onboarding an entire organization.

Org-offboard

 Offboarding an entire organization.

You can call the UpdateServiceSettings API and subsequently call the GetServiceSettings API to monitor the progress of enabling Linux subscriptions. Each status and status reason can apply to multiple Regions at once. The follow table provides more detail on the status and status reason:

Status Status reason Description
In Progress "Region": "Account-Onboard: Pending" Enabling Linux subscriptions for a single account is in progress.
"Region": "Org-Onboard: Pending" Enabling Linux subscriptions for an organization is in progress.
"Region": "Account-Offboard: Pending Disabling Linux subscriptions for a single account is in progress.
"Region": "Org-Offboard: Pending Disabling Linux subscriptions for an organization is in progress.
Successful "Region": "Account-Onboard: Successful" Enabling Linux subscriptions for a single account was successful.
"Region": "Org-Onboard: Successful" Enabling Linux subscriptions for an organization was successful.
"Region": "Account-Offboard: Successful Disabling Linux subscriptions for a single account was successful.
"Region": "Org-Offboard: Successful Disabling Linux subscriptions for an organization was successful.
Failed "Region": "Account-Onboard: Failed - Service-linked role not present" Enabling Linux subscriptions for a single account has failed due to the required service-linked role not being created. Create the required role, and try again.
"Region": "Account-Onboard: Failed - An internal error occurred" Enabling Linux subscriptions for a single account has failed due to an internal error.
"Region": "Org-Onboard: Failed - Account isn't the management account" Enabling Linux subscriptions for an organization has failed due to the account performing the operation not being the organization's management account. Log in to the management account, and try again.
"Region": "Org-Onboard: Failed - Account isn't part of an organization" Enabling Linux subscriptions for an organization has failed due to the account performing the operation not being in an organization. Try the operation from an account in the organization, or add this account to the organization, and try again.
"Region": "Org-Onboard: Failed - Linux subscriptions can't access the organization" Enabling Linux subscriptions for an organization has failed due to License Manager not having permissions to access the organization. Create the service-linked role for Linux subscriptions, and try again.

Disabling discovery of Linux subscriptions

You can disable discovery of Linux subscriptions from the Amazon License Manager settings page.

Warning

If you disable discovery, all of your data previously discovered for Linux subscriptions will be removed from Amazon License Manager.

To disable discovery for Linux subscriptions

  1. Open the License Manager console at https://console.amazonaws.cn/license-manager/.

  2. In the left navigation pane, choose Settings.

  3. On the Settings page, choose the Linux subscriptions tab and choose Disable Linux subscription discovery.

  4. Enter Disable and then choose Disable to confirm deactivation.

  5. (Optional) Remove the service-linked role used for Linux subscriptions. For more information, see Delete a service-linked role for License Manager.

  6. (Optional) Disable trusted access between License Manager and your organization. For more information, see Amazon License Manager and Amazon Organizations.