AWS License Manager
API Reference (API Version 2018-08-01)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

UpdateLicenseSpecificationsForResource

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.

Request Syntax

{ "AddLicenseSpecifications": [ { "LicenseConfigurationArn": "string" } ], "RemoveLicenseSpecifications": [ { "LicenseConfigurationArn": "string" } ], "ResourceArn": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

AddLicenseSpecifications

ARNs of the license configurations to add.

Type: Array of LicenseSpecification objects

Required: No

RemoveLicenseSpecifications

ARNs of the license configurations to remove.

Type: Array of LicenseSpecification objects

Required: No

ResourceArn

ARN of the AWS resource.

Type: String

Required: Yes

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

Access to resource denied.

HTTP Status Code: 400

AuthorizationException

The AWS user account does not have permission to perform the action. Check the IAM policy associated with this account.

HTTP Status Code: 400

InvalidParameterValueException

One or more parameter values are not valid.

HTTP Status Code: 400

InvalidResourceStateException

License Manager cannot allocate a license to a resource because of its state.

For example, you cannot allocate a license to an instance in the process of shutting down.

HTTP Status Code: 400

LicenseUsageException

You do not have enough licenses available to support a new resource launch.

HTTP Status Code: 400

RateLimitExceededException

Too many requests have been submitted. Try again after a brief wait.

HTTP Status Code: 400

ServerInternalException

The server experienced an internal error. Try again.

HTTP Status Code: 500

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: