AWS Marketplace API 参考已重组。有关支持的 API 操作的更多信息，请参阅 [AWS Marketplace API 参考](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)。

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

# 限制版本
<a name="ml-restrict-version"></a>

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

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

**要限制版本，请执行以下操作：**
+  要限制版本，请使用`RestrictDeliveryOptions`更改类型调用`StartChangeSet`操作。

## 请求语法
<a name="ml-restrict-version-request-syntax"></a>

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

## 必填字段
<a name="ml-restrict-version-required-fields"></a>

**必填字段**
+  `Entity`（对象）-必填 

  包含有关您的机器学习产品的信息。
  +  `Identifier`（字符串）-必填 

    您的产品编号。有关更多信息，请参阅[标识符](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)。
  +  `Type`（字符串）-必填 

    指定配送方式（产品类型）。它必须是 `MachineLearningProduct@1.0`。
+  `DetailsDocument`（对象）-必填 

   包含更新的版本信息。
  + `DeliveryOptionIds`（对象数组）—必填

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

## 响应语法
<a name="ml-restrict-version-response-syntax"></a>

成功的请求会返回：

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

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="ml-restrict-version-errors"></a>

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


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