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 （物件）—必要

    包含 ML 產品的相關資訊。

    • Identifier （字串）—必要

      您的產品 ID。如需詳細資訊，請參閱識別符。

    • Type （字串）—必要

      指定交付方法 （產品類型）。它必須是 MachineLearningProduct@1.0。

  • DetailsDocument （物件）—必要

    包含更新的版本資訊。

    • DeliveryOptionIds （物件陣列）—必要

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

回應語法

成功的請求會傳回：

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

  1. 驗證：系統會檢查所有資訊是否符合 AWS Marketplace 準則。

  2. 狀態監控：您可以用兩種方式檢查請求的狀態。

    • 透過 AWS Marketplace 管理入口網站

    • 使用 DescribeChangeSet 操作

  3. 完成：核准後，新版本會受到限制。

錯誤

非同步錯誤

下列錯誤可能會在變更集處理期間發生，並且可以使用 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 提供較少的交付選項來限制，因為至少一個必須保持公有狀態。