AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、[AWS Marketplace API リファレンス](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ソリューションの使用
ソリューションは、特定の顧客の問題を解決するために連携する製品やサービスのコレクションです。ソリューションには、AWS Marketplace 製品と AWS Marketplace 以外の製品を含めることができます。ソリューションは、複数の製品が統合されて業界固有のユースケースに対処する方法を紹介するのに役立ちます。このソリューションでは、顧客の問題、ユースケース、統合の詳細、および関連製品について説明します。
## AWS Marketplace と AWS Partner Central のソリューション
Partner Central 2.0 から Partner Central 3.0 に移行すると、AWS アカウントを作成し、AWS Marketplace 販売者として登録するように求められます。詳細については、「販売[者プロファイルの登録と作成](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html)」を参照してください。この登録は、次の目的で必要です。
+ 既存の Partner Central ソリューションを AWS Marketplace カタログに移行する (すべてのソリューションは`AWSMarketplace`カタログに移行されます)
+ AWS Marketplace ソリューションが Selling APIs などの Partner Central API と連携できるようにします。 [ APIs](https://docs.aws.amazon.com/partner-central/latest/APIReference/working-with-your-opportunities.html)
### プロファイルのリンクと移行について
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 2.0 ソリューションを AWS Marketplace に移行する
+ AWS Marketplace を通じてのみソリューションを管理する
+ Partner Central APIsが移行されたソリューションにアクセスできる
**注記**
AWS Partner Central と AWS アカウントを既にリンクしている場合は ([「AWS Partner Central と AWS アカウントのリンク](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)」を参照）、新しい AWS アカウントを作成する必要はありません。ただし、既存の AWS アカウントが AWS Marketplace 販売者として登録されていることを確認します。ソリューションを AWS Marketplace 購入者ウェブサイトで公開するには、AWS Marketplace 販売者としてのパブリックプロファイルが必要です。AWS Marketplace 販売者登録の手順については、[「販売者プロファイルの登録と作成](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html)」を参照してください。
### 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 以外の製品が含まれています。ソリューションは、製品、オファー、オファーセットとは別のエンティティタイプです。各ソリューションには、購入者が個々の製品とは別に閲覧できる独自の検出および出品経験があります。
**主な特徴**
+ 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 [変更タイプ](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html)を使用したソリューションの作成と管理に関する詳細情報を提供します。
開始する前に、以下の準備が整っていることを確認します。
+ 有効な AWS Marketplace 販売者登録とパブリックプロファイル。詳細については、「販売[者プロファイルの登録と作成](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html)」を参照してください。
+ API へのアクセスと完了した販売者の前提条件。詳細については、[「AWS Marketplace Catalog API のアクセスコントロール](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html)」を参照してください。
+ AWS Marketplace Catalog API の使用の基本については、[「AWS Marketplace Catalog API の使用](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html)」を参照してください。
## ソリューションを一覧表示する
アカウント内のすべてのソリューションを一覧表示するには、 `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 オペレーションを呼び出します。
**注記**
DescribeEntity レスポンスは、 `EntityId`と `RevisionId.` For ソリューション`EntityIdentifier`を組み合わせた を返します。これはソリューション ID `EntityId` であり、オプティミスティックロック`RevisionId`に使用できます。詳細については、[「識別子](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)」を参照してください。
**リクエスト**
```
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` を使用して現在のタグを表示します。
詳細については、[「リソースのタグの管理](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#managing-tags-on-resources)」および[「エンティティへのタグの追加」および「作成時の変更セット](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#example-adding-tags-entity-creation)」を参照してください。
## ソリューションを作成する
`CreateSolution` 変更タイプを使用して、ソリューション ID と名前のみを使用して新しいソリューションドキュメントを作成できます。他の値はまだ入力されていません。
リクエストが正常に処理されると、AWS Marketplace は `Draft`ステータスのソリューションを作成します。この不完全なソリューションは、AWS Marketplace の購入者には表示されません。
次に、他の変更タイプを使用してソリューションを完了します。`UpdateInformation`、`UpdateRelatedProducts`、 `UpdateBuyerEngagementOptions` (`Limited`ソリューションを作成するためのオプション）、および `ReleaseSolution`です。`ReleaseSolution` 変更タイプは、`Limited`ソリューションに必要なすべての必須フィールドがソリューションに存在することを検証し、それを`Limited`可視性に移動します。
**注記**
ソリューションをパブリックステータスに移動するか、ソリューションのステータスを変更するには、必要な値を指定した後に`UpdateVisibility`変更タイプを使用します。
**リクエストの構文**
```
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` 変更タイプを追加するフィールドの情報を入力します。
+ `Entity` (オブジェクト) (必須) – 作成されるソリューションエンティティの名前付きタイプ。
+ `Type` (文字列) (必須) – は `Type`である必要があります`Solution@1.0`。
+ `DetailsDocument` (オブジェクト) (必須) – リクエストの詳細。
+ `Name` (文字列) (必須) – 販売者自身のリファレンスのみの AWS リソース名 (購入者には表示されません）。最大長: 100 文字。先頭または末尾の空白、改行、またはコントロール文字を含めることはできません。`UpdateInformation` 変更タイプを使用してソリューションタイルを更新することもできます。
+ `Title` (文字列) (オプション) – ソリューションのタイトル。最大長: 255 文字。先頭または末尾の空白、改行、またはコントロール文字を含めることはできません。`UpdateInformation` 変更タイプを使用してソリューションタイトルを設定または更新することもできます。
**レスポンスの構文**
リクエストの変更セットが作成されます。レスポンスは、 `ChangeSetId`と を提供します`ChangeSetArn`。
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
変更リクエストがキューに追加され、処理されます。ステータスは、AWS Marketplace 管理ポータルまたは `DescribeChangeSet` API オペレーションを使用して確認できます。
リクエストが正常に完了すると ( `Status`が の場合`SUCCEEDED`)、新しいソリューション ID が生成されます。
**非同期エラー**
`CreateSolution` アクションは、[一般的な非同期エラーに加えて、特定のエラー](#solution-error-codes)を返します。これらのエラーは、変更セットの処理が終了した`DescribeChangeSet`後、 から送信されます。変更リクエストのステータスを取得する方法については、[「変更セットの使用](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。
| エラーコード | エラーメッセージ |
| --- | --- |
| INVALID\_NAME | ソリューション名の長さが無効です。1～100 文字の名前を入力して、もう一度試してください。 |
| MISSING\_NAME | Name 値は必須です。Name 値を指定して、もう一度試してください。 |
| 無効\_タイトル | ソリューションタイトルの長さが無効です。1～255 文字のタイトルを入力して、もう一度試してください。 |
## ソリューション情報を更新する
AWS Marketplace にソリューションがすでにある場合は、 Catalog API を使用してソリューション情報を更新できます。
ソリューション情報を更新するには、`UpdateInformation`変更タイプと更新された詳細を使用して `StartChangeSet` API オペレーションを呼び出します。次の例を参照してください。
**注記**
`UpdateInformation` 変更タイプは、最上位属性の HTTP PATCH オペレーションのように動作します。フィールドの更新方法:
最上位属性が に存在する場合`DetailsDocument`、ワークフローは入力を検証し、既存の値を上書きします。
最上位フィールドが に存在しない場合`DetailsDocument`、既存の値は保持されます。
オプションフィールドの設定を解除するには、`null`そのフィールドに明示的な JSON を送信します。
AWS Marketplace は、ロゴとプロモーションメディアアセットを検証し、AWS Marketplace が所有する場所に取り込みます。DescribeEntity は、StartChangeSet からの元の入力ではなく、取り込まれたファイルのアクセス可能な URL を返します。送信された元の URLs を表示するには、DescribeChangeSet API を使用します。
**注記**
`Public` ソリューションの`PromotionalMedia`アセットファイルを変更する場合 (新しい URLsを指定）、 では AWS Marketplace Seller Operations チームによる手動レビュー`UpdateInformation`が必要です。これにより、実行時間が長くなります。このシナリオでは、独自の変更セットで`UpdateInformation`個別に を使用します。
**リクエストの構文**
```
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` 変更タイプを追加するフィールドの情報を入力します。
+ `Entity` (オブジェクト) (必須) – 更新するエンティティの名前付きタイプ。
+ `Identifier` (文字列) (必須) – ソリューション ID。
+ `Type` (文字列) (必須) – である必要があります`Solution@1.0`。
+ `DetailsDocument` (オブジェクト) (必須) – ソリューション用に更新する情報を含むリクエストの詳細。各フィールドはオプションですが、更新するには少なくとも 1 つの変更を含める必要があります。
+ `Name` (文字列) — Catalog API 読み取りオペレーションを介して販売者にのみ表示され、購入者には表示されないソリューションのリソース名。最大長: 100 文字。先頭または末尾の空白、改行、またはコントロール文字を含めることはできません。
+ `Title` (文字列) – 購入者に表示されるソリューションのタイトル。最大長: 255 文字。先頭または末尾の空白、改行、またはコントロール文字を含めることはできません。
+ `ShortDescription` (文字列) – 購入者に表示されるソリューションの主要な側面に関する価値提案の説明。これは通常 2～3 文です。最大長: 1000 文字。先頭または末尾の空白やコントロール文字を含めることはできません。
+ `LongDescription` (文字列) – 購入者に表示されるこのソリューションの長い説明。これは通常、1～3 段落です。最大長: 5000 文字。先頭または末尾の空白やコントロール文字を含めることはできません。
+ `LogoUrl` (文字列) – パブリックにアクセス可能な Amazon S3 バケットまたは署名付き S3 URL 内のイメージへの URL。直接 S3 URL である必要があります (CloudFront または API Gateway の背後ではない）。最大長: 2048 文字。ロゴの仕様については、[「会社と製品のロゴ要件](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos)」を参照してください。
+ `PromotionalMedia` (オブジェクトの配列) – プロモーションイメージとビデオのリスト。最大 15 項目 (5 つの動画と 10 のイメージ）。プロモーションメディアの仕様については、[「プロモーションメディアで AWS Marketplace 製品を強化する](https://docs.aws.amazon.com/marketplace/latest/userguide/promotional-media.html)」を参照してください。
+ `Type` (文字列) (必須) – `Image`または `Video`。
+ `Url` (文字列) (必須) – メディアファイルへの URL。直接 S3 URL または署名付き S3 URL である必要があります。最大長: 2048 文字。https URL である必要があります。
+ `Title` (文字列) (必須) – メディアのタイトル。最大長: 100 文字。先頭または末尾の空白、改行、またはコントロール文字を含めることはできません。
+ `Description` (文字列) (必須) – メディアの説明。最大長: 200 文字。先頭または末尾の空白やコントロール文字を含めることはできません。
+ `PreviewUrl` (文字列) (オプション) – 動画のみの場合、プレビューイメージへの URL。最大長: 2048 文字。https URL である必要があります。
+ `AdditionalResources` (オブジェクトの配列) – 追加のリソースへの参照のリスト。最大 8 項目。
+ `Text` (文字列) – リソースの名前またはタイトル。最大長: 500 文字。先頭または末尾の空白、改行、またはコントロール文字を含めることはできません。
+ `Url` (文字列) – リソースへの URL。最大長: 2048 文字。https URL である必要があります。
+ `UseCases` (オブジェクトの配列) – このソリューションが対処するユースケースのリスト。最大 3 項目。有効なユースケースカテゴリ (Group、SubGroup、Item の組み合わせ) については、「アクティブな許容値とその[概要ラベル](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/i18n/en.json)の[ユースケースカテゴリリスト](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json)」を参照してください。Group、SubGroup、Item の組み合わせは、ユースケースカテゴリリストの有効な項目である必要があります。
+ `Group` (文字列) – 業界またはテクノロジーカテゴリ。[ユースケースカテゴリリスト](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json)のグループ値のいずれかである必要があります。
+ `SubGroup` (文字列) – カテゴリ内のユースケースグループ。[ユースケースカテゴリリスト](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json)の SubGroup 値のいずれかである必要があります。
+ `Item` (文字列) – 特定のユースケース。[ユースケースカテゴリリスト](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json)のアイテム値のいずれかである必要があります。
+ `Description` (文字列) – このソリューションがユースケースにどのように対処するかの説明。最大長: 500 文字。先頭または末尾の空白やコントロール文字を含めることはできません。
署名付き URL 情報については、[「署名付き URLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html)」を参照してください。
**注記**
UpdateInformation 変更タイプを呼び出すときは、`DetailsDocument`オブジェクトで更新するフィールドのサブセットを常に指定できます。ただし、ソリューションを から `Draft` に移動する前に`Limited`、、`Title`、`ShortDescription`、`LongDescription`および のフィールドを適切に設定する必要があります`LogoUrl`。
ただし、ソリューションの既存のフィールドを更新する場合は、変更`UpdateInformation`タイプ の `DetailsDocument` オブジェクトに変更が必要な属性のみを含めることができます。
**レスポンスの構文**
リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セット`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 がレビュー、監査、承認する必要がある時間が含まれます。
**非同期エラー**
[一般的な非同期エラー](#solution-error-codes)に加えて、次のエラーは AWS Marketplace Catalog API の`UpdateInformation`アクションに固有です。これらのエラーは、変更セットの処理`DescribeChangeSet`後に を呼び出すと返されます。`DescribeChangeSet` を使用して変更リクエストのステータスを取得する方法の詳細については、[「変更セットの使用](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。
| エラーコード | エラーメッセージ |
| --- | --- |
| INVALID\_SHORT\_DESCRIPTION | ソリューションの ShortDescription の長さが無効です。1～1000 文字の ShortDescription を入力して、もう一度試してください。 |
| INVALID\_LONG\_DESCRIPTION | ソリューション LongDescription の長さが無効です。1～5000 文字の LongDescription を入力して、もう一度試してください。 |
| INVALID\_NAME | ソリューション名の長さが無効です。1～100 文字の名前を入力して、もう一度試してください。 |
| 無効\_タイトル | ソリューションタイトルの長さが無効です。1～255 文字のタイトルを入力して、もう一度試してください。 |
| INVALID\_ADDITIONAL\_RESOURCES | ソリューション AdditionalResources[%d]。テキストの長さが無効です。1～500 文字のテキストを入力して、もう一度試してください。 |
| INVALID\_ADDITIONAL\_RESOURCES | 提供された追加リソースの次の URLs にアクセスできません: [%s]。有効でアクセス可能な URLs |
| INVALID\_ADDITIONAL\_RESOURCES | URL 値は必須です。URL 値を指定して、もう一度試してください。 |
| INVALID\_ADDITIONAL\_RESOURCES | テキストを省略することはできません。テキストを指定する |
| INVALID\_USE\_CASE | ソリューション UseCases[%d]。説明の長さが無効です。1～500 文字の説明を入力して、もう一度試してください。 |
| INVALID\_USE\_CASE | UseCases[%d]。グループ: 指定されたグループ (%s) が無効です。有効なグループを指定します。 |
| INVALID\_USE\_CASE | UseCases[%d]。SubGroup: 指定されたグループ (%s) が無効です。有効な SubGroup を指定します。 |
| INVALID\_USE\_CASE | UseCases[%d]。項目: 指定された項目 (%s) が無効です。有効な項目を指定してください。 |
| INVALID\_USE\_CASE | UseCases[%d]。項目: 提供されたユースケースは非アクティブです。アクティブなユースケースを提供する |
| INVALID\_USE\_CASE | UseCases[%d]。グループ: グループが見つかりません。グループを指定します。 |
| INVALID\_USE\_CASE | UseCases[%d]。SubGroup: SubGroup が見つかりません。SubGroup を指定します。 |
| INVALID\_USE\_CASE | UseCases[%d]。項目: SubGroup が見つかりません。項目を指定します。 |
| INVALID\_MEDIA | ソリューション PromotionalMedia[%d]。タイトルの長さが無効です。1～100 文字のタイトルを入力して、もう一度試してください。 |
| INVALID\_MEDIA | ソリューション PromotionalMedia[%d]。説明の長さが無効です。1～200 文字の説明を入力して、もう一度試してください。 |
| INVALID\_MEDIA | 無効な URL: %s S3 に保存されているメディアの新しい URL を指定します。 |
| INVALID\_MEDIA | メディアロケーションにアクセスできません: %s 次のいずれかの場所に保存されているメディアの新しいアクセス可能な URL を指定します: [S3]。 |
| INVALID\_MEDIA | イメージサイズが %s を超えています。%s 未満のイメージを指定します。 |
| INVALID\_MEDIA | 動画サイズが %s を超えています。%s 未満の動画を提供します。 |
| INVALID\_MEDIA | ロゴサイズが %s を超えています。%s 未満のロゴを指定します。 |
| INVALID\_MEDIA | マルウェアが %s で検出されました。マルウェアなしでメディアを提供します。 |
| INVALID\_MEDIA | 不適切なコンテンツ: %s が検出されました。不適切なコンテンツをメディアに提供する |
| INVALID\_MEDIA | %s の明示的なコンテンツ: '{ExplicitContent}' が検出されました。明示的なコンテンツなしでメディアを提供します。 |
| INVALID\_MEDIA | PromotionalMedia[%s]。URL: %s はサポートされている形式 (%s) ではありません。サポートされている形式 [JPEG、PNG] で正しい形式のイメージを使用します。 |
| INVALID\_MEDIA | PromotionalMedia[%s]。URL: %s はサポートされている形式 (%s) ではありません。サポートされている形式の動画を使用します: [MP4, MOV]。 |
| INVALID\_MEDIA | %s の LogoUrl のアスペクト比が無効です。アスペクト比が 1:1 (二乗) または 2:1 (全体) のイメージを指定します。 |
| INVALID\_MEDIA | ロゴ: %s のディメンションが無効です。120x120～1080x1080 ピクセルのイメージを指定します。 |
| INVALID\_MEDIA | PromotionalMedia[%d]。タイプはサポートされていません。サポートされているタイプで PromotionalMedia を提供する: %s |
| DUPLICATE\_MEDIA | 重複メディアが検出されました: [%s] 重複のないメディア項目を指定します。 |
| INVALID\_MEDIA | PromotionalMedia[%d]。URL: マルウェアが %s で検出されました。マルウェアなしでメディアを提供します。 |
| TOO\_MANY\_ITEMS | %d %s 以下を指定してください。 |
## 関連製品を更新する
Catalog API を使用して、AWS Marketplace 製品や AWS Marketplace 以外の製品など、ソリューションに含まれる製品やサービスを更新できます。
関連製品を更新するには、次の例に示すように、`UpdateRelatedProducts`変更タイプを使用して `StartChangeSet` API オペレーションを呼び出します。
**注記**
`UpdateRelatedProducts` 変更タイプは、最上位属性の HTTP PATCH オペレーションのように動作します。現在のすべての AWS Marketplace 製品タイプを `AwsMarketplaceProducts`のように指定できます`UpdateRelatedProducts`。
**リクエストの構文**
```
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` 変更タイプを追加するフィールドの情報を入力します。
+ `Entity` (オブジェクト) (必須) – 更新されるエンティティの名前付きタイプ。
+ `Identifier` (文字列) (必須) – ソリューション ID。
+ `Type` (文字列) (必須) – である必要があります`Solution@1.0`。
+ `DetailsDocument` (オブジェクト) (必須) – リクエストの詳細。各フィールドはオプションですが、更新するには少なくとも 1 つの変更を含める必要があります。
+ `IntegrationDescription` (文字列) – このソリューションで製品が連携する方法の説明。最大長: 5000 文字。先頭または末尾の空白やコントロール文字を含めることはできません。
+ `AwsMarketplaceProducts` (オブジェクトの配列) – このソリューションに含まれる AWS Marketplace 製品。最大 5 項目
+ `ProductId` (文字列) – AWS Marketplace 製品 ID (UUID または で始まる文字列`prod-`)。最大長: 50 文字。
+ `NonAwsMarketplaceProducts` (オブジェクトの配列) – AWS Marketplace では利用できない製品。最大 5 項目。
+ `Type` (文字列) (必須) – 製品のタイプ。指定できる値: `Software`、`Consulting`、`Hardware`、、`Communication`、`Professional Service``Managed Service``Value-Added Resale`、、 `Training`
+ `Title` (文字列) (必須) – 製品のタイトル。最大長: 255 文字。先頭または末尾の空白、改行、またはコントロール文字を含めることはできません。
+ `Description` (文字列) (オプション) – 製品の説明。最大長: 220 文字。先頭または末尾の空白やコントロール文字を含めることはできません。
+ `Url` (文字列) (オプション) – 製品に関する詳細情報の URL。最大長: 2048 文字。https URL である必要があります。
**レスポンスの構文**
リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セット`ChangeSetArn`の `ChangeSetId`と を提供し、次のようになります。
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
変更リクエストがキューに追加され、処理されます。
リクエストのステータスを確認するには、AWS Marketplace 管理ポータルを使用するか、 `DescribeChangeSet` API を呼び出します。
**非同期エラー**
[一般的な非同期エラー](#solution-error-codes)に加えて、次のエラーは AWS Marketplace Catalog API の`UpdateRelatedProducts`アクションに固有です。これらのエラーは、変更セットの処理`DescribeChangeSet`後に を呼び出すと返されます。`DescribeChangeSet` を使用して変更リクエストのステータスを取得する方法の詳細については、[「変更セットの使用](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。
| エラーコード | エラーメッセージ |
| --- | --- |
| INCOMPATIBLE\_OPERATION\_UPDATE\_RELATED\_PRODUCTS\_SOLUTION | 関連製品を更新するオペレーションは、パブリックソリューションではサポートされていません。この変更を行うには、まずソリューションの可視性を limited に変更し、もう一度試してください。 |
| INVALID\_AWS\_MARKETPLACE\_PRODUCTS | AWS Marketplace 製品 '%s' は、お客様のアカウントではご利用いただけません。許可リストにアクセスできるパブリック製品または制限付き製品を選択するか、販売者に連絡してアクセスをリクエストしてください。 |
| INVALID\_AWS\_MARKETPLACE\_PRODUCTS | 指定された製品タイプ '%s' はサポートされていません。[AmiProduct、SaaSProduct、ContainerProduct、MachineLearningProduct、ProfessionalServicesProduct、DataProduct] のいずれかの有効な製品タイプを指定して、もう一度試してください。 |
| INVALID\_AWS\_MARKETPLACE\_PRODUCTS | 製品 '%s' が見つかりません。同じカタログに有効な製品 ID を入力します。 |
| INVALID\_NON\_AWS\_MARKETPLACE\_PRODUCTS | 指定された AWS Marketplace 以外の製品 URLs にアクセスできません: [%s]。URLs が有効でパブリックにアクセスできることを確認し、もう一度試してください。 |
| INVALID\_INTEGRATION\_DESCRIPTION | ソリューション IntegrationDescription を 1～5000 文字で指定します。 |
| INVALID\_NON\_AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d] ソリューション。タイトルの長さが無効です。1～255 文字の説明を入力して、もう一度試してください。 |
| INVALID\_NON\_AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d] ソリューション。説明の長さが無効です。1～220 文字の説明を入力して、もう一度試してください。 |
| INVALID\_NON\_AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d] ソリューション。タイプの長さが無効です。1～50 文字のタイプを入力して、もう一度試してください。 |
| INVALID\_NON\_AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d]。Type は有効な AWS Marketplace 以外の製品タイプではありません。AWS Marketplace 以外の次のいずれかの製品タイプを指定してください: [%s] |
| INVALID\_NON\_AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d]。タイトル値は必須です。タイトル値を指定して、もう一度試してください。 |
| INVALID\_NON\_AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d]。タイプ値は必須です。Type 値を指定して、もう一度試してください。 |
| TOO\_MANY\_PRODUCTS | リンクできる AWS Marketplace 製品の最大数は %d です。新しい製品を追加する前に、既存のリンク済み製品を削除します。 |
| TOO\_MANY\_PRODUCTS | 追加できる AWS Marketplace 製品の最大数は %d です。新しい製品を追加する前に、既存のなしの AWS Marketplace 製品を削除します。 |
| INVALID\_AWS\_MARKETPLACE\_PRODUCTS | 重複する AWS Marketplace 製品 IDs は使用できません。各製品 ID はソリューション内で一意である必要があります。 |
| INVALID\_REMOVE\_OPERATION | オペレーションが無効です。すべての製品を削除することはできません。 |
## ソリューションをリリースする
Catalog API を使用して、`Draft`ソリューションを AWS Marketplace の`Limited`可視性に公開できます。
`ReleaseSolution` 変更タイプは、`Limited`ソリューションのすべての必須フィールドが存在することを検証します。次に、ソリューションを から`Draft``Limited`可視性に移動します。ソリューションが`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` 変更タイプを追加するフィールドの情報を入力します。
+ `Entity` (オブジェクト) (必須) – 解放されるエンティティの名前付きタイプ。
+ `Identifier` (文字列) (必須) – ソリューション ID。
+ `Type` (文字列) (必須) – である必要があります`Solution@1.0`。
+ `DetailsDocument` (オブジェクト) (必須) – 空のオブジェクトである必要があります。変更タイプ`ReleaseSolution`は詳細を受け入れません。
**レスポンスの構文**
リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セット`ChangeSetArn`の `ChangeSetId`と を提供し、次のようになります。
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
変更リクエストがキューに追加され、処理されます。リクエストのステータスは、AWS Marketplace 管理ポータルを通じて、または API オペレーションを使用して Catalog `DescribeChangeSet` API から直接確認できます。
**非同期エラー**
[一般的な非同期エラー](#solution-error-codes)に加えて、次のエラーは AWS Marketplace Catalog API の`ReleaseSolution`アクションに固有です。これらのエラーは、変更セットの処理`DescribeChangeSet`後に を呼び出すと返されます。`DescribeChangeSet` を使用して変更リクエストのステータスを取得する方法の詳細については、[「変更セットの使用](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。
| エラーコード | エラーメッセージ |
| --- | --- |
| MISSING\_REQUIRED\_FIELDS | リクエストに必要なパラメータ [%s] がありません。すべての必須パラメータの値を指定して、もう一度試してください。 |
| 互換性のないオペレーションリリースソリューション | 変更タイプは、ドラフトステータスのソリューションでのみ呼び出すことができます。ソリューションの可視性をドラフトに更新して、もう一度試してください。 |
## 購入者エンゲージメントオプションを更新する
Catalog API を使用して、購入者がソリューションにどのように関与するかを設定できます。
**注記**
この変更タイプを使用するには、[APN カスタマーエンゲージメント (ACE)](https://aws.amazon.com/partners/programs/ace/) プログラムへのアクティブな登録が必要です。また、AWS アカウントを ACE に登録した AWS Partner Central アカウントにリンクする必要があります。手順については、[「AWS Partner Central と AWS アカウントのリンク](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)」を参照してください。
購入者エンゲージメントオプションを更新するには、次の例に示すように、`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` 変更タイプを追加するフィールドの情報を入力します。
+ `Entity` (オブジェクト) (必須) – 更新されるエンティティの名前付きタイプ。
+ `Identifier` (文字列) (必須) – ソリューション ID。
+ `Type` (文字列) (必須) – である必要があります`Solution@1.0`。
+ `DetailsDocument` (オブジェクトの配列) (必須) – 有効にする購入者エンゲージメントオプション。
+ `EngagementOption` (文字列) (必須) – エンゲージメントオプションのタイプ。有効な値: `RequestPrivateOffer`、`RequestProductDemo`。
**レスポンスの構文**
リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セット`ChangeSetArn`の `ChangeSetId`と を提供し、次のようになります。
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
変更リクエストがキューに追加され、処理されます。
リクエストのステータスを確認するには、AWS Marketplace 管理ポータルを使用するか、 `DescribeChangeSet` API を呼び出します。
**非同期エラー**
[一般的な非同期エラー](#solution-error-codes)に加えて、次のエラーは AWS Marketplace Catalog API の`UpdateBuyerEngagementOptions`アクションに固有です。これらのエラーは、変更セットの処理`DescribeChangeSet`後に を呼び出すと返されます。`DescribeChangeSet` を使用して変更リクエストのステータスを取得する方法の詳細については、[「変更セットの使用](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。
| エラーコード | エラーメッセージ |
| --- | --- |
| INELIGIBLE\_SELLER | ACE 適格性の検証が完了していません。続行するには: 1) AWS Marketplace アカウントを APN アカウントにリンクし、2) ACE 資格要件を完了します。 |
## ソリューションの可視性を更新する
Catalog API を使用して、AWS Marketplace でのソリューションの可視性を更新できます。
ターゲットの可視性は、`Limited`、`Public`、または に設定できます`Restricted`。
+ **`Limited`** – ソリューションが完了し、`ReleaseSolution`変更タイプが正常に完了しました。この可視性では、ソリューションの購入者ウェブサイトの詳細をプレビューできます。AWS Marketplace 購入者ウェブサイトでは、ソリューションは、所有アカウント、ソリューションに含まれる各 AWS Marketplace 製品の所有者、および AWS Marketplace Seller Operations チームにのみ表示されます。
+ **`Public`** – ソリューションは AWS Marketplace に表示されます。購入者はソリューションを表示して操作できます。
+ **`Restricted`** – このソリューションは、AWS Marketplace 購入者ウェブサイトで一般公開されなくなりました。
**注記**
ソリューションを`Public`可視性に移行するには、次の要件を満たす必要があります。
AWS Marketplace にはパブリックプロファイルが必要です。
ソリューションには `Public`以外の製品があってはなりません。
ソリューションには、少なくとも 2 つの `Public` AWS Marketplace 製品が必要です。
ソリューションには、同じ AWS アカウントから少なくとも 1 つの AWS Marketplace 製品が必要です。
ソリューションでは、`RequestPrivateOffer`購入者エンゲージメントオプションが有効になっている必要があります。
AWS Marketplace Seller Operations チームは、ソリューションを`Public`可視性に移行するためのすべてのリクエストを確認します。サポートについては、[「AWS Marketplace のサポートを受ける](https://docs.aws.amazon.com/marketplace/latest/buyerguide/getting-support.html)」を参照してください。
`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` 変更タイプを追加するフィールドの情報を入力します。
+ `Entity` (オブジェクト) (必須) – 更新されるエンティティの名前付きタイプ。
+ `Identifier` (文字列) (必須) – ソリューション ID。
+ `Type` (文字列) (必須) – である必要があります`Solution@1.0`。
+ `DetailsDocument` (オブジェクト) (必須) – 変更セットの実行に必要な詳細。
+ `TargetVisibility` (文字列) (必須) – ソリューションの新しい可視性。想定される値: `Public`、`Limited`、`Restricted`。
**レスポンスの構文**
リクエストの変更セットが作成されます。このリクエストに対するレスポンスは、変更セット`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` を使用して変更リクエストのステータスを取得する方法の詳細については、[「変更セットの使用](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。
| エラーコード | エラーメッセージ |
| --- | --- |
| INVALID\_VISIBILITY\_TRANSITION | ソリューションをドラフト状態に戻すことはできません。リリースされると、ソリューションは制限付き、パブリック、制限付きの状態の間でのみ移行できます。 |
| TOO\_FEW\_USE\_CASES | ソリューションを公開するには、少なくとも 1 つのユースケースが必要です。ユースケースを追加して、もう一度試してください。 |
| TOO\_FEW\_PUBLIC\_PRODUCTS | ソリューションを公開するには、少なくとも 2 つのパブリック AWS Marketplace 製品が必要です。必要な製品を追加して、もう一度試してください。 |
| INCOMPATIBLE\_PRODUCTS | このソリューションには、1 つ以上の非公開 AWS Marketplace 製品が含まれています。ソリューションを公開するには、非公開製品をすべて削除して、もう一度試してください。 |
| TOO\_FEW\_SELF\_OWNED\_PRODUCTS | このソリューションには、ソリューション所有者が所有する AWS Marketplace 製品が少なくとも 1 つ必要です。アカウントから AWS Marketplace 製品を追加して、もう一度試してください。 |
| INCOMPATIBLE\_BUYER\_ENGAGEMENT\_OPTIONS | このソリューションを公開するには、RequestPrivateOffer 購入者エンゲージメントオプションを有効にする必要があります。RequestPrivateOffer を有効にして、もう一度試してください。 |
| INCOMPATIBLE\_OPERATION\_UPDATE\_VISIBILITY | UpdateVisibility は、ドラフト状態のソリューションではサポートされていません。ReleaseSolution を使用してソリューションをドラフトから制限付きに公開してから、UpdateVisibility を使用してパブリックまたは制限付きに変更します。 |
| LIMIT\_EXCEEDED\_TOO\_MANY\_PUBLIC\_SOLUTIONS | このアカウントは 5 つのパブリックソリューションの制限に達しました。既存のパブリックソリューションを制限付きまたは制限付き可視性に更新して、もう一度試してください。 |
| MISSING\_SELLER\_PROFILE\_INFORMATION | ソリューションを公開するには、公開販売者プロファイルが必要です。販売者アカウントにパブリックプロファイルを作成し、もう一度試してください。 |
## 一般的な非同期エラーコード
URL の有効性とサポートされていない文字のチェックなど、すべてのソリューション変更タイプに適用される非同期検証があり、それらのエラーコードとエラーメッセージがここに一覧表示されます。
指定する各 URL フィールドは HTTPS プロトコルを使用し、RFC2396 または RFC 2732 標準に準拠している必要があります。
| エラーコード | エラーメッセージ |
| --- | --- |
| INVALID\_INPUT | 無効な '%s' フィールド。サポートされていない文字 %s を削除します。 |
| INVALID\_INPUT | %s フィールドに不適切なコンテンツ '%s' が見つかりました。不適切なコンテンツなしで %s を指定します。 |
| UNSUPPORTED\_CATALOG | リクエストされたカタログ %s は、この変更タイプではサポートされていません。 |
| INVALID\_REMOVE\_OPERATION | オペレーションが無効です。%s を削除することはできません |
| AUDIT\_ERROR | (AWS Marketplace Seller Operations チームの監査結果によって異なります) |
## ソリューションライフサイクル
ソリューションは、次の可視性値を通じて進行します。
+ `Draft` - 作成後の初期可視性。他の変更タイプを使用して情報を段階的に追加できます。
+ `Limited` - ソリューションは完全であり、プレビューのためにユーザーと製品所有者に表示されます。これを実現するには、 を使用します`ReleaseSolution`。
+ `Public` - ソリューションは、AWS Marketplace ウェブサイトを閲覧するすべての購入者に表示されます。これには追加の検証が必要です。
+ `Restricted` - ソリューションは新しい購入者には表示されなくなりました。
**重要**
ソリューションが から`Limited`可視性`Draft`に移行すると、それを に戻すことはできません`Draft`。 は、`Limited`可視性に移行する前に、`Limited`ソリューションのすべての必須フィールドが存在することを`ReleaseSolution`検証します。
### 完全なソリューションの最小要件
完全なソリューションを作成し、ドラフトステータスを超えて公開するには、次の変更タイプと属性が必要です。
+ **`CreateSolution`**: `Name`
+ **`UpdateInformation`**: `Title`, `ShortDescription`, `LongDescription`, `LogoUrl`
+ **`UpdateRelatedProducts`**: `IntegrationDescription`、 `AwsMarketplaceProducts` と 全体で少なくとも 1 つの項目 `NonAwsMarketplaceProducts`
+ **`ReleaseSolution`**
次の例は、単一の変更セットで`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 のアクセスコントロール](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html)」を参照してください。
を使用して`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"
]
}
}
}
]
}
```