AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Paid container software products sold through AWS Marketplace must integrate with the AWS Marketplace Metering Service and call the RegisterUsage operation for software entitlement and metering. Free and BYOL products for Amazon ECS or Amazon EKS aren't required to call RegisterUsage, but you may choose to do so if you would like to receive usage data in your seller reports. The sections below explain the behavior of RegisterUsage. RegisterUsage performs two primary functions: metering and entitlement.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to RegisterUsageAsync.

Namespace: Amazon.AWSMarketplaceMetering
Assembly: AWSSDK.AWSMarketplaceMetering.dll
Version: 3.x.y.z

Syntax

C#
public virtual RegisterUsageResponse RegisterUsage(
         RegisterUsageRequest request
)

Parameters

request
Type: Amazon.AWSMarketplaceMetering.Model.RegisterUsageRequest

Container for the necessary parameters to execute the RegisterUsage service method.

Return Value


The response from the RegisterUsage service method, as returned by AWSMarketplaceMetering.

Exceptions

ExceptionCondition
CustomerNotEntitledException Exception thrown when the customer does not have a valid subscription for the product.
DisabledApiException The API is disabled in the Region.
InternalServiceErrorException An internal error has occurred. Retry your request. If the problem persists, post a message with details on the AWS forums.
InvalidProductCodeException The product code passed does not match the product code used for publishing the product.
InvalidPublicKeyVersionException Public Key version is invalid.
InvalidRegionException RegisterUsage must be called in the same AWS Region the ECS task was launched in. This prevents a container from hardcoding a Region (e.g. withRegion(“us-east-1”) when calling RegisterUsage.
PlatformNotSupportedException AWS Marketplace does not support metering usage from the underlying platform. Currently, Amazon ECS, Amazon EKS, and AWS Fargate are supported.
ThrottlingException The calls to the API are throttled.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also