已重組 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` （物件）—必要 

  包含 ML 產品的相關資訊。
  +  `Identifier` （字串）—必要 

    您的產品 ID。如需詳細資訊，請參閱[識別符](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier)。
  +  `Type` （字串）—必要 

    指定交付方法 （產品類型）。它必須是 `MachineLearningProduct@1.0`。
+  `DetailsDocument` （物件）—必要 

   包含更新的版本資訊。
  + `DeliveryOptionIds` （物件陣列）—必要

    您要限制之版本的 DeliveryOption IDs 清單。對您要限制的版本呼叫 DescribeEntity 動作，擷取每個 DeliveryOption 的唯一識別符。

## 回應語法
<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`操作擷取：


| 錯誤碼 | 錯誤訊息 | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | 使用現有的公有或有限產品 | 
| MISSING\_DELIVERY\_OPTION\_IDS | 從現有 IDs 清單中提供交付選項。 | 
| INVALID\_DELIVERY\_OPTION\_IDS | 提供可在產品中找到的交付選項 IDs。找不到 IDs：【x】 | 
| INVALID\_DELIVERY\_OPTION\_STATUS | 交付選項 IDs 【invalid\_ids】 無效。在公有狀態下提供交付選項。 | 
| ALL\_DELIVERY\_OPTIONS\_RESTRICTED | 提供較少的交付選項來限制，因為至少一個必須保持公有狀態。 |