View a markdown version of this page

更新定價條款 - AWS Marketplace
請求語法必要欄位回應語法變更集處理錯誤

AWS Marketplace API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 AWS Marketplace API 參考。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

更新定價條款

您可以使用目錄 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 （字串） （必要） – Type 必須Offer@1.0用於更新定價。

  • DetailsDocument （物件） （必要） – 有關機器學習產品定價條款的詳細資訊。

    • PricingModel （字串） （必要） - 您產品的定價模式 - 您可以選擇用量、免費和合約 （適用於私有優惠）。如需詳細資訊，請參閱Machine Learning產品定價。

    • Terms （物件陣列） - 定價術語的陣列，可共同定義產品的整體定價。

      • Type （字串） （必要） - 定價期限的類型。有效選項為 UsageBasedPricingTerm 或 FreeTrialPricingTerm 或 FixedUpfrontPricingTerm（適用於私有優惠）。

      • CurrencyCode （字串） ( UsageBasedPricingTerm或 FixedUpfrontPricingTerm - 定價期限的貨幣必填。有效值為 USD。

      • RateCards （物件陣列） ( 需要UsageBasedPricingTerm) - 定義機器學習產品定價的費率卡。您必須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 之間。

      • 授予 （物件陣列） - 有關哪些 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. 狀態監控：您可以用兩種方式檢查請求的狀態。

    • 透過 AWS Marketplace 管理入口網站

    • 使用 DescribeChangeSet 操作

  3. 完成：核准時，定價條款會更新。

錯誤

非同步錯誤

變更集開始處理後，可以使用 DescribeChangeSet操作擷取UpdatePricingTerms動作的特定錯誤。如需錯誤詳細資訊和疑難排解，請參閱變更集狀態和錯誤。

錯誤碼 錯誤訊息
INCOMPATIBLE_PRODUCT_STATUS 使用現有的有限或公開產品。