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

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

ソリューションの使用

ソリューションは、特定の顧客の問題を解決するために連携する製品やサービスのコレクションです。ソリューションには、AWS Marketplace 製品と AWS Marketplace 以外の製品を含めることができます。ソリューションは、複数の製品が統合されて業界固有のユースケースに対処する方法を紹介するのに役立ちます。このソリューションでは、顧客の問題、ユースケース、統合の詳細、および関連製品について説明します。

AWS Marketplace と AWS Partner Central のソリューション

Partner Central 2.0 から Partner Central 3.0 に移行すると、AWS アカウントを作成し、AWS Marketplace 販売者として登録するように求められます。詳細については、「販売者プロファイルの登録と作成」を参照してください。この登録は、次の目的で必要です。

プロファイルのリンクと移行について

Partner Central アカウントと AWS Marketplace アカウントを接続するには、次の 2 つの異なるシナリオがあります。

プロファイルリンクのみ – Partner Central 3.0 に移行せずに AWS Partner Central と AWS アカウントをリンクする場合、AWS Marketplace ソリューションと Partner Central ソリューションは別々に残ります。各プラットフォームは個別に管理します。

プロファイルの移行 – リンクされた AWS Marketplace 販売者プロファイルを使用して Partner Central 3.0 に移行する場合:

Partner Central APIs で既存の AWS Marketplace ソリューションを利用できるようにする

Partner Central 3.0 プロファイル移行前に作成した AWS Marketplace ソリューションは、Partner Central APIsによって自動的に認識されません。これは、移行を完了し、AWS アカウントを Partner Central アカウントにリンクした後でも適用されます。

既存の移行前ソリューションを Partner Central APIsに表示するには、ソリューション内の任意のフィールドを更新します。現在存在するのと同じ情報を入力できます。Partner Central 3.0 プロファイルの移行前に作成したソリューションごとにこのプロセスを繰り返します。

たとえば、 UpdateInformation変更タイプを使用して、ソリューションの名前を現在の値で更新します。ソリューションを更新すると、Partner Central APIsはそのソリューションの今後の更新を自動的に認識します。

ソリューションエンティティ

ソリューションは、購入者がお客様のサービスを見つけて理解するのに役立つマーケティングドキュメントです。ソリューションには、タイトル、説明、ユースケース、AWS Marketplace 製品、AWS Marketplace 以外の製品が含まれています。ソリューションは、製品、オファー、オファーセットとは別のエンティティタイプです。各ソリューションには、購入者が個々の製品とは別に閲覧できる独自の検出および出品経験があります。

主な特徴

ソリューションエンティティタイプは ですSolution@1.0。

エンティティ識別子

ソリューションはsoln-*識別子形式 ( などsoln-abc123def456) を使用します。

エンティティ ARN 形式

ソリューションは標準の AWS ARN 形式に従います。

arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}

例:

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456

ソリューションの開始方法

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

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

ソリューションを一覧表示する

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

リクエスト

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

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

レスポンス

{
  "EntitySummaryList": [
    {
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
      "EntityId": "soln-abc123456",
      "EntityType": "Solution",
      "LastModifiedDate": "2024-10-10T19:50:43Z",
      "Name": "Test Solution 1",
      "Visibility": "Limited"
    }
  ],
  "NextToken": null
}

可視性でソリューションをフィルタリングする

FilterList パラメータを使用して、可視性によってソリューションをフィルタリングできます。

[リクエスト]

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

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution",
  "FilterList": [
    {
      "Name": "Visibility",
      "ValueList": [
        "Public"
      ]
    }
  ]
}

ソリューションの詳細を取得する

特定のソリューションに関する詳細情報を取得するには、 DescribeEntity API オペレーションを呼び出します。

リクエスト

GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1

レスポンス

{
  "Details": "{...}",
  "DetailsDocument": {
    "Lifecycle": {
      "Visibility": "Limited"
    },
    "Identifiers": {
      "Id": "soln-abc123456"
    },
    "Presentation": {
      "Title": "My Solution",
      "Name": "solution_for_customer_X",
      "ShortDescription": "Solution value proposition",
      "LongDescription": "Detailed solution description",
      "LogoUrl": "https://s3.amazonaws.com/logo.jpg",
      "UseCases": [
        {
          "Group": "advertising_and_marketing",
          "SubGroup": "ad_intelligence_and_measurement",
          "Item": "amazon_ads_insights",
          "Description": "Use case description"
        }
      ]
    },
    "RelatedProducts": {
      "AwsMarketplaceProducts": [
        {
          "ProductId": "prod-123"
        }
      ],
      "IntegrationDescription": "How products work together",
      "NonAwsMarketplaceProducts": [
        {
          "Type": "Hardware",
          "Title": "A hardware product",
          "Url": "https://example.com",
          "Description": "My hardware product description"
        }
      ]
    },
    "BuyerEngagement": [
      {
        "EngagementOption": "RequestPrivateOffer"
      }
    ]
  },
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
  "EntityIdentifier": "soln-abc123456@12",
  "EntityType": "Solution@1.0",
  "LastModifiedDate": "2025-04-22T01:02:48Z"
}

ソリューションの変更履歴を一覧表示する

特定のソリューションの変更履歴を表示するには、エンティティフィルターを使用して ListChangeSets API オペレーションを呼び出します。

リクエストの構文

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

{
  "Catalog": "AWSMarketplace",
  "FilterList": [
    {
      "Name": "EntityId",
      "ValueList": [
        "soln-abc123456"
      ]
    }
  ]
}

タグソリューションと変更セット

作成時にソリューションと変更セットにタグを追加したり、後で更新したりできます。

作成時のタグ付け

CreateSolution は変更タイプEntityTagsにのみ追加でき、他のソリューション変更タイプには追加できません。を任意のStartChangeSetペイロードChangeSetTagsに追加できます。

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "Test solution resource name"
      },
      "EntityTags": [
        {
          "Key": "Team",
          "Value": "Solutions"
        }
      ]
    }
  ],
  "ChangeSetTags": [
    {
      "Key": "Environment",
      "Value": "Production"
    }
  ]
}

既存のリソースのタグを管理する

TagResource および UntagResource API オペレーションを使用して、既存のソリューションと変更セットのタグを管理します。ListTagsForResource を使用して現在のタグを表示します。

詳細については、「リソースのタグの管理」および「エンティティへのタグの追加」および「作成時の変更セット」を参照してください。

ソリューションを作成する

CreateSolution 変更タイプを使用して、ソリューション ID と名前のみを使用して新しいソリューションドキュメントを作成できます。他の値はまだ入力されていません。

リクエストが正常に処理されると、AWS Marketplace は Draftステータスのソリューションを作成します。この不完全なソリューションは、AWS Marketplace の購入者には表示されません。

次に、他の変更タイプを使用してソリューションを完了します。UpdateInformation、UpdateRelatedProducts、 UpdateBuyerEngagementOptions (Limitedソリューションを作成するためのオプション）、および ReleaseSolutionです。ReleaseSolution 変更タイプは、Limitedソリューションに必要なすべての必須フィールドがソリューションに存在することを検証し、それをLimited可視性に移動します。

リクエストの構文

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "solution_for_customerX_en",
        "Title": "New Partner Solution"
      }
    }
  ]
}

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

レスポンスの構文

リクエストの変更セットが作成されます。レスポンスは、 ChangeSetIdと を提供しますChangeSetArn。

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

変更リクエストがキューに追加され、処理されます。ステータスは、AWS Marketplace 管理ポータルまたは DescribeChangeSet API オペレーションを使用して確認できます。

リクエストが正常に完了すると ( Statusが の場合SUCCEEDED)、新しいソリューション ID が生成されます。

非同期エラー

CreateSolution アクションは、一般的な非同期エラーに加えて、特定のエラーを返します。これらのエラーは、変更セットの処理が終了したDescribeChangeSet後、 から送信されます。変更リクエストのステータスを取得する方法については、「変更セットの使用」を参照してください。

ソリューション情報を更新する

AWS Marketplace にソリューションがすでにある場合は、 Catalog API を使用してソリューション情報を更新できます。

ソリューション情報を更新するには、UpdateInformation変更タイプと更新された詳細を使用して StartChangeSet API オペレーションを呼び出します。次の例を参照してください。

AWS Marketplace は、ロゴとプロモーションメディアアセットを検証し、AWS Marketplace が所有する場所に取り込みます。DescribeEntity は、StartChangeSet からの元の入力ではなく、取り込まれたファイルのアクセス可能な URL を返します。送信された元の URLs を表示するには、DescribeChangeSet API を使用します。

リクエストの構文

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Identifier": "soln-1234abcd",
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "project_cold_harbor",
        "Title": "My Awesome Solution",
        "ShortDescription": "Solution value proposition",
        "LongDescription": "Detailed solution description explaining how this addresses customer needs",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
        "PromotionalMedia": [
          {
            "Type": "Image",
            "Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
            "Title": "Sample image",
            "Description": "Sample image description"
          },
          {
            "Type": "Video",
            "Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
            "Title": "Sample video",
            "PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
            "Description": "Sample video description"
          }
        ],
        "AdditionalResources": [
          {
            "Text": "Troubleshooting guide",
            "Url": "https://example.com/troubleshooting"
          }
        ],
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Highlight description of this use case"
          }
        ]
      }
    }
  ]
}

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

署名付き URL 情報については、「署名付き URLs」を参照してください。

レスポンスの構文

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

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

変更リクエストがキューに追加され、処理されます。リクエストのステータスを確認するには、AWS Marketplace 管理ポータルを使用するか、 DescribeChangeSet API を呼び出します。

Public ソリューション用に変更されたPromotionalMediaアセットを使用してこの変更タイプをトリガーすると、完了までに最大 37 日かかる場合があります。これには、AWS Marketplace Seller Operations Team がレビュー、監査、承認する必要がある時間が含まれます。

非同期エラー

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

関連製品を更新する

Catalog API を使用して、AWS Marketplace 製品や AWS Marketplace 以外の製品など、ソリューションに含まれる製品やサービスを更新できます。

関連製品を更新するには、次の例に示すように、UpdateRelatedProducts変更タイプを使用して StartChangeSet API オペレーションを呼び出します。

リクエストの構文

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-123456"
      },
      "DetailsDocument": {
        "IntegrationDescription": "How to use the products in this solution (usage guide)",
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          },
          {
            "ProductId": "prod-456"
          }
        ],
        "NonAwsMarketplaceProducts": [
          {
            "Type": "Hardware",
            "Title": "Diamond engine",
            "Description": "Hardware details",
            "Url": "https://example.com/hardware-product-specs.html"
          }
        ]
      }
    }
  ]
}

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

レスポンスの構文

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

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

変更リクエストがキューに追加され、処理されます。

リクエストのステータスを確認するには、AWS Marketplace 管理ポータルを使用するか、 DescribeChangeSet API を呼び出します。

非同期エラー

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

ソリューションをリリースする

Catalog API を使用して、Draftソリューションを AWS Marketplace のLimited可視性に公開できます。

ReleaseSolution 変更タイプは、Limitedソリューションのすべての必須フィールドが存在することを検証します。次に、ソリューションを からDraftLimited可視性に移動します。ソリューションがLimited可視化されると、可視性に戻すことはできませんDraft。

ソリューションをリリースするには、次の例に示すように、 ReleaseSolution変更タイプで StartChangeSet API オペレーションを呼び出します。

リクエストの構文

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {}
    }
  ]
}

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

レスポンスの構文

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

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

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

非同期エラー

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

購入者エンゲージメントオプションを更新する

Catalog API を使用して、購入者がソリューションにどのように関与するかを設定できます。

購入者エンゲージメントオプションを更新するには、次の例に示すように、UpdateBuyerEngagementOptions変更タイプを使用して StartChangeSet API オペレーションを呼び出します。

リクエストの構文

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": [
        {
          "EngagementOption": "RequestProductDemo"
        },
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    }
  ]
}

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

レスポンスの構文

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

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

変更リクエストがキューに追加され、処理されます。

リクエストのステータスを確認するには、AWS Marketplace 管理ポータルを使用するか、 DescribeChangeSet API を呼び出します。

非同期エラー

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

ソリューションの可視性を更新する

Catalog API を使用して、AWS Marketplace でのソリューションの可視性を更新できます。

ターゲットの可視性は、Limited、Public、または に設定できますRestricted。

TargetVisibility を に設定するとPublic、UpdateVisibility変更タイプには AWS Marketplace Seller Operations チームによる手動レビューが必要です。これにより、実行時間が長くなります。独自の変更セットでUpdateVisibility個別に を使用します。

ソリューションの可視性を更新するには、次の例に示すように、UpdateVisibility変更タイプを使用して StartChangeSet API オペレーションを呼び出します。

リクエストの構文

TargetVisibility が Publicまたは の場合Limited。

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Public"
      }
    }
  ]
}

TargetVisibility が の場合Restricted。

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Restricted"
      }
    }
  ]
}

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

レスポンスの構文

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

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

変更リクエストがキューに追加され、処理されます。

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

この変更タイプを TargetVisibilityとしてトリガーした後Public、完了までに最大 37 日かかることがあります。これには、AWS Marketplace Seller Operations Team がレビュー、監査、承認する必要がある時間が含まれます。

非同期エラー

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

一般的な非同期エラーコード

URL の有効性とサポートされていない文字のチェックなど、すべてのソリューション変更タイプに適用される非同期検証があり、それらのエラーコードとエラーメッセージがここに一覧表示されます。

指定する各 URL フィールドは HTTPS プロトコルを使用し、RFC2396 または RFC 2732 標準に準拠している必要があります。

ソリューションライフサイクル

ソリューションは、次の可視性値を通じて進行します。

完全なソリューションの最小要件

完全なソリューションを作成し、ドラフトステータスを超えて公開するには、次の変更タイプと属性が必要です。

次の例は、単一の変更セットでLimited可視性を備えた完全なソリューションを作成する方法を示しています。

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "complete_solution_example",
        "Title": "Complete Solution Example"
      }
    },
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateInformationChange",
      "DetailsDocument": {
        "ShortDescription": "A comprehensive solution for customer needs",
        "LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Provides comprehensive advertising insights and measurement capabilities"
          }
        ]
      }
    },
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateRelatedProductsChange",
      "DetailsDocument": {
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          }
        ],
        "IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
      }
    },
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateBuyerEngagementChange",
      "DetailsDocument": [
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    },
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "ReleaseSolutionChange",
      "DetailsDocument": {}
    }
  ]
}

ソリューションの IAM アクセス許可

AWS Marketplace Catalog API は、標準の IAM アクセス許可を使用します。詳細については、「AWS Marketplace Catalog API のアクセスコントロール」を参照してください。

を使用してAWSMarketplaceSellerProductFullAccess、AWS マネジメントコンソールの Catalog API と Partner Central 3.0 を介してソリューションにアクセスするために必要なすべてのオペレーションを実行できます。

ソリューションのサンプル IAM ポリシー

次のサンプル IAM ポリシーではDescribeEntity、Solution@1.0エンティティに対する特定のアクション (、ListEntities、および StartChangeSet) を許可します。さらに絞り込んで、プリンシパルのアクセスを特定のエンティティ IDs の特定の変更タイプに制限したり、拡張して、プリンシパルが Catalog API でサポートされている別のエンティティタイプでも動作できるようにしたりできます。

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "CreateSolution",
            "UpdateInformation",
            "UpdateRelatedProducts",
            "ReleaseSolution",
            "UpdateBuyerEngagementOptions",
            "UpdateVisibility"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeEntity"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeChangeSet",
        "aws-marketplace:ListChangeSets",
        "aws-marketplace:CancelChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:TagResource",
        "aws-marketplace:UntagResource",
        "aws-marketplace:ListTagsForResource"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    }
  ]
}

特定のソリューションへのアクセスの制限

リソース ARN のソリューション ID を使用して、特定のソリューションへのアクセスを制限できます。

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
      ]
    }
  ]
}

特定の変更タイプへのアクセスの制限

条件キーを使用して、特定の変更タイプへのアクセスを制限できます。

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "UpdateInformation",
            "UpdateRelatedProducts"
          ]
        }
      }
    }
  ]
}