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`（对象）（必填）-包含有关您的机器学习商品报价的信息。
  + `Identifier`（字符串）（必填）-您要更新定价条款的报价编号。有关更多信息，请参阅[标识符](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)。
  + `Type`（字符串）（必填）-`Type` 必须`Offer@1.0`用于更新定价。
+ `DetailsDocument`（object）（必填）— 有关您的机器学习产品定价条款的详细信息。
  + `PricingModel`（字符串）（必填）-产品的定价模式-您可以在 “使用”、“免费” 和 “合同”（适用于私人优惠）之间进行选择。有关更多信息，请参阅 M [achine 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)。


| 错误代码 | 错误消息 | 
| --- | --- | 
| 不兼容产品状态 | 使用现有的限量产品或公共产品。 |