View a markdown version of this page

Integrating BYOM DB Instance with Amazon License Manager - Amazon Relational Database Service
Create self-managed license (Console)Create self-managed license (CLI)
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).

Integrating BYOM DB Instance with Amazon License Manager

To make it easier to monitor SQL Server license usage in the BYOM model, Amazon License Manager integrates with RDS for SQL Server. License Manager supports tracking of RDS for SQL Server engine editions based on virtual cores (vCPUs). You can also use License Manager with Amazon Organizations to manage all of your organizational accounts centrally.

The following table shows the product information filters for RDS for SQL Server.

FilterNameDescription
Engine Editionsqlserver-eeSQL Server Enterprise Edition (EE)
Engine Editionsqlserver-seSQL Server Standard Edition (SE)

To track license usage of your SQL Server DB instances, you can create a self-managed license using Amazon License Manager. In this case, RDS for SQL Server resources that match the product information filter are automatically associated with the self-managed license. Discovery of SQL Server DB instances can take up to 24 hours. You can also track a license across accounts by using Amazon Resource Access Manager.

To create a self-managed license in Amazon License Manager

To create a self-managed license in Amazon License Manager to track the license usage of your RDS for SQL Server DB instances:

  1. Go to https://console.aws.amazon.com/license-manager/.

  2. Choose Create self-managed license.

    For instructions, see Create a self-managed license in the Amazon License Manager User Guide.

    Add a rule for an RDS Product Information Filter in the Product Information panel. When selecting the resource type, choose SQL Server Database.

    For more information, see ProductInformation in the Amazon License Manager API Reference.

  3. (Cross-account tracking only) Use Amazon Resource Access Manager to share your self-managed licenses with any Amazon account or through Amazon Organizations. For more information, see Sharing your Amazon resources.

To create a self-managed license by using the Amazon CLI

To create a self-managed license by using the Amazon CLI, call the create-license-configuration command. Use the --cli-input-json or --cli-input-yaml parameters to pass the parameters to the command.

Example

The following example creates a self-managed license for SQL Server Enterprise Edition.

aws license-manager create-license-configuration --cli-input-json file://rds-sqlserver-ee.json

The following is the sample rds-sqlserver-ee.json file used in the example.

{
    "Name": "rds-sqlserver-ee",
    "Description": "RDS SQL Server Enterprise Edition",
    "LicenseCountingType": "vCPU",
    "LicenseCountHardLimit": false,
    "ProductInformationList": [
        {
            "ResourceType": "RDS",
            "ProductInformationFilterList": [
                {
                    "ProductInformationFilterName": "Engine Edition",
                    "ProductInformationFilterValue": ["sqlserver-ee"],
                    "ProductInformationFilterComparator": "EQUALS"
                }
            ]
        }
    ]
}

For more information about product information, see Automated discovery of resource inventory in the Amazon License Manager User Guide.

For more information about the --cli-input parameter, see Generating Amazon CLI skeleton and input parameters from a JSON or YAML input file in the Amazon CLI User Guide.