View a markdown version of this page

料金条件を更新する - AWS Marketplace
リクエストの構文必須フィールドレスポンスの構文変更セット処理エラー

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

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

料金条件を更新する

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

    • Type (文字列) (必須) – 料金を更新するOffer@1.0には、 が Type である必要があります。

  • DetailsDocument (オブジェクト) (必須) – 機械学習製品の料金条件に関する詳細。

    • PricingModel (文字列) (必須) - 製品の料金モデル - Usage、Free、Contract (プライベートオファーの場合) から選択できます。詳細については、Machine Learning製品の料金」を参照してください。

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

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

    • AWS Marketplace 管理ポータル経由

    • DescribeChangeSet 操作の使用

  3. 完了: 承認されると、料金条件が更新されます。

エラー

非同期エラー

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

エラーコード エラーメッセージ
INCOMPATIBLE_PRODUCT_STATUS 既存の制限付き製品またはパブリック製品を使用します。