Distribute License Manager entitlements - Amazon License Manager
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).

Distribute License Manager entitlements

If you are a license administrator operating in the management account of your organization with all features enabled, you can distribute entitlements to your organization from your granted licenses by creating a grant. For more information about Amazon Organizations, see Amazon Organizations terminology and concepts.

You can specify the recipient of the grant as one of the following:

  • An Amazon Web Services account, which includes only the specified account.

  • An organization root, which will include all accounts across your organization.

  • An organizational unit (OU) (that is not nested), which includes all accounts in the specified OU and in nested OUs under the specified OU.

Note

You can create up to 2,000 grants per license.

You can use either the Amazon License Manager console or the Amazon CLI to distribute your entitlements. You can specify the organization ID or the organization ARN when creating a grant in the console, but the ARN format must be used with the Amazon CLI. For example, the ARNs will resemble the following:

Organization ID ARN

arn:aws:organizations::<account-id-of-management-account>:organization/o-<organization-id>

Organization OU ARN

arn:aws:organizations::<account-id-of-management-account>:ou/o-<organization-id>/ou-<organizational-unit-id>

Console
To create a grant (Console)

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

  2. In the navigation pane, choose Granted licenses.

  3. Choose a license ID to open the License overview page.

  4. From the Grants section, choose Create grant.

  5. On the Grant details panel, do the following:

    1. Enter a name for the grant to help you identify the purpose or recipient of the grant.

    2. Enter the Amazon Web Services account ID, Amazon Organizations OU ID or ARN, or Amazon Organizations ID or ARN of the grant recipient.

    3. Choose Create grant.

  6. On the License overview page, you'll see an entry for the grant in the Grants panel. The initial status of the grant is Pending acceptance. The status changes to Active when the recipient accepts the grant or Rejected when the recipient rejects the grant.

Amazon CLI

You can use the Amazon CLI to distribute an entitlement. You must use specify an organization ID or OU in ARN format when using the Amazon License Manager API.

To create and list your grants using the Amazon CLI:

The grant details page displays the list of accounts that you have granted access to the entitlement. After distributing a license to your organization, you can deactivate or activate the licenses individually on each account.