AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、[AWS Marketplace API リファレンス](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 新しいバージョンを追加する
Catalog API または AWS Marketplace Management Portal を使用して、機械学習製品に新しいバージョンを追加できます。ポータルの使用の詳細については、*AWS Marketplace 販売者ガイド*の[「新しいバージョンの追加](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-products.html)」を参照してください。
**注記**
ML 製品の場合、バージョンは 1 つの配信オプションで構成されます。これは、利用可能にする製品を表します。Catalog API では、ML 製品の配信オプションを使用して、製品のバージョンを効果的に変更します。
新しいインスタンスタイプを追加するときは、`UpdatePricingTerms`変更セットに変更タイプを含めて、新しいインスタンスタイプの料金を指定します。新製品の場合、 はサポートされているすべてのインスタンスタイプをカバーする`UpdatePricingTerms`必要があります。 `UpdatePricingDimensions`は、サポートされているすべてのインスタンスタイプに対してディメンションが自動的に生成されるため、ML 製品では必須またはサポートされません。詳細については、[料金設定ディメンションを更新する](work-with-seller-products.md#update-dimensions) を参照してください。
**`StartChangeSet` を使用してバージョンを追加する**
新しいバージョンを追加するには、`AddDeliveryOptions`変更タイプを使用して `StartChangeSet`オペレーションを呼び出します。
1. バージョンを作成せずに API コールを検証するには、 `Intent` を に設定します`VALIDATE`。
1. 実際のバージョンを作成するには、 `Intent`を に設定します`APPLY`。
## リクエストの構文
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
"Type": "MachineLearningProduct@1.0"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "version 1.1",
"ReleaseNotes": "Patch update for small bugfix in version 1.0"
},
"DeliveryOptions": [{
"Details": {
"SageMakerAlgorithmDeliveryOptionDetails": {
"SageMakerAlgorithmArn": "arn:aws:sagemaker:us-east-2:605142612156:algorithm/scikit-decision-trees-1552343220",
"AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceSageMakerIngestion",
"UsageInstructions":"This is how you use your algorithm",
"SampleNotebookUrl": "https://www.amazon.com",
"RepositoryUrl": "https://www,amazon.com",
"InputProperties": {
"Description": "Input should have all columns in the train/test file except for 'is_fraud' column.",
"Limitations": "Can predict on 1 input in the CSV only at a time",
"SampleInput": {
"RealtimeInferenceText": "{\"prompt\":\"Write summary\",
\"maxTokens\": 1 }",
"BatchTransformUrl": "https://www.sampleData.com",
},
"Parameters": [{
"Name": "prompt",
"Description": "Represents the instruct-style prompt for the model. DataType is String",
"Constraints": "Minimum length should be 1",
"Required": true
},
{
"Name": "maxTokens",
"Description": "Denotes the number of tokens to predict per generation. See BPE Tokens for more details.",
"Constraints": "Minvalue: 1, MaxValue: 30"
}
],
"SageMakerCustomAttributes": [{
"Name": "threshold",
"Description": "Threshold of the confidence score of the detected object",
"Constraints": "Should be an Integer"
}]
},
"OutputProperties": {
"Description": "The output is a JSON object that has the generated text along with likelihoods of tokens, if requested. See example json.",
"SampleOutput": {
"RealtimeInferenceUrl": "https://www.sampledata.com",
"BatchTransformUrl": "https://www.sampleData.com",
},
"Parameters": [{
"Name": "id",
"Description": "An identifier for response"
"AlwaysReturned": true
},
{
"Name": "generations",
"Description": "The generated text along with the likelihoods for tokens requested.",
}
],
},
"RecommendedInstanceTypes": {
"BatchTransform": "ml.m4.large",
"RealtimeInference": "ml.m4.large",
"Training": "ml.m4.large"
}
}
}]
}
}],
"Intent": "APPLY"
}
```
## 必須フィールド
+ `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 つの配信オプションに制限されています。
+ `Details` (オブジェクト) — 必須
+ `SagemakerModelPackageDeliveryOptionDetails` または `SageMakerAlgorithmDeliveryOptionDetails` (オブジェクト)
+ `SageMakerModelPackageArn` または `SageMakerAlgorithmArn` (文字列) — 必須
モデルパッケージまたはアルゴリズムの Amazon リソースネーム (ARN)。
+ `AccessRoleArn` (文字列) — 必須
AWS Marketplace が SageMaker リソースにアクセスするための IAM ロール ARN。
+ `SampleNotebookUrl` (文字列) — 必須
使用コードを含むサンプル Jupyter Notebook へのリンク。詳細については、GitHub [のサンプルノートブックテンプレート](https://github.com/aws/amazon-sagemaker-examples/blob/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template/title_of_your_product-Model.ipynb)を参照してください。
+ `RepositoryUrl` (文字列) — 必須
ノートブックおよびサンプルデータアクセス用の Git リポジトリ URL。詳細については、[GitHub のサンプル Git リポジトリ](https://github.com/aws/amazon-sagemaker-examples/tree/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template)を参照してください。 GitHub
+ `UsageInstructions` (文字列) — 必須
アルゴリズムのトレーニング情報またはモデルの使用に関する詳細。
+ `InputProperties` (オブジェクト) — 必須
+ `Description` (文字列) — 必須
モデル/アルゴリズム入力の説明
+ `Limitations` (文字列)
入力制限
+ `SampleInput` (オブジェクト) — 必須
RealtimeInferenceUrl (文字列) \| RealtimeInferenceText (文字列) \| BatchTransformUrl (文字列) \| BatchTransformText (文字列)
+ `Parameters` (配列