The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Paws::LicenseManager - Perl Interface to AWS AWS License Manager

SYNOPSIS

  use Paws;

  my $obj = Paws->service('LicenseManager');
  my $res = $obj->Method(
    Arg1 => $val1,
    Arg2 => [ 'V1', 'V2' ],
    # if Arg3 is an object, the HashRef will be used as arguments to the constructor
    # of the arguments type
    Arg3 => { Att1 => 'Val1' },
    # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
    # the constructor of the arguments type
    Arg4 => [ { Att1 => 'Val1'  }, { Att1 => 'Val2' } ],
  );

DESCRIPTION

AWS License Manager

AWS License Manager makes it easier to manage licenses from software vendors across multiple AWS accounts and on-premises servers.

For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01

METHODS

AcceptGrant

GrantArn => Str

Each argument is described in detail in: Paws::LicenseManager::AcceptGrant

Returns: a Paws::LicenseManager::AcceptGrantResponse instance

Accepts the specified grant.

CheckInLicense

LicenseConsumptionToken => Str
[Beneficiary => Str]

Each argument is described in detail in: Paws::LicenseManager::CheckInLicense

Returns: a Paws::LicenseManager::CheckInLicenseResponse instance

Checks in the specified license. Check in a license when it is no longer in use.

CheckoutBorrowLicense

ClientToken => Str
DigitalSignatureMethod => Str
Entitlements => ArrayRef[Paws::LicenseManager::EntitlementData]
LicenseArn => Str
[CheckoutMetadata => ArrayRef[Paws::LicenseManager::Metadata]]
[NodeId => Str]

Each argument is described in detail in: Paws::LicenseManager::CheckoutBorrowLicense

Returns: a Paws::LicenseManager::CheckoutBorrowLicenseResponse instance

Checks out the specified license for offline use.

CheckoutLicense

CheckoutType => Str
ClientToken => Str
Entitlements => ArrayRef[Paws::LicenseManager::EntitlementData]
KeyFingerprint => Str
ProductSKU => Str
[Beneficiary => Str]
[NodeId => Str]

Each argument is described in detail in: Paws::LicenseManager::CheckoutLicense

Returns: a Paws::LicenseManager::CheckoutLicenseResponse instance

Checks out the specified license.

CreateGrant

AllowedOperations => ArrayRef[Str|Undef]
ClientToken => Str
GrantName => Str
HomeRegion => Str
LicenseArn => Str
Principals => ArrayRef[Str|Undef]

Each argument is described in detail in: Paws::LicenseManager::CreateGrant

Returns: a Paws::LicenseManager::CreateGrantResponse instance

Creates a grant for the specified license. A grant shares the use of license entitlements with specific AWS accounts.

CreateGrantVersion

ClientToken => Str
GrantArn => Str
[AllowedOperations => ArrayRef[Str|Undef]]
[GrantName => Str]
[SourceVersion => Str]
[Status => Str]
[StatusReason => Str]

Each argument is described in detail in: Paws::LicenseManager::CreateGrantVersion

Returns: a Paws::LicenseManager::CreateGrantVersionResponse instance

Creates a new version of the specified grant.

CreateLicense

Beneficiary => Str
ClientToken => Str
ConsumptionConfiguration => Paws::LicenseManager::ConsumptionConfiguration
Entitlements => ArrayRef[Paws::LicenseManager::Entitlement]
HomeRegion => Str
Issuer => Paws::LicenseManager::Issuer
LicenseName => Str
ProductName => Str
ProductSKU => Str
Validity => Paws::LicenseManager::DatetimeRange
[LicenseMetadata => ArrayRef[Paws::LicenseManager::Metadata]]

Each argument is described in detail in: Paws::LicenseManager::CreateLicense

Returns: a Paws::LicenseManager::CreateLicenseResponse instance

Creates a license.

CreateLicenseConfiguration

LicenseCountingType => Str
Name => Str
[Description => Str]
[DisassociateWhenNotFound => Bool]
[LicenseCount => Int]
[LicenseCountHardLimit => Bool]
[LicenseRules => ArrayRef[Str|Undef]]
[ProductInformationList => ArrayRef[Paws::LicenseManager::ProductInformation]]
[Tags => ArrayRef[Paws::LicenseManager::Tag]]

Each argument is described in detail in: Paws::LicenseManager::CreateLicenseConfiguration

Returns: a Paws::LicenseManager::CreateLicenseConfigurationResponse instance

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.

CreateLicenseManagerReportGenerator

ClientToken => Str
ReportContext => Paws::LicenseManager::ReportContext
ReportFrequency => Paws::LicenseManager::ReportFrequency
ReportGeneratorName => Str
Type => ArrayRef[Str|Undef]
[Description => Str]
[Tags => ArrayRef[Paws::LicenseManager::Tag]]

Each argument is described in detail in: Paws::LicenseManager::CreateLicenseManagerReportGenerator

Returns: a Paws::LicenseManager::CreateLicenseManagerReportGeneratorResponse instance

Creates a new report generator.

CreateLicenseVersion

ClientToken => Str
ConsumptionConfiguration => Paws::LicenseManager::ConsumptionConfiguration
Entitlements => ArrayRef[Paws::LicenseManager::Entitlement]
HomeRegion => Str
Issuer => Paws::LicenseManager::Issuer
LicenseArn => Str
LicenseName => Str
ProductName => Str
Status => Str
Validity => Paws::LicenseManager::DatetimeRange
[LicenseMetadata => ArrayRef[Paws::LicenseManager::Metadata]]
[SourceVersion => Str]

Each argument is described in detail in: Paws::LicenseManager::CreateLicenseVersion

Returns: a Paws::LicenseManager::CreateLicenseVersionResponse instance

Creates a new version of the specified license.

CreateToken

ClientToken => Str
LicenseArn => Str
[ExpirationInDays => Int]
[RoleArns => ArrayRef[Str|Undef]]
[TokenProperties => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::LicenseManager::CreateToken

Returns: a Paws::LicenseManager::CreateTokenResponse instance

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.

DeleteGrant

GrantArn => Str
Version => Str
[StatusReason => Str]

Each argument is described in detail in: Paws::LicenseManager::DeleteGrant

Returns: a Paws::LicenseManager::DeleteGrantResponse instance

Deletes the specified grant.

DeleteLicense

LicenseArn => Str
SourceVersion => Str

Each argument is described in detail in: Paws::LicenseManager::DeleteLicense

Returns: a Paws::LicenseManager::DeleteLicenseResponse instance

Deletes the specified license.

DeleteLicenseConfiguration

LicenseConfigurationArn => Str

Each argument is described in detail in: Paws::LicenseManager::DeleteLicenseConfiguration

Returns: a Paws::LicenseManager::DeleteLicenseConfigurationResponse instance

Deletes the specified license configuration.

You cannot delete a license configuration that is in use.

DeleteLicenseManagerReportGenerator

LicenseManagerReportGeneratorArn => Str

Each argument is described in detail in: Paws::LicenseManager::DeleteLicenseManagerReportGenerator

Returns: a Paws::LicenseManager::DeleteLicenseManagerReportGeneratorResponse instance

Delete an existing report generator.

This action deletes the report generator, which stops it from generating future reports and cannot be reversed. However, the previous reports from this generator will remain in your S3 bucket.

DeleteToken

TokenId => Str

Each argument is described in detail in: Paws::LicenseManager::DeleteToken

Returns: a Paws::LicenseManager::DeleteTokenResponse instance

Deletes the specified token. Must be called in the license home Region.

ExtendLicenseConsumption

LicenseConsumptionToken => Str
[DryRun => Bool]

Each argument is described in detail in: Paws::LicenseManager::ExtendLicenseConsumption

Returns: a Paws::LicenseManager::ExtendLicenseConsumptionResponse instance

Extends the expiration date for license consumption.

GetAccessToken

Token => Str
[TokenProperties => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::LicenseManager::GetAccessToken

Returns: a Paws::LicenseManager::GetAccessTokenResponse instance

Gets a temporary access token to use with AssumeRoleWithWebIdentity. Access tokens are valid for one hour.

GetGrant

GrantArn => Str
[Version => Str]

Each argument is described in detail in: Paws::LicenseManager::GetGrant

Returns: a Paws::LicenseManager::GetGrantResponse instance

Gets detailed information about the specified grant.

GetLicense

LicenseArn => Str
[Version => Str]

Each argument is described in detail in: Paws::LicenseManager::GetLicense

Returns: a Paws::LicenseManager::GetLicenseResponse instance

Gets detailed information about the specified license.

GetLicenseConfiguration

LicenseConfigurationArn => Str

Each argument is described in detail in: Paws::LicenseManager::GetLicenseConfiguration

Returns: a Paws::LicenseManager::GetLicenseConfigurationResponse instance

Gets detailed information about the specified license configuration.

GetLicenseManagerReportGenerator

LicenseManagerReportGeneratorArn => Str

Each argument is described in detail in: Paws::LicenseManager::GetLicenseManagerReportGenerator

Returns: a Paws::LicenseManager::GetLicenseManagerReportGeneratorResponse instance

Gets information on the specified report generator.

GetLicenseUsage

LicenseArn => Str

Each argument is described in detail in: Paws::LicenseManager::GetLicenseUsage

Returns: a Paws::LicenseManager::GetLicenseUsageResponse instance

Gets detailed information about the usage of the specified license.

GetServiceSettings

Each argument is described in detail in: Paws::LicenseManager::GetServiceSettings

Returns: a Paws::LicenseManager::GetServiceSettingsResponse instance

Gets the License Manager settings for the current Region.

ListAssociationsForLicenseConfiguration

LicenseConfigurationArn => Str
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListAssociationsForLicenseConfiguration

Returns: a Paws::LicenseManager::ListAssociationsForLicenseConfigurationResponse instance

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).

ListDistributedGrants

[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[GrantArns => ArrayRef[Str|Undef]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListDistributedGrants

Returns: a Paws::LicenseManager::ListDistributedGrantsResponse instance

Lists the grants distributed for the specified license.

ListFailuresForLicenseConfigurationOperations

LicenseConfigurationArn => Str
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListFailuresForLicenseConfigurationOperations

Returns: a Paws::LicenseManager::ListFailuresForLicenseConfigurationOperationsResponse instance

Lists the license configuration operations that failed.

ListLicenseConfigurations

[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[LicenseConfigurationArns => ArrayRef[Str|Undef]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListLicenseConfigurations

Returns: a Paws::LicenseManager::ListLicenseConfigurationsResponse instance

Lists the license configurations for your account.

ListLicenseManagerReportGenerators

[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListLicenseManagerReportGenerators

Returns: a Paws::LicenseManager::ListLicenseManagerReportGeneratorsResponse instance

Lists the report generators for your account.

ListLicenses

[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[LicenseArns => ArrayRef[Str|Undef]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListLicenses

Returns: a Paws::LicenseManager::ListLicensesResponse instance

Lists the licenses for your account.

ListLicenseSpecificationsForResource

ResourceArn => Str
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListLicenseSpecificationsForResource

Returns: a Paws::LicenseManager::ListLicenseSpecificationsForResourceResponse instance

Describes the license configurations for the specified resource.

ListLicenseVersions

LicenseArn => Str
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListLicenseVersions

Returns: a Paws::LicenseManager::ListLicenseVersionsResponse instance

Lists all versions of the specified license.

ListReceivedGrants

[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[GrantArns => ArrayRef[Str|Undef]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListReceivedGrants

Returns: a Paws::LicenseManager::ListReceivedGrantsResponse instance

Lists grants that are received but not accepted.

ListReceivedLicenses

[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[LicenseArns => ArrayRef[Str|Undef]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListReceivedLicenses

Returns: a Paws::LicenseManager::ListReceivedLicensesResponse instance

Lists received licenses.

ListResourceInventory

[Filters => ArrayRef[Paws::LicenseManager::InventoryFilter]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListResourceInventory

Returns: a Paws::LicenseManager::ListResourceInventoryResponse instance

Lists resources managed using Systems Manager inventory.

ListTagsForResource

ResourceArn => Str

Each argument is described in detail in: Paws::LicenseManager::ListTagsForResource

Returns: a Paws::LicenseManager::ListTagsForResourceResponse instance

Lists the tags for the specified license configuration.

ListTokens

[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[MaxResults => Int]
[NextToken => Str]
[TokenIds => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::LicenseManager::ListTokens

Returns: a Paws::LicenseManager::ListTokensResponse instance

Lists your tokens.

ListUsageForLicenseConfiguration

LicenseConfigurationArn => Str
[Filters => ArrayRef[Paws::LicenseManager::Filter]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::LicenseManager::ListUsageForLicenseConfiguration

Returns: a Paws::LicenseManager::ListUsageForLicenseConfigurationResponse instance

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.

RejectGrant

GrantArn => Str

Each argument is described in detail in: Paws::LicenseManager::RejectGrant

Returns: a Paws::LicenseManager::RejectGrantResponse instance

Rejects the specified grant.

TagResource

ResourceArn => Str
Tags => ArrayRef[Paws::LicenseManager::Tag]

Each argument is described in detail in: Paws::LicenseManager::TagResource

Returns: a Paws::LicenseManager::TagResourceResponse instance

Adds the specified tags to the specified license configuration.

UntagResource

ResourceArn => Str
TagKeys => ArrayRef[Str|Undef]

Each argument is described in detail in: Paws::LicenseManager::UntagResource

Returns: a Paws::LicenseManager::UntagResourceResponse instance

Removes the specified tags from the specified license configuration.

UpdateLicenseConfiguration

LicenseConfigurationArn => Str
[Description => Str]
[DisassociateWhenNotFound => Bool]
[LicenseConfigurationStatus => Str]
[LicenseCount => Int]
[LicenseCountHardLimit => Bool]
[LicenseRules => ArrayRef[Str|Undef]]
[Name => Str]
[ProductInformationList => ArrayRef[Paws::LicenseManager::ProductInformation]]

Each argument is described in detail in: Paws::LicenseManager::UpdateLicenseConfiguration

Returns: a Paws::LicenseManager::UpdateLicenseConfigurationResponse instance

Modifies the attributes of an existing license configuration.

UpdateLicenseManagerReportGenerator

ClientToken => Str
LicenseManagerReportGeneratorArn => Str
ReportContext => Paws::LicenseManager::ReportContext
ReportFrequency => Paws::LicenseManager::ReportFrequency
ReportGeneratorName => Str
Type => ArrayRef[Str|Undef]
[Description => Str]

Each argument is described in detail in: Paws::LicenseManager::UpdateLicenseManagerReportGenerator

Returns: a Paws::LicenseManager::UpdateLicenseManagerReportGeneratorResponse instance

Updates a report generator.

After you make changes to a report generator, it will start generating new reports within 60 minutes of being updated.

UpdateLicenseSpecificationsForResource

ResourceArn => Str
[AddLicenseSpecifications => ArrayRef[Paws::LicenseManager::LicenseSpecification]]
[RemoveLicenseSpecifications => ArrayRef[Paws::LicenseManager::LicenseSpecification]]

Each argument is described in detail in: Paws::LicenseManager::UpdateLicenseSpecificationsForResource

Returns: a Paws::LicenseManager::UpdateLicenseSpecificationsForResourceResponse instance

Adds or removes the specified license configurations for the specified AWS resource.

You can update the license specifications of AMIs, instances, and hosts. You cannot update the license specifications for launch templates and AWS CloudFormation templates, as they send license configurations to the operation that creates the resource.

UpdateServiceSettings

[EnableCrossAccountsDiscovery => Bool]
[OrganizationConfiguration => Paws::LicenseManager::OrganizationConfiguration]
[S3BucketArn => Str]
[SnsTopicArn => Str]

Each argument is described in detail in: Paws::LicenseManager::UpdateServiceSettings

Returns: a Paws::LicenseManager::UpdateServiceSettingsResponse instance

Updates License Manager settings for the current Region.

PAGINATORS

Paginator methods are helpers that repetively call methods that return partial results

ListAllAssociationsForLicenseConfiguration(sub { },LicenseConfigurationArn => Str, [MaxResults => Int, NextToken => Str])

ListAllAssociationsForLicenseConfiguration(LicenseConfigurationArn => Str, [MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - LicenseConfigurationAssociations, passing the object as the first parameter, and the string 'LicenseConfigurationAssociations' as the second parameter 

If not, it will return a a Paws::LicenseManager::ListAssociationsForLicenseConfigurationResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllLicenseConfigurations(sub { },[Filters => ArrayRef[Paws::LicenseManager::Filter], LicenseConfigurationArns => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])

ListAllLicenseConfigurations([Filters => ArrayRef[Paws::LicenseManager::Filter], LicenseConfigurationArns => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - LicenseConfigurations, passing the object as the first parameter, and the string 'LicenseConfigurations' as the second parameter 

If not, it will return a a Paws::LicenseManager::ListLicenseConfigurationsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllLicenseSpecificationsForResource(sub { },ResourceArn => Str, [MaxResults => Int, NextToken => Str])

ListAllLicenseSpecificationsForResource(ResourceArn => Str, [MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - LicenseSpecifications, passing the object as the first parameter, and the string 'LicenseSpecifications' as the second parameter 

If not, it will return a a Paws::LicenseManager::ListLicenseSpecificationsForResourceResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllResourceInventory(sub { },[Filters => ArrayRef[Paws::LicenseManager::InventoryFilter], MaxResults => Int, NextToken => Str])

ListAllResourceInventory([Filters => ArrayRef[Paws::LicenseManager::InventoryFilter], MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - ResourceInventoryList, passing the object as the first parameter, and the string 'ResourceInventoryList' as the second parameter 

If not, it will return a a Paws::LicenseManager::ListResourceInventoryResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllUsageForLicenseConfiguration(sub { },LicenseConfigurationArn => Str, [Filters => ArrayRef[Paws::LicenseManager::Filter], MaxResults => Int, NextToken => Str])

ListAllUsageForLicenseConfiguration(LicenseConfigurationArn => Str, [Filters => ArrayRef[Paws::LicenseManager::Filter], MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - LicenseConfigurationUsageList, passing the object as the first parameter, and the string 'LicenseConfigurationUsageList' as the second parameter 

If not, it will return a a Paws::LicenseManager::ListUsageForLicenseConfigurationResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

SEE ALSO

This service class forms part of Paws

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues