{"files":{"SKILL.md":"---\nname: aws-license-manager\ndescription: \"AWS License Manager API skill. Use when working with AWS License Manager for root. Covers 50 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# AWS License Manager\nAPI version: 2018-08-01\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. Verify API access with a test request\n3. POST / -- create first resource\n\n## Endpoints\n50 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Root\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | / | Accepts the specified grant. |\n| POST | / | Checks in the specified license. Check in a license when it is no longer in use. |\n| POST | / | Checks out the specified license for offline use. |\n| POST | / | Checks out the specified license.  If the account that created the license is the same that is performing the check out, you must specify the account as the beneficiary. |\n| POST | / | Creates a grant for the specified license. A grant shares the use of license entitlements with a specific Amazon Web Services account, an organization, or an organizational unit (OU). For more information, see Granted licenses in License Manager in the License Manager User Guide. |\n| POST | / | Creates a new version of the specified grant. For more information, see Granted licenses in License Manager in the License Manager User Guide. |\n| POST | / | Creates a license. |\n| POST | / | Creates a license configuration. A license configuration is an abstraction of a customer license agreement that can be consumed and enforced by License Manager. Components include specifications for the license type (licensing by instance, socket, CPU, or vCPU), allowed tenancy (shared tenancy, Dedicated Instance, Dedicated Host, or all of these), license affinity to host (how long a license must be associated with a host), and the number of licenses purchased and used. |\n| POST | / | Creates a new license conversion task. |\n| POST | / | Creates a report generator. |\n| POST | / | Creates a new version of the specified license. |\n| POST | / | Creates a long-lived token. A refresh token is a JWT token used to get an access token. With an access token, you can call AssumeRoleWithWebIdentity to get role credentials that you can use to call License Manager to manage the specified license. |\n| POST | / | Deletes the specified grant. |\n| POST | / | Deletes the specified license. |\n| POST | / | Deletes the specified license configuration. You cannot delete a license configuration that is in use. |\n| POST | / | Deletes the specified report generator. This action deletes the report generator, which stops it from generating future reports. The action cannot be reversed. It has no effect on the previous reports from this generator. |\n| POST | / | Deletes the specified token. Must be called in the license home Region. |\n| POST | / | Extends the expiration date for license consumption. |\n| POST | / | Gets a temporary access token to use with AssumeRoleWithWebIdentity. Access tokens are valid for one hour. |\n| POST | / | Gets detailed information about the specified grant. |\n| POST | / | Gets detailed information about the specified license. |\n| POST | / | Gets detailed information about the specified license configuration. |\n| POST | / | Gets information about the specified license type conversion task. |\n| POST | / | Gets information about the specified report generator. |\n| POST | / | Gets detailed information about the usage of the specified license. |\n| POST | / | Gets the License Manager settings for the current Region. |\n| POST | / | Lists the resource associations for the specified license configuration. Resource associations need not consume licenses from a license configuration. For example, an AMI or a stopped instance might not consume a license (depending on the license rules). |\n| POST | / | Lists the grants distributed for the specified license. |\n| POST | / | Lists the license configuration operations that failed. |\n| POST | / | Lists the license configurations for your account. |\n| POST | / | Lists the license type conversion tasks for your account. |\n| POST | / | Lists the report generators for your account. |\n| POST | / | Describes the license configurations for the specified resource. |\n| POST | / | Lists all versions of the specified license. |\n| POST | / | Lists the licenses for your account. |\n| POST | / | Lists grants that are received. Received grants are grants created while specifying the recipient as this Amazon Web Services account, your organization, or an organizational unit (OU) to which this member account belongs. |\n| POST | / | Lists the grants received for all accounts in the organization. |\n| POST | / | Lists received licenses. |\n| POST | / | Lists the licenses received for all accounts in the organization. |\n| POST | / | Lists resources managed using Systems Manager inventory. |\n| POST | / | Lists the tags for the specified license configuration. |\n| POST | / | Lists your tokens. |\n| POST | / | Lists all license usage records for a license configuration, displaying license consumption details by resource at a selected point in time. Use this action to audit the current license consumption for any license inventory and configuration. |\n| POST | / | Rejects the specified grant. |\n| POST | / | Adds the specified tags to the specified license configuration. |\n| POST | / | Removes the specified tags from the specified license configuration. |\n| POST | / | Modifies the attributes of an existing license configuration. |\n| POST | / | Updates a report generator. After you make changes to a report generator, it starts generating new reports within 60 minutes of being updated. |\n| POST | / | Adds or removes the specified license configurations for the specified Amazon Web Services resource. You can update the license specifications of AMIs, instances, and hosts. You cannot update the license specifications for launch templates and CloudFormation templates, as they send license configurations to the operation that creates the resource. |\n| POST | / | Updates License Manager settings for the current Region. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a resource?\" -> POST /\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api AWS License Manager\n@version 2018-08-01\n@auth AWS SigV4\n@endpoints 50\n@hint download_for_search\n@toc root(50)\n\n@endpoint POST /\n@desc Accepts the specified grant.\n@required {GrantArn: str}\n@returns(200) {GrantArn: str?, Status: str?, Version: str?}\n\n@endpoint POST /\n@desc Checks in the specified license. Check in a license when it is no longer in use.\n@required {LicenseConsumptionToken: str}\n@optional {Beneficiary: str}\n\n@endpoint POST /\n@desc Checks out the specified license for offline use.\n@required {LicenseArn: str, Entitlements: [EntitlementData], DigitalSignatureMethod: str, ClientToken: str}\n@optional {NodeId: str, CheckoutMetadata: [Metadata]}\n@returns(200) {LicenseArn: str?, LicenseConsumptionToken: str?, EntitlementsAllowed: [EntitlementData]?, NodeId: str?, SignedToken: str?, IssuedAt: str?, Expiration: str?, CheckoutMetadata: [Metadata]?}\n\n@endpoint POST /\n@desc Checks out the specified license.  If the account that created the license is the same that is performing the check out, you must specify the account as the beneficiary.\n@required {ProductSKU: str, CheckoutType: str, KeyFingerprint: str, Entitlements: [EntitlementData], ClientToken: str}\n@optional {Beneficiary: str, NodeId: str}\n@returns(200) {CheckoutType: str?, LicenseConsumptionToken: str?, EntitlementsAllowed: [EntitlementData]?, SignedToken: str?, NodeId: str?, IssuedAt: str?, Expiration: str?, LicenseArn: str?}\n\n@endpoint POST /\n@desc Creates a grant for the specified license. A grant shares the use of license entitlements with a specific Amazon Web Services account, an organization, or an organizational unit (OU). For more information, see Granted licenses in License Manager in the License Manager User Guide.\n@required {ClientToken: str, GrantName: str, LicenseArn: str, Principals: [str], HomeRegion: str, AllowedOperations: [str]}\n@returns(200) {GrantArn: str?, Status: str?, Version: str?}\n\n@endpoint POST /\n@desc Creates a new version of the specified grant. For more information, see Granted licenses in License Manager in the License Manager User Guide.\n@required {ClientToken: str, GrantArn: str}\n@optional {GrantName: str, AllowedOperations: [str], Status: str, StatusReason: str, SourceVersion: str, Options: Options}\n@returns(200) {GrantArn: str?, Status: str?, Version: str?}\n\n@endpoint POST /\n@desc Creates a license.\n@required {LicenseName: str, ProductName: str, ProductSKU: str, Issuer: Issuer, HomeRegion: str, Validity: DatetimeRange, Entitlements: [Entitlement], Beneficiary: str, ConsumptionConfiguration: ConsumptionConfiguration, ClientToken: str}\n@optional {LicenseMetadata: [Metadata]}\n@returns(200) {LicenseArn: str?, Status: str?, Version: str?}\n\n@endpoint POST /\n@desc Creates a license configuration. A license configuration is an abstraction of a customer license agreement that can be consumed and enforced by License Manager. Components include specifications for the license type (licensing by instance, socket, CPU, or vCPU), allowed tenancy (shared tenancy, Dedicated Instance, Dedicated Host, or all of these), license affinity to host (how long a license must be associated with a host), and the number of licenses purchased and used.\n@required {Name: str, LicenseCountingType: str}\n@optional {Description: str, LicenseCount: int(i64), LicenseCountHardLimit: bool, LicenseRules: [str], Tags: [Tag], DisassociateWhenNotFound: bool, ProductInformationList: [ProductInformation]}\n@returns(200) {LicenseConfigurationArn: str?}\n\n@endpoint POST /\n@desc Creates a new license conversion task.\n@required {ResourceArn: str, SourceLicenseContext: LicenseConversionContext, DestinationLicenseContext: LicenseConversionContext}\n@returns(200) {LicenseConversionTaskId: str?}\n\n@endpoint POST /\n@desc Creates a report generator.\n@required {ReportGeneratorName: str, Type: [str], ReportContext: ReportContext, ReportFrequency: ReportFrequency, ClientToken: str}\n@optional {Description: str, Tags: [Tag]}\n@returns(200) {LicenseManagerReportGeneratorArn: str?}\n\n@endpoint POST /\n@desc Creates a new version of the specified license.\n@required {LicenseArn: str, LicenseName: str, ProductName: str, Issuer: Issuer, HomeRegion: str, Validity: DatetimeRange, Entitlements: [Entitlement], ConsumptionConfiguration: ConsumptionConfiguration, Status: str, ClientToken: str}\n@optional {LicenseMetadata: [Metadata], SourceVersion: str}\n@returns(200) {LicenseArn: str?, Version: str?, Status: str?}\n\n@endpoint POST /\n@desc Creates a long-lived token. A refresh token is a JWT token used to get an access token. With an access token, you can call AssumeRoleWithWebIdentity to get role credentials that you can use to call License Manager to manage the specified license.\n@required {LicenseArn: str, ClientToken: str}\n@optional {RoleArns: [str], ExpirationInDays: int, TokenProperties: [str]}\n@returns(200) {TokenId: str?, TokenType: str?, Token: str?}\n\n@endpoint POST /\n@desc Deletes the specified grant.\n@required {GrantArn: str, Version: str}\n@optional {StatusReason: str}\n@returns(200) {GrantArn: str?, Status: str?, Version: str?}\n\n@endpoint POST /\n@desc Deletes the specified license.\n@required {LicenseArn: str, SourceVersion: str}\n@returns(200) {Status: str?, DeletionDate: str?}\n\n@endpoint POST /\n@desc Deletes the specified license configuration. You cannot delete a license configuration that is in use.\n@required {LicenseConfigurationArn: str}\n\n@endpoint POST /\n@desc Deletes the specified report generator. This action deletes the report generator, which stops it from generating future reports. The action cannot be reversed. It has no effect on the previous reports from this generator.\n@required {LicenseManagerReportGeneratorArn: str}\n\n@endpoint POST /\n@desc Deletes the specified token. Must be called in the license home Region.\n@required {TokenId: str}\n\n@endpoint POST /\n@desc Extends the expiration date for license consumption.\n@required {LicenseConsumptionToken: str}\n@optional {DryRun: bool}\n@returns(200) {LicenseConsumptionToken: str?, Expiration: str?}\n\n@endpoint POST /\n@desc Gets a temporary access token to use with AssumeRoleWithWebIdentity. Access tokens are valid for one hour.\n@required {Token: str}\n@optional {TokenProperties: [str]}\n@returns(200) {AccessToken: str?}\n\n@endpoint POST /\n@desc Gets detailed information about the specified grant.\n@required {GrantArn: str}\n@optional {Version: str}\n@returns(200) {Grant: Grant?{GrantArn: str, GrantName: str, ParentArn: str, LicenseArn: str, GranteePrincipalArn: str, HomeRegion: str, GrantStatus: str, StatusReason: str?, Version: str, GrantedOperations: [str], Options: Options?{ActivationOverrideBehavior: str?}}}\n\n@endpoint POST /\n@desc Gets detailed information about the specified license.\n@required {LicenseArn: str}\n@optional {Version: str}\n@returns(200) {License: License?{LicenseArn: str?, LicenseName: str?, ProductName: str?, ProductSKU: str?, Issuer: IssuerDetails?{Name: str?, SignKey: str?, KeyFingerprint: str?}, HomeRegion: str?, Status: str?, Validity: DatetimeRange?{Begin: str, End: str?}, Beneficiary: str?, Entitlements: [Entitlement]?, ConsumptionConfiguration: ConsumptionConfiguration?{RenewType: str?, ProvisionalConfiguration: ProvisionalConfiguration?{MaxTimeToLiveInMinutes: int}, BorrowConfiguration: BorrowConfiguration?{AllowEarlyCheckIn: bool, MaxTimeToLiveInMinutes: int}}, LicenseMetadata: [Metadata]?, CreateTime: str?, Version: str?}}\n\n@endpoint POST /\n@desc Gets detailed information about the specified license configuration.\n@required {LicenseConfigurationArn: str}\n@returns(200) {LicenseConfigurationId: str?, LicenseConfigurationArn: str?, Name: str?, Description: str?, LicenseCountingType: str?, LicenseRules: [str]?, LicenseCount: int(i64)?, LicenseCountHardLimit: bool?, ConsumedLicenses: int(i64)?, Status: str?, OwnerAccountId: str?, ConsumedLicenseSummaryList: [ConsumedLicenseSummary]?, ManagedResourceSummaryList: [ManagedResourceSummary]?, Tags: [Tag]?, ProductInformationList: [ProductInformation]?, AutomatedDiscoveryInformation: AutomatedDiscoveryInformation?{LastRunTime: str(timestamp)?}, DisassociateWhenNotFound: bool?}\n\n@endpoint POST /\n@desc Gets information about the specified license type conversion task.\n@required {LicenseConversionTaskId: str}\n@returns(200) {LicenseConversionTaskId: str?, ResourceArn: str?, SourceLicenseContext: LicenseConversionContext?{UsageOperation: str?}, DestinationLicenseContext: LicenseConversionContext?{UsageOperation: str?}, StatusMessage: str?, Status: str?, StartTime: str(timestamp)?, LicenseConversionTime: str(timestamp)?, EndTime: str(timestamp)?}\n\n@endpoint POST /\n@desc Gets information about the specified report generator.\n@required {LicenseManagerReportGeneratorArn: str}\n@returns(200) {ReportGenerator: ReportGenerator?{ReportGeneratorName: str?, ReportType: [str]?, ReportContext: ReportContext?{licenseConfigurationArns: [str]}, ReportFrequency: ReportFrequency?{value: int?, period: str?}, LicenseManagerReportGeneratorArn: str?, LastRunStatus: str?, LastRunFailureReason: str?, LastReportGenerationTime: str?, ReportCreatorAccount: str?, Description: str?, S3Location: S3Location?{bucket: str?, keyPrefix: str?}, CreateTime: str?, Tags: [Tag]?}}\n\n@endpoint POST /\n@desc Gets detailed information about the usage of the specified license.\n@required {LicenseArn: str}\n@returns(200) {LicenseUsage: LicenseUsage?{EntitlementUsages: [EntitlementUsage]?}}\n\n@endpoint POST /\n@desc Gets the License Manager settings for the current Region.\n@returns(200) {S3BucketArn: str?, SnsTopicArn: str?, OrganizationConfiguration: OrganizationConfiguration?{EnableIntegration: bool}, EnableCrossAccountsDiscovery: bool?, LicenseManagerResourceShareArn: str?}\n\n@endpoint POST /\n@desc Lists the resource associations for the specified license configuration. Resource associations need not consume licenses from a license configuration. For example, an AMI or a stopped instance might not consume a license (depending on the license rules).\n@required {LicenseConfigurationArn: str}\n@optional {MaxResults: int, NextToken: str}\n@returns(200) {LicenseConfigurationAssociations: [LicenseConfigurationAssociation]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the grants distributed for the specified license.\n@optional {GrantArns: [str], Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {Grants: [Grant]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the license configuration operations that failed.\n@required {LicenseConfigurationArn: str}\n@optional {MaxResults: int, NextToken: str}\n@returns(200) {LicenseOperationFailureList: [LicenseOperationFailure]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the license configurations for your account.\n@optional {LicenseConfigurationArns: [str], MaxResults: int, NextToken: str, Filters: [Filter]}\n@returns(200) {LicenseConfigurations: [LicenseConfiguration]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the license type conversion tasks for your account.\n@optional {NextToken: str, MaxResults: int, Filters: [Filter]}\n@returns(200) {LicenseConversionTasks: [LicenseConversionTask]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the report generators for your account.\n@optional {Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {ReportGenerators: [ReportGenerator]?, NextToken: str?}\n\n@endpoint POST /\n@desc Describes the license configurations for the specified resource.\n@required {ResourceArn: str}\n@optional {MaxResults: int, NextToken: str}\n@returns(200) {LicenseSpecifications: [LicenseSpecification]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists all versions of the specified license.\n@required {LicenseArn: str}\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {Licenses: [License]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the licenses for your account.\n@optional {LicenseArns: [str], Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {Licenses: [License]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists grants that are received. Received grants are grants created while specifying the recipient as this Amazon Web Services account, your organization, or an organizational unit (OU) to which this member account belongs.\n@optional {GrantArns: [str], Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {Grants: [Grant]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the grants received for all accounts in the organization.\n@required {LicenseArn: str}\n@optional {Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {Grants: [Grant]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists received licenses.\n@optional {LicenseArns: [str], Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {Licenses: [GrantedLicense]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the licenses received for all accounts in the organization.\n@optional {Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {Licenses: [GrantedLicense]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists resources managed using Systems Manager inventory.\n@optional {MaxResults: int, NextToken: str, Filters: [InventoryFilter]}\n@returns(200) {ResourceInventoryList: [ResourceInventory]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists the tags for the specified license configuration.\n@required {ResourceArn: str}\n@returns(200) {Tags: [Tag]?}\n\n@endpoint POST /\n@desc Lists your tokens.\n@optional {TokenIds: [str], Filters: [Filter], NextToken: str, MaxResults: int}\n@returns(200) {Tokens: [TokenData]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists all license usage records for a license configuration, displaying license consumption details by resource at a selected point in time. Use this action to audit the current license consumption for any license inventory and configuration.\n@required {LicenseConfigurationArn: str}\n@optional {MaxResults: int, NextToken: str, Filters: [Filter]}\n@returns(200) {LicenseConfigurationUsageList: [LicenseConfigurationUsage]?, NextToken: str?}\n\n@endpoint POST /\n@desc Rejects the specified grant.\n@required {GrantArn: str}\n@returns(200) {GrantArn: str?, Status: str?, Version: str?}\n\n@endpoint POST /\n@desc Adds the specified tags to the specified license configuration.\n@required {ResourceArn: str, Tags: [Tag]}\n\n@endpoint POST /\n@desc Removes the specified tags from the specified license configuration.\n@required {ResourceArn: str, TagKeys: [str]}\n\n@endpoint POST /\n@desc Modifies the attributes of an existing license configuration.\n@required {LicenseConfigurationArn: str}\n@optional {LicenseConfigurationStatus: str, LicenseRules: [str], LicenseCount: int(i64), LicenseCountHardLimit: bool, Name: str, Description: str, ProductInformationList: [ProductInformation], DisassociateWhenNotFound: bool}\n\n@endpoint POST /\n@desc Updates a report generator. After you make changes to a report generator, it starts generating new reports within 60 minutes of being updated.\n@required {LicenseManagerReportGeneratorArn: str, ReportGeneratorName: str, Type: [str], ReportContext: ReportContext, ReportFrequency: ReportFrequency, ClientToken: str}\n@optional {Description: str}\n\n@endpoint POST /\n@desc Adds or removes the specified license configurations for the specified Amazon Web Services resource. You can update the license specifications of AMIs, instances, and hosts. You cannot update the license specifications for launch templates and CloudFormation templates, as they send license configurations to the operation that creates the resource.\n@required {ResourceArn: str}\n@optional {AddLicenseSpecifications: [LicenseSpecification], RemoveLicenseSpecifications: [LicenseSpecification]}\n\n@endpoint POST /\n@desc Updates License Manager settings for the current Region.\n@optional {S3BucketArn: str, SnsTopicArn: str, OrganizationConfiguration: OrganizationConfiguration, EnableCrossAccountsDiscovery: bool}\n\n@end\n"}}