View a markdown version of this page

限制版本 - AWS Marketplace
请求语法必填字段响应语法错误

AWS Marketplace API 参考已重组。有关支持的 API 操作的更多信息，请参阅 AWS Marketplace API 参考。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

限制版本

您可以使用目录 API 来限制您的机器学习产品的某个版本 AWS Marketplace。如果受到限制，新买家将无法访问该版本。现有订阅者保留对受限版本的访问权限。 AWS Marketplace 指南要求在限制后的 90 天内继续为现有买家提供支持。

重要

必须至少有一个不受限制的版本可用。您不能限制产品的最新公开发售版本。

要限制版本，请执行以下操作：

  • 要限制版本，请使用RestrictDeliveryOptions更改类型调用StartChangeSet操作。

请求语法

POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictDeliveryOptions",
      "Entity":
      {
        "Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "DeliveryOptionIds":
        [
          "example1-2222-cccc-2222-cccccccccccc"
        ]
      }
    }
  ]
}

必填字段

必填字段

  • Entity（对象）-必填

    包含有关您的机器学习产品的信息。

    • Identifier（字符串）-必填

      您的产品编号。有关更多信息，请参阅标识符。

    • Type（字符串）-必填

      指定配送方式（产品类型）。它必须是 MachineLearningProduct@1.0。

  • DetailsDocument（对象）-必填

    包含更新的版本信息。

    • DeliveryOptionIds（对象数组）—必填

      您要限制的版本的 DeliveryOption ID 列表。 DeliveryOption 通过对您限制的版本调用 DescribeEntity 操作来检索每个版本的唯一标识符。

响应语法

成功的请求会返回：

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

  1. 验证：系统检查所有信息是否符合 AWS Marketplace 指导方针。

  2. 状态监控：您可以通过两种方式检查请求的状态。

    • 通过 AWS Marketplace 管理门户

    • 使用 DescribeChangeSet 操作

  3. 完成：获得批准后，新版本将受到限制。

错误

异步错误

在处理更改集的过程中可能会出现以下错误，可以使用该DescribeChangeSet操作进行检索：

错误代码 错误消息
不兼容产品状态 使用现有的公共产品或限量产品
缺少配送选项编号 从现有的 ID 列表中提供配送选项。
无效的配送选项编码 提供可在产品中找到的配送选项编号。找不到身份证：[x]
无效的配送选项状态 配送选项 ID [invalid_ids] 无效。提供公共州的配送选项。
所有配送选项受限 提供更少的配送选项进行限制，因为必须至少有一个选项保持在公共状态。