View a markdown version of this page

バージョンを制限する - AWS Marketplace
リクエストの構文必須フィールドレスポンスの構文エラー

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

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

バージョンを制限する

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。詳細については、「識別子」を参照してください。

    • 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 ガイドラインを満たしているかどうかを確認します。

  2. ステータスモニタリング: リクエストのステータスは 2 つの方法で確認できます。

    • AWS Marketplace 管理ポータル経由

    • DescribeChangeSet 操作の使用

  3. 完了: 承認されると、新しいバージョンが制限されます。

エラー

非同期エラー

変更セットの処理中に次のエラーが発生する可能性があり、 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 つをパブリック状態に保つ必要があるため、制限する配信オプションの数を減らします。