Sync Dimensions to Private Offers

Add newly-listed usage dimensions to your already-released AWS private offers in bulk, by uploading a reviewed worklist.

Overview

When you add a new usage metering dimension to a product’s public listing, the private offers that were already released keep the dimension set they had when they were created. Buyers on those offers cannot be metered on the new dimension until it is added to their offer.

This tool lets you add one or more missing dimensions to a batch of released private offers at a price you specify — in a single upload — without changing any existing dimension or price on those offers.

Before you start

• Your organization is an AWS Marketplace seller (has a connected AWS integration). If you don’t see the card described below, contact Suger to enable this feature for your account.
• You are signed in to the Suger Console as an admin of the organization.
• You know the target private offer IDs and the dimension keys you want to add.

Where to find it

In the Suger Console, go to Settings → Private Offer tab → the Dimension Sync to Private Offers card.

Step 1 — Download the worklist template

On the card, click Upload worklist, then Download template. The template is a spreadsheet/CSV with the columns below.

Step 2 — Fill the worklist

• One header row, values only (no formulas). For .xlsx, only the first sheet is read; extra columns are ignored.
• One row per (offer, dimension) you want to add. An offer that needs several dimensions gets one row per dimension — they are added together in a single update to that offer.
• Get the Price from the dimension’s list price on the product’s public listing (see Pricing Model).

Step 3 — Upload

Click Upload worklist, drag in (or browse to) your .xlsx or .csv, then Upload.

On success you see “Accepted — applying in the background”, and a new row appears in the task table on the card.

Step 4 — Track progress

The task table lists every upload, newest first, and refreshes on its own while a task runs.

You can Cancel a running task. After you cancel, no new offers are submitted; offers already submitted finish and are recorded.

Step 5 — Download the report

For any finished task, click Report. The report echoes every input row plus a Status and a Reason, so every row is accounted for:

How it behaves

• Existing dimensions and prices are never changed. Only the missing dimensions you list are added.
• Per offer, one update. All of an offer’s requested dimensions are added together, so an offer is updated at most once per upload.
• Expired or non-updatable offers are skipped, not failed. An offer whose acceptance window has passed with no active agreement cannot be updated by AWS; it is reported as skipped.
• Safe to re-run. If you upload the same worklist again, dimensions already on an offer are skipped — re-uploading applies no duplicate changes.
• Unregistered dimensions fail that row only. A dimension that is not registered on the product is reported failed for that row; the offer’s other valid rows still apply.

FAQ

• Does this change the prices of dimensions already on the offer?

  No. Existing dimensions and their prices are left exactly as they are. Only the missing dimensions you list are added, at the price you set.

• I re-uploaded the same file — will it double-apply?

  No. Dimensions already present on an offer are reported as skipped, so a re-run makes no additional changes.

• Why was my offer reported as “expired / not updatable”?

  AWS does not allow updating a private offer whose acceptance window has passed when there is no active agreement behind it. Those offers are skipped rather than failed.

• What is the % column for?

  It is carried through to the report for your own audit only. It has no effect on the price that is applied.