AWS Marketplace

Complete guide to managing your AWS Marketplace presence with Automatum.

Overview

Automatum provides deep integration with AWS Marketplace, enabling you to manage listings, private offers, contracts, and metering from a unified platform.

Supported Offer Types

SaaS Products

• Subscription: Recurring monthly/annual charges
• Contract: Upfront payment with flexible terms
• Contract with Consumption: Upfront + usage-based
• Free Trial: Time-limited free access

AMI Products

• Hourly Pricing: Pay-per-hour usage
• Annual Subscription: Discounted yearly rate
• BYOL: Bring Your Own License

Container Products

• ECS/EKS: Container orchestration pricing
• Fargate: Serverless container pricing

Quick Start

1. Connect AWS Account

Follow the AWS Setup Guide

2. Sync Products

Import existing products:

1. Go to Listings
2. Click Sync from AWS
3. Select products
4. Click Import

3. Create Private Offer

1. Select a listing
2. Click Create Private Offer
3. Enter customer AWS Account ID
4. Configure pricing
5. Submit to AWS

Key Features

Product Management

• View all AWS products
• Edit descriptions and metadata
• Update pricing tiers
• Manage dimensions (metered)
• Track product versions

See Listings Management Guide for complete details.

Private Offers

Create custom pricing with flexible payment schedules, multi-year contracts, channel partner offers, and reseller agreements.

See Private Offers Guide for complete details on creating and managing AWS private offers.

Customer Management

Track AWS account IDs, view entitlements, monitor subscriptions, and manage renewals.

See Customer Management Guide for complete details.

Usage Metering

Report SaaS consumption with automatic validation, retries, and audit logging.

See Metering Guide for complete details on usage reporting.

AWS-Specific Configuration

IAM Role Setup

Automatum requires an IAM role with:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:*",
        "aws-marketplace-management:*"
      ],
      "Resource": "*"
    }
  ]
}

Trust Relationship

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::AUTOMATUM_ACCOUNT:role/AutomatumRole"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "YOUR_EXTERNAL_ID"
        }
      }
    }
  ]
}

Required Permissions

Permission	Purpose
marketplace:DescribeEntity	Read product info
marketplace:ListEntities	List all products
marketplace:StartChangeSet	Create/update offers
marketplace:DescribeChangeSet	Track submission status
marketplace:BatchMeterUsage	Report consumption

Private Offer Configuration

AWS Marketplace supports flexible private offer configurations including:

• Multiple discount types (percentage, absolute, custom pricing)
• Flexible payment schedules (upfront, monthly, quarterly, annual)
• Contract durations from 1 to 36+ months
• Channel partner and reseller agreements

Buyer Requirements:

• AWS Account ID (12 digits)
• Appropriate IAM permissions
• Payment method configured

For detailed information on creating and configuring private offers, see the Private Offers Guide.

Metering Integration

AWS Marketplace supports usage-based billing through custom dimensions. Define dimensions in your product (e.g., Users, API Calls, Storage) and report usage via the Automatum API.

Key Constraints:

• Report within 1 hour of usage
• Maximum 25 records per batch
• Quantity must be positive integer
• Dimension must exist in product

For complete metering documentation including API examples, see the Metering Guide.

Compliance & Security

Data Handling

• Customer data encrypted at rest
• API calls over TLS
• Audit logging enabled
• SOC 2 compliance

AWS Marketplace Policies

Ensure compliance with:

• AWS Acceptable Use Policy
• AWS Marketplace Seller Agreement
• Product guidelines

Troubleshooting

Common Issues

"Entity not found" error:

• Verify product code
• Check AWS account permissions
• Ensure product is published

"Invalid buyer" error:

• Verify AWS Account ID format
• Check buyer has valid payment method
• Ensure buyer isn't already subscribed

Metering failures:

• Check dimension exists
• Verify timestamp is recent
• Confirm customer has entitlement

Support Resources

• AWS Marketplace Support
• AWS Documentation
• Contact support@automatum.io for assistance

API Integration

Automatum provides a comprehensive OAuth 2.0 API for programmatic access to AWS Marketplace operations:

• Sync listings from AWS Marketplace
• Create and manage private offers
• Report usage metering
• Retrieve customer entitlements
• Access analytics data

Quick Example:

# Get all AWS listings
GET https://api.automatum.io/api/v1/listings?vendor=aws
Authorization: Bearer YOUR_ACCESS_TOKEN

For complete API documentation:

• API Authentication - OAuth 2.0 setup
• API Reference - All available endpoints including private offers and metering

Best Practices

1. Test in sandbox - Use AWS Marketplace sandbox first
2. Monitor metering - Set up alerts for failures
3. Track renewals - Start 90 days before expiry
4. Keep products updated - Sync regularly
5. Document offers - Maintain offer records

Related Documentation

• AWS Setup Guide
• Private Offers
• Usage Metering
• Customer Management

Need Help?

Contact support@automatum.io for AWS Marketplace assistance.