ConfirmProductInstance
Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner must verify whether another user's instance is eligible for support.
Request Parameters
The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.
- DryRun
-
Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is
DryRunOperation
. Otherwise, it isUnauthorizedOperation
.Type: Boolean
Required: No
- InstanceId
-
The ID of the instance.
Type: String
Required: Yes
- ProductCode
-
The product code. This must be a product code that you own.
Type: String
Required: Yes
Response Elements
The following elements are returned by the service.
- ownerId
-
The AWS account ID of the instance owner. This is only present if the product code is attached to the instance.
Type: String
- requestId
-
The ID of the request.
Type: String
- return
-
The return value of the request. Returns
true
if the specified product code is owned by the requester and associated with the specified instance.Type: Boolean
Errors
For information about the errors that are common to all actions, see Common client error codes.
Examples
Example
This example determines whether the specified product code is associated with the specified instance.
Sample Request
https://ec2.amazonaws.com/?Action=ConfirmProductInstance
&ProductCode=774F4FF8
&InstanceId=i-1234567890abcdef0
&AUTHPARAMS
Sample Response
<ConfirmProductInstanceResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
<requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
<return>true</return>
<ownerId>111122223333</ownerId>
</ConfirmProductInstanceResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: