AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、[AWS Marketplace API リファレンス](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# バージョンを制限する
Catalog API を使用して、機械学習製品のバージョンを制限できます AWS Marketplace。制限されている場合、新しい購入者はそのバージョンにアクセスできません。既存のサブスクライバーは、制限されたバージョンへのアクセスを保持します。 AWS Marketplace ガイドラインでは、制限後 90 日間、既存の購入者に対する継続的なサポートが必要です。
**重要**
少なくとも 1 つの無制限のバージョンが使用可能である必要があります。製品の最終公開バージョンを制限することはできません。
**バージョンを制限するには:**
+ バージョンを制限するには、`RestrictDeliveryOptions`変更タイプを使用して `StartChangeSet`オペレーションを呼び出します。
## リクエストの構文
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet":
[
{
"ChangeType": "RestrictDeliveryOptions",
"Entity":
{
"Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
"Type": "MachineLearningProduct@1.0"
},
"DetailsDocument":
{
"DeliveryOptionIds":
[
"{{example1-2222-cccc-2222-cccccccccccc}}"
]
}
}
]
}
```
## 必須フィールド
**必須フィールド**
+ `Entity` (オブジェクト) — 必須
ML 製品に関する情報が含まれています。
+ `Identifier` (文字列) — 必須
製品 ID。詳細については、[「識別子](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)」を参照してください。
+ `Type` (文字列) — 必須
配信方法 (製品タイプ) を指定します。これは `MachineLearningProduct@1.0` である必要があります。
+ `DetailsDocument` (オブジェクト) — 必須
更新されたバージョン情報が含まれます。
+ `DeliveryOptionIds` (オブジェクトの配列) — 必須
制限するバージョンの DeliveryOption IDs のリスト。制限するバージョンで DescribeEntity アクションを呼び出して、各 DeliveryOption の一意の識別子を取得します。
## レスポンスの構文
リクエストが成功すると、以下が返されます。
```
{
"ChangeSetId": "example123456789012abcdef",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}
```
1. 検証: システムは、すべての情報が AWS Marketplace ガイドラインを満たしているかどうかを確認します。
+ 処理時間: 数分から数時間
+ 検証エラーについては、[「Change set status and errors](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors)」を参照してください。
1. ステータスモニタリング: リクエストのステータスは 2 つの方法で確認できます。
+ AWS Marketplace 管理ポータル経由
+ `DescribeChangeSet` 操作の使用
1. 完了: 承認されると、新しいバージョンが制限されます。
## エラー
**非同期エラー**
変更セットの処理中に次のエラーが発生する可能性があり、 `DescribeChangeSet`オペレーションを使用して取得できます。
| エラーコード | エラーメッセージ |
| --- | --- |
| INCOMPATIBLE\_PRODUCT\_STATUS | 既存のパブリック製品または制限付き製品を使用する |
| MISSING\_DELIVERY\_OPTION\_IDS | 既存の IDs リストから配信オプションを指定します。 |
| INVALID\_DELIVERY\_OPTION\_IDS | 製品にある配信オプション IDs を指定します。IDsが見つかりません: [x] |
| INVALID\_DELIVERY\_OPTION\_STATUS | 配信オプション IDs [invalid\_ids] が無効です。パブリック状態で配信オプションを指定します。 |
| ALL\_DELIVERY\_OPTIONS\_RESTRICTED | 少なくとも 1 つをパブリック状態に保つ必要があるため、制限する配信オプションの数を減らします。 |