

AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、[AWS Marketplace API リファレンス](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)を参照してください。

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

# バージョン情報を更新する
<a name="ml-update-version"></a>

 Catalog API を使用して、 の既存のバージョンの機械学習製品の詳細を更新できます AWS Marketplace。

**重要**  
 バージョンの ARN を更新することはできません。ARN を変更する必要がある場合は、代わりに新しいバージョンを作成する必要があります。

**`StartChangeSet` を使用してバージョンを追加する:**
+  バージョン情報を更新するには、 `UpdateDeliveryOptions` `StartChangeSet`オペレーションを変更タイプで呼び出します。

## リクエストの構文
<a name="ml-update-version-request-syntax"></a>

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateDeliveryOptions",
      "Entity":
      {
        "Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "ReleaseNotes": "{{Adding support for new parameters}}"
        },
        "DeliveryOptions":
        [
          {
            "Id": "{{example1-2222-cccc-2222-cccccccccccc}}",
            "Details":
            {
              "SagemakerModelPackageDeliveryOptionDetails":
              {
                "SampleNotebookUrl": "{{https://www.amazon.com}}",
                "RepositoryUrl":"{{https://www,amazon.com}}",
                "InputProperties": 
                { 
                    "SampleInput": {
                        "RealtimeInferenceUrl": "{{https://www.sampleData.com}}",
                        "BatchTranformUrl": "{{https://www.sampleData.com}}",
                     },
                 },
                 "RecommendedInstanceTypes": {
                        "BatchTransform": "{{ml.m4.large}}",
                        "RealtimeInference": "{{ml.m4.large}}"
                  }
            }
          }
        ]
      }
    }
  ]
}
```

## 必須フィールド
<a name="ml-update-version-required-fields"></a>
+  `Entity` (オブジェクト) — 必須 

  ML 製品に関する情報が含まれています。
  +  `Identifier` (文字列) — 必須 

    製品 ID。詳細については、[「識別子](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)」を参照してください。
  +  `Type` (文字列) — 必須 

    配信方法 (製品タイプ) を指定します。これは `MachineLearningProduct@1.0` である必要があります。
+  `DetailsDocument` (オブジェクト) — 必須 

   更新されたバージョン情報が含まれます。
  + `Version` (オブジェクト) — 必須

    バージョン固有の情報を定義します。
    + `VersionTitle` (文字列) — 必須

      「バージョン 1.1」や「1.1」など、購入者に表示されるバージョン識別子。購入者はこのタイトルを使用してデプロイするバージョンを選択します。
    + `ReleaseNotes` (文字列) — 必須 

      このバージョンに関する詳細な注意事項。30,000 文字に制限されています。
  + `DeliveryOptions` (配列) — 必須 

    製品バージョンの配信方法を指定します。バージョンごとに 1 つの配信オプションに制限されています。
    + `Id` (文字列) — 必須 

      DeliveryOption の一意の識別子。製品の DescribeEntity アクションを使用してこれを取得します。
    + `Details` (オブジェクト) — 必須 

      配信オプションの仕様が含まれます。
      + `SageMakerModelPackageSubscriptionDetails` または `SageMakerAlgorithmSubscriptionDetails` (オブジェクト) — 必須 

        配信オプションの詳細。
        + `SampleNotebookUrl` (文字列) — 必須 

          購入者が使用するコードを提供する Jupyter ノートブックリンクのサンプル。
        + `RepositoryUrl` (文字列) — 必須 

          ノートブックとサンプルデータをクローンするための Git リポジトリ URL。
        + `UsageInstructions` (文字列) — 必須 

          アルゴリズムの場合: トレーニング情報。モデルの場合: 追加の使用状況情報。
        + `InputProperties` (オブジェクト) — 必須 

          モデル/アルゴリズムの入力要件の詳細。
          + `Description` (文字列) — 必須 

            必要な入力の説明。
          + `Limitations` (文字列) 

            入力制限。
          + `SampleInput` (オブジェクト) — 必須 

            さまざまなオペレーションのサンプル入力データ。
            + `RealtimeInferenceUrl` (文字列) 

              リアルタイム推論用のサンプル入力 URL。
            + `RealtimeInferenceText` (文字列) 

              リアルタイム推論用のサンプル入力テキスト。
            + `BatchTransformUrl` (文字列) 

              バッチ変換ジョブのサンプル入力 URL。
            + `BatchTransformText` (文字列) 

              バッチ変換ジョブのサンプル入力テキスト。
          + `Parameters` (配列<Object>) 

            各入力パラメータの詳細。
            + `Name` (文字列) — 必須 

              入力パラメータの名前。
            + `Description` (文字列) — 必須 

              入力パラメータの説明。
            + `Constraints` (文字列) 

              パラメータ制約 (MinValue、MaxValue、AllowedValues、MinLength、MaxLength、パターンなど）。
            + `Required` (ブーリアン) 

              パラメータが必要かどうかを示します。デフォルトは偽です。
          + `SageMakerCustomAttributes` (配列<Object>) 

            サポートされている CustomAttributes の詳細。
            + `Name` (文字列) — 必須 

              カスタム属性の名前。
            + `Description` (文字列) — 必須 

              カスタム属性の説明。
            + `Constraints` (文字列) 

              属性制約 (MinValue、MaxValue、AllowedValues、MinLength、MaxLength、パターンなど）。
            + `Required` (ブーリアン) 

              属性が必要かどうかを示します。デフォルトは偽です。
        + `OutputProperties` (オブジェクト) — 必須 

          モデル/アルゴリズムの出力の詳細。
          + `Description` (文字列) — 必須 

            モデル/アルゴリズム出力の説明。
          + `SampleOutput` (配列<Object>) — 必須 

            さまざまなオペレーションのサンプル出力データ。
            + `RealtimeInferenceUrl` (文字列) 

              リアルタイム推論のサンプル出力 URL。
            + `RealtimeInferenceText` (文字列) 

              リアルタイム推論のサンプル出力テキスト。
            + `BatchTransformUrl` (文字列) 

              バッチ変換ジョブのサンプル出力 URL。
            + `BatchTransformText` (文字列) 

              バッチ変換ジョブのサンプル出力テキスト。
          + `Parameters` (配列) 

            各出力パラメータの詳細。
            + `Name` (文字列) — 必須 

              出力パラメータの名前。
            + `Description` (文字列) — 必須 

              出力パラメータの説明。
            + `AlwaysReturned` (ブーリアン) 

              パラメータが常に返されるかどうかを示します。デフォルトは偽です。
        + `RecommendedInstanceTypes` (オブジェクト) — 必須 

          最適なパフォーマンスのために推奨されるインスタンスタイプ。
          + `BatchTransform` (文字列) — 必須 

            バッチ変換オペレーションに推奨されるインスタンスタイプ。
          + `RealtimeInference` (文字列) — 必須 

            リアルタイム推論オペレーションに推奨されるインスタンスタイプ。
          + `Training` (文字列) — 必須 

            アルゴリズムトレーニングオペレーションに推奨されるインスタンスタイプ。SageMaker アルゴリズムにのみ必要です。

## レスポンスの構文
<a name="ml-update-version-response-syntax"></a>

リクエストが成功すると、以下が返されます。

```
{
    "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.  完了: 承認されると、新しいバージョンが更新されます。

## エラー
<a name="ml-update-version-errors"></a>

**非同期エラー**  
`UpdateDeliveryOptions` アクションの特定のエラーは、変更セットの処理開始後に `DescribeChangeSet`オペレーションを使用して取得できます。エラーの詳細とトラブルシューティングについては、[「Change set status and errors](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。


| エラーコード | エラーメッセージ | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | 既存の制限付き製品またはパブリック製品を使用します。 | 
| INVALID\_DELIVERY\_OPTION\_ID | 製品にある配信オプション IDs を指定します。IDsが見つかりません: [x] | 
| INCOMPATIBLE\_DELIVERY\_OPTION\_STATUS | 配信オプションは制限付きステータスであるため、更新できません。代わりに新しいバージョンを追加してみてください。 | 
| INCOMPATIBLE\_DELIVERY\_OPTIONS | 以前に配信オプションとして [X ] を使用していた製品であるため、今後の配信オプションはすべてタイプ [X] である必要があります | 
| INVALID\_RECOMMENDED\_INSTANCE\_TYPE | [X] に既存の使用可能なインスタンスタイプを指定します (X はバッチ変換、リアルタイム推論、または ALgorithm トレーニングのいずれかです）。 | 
| DUPLICATE\_VERSION\_TITLE | バージョンタイトルは、この製品の他のバージョンタイトルとは異なる必要があります。 | 
| FIELD\_NOT\_ALLOWED\_TO\_CHANGE | フィールド X は変更できません。 | 