已重組 AWS Marketplace API 參考。如需支援的 API 操作的詳細資訊，請參閱 [AWS Marketplace API 參考](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)。

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

# 更新定價條款
<a name="update-pricing-terms"></a>

您可以使用目錄 API 來更新 中機器學習產品的定價 AWS Marketplace。

**注意**  
您必須為所有支援的機器學習產品執行個體類型定價。建立第一個版本時， `UpdatePricingTerms`和 會使用所有支援的執行個體類型的價格`AddDeliveryOptions`變更類型，以發佈您的產品。使用先前不支援的新執行個體類型，將新版本新增至現有產品時，您必須在 `UpdatePricingTerms`和`AddDeliveryOptions`變更類型中包含這些執行個體類型。

若要更新定價條款，請使用`UpdatePricingTerms`變更類型呼叫 `StartChangeSet`操作。

## 請求語法
<a name="request-syntax"></a>

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

## 必要欄位
<a name="pricing-terms-required-fields"></a>
+ `Entity` （物件） （必要） - 包含有關 ML 產品優惠的資訊。
  + `Identifier` （字串） （必要） – 您要更新定價條件的優惠 ID。如需詳細資訊，請參閱[識別符](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)。
  + `Type` （字串） （必要） – `Type` 必須`Offer@1.0`用於更新定價。
+ `DetailsDocument` （物件） （必要） – 有關機器學習產品定價條款的詳細資訊。
  + `PricingModel` （字串） （必要） - 您產品的定價模式 - 您可以選擇用量、免費和合約 （適用於私有優惠）。如需詳細資訊，請參閱[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`) - 定義機器學習產品定價的費率卡。您必須`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` 適用於每個推論的即時定價。

## 回應語法
<a name="update-pricing-response-syntax"></a>

成功的請求會傳回：

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

## 變更集處理
<a name="update-pricing-change-set-processing"></a>

變更請求會進入處理佇列，其中會經歷幾個步驟：

1. 驗證：系統會檢查以確保所有資訊都符合 AWS Marketplace 準則。
   + 處理時間：幾分鐘到幾個小時
   + 如需驗證錯誤，請參閱[變更集狀態和錯誤](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors)。

1. 狀態監控：您可以用兩種方式檢查請求的狀態。
   + 透過 AWS Marketplace 管理入口網站
   + 使用 `DescribeChangeSet` 操作

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

## 錯誤
<a name="update-pricing-errors"></a>

**非同步錯誤**  
變更集開始處理後，可以使用 `DescribeChangeSet`操作擷取`UpdatePricingTerms`動作的特定錯誤。如需錯誤詳細資訊和疑難排解，請參閱[變更集狀態和錯誤](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets)。


| 錯誤碼 | 錯誤訊息 | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | 使用現有的有限或公開產品。 |