Working with license asset rulesets

To use Amazon-managed rulesets

1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

2. In the navigation pane, choose License asset discovery and ruleset.

3. In the License asset ruleset section, select Amazon-managed rulesets.

4. Browse the available managed rulesets and select the ones that match your software products.

To create rulesets using the console

1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

2. In the navigation pane, choose License asset discovery and ruleset.

3. In the License asset ruleset section, choose Create Ruleset.

4. For Ruleset name, enter a friendly name for the ruleset.

5. For Ruleset description, provide a description of what the ruleset is meant to be.

6. (Optional) Add tags for the ruleset and choose Next.

7. In step 2 (Configure discovery of licenses), you can add rules related to your licenses. This ensures the system can use the license to calculate license usage for instances the product is installed on. While configuring discovery of licenses is optional, we recommend adding it if you want license usage calculations.

   • You can add self-managed licenses and provide ARN or account ID

   • You can also add granted licenses (licenses procured from Amazon Marketplace) ARN, ProductSKU, etc.

   • You can add multiple rules by choosing Add rule

8. In step 3 (Configure discovery of instances), you can add rules on how to discover various instances. This ensures instances can be found based on selection criteria and that those instances are accounted for the product you are configuring your license asset group. You can add one or more rules by selecting the following fields:

   • Platform (Windows or Linux)

   • EC2 billing product code

   • Marketplace product code

   • AMI ID, Host ID, Instance ID, etc.

9. Review your configuration and choose Submit.

10. You can see your recently created ruleset under My rulesets.

To create rulesets using the CLI

• Use the create-license-asset-ruleset command. For more information, see the Amazon CLI Command Reference.

  
  aws license-manager create-license-asset-ruleset \
      --name "Custom Windows Ruleset" \
      --description "Custom ruleset for Windows Server tracking" \
      --rules '[
        {
          "RuleStatement": {
            "InstanceRuleStatement": {
              "MatchingRuleStatement": {
                "Attribute": "Platform",
                "Values": ["Windows"]
              }
            }
          }
        }
      ]' \
      --client-token unique-token
             

To update rulesets using the console

1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

2. In the navigation pane, choose License asset discovery and ruleset.

3. In the License asset ruleset section, navigate to My rulesets.

4. To select a ruleset, select the associated check box and choose Actions, Edit. Alternatively, choose the ruleset name, then choose the Edit button on the ruleset page.

5. From here, you can make the following updates:

   • Edit the ruleset name

   • Edit the ruleset description

   • Add or remove tags associated with the resource

6. Choose Next when your changes are complete. From the next screen, you can:

   • Add or remove rules

   • Update license types for existing rules

   • Update conditions for existing rules

7. Choose Next when your changes are complete. From the next screen, you can:

   • Add or remove inclusion rules to specify conditions to identify instances you want to include

8. Review and edit changes made on the previous screens. Choose Submit to finalize changes.

To update rulesets using the CLI

• Use the update-license-asset-ruleset command. For more information, see the Amazon CLI Command Reference.

  
  aws license-manager update-license-asset-ruleset \
      --license-asset-ruleset-arn arn:aws:license-manager:region:account:ruleset/ruleset-id \
      --name "Updated Custom Windows Ruleset" \
      --description "Updated description for Windows Server tracking"
             

To delete rulesets using the console

1. Open the License Manager console at https://console.aws.amazon.com/license-manager/.

2. In the navigation pane, choose License asset discovery and ruleset.

3. In the License asset ruleset section, navigate to My rulesets.

4. To select a ruleset for deletion, select the associated check box and choose Actions, Delete. Alternatively, choose the ruleset name, then choose the Delete button on the ruleset page.

5. To permanently delete the ruleset, type confirm in the text box, then choose Delete.

To delete rulesets using the CLI

• Use the delete-license-asset-ruleset command. For more information, see the Amazon CLI Command Reference.

  
  aws license-manager delete-license-asset-ruleset \
      --license-asset-ruleset-arn arn:aws:license-manager:region:account:ruleset/ruleset-id
             

To get rulesets using the CLI

• Use the get-license-asset-ruleset command. For more information, see the Amazon CLI Command Reference.

  
  aws license-manager get-license-asset-ruleset \
      --license-asset-ruleset-arn arn:aws:license-manager:region:account:ruleset/ruleset-id
             

To list rulesets using the CLI

• Use the list-license-asset-rulesets command. For more information, see the Amazon CLI Command Reference.

  
  aws license-manager list-license-asset-rulesets \
      --max-results 50 \
      --next-token token-from-previous-call