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（对象）（必填）-包含有关您的机器学习商品报价的信息。

    • Identifier（字符串）（必填）-您要更新定价条款的报价编号。有关更多信息，请参阅标识符。

    • Type（字符串）（必填）-Type 必须Offer@1.0用于更新定价。

  • DetailsDocument（object）（必填）— 有关您的机器学习产品定价条款的详细信息。

    • PricingModel（字符串）（必填）-产品的定价模式-您可以在 “使用”、“免费” 和 “合同”（适用于私人优惠）之间进行选择。有关更多信息，请参阅 M achine 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有关错误详情和疑难解答，请参阅更改集合状态和错误。

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