AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、[AWS Marketplace API リファレンス](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 料金条件を更新する
Catalog API を使用して、 の機械学習製品の料金を更新できます AWS Marketplace。
**注記**
サポートされているすべてのインスタンスタイプの機械学習製品の料金を設定する必要があります。最初のバージョンを作成すると、 `UpdatePricingTerms`および は、製品を公開するために、サポートされているすべてのインスタンスタイプの料金でタイプ`AddDeliveryOptions`を変更します。以前にサポートされていなかった新しいインスタンスタイプを持つ既存の製品に新しいバージョンを追加する場合は、それらのインスタンスタイプを `UpdatePricingTerms`および `AddDeliveryOptions`変更タイプに含める必要があります。
料金条件を更新するには、 `UpdatePricingTerms` `StartChangeSet`オペレーションを変更タイプで呼び出します。
## リクエストの構文
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [
{
"ChangeType": "UpdatePricingTerms",
"Entity": {
"Type": "Offer@1.0",
"Identifier": "$CreateOfferChange.Entity.Identifier"
},
"DetailsDocument": {
"PricingModel": "Usage",
"Terms": [
{
"Type": "UsageBasedPricingTerm",
"CurrencyCode": "USD",
"RateCards": [
{
"RateCard": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b",
"Price": 0.1
},
{
"DimensionKey": "m.i.c",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m5.4xlarge.a.t",
"Price": 0.1
},
{
"DimensionKey": "ml.m4.16xlarge.a.t",
"Price": 0.1
}
]
}
]
},
{
"Type": "FreeTrialPricingTerm",
"Duration": "P30D",
"Grants": [
{
"DimensionKey": "ml.m4.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m5.4xlarge.m.i.b"
},
{
"DimensionKey": "ml.m4.16xlarge.m.i.b"
},
{
"DimensionKey": "m.i.c"
},
{
"DimensionKey": "ml.m4.4xlarge.a.t"
},
{
"DimensionKey": "ml.m5.4xlarge.a.t"
},
{
"DimensionKey": "ml.m4.16xlarge.a.t"
}
]
}
]
}
},
]
}
```
## 必須フィールド
+ `Entity` (オブジェクト) (必須) - ML 製品のオファーに関する情報が含まれます。
+ `Identifier` (文字列) (必須) – 料金条件を更新するオファー ID。詳細については、[「識別子](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)」を参照してください。
+ `Type` (文字列) (必須) – 料金を更新する`Offer@1.0`には、 が `Type` である必要があります。
+ `DetailsDocument` (オブジェクト) (必須) – 機械学習製品の料金条件に関する詳細。
+ `PricingModel` (文字列) (必須) - 製品の料金モデル - Usage、Free、Contract (プライベートオファーの場合) から選択できます。詳細については、[Machine Learning製品の料金](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html)」を参照してください。
+ `Terms` (オブジェクトの配列) - 製品の全体的な価格をまとめて定義する一連の料金条件。
+ `Type` (文字列) (必須) - 料金条件のタイプ。有効なオプションは、 `UsageBasedPricingTerm` または `FreeTrialPricingTerm`または `FixedUpfrontPricingTerm` (プライベートオファーの場合) です。
+ `CurrencyCode` (文字列) ( `UsageBasedPricingTerm`または `FixedUpfrontPricingTerm` に必須 - 料金条件の通貨。有効な値は `USD` です。
+ `RateCards` (オブジェクトの配列) ( に必須`UsageBasedPricingTerm`) - 機械学習製品の料金を定義するレートカード。この配列には 1 `RateCard`つのみ含める必要があります。
+ `RateCard` (オブジェクトの配列) - 機械学習製品のディメンションとレートの配列。製品を公開するには、サポートされているすべてのインスタンスタイプの料金を設定する必要があります。
+ `DimensionKey` - 料金設定するディメンション。有効なディメンションキーは次のとおりです。
+ インスタンスタイプとそれに続く時間単位のレートの オペレーション:
+ インスタンスタイプは で始まり、その後にインスタンス名とサイズが`ml`続きます。イグザムポールの場合、 `ml.m4.xlarge`
+ オペレーションは、`m.i.b`バッチ変換`m.i.r`、時間単位のリアルタイム推論、アルゴリズムトレーニング`a.t`用です。
+ 例: `ml.m4.4xlarge.m.i.b` バッチ変換`ml.m4.xlarge.m.i.r`、リアルタイム推論、アルゴリズムトレーニング`ml.m4.16xlarge.a.t`の場合
+ `m.i.c` 推論あたりのリアルタイム料金。
+ `Price` - ディメンションのレート。レートは、dimensionKey に応じて、時間単位または推論単位です。
+ `Duration` (文字列) ( `FreeTrialPricingTerm`または に必須 `FixedUpfrontPricingTerm` - 無料トライアルまたは契約期間。無料トライアルの有効な値は X と Y の間です。契約の場合、有効な値は X と Y の間です。
+ Grants (オブジェクトの配列) - 無料トライアルの対象となる dimensionKeys に関する詳細。サポートされているすべての dimensionKeys を指定する必要があります。
+ DimensionKey - 無料トライアルオファーの一部として含めるディメンション。
+ インスタンスタイプとそれに続く時間単位のレートの オペレーション:
+ インスタンスタイプは で始まり、その後にインスタンス名とサイズが`ml`続きます。例: `ml.m4.xlarge`
+ オペレーションは、`m.i.b`バッチ変換`m.i.r`、時間単位のリアルタイム推論、またはアルゴリズムトレーニング`a.t`用です。
+ 例: `ml.m4.4xlarge.m.i.b` バッチ変換`ml.m4.xlarge.m.i.r`、リアルタイム推論、アルゴリズムトレーニング`ml.m4.16xlarge.a.t`の場合
+ `m.i.c` 推論あたりのリアルタイム料金。
## レスポンスの構文
リクエストが成功すると、以下が返されます。
```
{
"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. 完了: 承認されると、料金条件が更新されます。
## エラー
**非同期エラー**
`UpdatePricingTerms` アクションの特定のエラーは、変更セットの処理開始後に `DescribeChangeSet`オペレーションを使用して取得できます。エラーの詳細とトラブルシューティングについては、[「Change set status and errors](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)」を参照してください。
| エラーコード | エラーメッセージ |
| --- | --- |
| INCOMPATIBLE\_PRODUCT\_STATUS | 既存の制限付き製品またはパブリック製品を使用します。 |