バージョン情報を更新する

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

重要

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

`StartChangeSet` を使用してバージョンを追加する:

バージョン情報を更新するには、 UpdateDeliveryOptions StartChangeSetオペレーションを変更タイプで呼び出します。

リクエストの構文


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"
                  }
            }
          }
        ]
      }
    }
  ]
}

必須フィールド

Entity (オブジェクト) — 必須

ML 製品に関する情報が含まれています。
- Identifier (文字列) — 必須
  
  製品 ID。詳細については、「識別子」を参照してください。
- 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 アルゴリズムにのみ必要です。

レスポンスの構文

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


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

変更セット処理

変更リクエストは処理キューに入り、いくつかのステップを実行します。

検証: システムは、すべての情報が AWS Marketplace ガイドラインを満たしているかどうかを確認します。
- 処理時間: 数分から数時間
- 検証エラーについては、「Change set status and errors」を参照してください。
ステータスモニタリング: リクエストのステータスは 2 つの方法で確認できます。
- AWS Marketplace 管理ポータル経由
- DescribeChangeSet 操作の使用
完了: 承認されると、新しいバージョンが更新されます。

エラー

非同期エラー

UpdateDeliveryOptions アクションの特定のエラーは、変更セットの処理開始後に DescribeChangeSetオペレーションを使用して取得できます。エラーの詳細とトラブルシューティングについては、「Change set status and errors」を参照してください。

エラーコード	エラーメッセージ
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 は変更できません。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

新しいバージョンを追加する

料金条件を更新する