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

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

オファーセットの使用

AWS Marketplace オファーセットを使用すると、販売者は複数のプライベートオファーを購入者向けの統合マルチ製品取引可能パッケージにパッケージ化できます。この機能は、複雑なエンタープライズ環境における包括的なend-to-endソリューションに対する顧客の需要の高まりに対処します。

従来、購入者は複数の販売者から個々の製品を検出して調達する必要があり、その結果、エクスペリエンスが断片化され、統合の課題が発生し、調達サイクルが長くなりました。オファーセットは、AWS Marketplace パートナーが複数のオファーを組み合わせて、顧客が 1 回限りの承認ですべてのコンポーネントを確認して受け入れることができる、調整されたプライベートオファーを通じてトランザクションプロセスを合理化することで、これを簡素化します。

オファーセットは ソリューションと連携して、包括的なマルチ製品を提供します。ソリューションは、詳細な説明、アーキテクチャ図、ユースケースドキュメントなどの豊富なマーケティングコンテンツを提供しますが、オファーセットは、統合調達のための取引可能なパッケージングと商用条件を処理します。

オファーセットエンティティ

オファーセットは、2～7 のプライベートオファーを 1 つのトランザクション可能なパッケージにグループ化するコンテナです。オファーセット内の各オファーは独自の料金、支払い条件、期間、エンドユーザーライセンス契約 (EULA) を維持し、オファーセットは購入者に統一された検出と承諾エクスペリエンスを提供します。

主な特性:

オファーセットエンティティタイプは ですOfferSet@1.0。

エンティティ識別子

オファーセットはofferset-*識別子形式 ( などofferset-abc123def456) を使用します。

エンティティ ARN 形式

オファーセットは、標準の AWS ARN 形式に従います。

arn:aws:aws-marketplace:{region}:{account-id}:AWSMarketplace/OfferSet/{offerset-id}

例:

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-abc123def456

オファーセットの開始方法

このセクションでは、 AWS Marketplace Catalog API 変更タイプを使用したオファーセットの作成と管理に関する詳細情報を提供します。

開始する前に、以下の準備が整っていることを確認します。

オファーセットを一覧表示する

アカウント内のすべてのオファーセットを一覧表示するには、 を EntityTypeに設定して ListEntities API オペレーションを呼び出しますOfferSet。

リクエスト

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "OfferSet"
}

レスポンス

{
  "EntitySummaryList": [
    {
      "EntityType": "OfferSet",
      "EntityId": "offerset-xyz123",
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123",
      "LastModifiedDate": "2025-06-25T23:46:25Z",
      "OfferSetSummary": {
        "Name": "Enterprise Security Solution Offer Set",
        "State": "Released",
        "ReleaseDate": "2025-06-25T23:46:20Z",
        "SolutionId": "soln-abc987",
        "AssociatedOfferIds": [
          "offer-abc123",
          "offer-def456",
          "offer-ghi789"
        ]
      }
    }
  ],
  "NextToken": null
}

オファーセットを状態別にフィルタリングする

オファーセットは、 EntityTypeFiltersパラメータを使用して状態別にフィルタリングできます。

[リクエスト]

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "OfferSet",
  "EntityTypeFilters": {
    "OfferSetFilters": {
      "State": {
        "ValueList": [
          "Released"
        ]
      }
    }
  }
}

ソリューション ID でオファーセットをフィルタリングする

オファーセットは、 EntityTypeFiltersパラメータを使用してソリューション ID でフィルタリングできます。

[リクエスト]

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "OfferSet",
  "EntityTypeFilters": {
    "OfferSetFilters": {
      "SolutionId": {
        "ValueList": [
          "soln-abc987"
        ]
      }
    }
  }
}

リリース日でオファーセットをフィルタリングする

オファーセットをリリース日でフィルタリングし、 EntityTypeFilters および EntityTypeSortパラメータを使用して結果をソートできます。

[リクエスト]

POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "OfferSet",
  "EntityTypeFilters": {
    "OfferSetFilters": {
      "ReleaseDate": {
        "AfterValue": "2025-11-01"
      }
    }
  },
  "EntityTypeSort": {
    "OfferSetSort": {
      "SortBy": "ReleaseDate",
      "SortOrder": "DESCENDING"
    }
  }
}

オファーセットの説明

特定のオファーセットに関する詳細情報を取得するには、 DescribeEntity API オペレーションを呼び出します。

リクエスト

GET /DescribeEntity?catalog=AWSMarketplace&entityId=offerset-xyz123 HTTP/1.1

レスポンス

{
  "EntityType": "OfferSet@1.0",
  "EntityId": "offerset-xyz123",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123",
  "LastModifiedDate": "2025-06-25T23:46:25Z",
  "DetailsDocument": {
    "Id": "offerset-xyz123",
    "Name": "Enterprise Security Solution Offer Set",
    "BuyerNotes": "Complete security solution including endpoint protection and network monitoring",
    "State": "Released",
    "SolutionId": "soln-abc987",
    "ReleaseDate": "2025-06-25T23:46:20Z",
    "AssociatedOffers": [
      {
        "OfferId": "offer-abc123"
      },
      {
        "OfferId": "offer-def456"
      },
      {
        "OfferId": "offer-ghi789"
      }      
    ]
  }
}

オファーセットを作成する

CreateOfferSet 変更タイプを使用して、Draft 状態の新しいオファーセットエンティティを作成します。これはオファーセットライフサイクルの最初のステップであり、後で購入者にリリースする前にオファーの関連付けとメタデータで設定される基盤エンティティを確立します。

リクエストの構文

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateOfferSet",
      "Entity": {
        "Type": "OfferSet@1.0"
      },
      "ChangeName": "CreateOfferSetChange",
      "DetailsDocument": {
        "Name": "Enterprise Security Solution Offer Set"
      }
    }
  ]
}

CreateOfferSet 変更タイプを追加するフィールドの情報を入力します。

レスポンスの構文

リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セットChangeSetArnの ChangeSetIdと を提供し、次のようになります。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

変更リクエストがキューに追加され、処理されます。これには、AWS Marketplace ガイドラインを満たしていることを確認するための情報の検証が含まれます。検証プロセスには数分かかる場合があります。

リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog DescribeChangeSet API から直接確認できます。

処理が成功すると、 は というプレフィックスが付いた一意の識別子を持つオファーセットをドラフト状態で AWS Marketplace 生成しますofferset-。

オファーセット情報の更新

UpdateInformation 変更タイプを使用して、名前や購入者のメモなど、既存のオファーセットの詳細を変更します。

リクエストの構文

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Type": "OfferSet@1.0",
        "Identifier": "offerset-abc123"
      },
      "DetailsDocument": {
        "Name": "Updated Enterprise Security Offer Set",
        "BuyerNotes": "Complete security solution including endpoint protection, network monitoring, and professional services implementation"
      }
    }
  ]
}

UpdateInformation 変更タイプを追加するフィールドの情報を入力します。

レスポンスの構文

リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セットChangeSetArnの ChangeSetIdと を提供し、次のようになります。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

変更リクエストがキューに追加され、処理されます。これには、AWS Marketplace ガイドラインを満たしていることを確認するための情報の検証が含まれます。検証プロセスには数分かかる場合があります。

リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog DescribeChangeSet API から直接確認できます。

オファーをオファーセットに関連付ける

AssociateOffers 変更タイプを使用して、複数の AWS Marketplace オファーをオファーセットに関連付けます。これにより、オファーとオファーセットの関係が作成され、オファーセットのトランザクション可能な設定の一部になります。

オペレーションはべき等であり、現在の状態に関係なくオファーを関連付けることができるため、個々のオファーがリリースされる前に完全な設定が可能になります。各オファーは 1 つのオファーセットにのみ属できます。

必要な IAM アクセス許可の詳細については、「」を参照してくださいオファーセットの IAM アクセス許可。

リクエストの構文

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "AssociateOffers",
      "Entity": {
        "Type": "OfferSet@1.0",
        "Identifier": "offerset-abc123"
      },
      "DetailsDocument": {
        "Offers": [
          {
            "OfferId": "offer-xyz789"
          },
          {
            "OfferId": "offer-def456"
          },
          {
            "OfferId": "offer-ghi123"
          }
        ]
      }
    }
  ]
}

AssociateOffers 変更タイプを追加するフィールドの情報を入力します。

レスポンスの構文

リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セットChangeSetArnの ChangeSetIdと を提供し、次のようになります。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

変更リクエストがキューに追加され、処理されます。これには、AWS Marketplace ガイドラインを満たしていることを確認するための情報の検証が含まれます。検証プロセスには数分かかる場合があります。

リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog DescribeChangeSet API から直接確認できます。

非同期エラー

以下のエラーは、 AWS Marketplace Catalog API の AssociateOffersアクションに固有のものです。これらのエラーは、変更セットの処理DescribeChangeSet後に を呼び出すと返されます。DescribeChangeSet を使用して変更リクエストのステータスを取得する方法の詳細については、「」を参照してください変更セットの使用。

オファーセットからオファーの関連付けを解除する

DisassociateOffers 変更タイプを使用して、 AWS Marketplace オファーセットから複数のオファーを削除します。このべき等操作は、オファーの OfferSetId 属性を保持しながら関連付け関係を削除します。関連付けが解除されたオファーは、同じオファーセットに再関連付けされるまで、購入者検出から非表示になります。別のオファーセットに関連付けることはできません。

リクエストの構文

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "DisassociateOffers",
      "Entity": {
        "Type": "OfferSet@1.0",
        "Identifier": "offerset-abc123"
      },
      "DetailsDocument": {
        "Offers": [
          {
            "OfferId": "offer-xyz789"
          }
        ]
      }
    }
  ]
}

DisassociateOffers 変更タイプを追加するフィールドの情報を入力します。

レスポンスの構文

リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セットChangeSetArnの ChangeSetIdと を提供し、次のようになります。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

変更リクエストがキューに追加され、処理されます。これには、AWS Marketplace ガイドラインを満たしていることを確認するための情報の検証が含まれます。検証プロセスには数分かかる場合があります。

リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog DescribeChangeSet API から直接確認できます。

非同期エラー

次のエラーは、 AWS Marketplace Catalog API の DisassociateOffersアクションに固有のものです。これらのエラーは、変更セットの処理DescribeChangeSet後に を呼び出すと返されます。DescribeChangeSet を使用して変更リクエストのステータスを取得する方法の詳細については、「」を参照してください変更セットの使用。

ソリューションをオファーセットに関連付ける

AssociateSolution 変更タイプを使用して、単一の AWS Marketplace ソリューションをオファーセットに関連付けます。これにより、購入者はソリューションへのオファーセットの接続を検出し、詳細な説明、アーキテクチャ図、ユースケースドキュメントなどのソリューションの豊富なマーケティングコンテンツにアクセスできるようになります。

必要な IAM アクセス許可の詳細については、「」を参照してくださいオファーセットの IAM アクセス許可。

リクエストの構文

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "AssociateSolution",
      "Entity": {
        "Type": "OfferSet@1.0",
        "Identifier": "offerset-abc123"
      },
      "DetailsDocument": {
        "SolutionId": "soln-xyz789"
      }
    }
  ]
}

AssociateSolution 変更タイプを追加するフィールドの情報を入力します。

レスポンスの構文

リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セットChangeSetArnの ChangeSetIdと を提供し、次のようになります。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

変更リクエストがキューに追加され、処理されます。これには、AWS Marketplace ガイドラインを満たしていることを確認するための情報の検証が含まれます。検証プロセスには数分かかる場合があります。

リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog DescribeChangeSet API から直接確認できます。

非同期エラー

次のエラーは、 AWS Marketplace Catalog API の AssociateSolutionアクションに固有です。これらのエラーは、変更セットの処理DescribeChangeSet後に を呼び出すと返されます。DescribeChangeSet を使用して変更リクエストのステータスを取得する方法の詳細については、「」を参照してください変更セットの使用。

オファーセットからソリューションの関連付けを解除する

DisassociateSolution 変更タイプを使用して、ソリューションとオファーセット間の関連付けを削除します。これにより、オファーセットのトランザクション可能な機能を維持しながら、ソリューションのマーケティングコンテンツがオファーセットから削除されます。

リクエストの構文

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "DisassociateSolution",
      "Entity": {
        "Type": "OfferSet@1.0",
        "Identifier": "offerset-abc123"
      },
      "DetailsDocument": {
        "SolutionId": "soln-xyz789"
      }
    }
  ]
}

DisassociateSolution 変更タイプを追加するフィールドの情報を入力します。

レスポンスの構文

リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セットChangeSetArnの ChangeSetIdと を提供し、次のようになります。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

変更リクエストがキューに追加され、処理されます。これには、AWS Marketplace ガイドラインを満たしていることを確認するための情報の検証が含まれます。検証プロセスには数分かかる場合があります。

リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog DescribeChangeSet API から直接確認できます。

非同期エラー

以下のエラーは、 AWS Marketplace Catalog API の DisassociateSolutionアクションに固有のものです。これらのエラーは、変更セットの処理DescribeChangeSet後に を呼び出すと返されます。DescribeChangeSet を使用して変更リクエストのステータスを取得する方法の詳細については、「」を参照してください変更セットの使用。

オファーセットをリリースする

ReleaseOfferSet 変更タイプを使用して、購入者がオファーセットを利用できるようにします。リリースされると、オファーセットはドラフト状態からリリース状態に移行し、 を通じて検出可能になり AWS Marketplace、関連するオファーは統合パッケージの一部としてのみ見つかります。

リリースされたオファーセットは、個別のオファーとオファーセット自体の 2 つのレベルで通知を生成します。すべての個々のオファー通知には、既存の通知チャネル (E メール通知と Amazon EventBridge イベント) の OfferSetId が含まれます。オファーセットレベルの通知は、オファーセットがリリースされたときなどの主要なイベントに送信されます。

リクエストの構文

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseOfferSet",
      "Entity": {
        "Type": "OfferSet@1.0",
        "Identifier": "offerset-abc123"
      },
      "DetailsDocument": {}
    }
  ]
}

ReleaseOfferSet 変更タイプを追加するフィールドの情報を入力します。

レスポンスの構文

リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セットChangeSetArnの ChangeSetIdと を提供し、次のようになります。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

変更リクエストがキューに追加され、処理されます。これには、AWS Marketplace ガイドラインを満たしていることを確認するための情報の検証が含まれます。検証プロセスには数分かかる場合があります。

リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog DescribeChangeSet API から直接確認できます。

非同期エラー

以下のエラーは、 AWS Marketplace Catalog API の ReleaseOfferSetアクションに固有です。これらのエラーは、変更セットの処理DescribeChangeSet後に を呼び出すと返されます。DescribeChangeSet を使用して変更リクエストのステータスを取得する方法の詳細については、「」を参照してください変更セットの使用。

オファーセットのライフサイクル

オファーセットのライフサイクルは、次のステージで構成されます。

作成フェーズ

CreateOfferSet 変更タイプを使用して、オファーセットエンティティをドラフト状態で作成します。オファーセットは一意の識別子を受け取り、ドラフト状態で開始します。

設定フェーズ

設定中、次の操作を行います。

検証フェーズ

オファーセットをリリースする前に、以下を確認してください。

リリースフェーズ

準備ができたら、ReleaseOfferSet変更タイプを使用してオファーセットをドラフト状態からリリース状態に移行します。これにより、オファーセットは購入者が検出できるようになります AWS Marketplace。

リリース後の管理

有効期限管理:

オファーセットの変更:

購入者がリリースされたオファーセットの変更をリクエストする場合は、再作成ワークフローを使用します。

オファーセットの IAM アクセス許可

AWS Marketplace Catalog API を使用してオファーセットを使用するには、特定の IAM アクセス許可が必要です。このセクションでは、オファーセットオペレーションとクロスエンティティ認可要件に必要なアクセス許可について説明します。

必須 IAM アクション

オファーセットオペレーションには、次の IAM アクションが必要です。

リソースのアクセス許可

次の ARN パターンを使用して、特定のリソースに対するアクセス許可を付与します。

アクセス許可をより制限するには、ワイルドカード (*) を特定のエンティティ識別子に置き換えます。

クロスエンティティ認可

一部のオファーセットオペレーションでは、オファーセットと関連付けられているエンティティの両方に対するアクセス許可が必要です。

AssociateOffers

AssociateSolution

IAM ポリシーの例

基本的なオファーセット管理

このポリシーは、エンティティ間の関連付けなしで基本的なオファーセットオペレーションのアクセス許可を提供します。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet",
        "aws-marketplace:DescribeChangeSet",
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeEntity"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*"
      ]
    }
  ]
}

AssociateOffers のクロスエンティティアクセス許可

このポリシーは、AssociateOffers に必要な特定のアクセス許可と条件を示しています。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "aws-marketplace:StartChangeSet",
      "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*",
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": ["AssociateOffers"]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "aws-marketplace:DescribeEntity",
      "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*"
    },
    {
      "Effect": "Allow",
      "Action": "aws-marketplace:StartChangeSet",
      "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*",
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": ["AssociateWithOfferSet"]
        }
      }
    }
  ]
}

より制限の厳しいアクセス許可を得るには、ワイルドカード (*) を特定のエンティティ識別子に置き換えます。

AssociateSolution のクロスエンティティアクセス許可

このポリシーは、AssociateSolution に必要な特定のアクセス許可と条件を示しています。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "aws-marketplace:StartChangeSet",
      "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*",
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": ["AssociateSolution"]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": "aws-marketplace:DescribeEntity",
      "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
    },
    {
      "Effect": "Allow",
      "Action": "aws-marketplace:StartChangeSet",
      "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": ["AssociateWithOfferSet"]
        }
      }
    }
  ]
}

より制限の厳しいアクセス許可を得るには、ワイルドカード (*) を特定のエンティティ識別子に置き換えます。