View a markdown version of this page

AWS Marketplace Discovery API の使用 - AWS Marketplace
サービスエンドポイントAPI バージョンデータモデル認証リクエストの実行レスポンスの形式AWS SDK の使用Pagination (ページ分割)スロットリング

AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、AWS Marketplace API リファレンスを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Marketplace Discovery API の使用

AWS Marketplace Discovery API は、 AWS Marketplace カタログへのプログラムによるアクセスを提供します。これを使用して、製品と料金情報の取得、統合された調達エクスペリエンスの構築、カスタムストアフロントの作成を行うことができます。

サービスエンドポイント

Discovery API は、次のエンドポイント形式を使用します。

https://discovery-marketplace.region.api.aws

たとえば、米国東部 (バージニア北部) で API を呼び出すには:

https://discovery-marketplace.us-east-1.api.aws

API バージョン

現在の API バージョンは です2026-02-05。

データモデル

Discovery API は、 AWS Marketplace カタログを次のエンティティに整理します。

  • 出品 — 購入者に表示される製品またはマルチ製品ソリューション。出品には、説明、ハイライト、カテゴリ、バッジ、料金モデル、料金単位、レビュー、プロモーションメディア、販売者のエンゲージメント、フルフィルメントオプションタイプ、および関連する製品やオファーへの参照が含まれます。GetListing を使用して出品を取得するか、出品全体でSearchListings検索します。

  • 製品 — 販売されている基盤となるソフトウェアまたはサービス。製品には、購入者が製品 (AMI、SaaS、コンテナ、Helm など) をデプロイまたはアクセスする方法を説明する説明、ハイライト、カテゴリ、プロモーションメディア、販売者のエンゲージメント、フルフィルメントオプションが含まれます。GetProduct を使用して製品の詳細を取得し、 ListFulfillmentOptions を使用して製品の詳細なフルフィルメントオプションを取得します。

  • オファー — 料金モデル、登録販売者、利用可能日、バッジなど、製品の料金設定。オファーには、使用量ベースの料金、固定前払い料金、無料トライアル期間、法律文書、支払いスケジュール、更新期間などの商用条件が含まれます。ListPurchaseOptions を使用して、製品の利用可能なすべてのオファーを検索し、オファーの詳細GetOfferを取得し、オファーの特定の条件GetOfferTermsを取得します。

  • オファーセット — マルチ製品ソリューションの各製品のプライベートオファーのグループ化されたコレクション。オファーセットを使用すると、購入者はすべてのオファーをまとめて確認し、1 つのアクションで同時に受け入れることができます。ListPurchaseOptions を使用して、製品の利用可能なすべてのオファーセットを検索GetOfferSetし、オファーセットの詳細を取得し、オファーの詳細GetOfferを取得し、オファーの特定の条件GetOfferTermsを取得します。

認証

Discovery API は、標準の AWS Signature Version 4 (SigV4) 認証を使用します。API を呼び出すには、有効な AWS 認証情報と適切な IAM アクセス許可が必要です。詳細については、「AWS Marketplace Discovery API のアクセスコントロール」を参照してください。

リクエストの実行

すべての Discovery API オペレーションは、JSON リクエストボディで HTTP POSTメソッドを使用します。オペレーション名は URL パスで指定されます。

レスポンスの形式

すべてのレスポンスは JSON 形式で返されます。正常なレスポンスは、HTTP ステータスコード 200 を返します。エラーレスポンスには、エラータイプとメッセージが含まれます。詳細については、「一般的なエラー」を参照してください。

AWS SDK の使用

Discovery API を呼び出す推奨方法は、 AWS SDK を使用することです。SDK は、認証、リクエスト署名、シリアル化、エラー処理を自動的に処理します。

# Python (Boto3) example
import boto3

client = boto3.client('marketplace-discovery', region_name='us-east-1')

response = client.get_listing(
    listingId='listing-saas-abc123'
)

print(response['listingName'])
// JavaScript (AWS SDK v3) example
import { MarketplaceDiscoveryClient, GetListingCommand } from "@aws-sdk/client-marketplace-discovery";

const client = new MarketplaceDiscoveryClient({ region: "us-east-1" });
const response = await client.send(new GetListingCommand({
    listingId: "listing-saas-abc123"
}));

console.log(response.listingName);

Pagination (ページ分割)

リストを返すオペレーション ( ListPurchaseOptionsや などSearchFacets) は、 を使用したページ分割をサポートしていますnextToken。レスポンスにnextToken値が含まれている場合は、次のリクエストでそれを渡して、追加の結果を取得します。

スロットリング

Discovery API は、サービスの可用性を確保するためにリクエストレート制限を適用します。レート制限を超えると、API は ThrottlingException (HTTP 429) を返します。エクスポネンシャルバックオフと再試行ロジックをアプリケーションに実装します。