AWS Marketplace API 參考已重組。如需支援的 API 操作的詳細資訊，請參閱 AWS Marketplace API 參考。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 AWS MarketplaceAPIs 處理轉售授權

您可以使用 AWS Marketplace Catalog API自動化使用轉售授權的任務。

雖然產品說明 中銷售的內容AWS Marketplace，但轉售授權 （也稱為機會） 說明有關該產品如何獲得授權進行轉售的條款和規則AWS Marketplace。CPPO 是轉售授權的目標。

轉售授權具有一系列條款和規則，用於製造商和管道合作夥伴之間的經銷商協議。接受轉售授權的條款可讓經銷商根據條款中表達的條件為產品建立優惠。

轉售授權中有兩種類型的規則：

請參閱下列資源：

下列主題說明如何使用目錄 API 來建立和更新轉售授權：

轉售授權先決條件

若要使用轉售授權，獨立軟體廠商 (ISVs) 和AWS Marketplace頻道合作夥伴都必須建立服務連結角色，以提供資源共用許可給 AWS。如果兩個群組都無法執行此先決條件，則 AWS無法將授權資源從 ISV 共用給AWS Marketplace頻道合作夥伴。如需詳細資訊，請參閱《 AWS Marketplace 賣方指南》中的使用 的 角色進行轉售授權AWS Marketplace。

建立新的轉售授權

您可以使用目錄 API 在 中建立新的轉售授權AWS Marketplace。

如果您的請求處理成功， 會為您AWS Marketplace Catalog API產生處於 Draft 狀態的轉售授權。這是不完整的轉售授權，通路合作夥伴看不到AWS Marketplace。

使用Update變更類型來完成轉售授權。轉售授權完成後，請使用ReleaseResaleAuthorization變更類型來完成轉售授權建立程序並釋出轉售授權，這會驗證整個轉售授權，並讓管道合作夥伴看到您的授權AWS Marketplace。

若要在 Draft 狀態建立轉售授權，請呼叫CreateResaleAuthorization變更類型的 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1 
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateResaleAuthorization",
      "ChangeName": "xyz",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999"
      }
    }
  ]
}

提供輸入欄位的資訊以新增CreateResaleAuthorization變更類型：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

當請求完成時 （如果 Status是 SUCCEEDED)，ResaleAuthorization會產生新的 。雖然SUCCEEDED狀態指出CreateResaleAuthorization變更類型呼叫已完成，但ResaleAuthorization狀態仍處於 Draft 狀態。

以下顯示 DescribeChangeSet API 操作的回應。

{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef",
  "ChangeSetName": "Submitted by 123456789012",
  "StartTime": "2021-05-27T22:21:26Z",
  "EndTime": "2021-05-27T22:32:19Z",
  "Status": "SUCCEEDED",
  "ChangeSet":
  [
    {
      "ChangeType": "CreateResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "ProductId": "prod-ad8EXAMPLE51",
        "Name": "Test ResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "ResellerAccountId": "777788889999",
        "BulkRequestId": "84977023-5093-4a66-8b24-ef2c5a2f8b1f"
      },
      "ErrorDetailList":
      []
    }
  ]
}

同步驗證

結構描述驗證專屬於 中的CreateResaleAuthorization動作AWS Marketplace Catalog API。當您呼叫 時，會執行驗證StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的CreateResaleAuthorization 動作AWS Marketplace Catalog API。當您在處理變更集DescribeChangeSet之後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet 取得變更請求狀態的詳細資訊，請參閱 使用變更集。

更新以買方為目標的買方

您可以使用目錄 API 來更新以您的轉售授權為目標的買方AWS Marketplace。

任何未包含在最新請求中的現有目標選項都會從轉售授權中移除。此變更類型對於發行轉售授權是選用的。

若要更新以您的轉售授權為目標的買方，請使用UpdateBuyerTargetingTerms變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
   "Catalog": "AWSMarketplace",
   "ChangeSet": [        
      {
         "ChangeType":"UpdateBuyerTargetingTerms",
         "Entity":{
            "Type": "ResaleAuthorization@1.0", 
            "Identifier": "resaleauthz-123456789"
         },
         "DetailsDocument":
         {
           "Terms":
           [
             {
               "Type": "BuyerTargetingTerm",
               "PositiveTargeting":
               {
                 "BuyerAccounts":
                 [
                  "123456789012"
                 ]
               }
             }
           ]
         }
      }
   ]
}

提供要新增UpdateBuyerTargetingTerms變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括與AWS Marketplace賣方營運團隊驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾個小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

結構描述驗證專屬於 中的UpdateBuyerTargetingTerms動作AWS Marketplace Catalog API。這些驗證會在您呼叫 時執行StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的UpdateBuyerTargetingTerms動作AWS Marketplace Catalog API。當您在處理變更集DescribeChangeSet之後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet 取得變更請求狀態的詳細資訊，請參閱 使用變更集。

更新可用性

您可以使用目錄 API 來限制建立多少私有優惠的可用性，或直到可以建立私有優惠的特定時間為止。

根據預設，此值不限用量，雖然您可以在規則清單下檢查可用性。

若要控制轉售授權的可用性和可用性，請使用UpdateAvailability變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateAvailability",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "AvailabilityEndDate": "2022-05-31",
        "OffersMaxQuantity": 1
      }
    }
  ]
}

提供要新增UpdateAvailability變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括與AWS Marketplace賣方營運團隊驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾個小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

結構描述驗證專屬於 中的UpdateAvailability動作AWS Marketplace Catalog API。當您呼叫 時，會執行驗證StartChangeSet。如果請求不符合下列要求，它會因 HTTP 回應而失敗

非同步錯誤

下列錯誤專屬於 AWS Marketplace Catalog API 中的UpdateAvailability動作。當您在處理變更集DescribeChangeSet之後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet 取得變更請求狀態的詳細資訊，請參閱 使用變更集。

更新未來日期協議的有效性

您可以使用目錄 API 來修改和控制未來日期的服務開始日期AWS Marketplace。

此變更集並非發行轉售授權的必要項目。

若要修改和控制轉售授權的產品協議持續時間，請使用UpdateBuyerValidityTerms變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateBuyerValidityTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerValidityTerm",
            "MaximumAgreementStartDate": "2024-05-31"
          }
        ]
      }
    }
  ]
}

提供輸入欄位的資訊以新增UpdateBuyerValidityTerms變更類型：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括與AWS Marketplace賣方營運團隊驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾個小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

結構描述驗證專屬於 中的UpdateBuyerValidityTerms動作AWS Marketplace Catalog API。當您呼叫 時，會執行驗證StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的UpdateBuyerValidityTerms 動作AWS Marketplace Catalog API。當您在處理變更集DescribeChangeSet之後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet取得變更請求狀態的詳細資訊，請參閱 使用變更集。

更新法律資源

您可以使用目錄 API 完全取代 中現有的法律術語AWS Marketplace。

未包含在最新請求中的法律條款將從轉售授權中移除。 BuyerLegalTerm包含 EULA，該 EULA 將包含在最終買方協議中，並LegalTerm包含經銷商合約，該合約將包含在通路合作夥伴與 ISV 之間的經銷商協議中。

若要更新 的法律條款ResaleAuthorization，請使用UpdateLegalTerms變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1 
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateLegalTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "BuyerLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomEula",
                "Url": "https://my-public-bucket.s3.amazonaws.com/eula-example12345.txt"
              }
            ]
          },
          {
            "Type": "ResaleLegalTerm",
            "Documents":
            [
              {
                "Type": "CustomResellerContract",
                "Url": "https://my-public-bucket.s3.amazonaws.com/reseller-example12345.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

提供要新增UpdateLegalTerms變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

結構描述驗證專屬於 中的UpdateLegalTerms動作AWS Marketplace Catalog API。當您呼叫 時，會執行驗證StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的UpdateLegalTerms動作AWS Marketplace Catalog API。當您呼叫 時DescribeChangeSet，在處理變更集之後，會傳回這些錯誤。如需使用 DescribeChangeSet取得變更請求狀態的詳細資訊，請參閱 使用變更集。

更新定價

您可以使用目錄 API 完全取代 中現有的定價條款AWS Marketplace。

未包含在最新請求中的定價條款將從轉售授權中移除。您可以透過此 API 更新產品的折扣定價。

若要更新轉售授權的定價詳細資訊，請使用UpdatePricingTerms變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdatePricingTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "PricingModel": "Contract",
        "Terms":
        [
          {
            "Type": "ResaleUsageBasedPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "0.10"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "0.20"
                  }
                ]
              }
            ]
          },
          {
            "Type": "ResaleConfigurableUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "RateCards":
            [
              {
                "Selector":
                {
                  "Type": "Duration",
                  "Value": "P12M"
                },
                "RateCard":
                [
                  {
                    "DimensionKey": "m3.large",
                    "Price": "300"
                  },
                  {
                    "DimensionKey": "m4.xlarge",
                    "Price": "400"
                  }
                ],
                "Constraints":
                {
                  "MultipleDimensionSelection": "Allowed",
                  "QuantityConfiguration": "Allowed"
                }
              }
            ]
          },
          {
            "Type": "ResaleFixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Duration": "P2M",
            "Price": "200.0",
            "Grants":
            [
              {
                "DimensionKey": "Users",
                "MaxQuantity": 10
              }
            ]
          }
        ]
      }
    }
  ]
}

提供要新增UpdatePricingTerms變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

下列結構描述驗證專屬於 AWS Marketplace Catalog API 中的UpdatePricingTerms動作。當您呼叫 時，會執行驗證StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的UpdatePricingTerms動作AWS Marketplace Catalog API。當您在處理變更集DescribeChangeSet之後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet取得變更請求狀態的詳細資訊，請參閱 使用變更集。

更新付款排程

您可以使用目錄 API 變更付款相關詳細資訊，例如彈性付款排程AWS Marketplace。

若要更新轉售授權的付款相關詳細資訊，請使用UpdatePaymentScheduleTerms變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1 
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdatePaymentScheduleTerms",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Terms":
        [
          {
            "Type": "ResalePaymentScheduleTerm",
            "CurrencyCode": "USD",
            "Schedule":
            [
              {
                "ChargeDate": "2021-12-01",
                "ChargeAmount": "200.00"
              },
              {
                "ChargeDate": "2022-03-01",
                "ChargeAmount": "250.00"
              }
            ]
          }
        ]
      }
    }
  ]
}

提供要新增UpdatePaymentScheduleTerms變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾個小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

結構描述驗證專屬於 中的UpdatePaymentScheduleTerms動作AWS Marketplace Catalog API。當您呼叫 時，會執行驗證StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的UpdatePaymentScheduleTerms動作AWS Marketplace Catalog API。當您在變更集處理DescribeChangeSet後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet取得變更請求狀態的詳細資訊，請參閱 使用變更集。

更新轉售授權詳細資訊

您可以使用目錄 API 來更新 中的轉售授權詳細資訊AWS Marketplace。

若要更新轉售授權詳細資訊，請使用UpdateInformation變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateInformation",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument":
      {
        "Name": "TestResaleAuthorization",
        "Description": "Worldwide ResaleAuthorization for Test Product",
        "PreExistingBuyerAgreement":
        {
          "AcquisitionChannel": "AwsMarketplace",
          "PricingModel": "Contract"
        }
      }
    }
  ]
}

提供要新增UpdateInformation變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾個小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

下列結構描述驗證專屬於 中的UpdateInformation動作AWS Marketplace Catalog API。這些驗證會在您呼叫 時執行StartChangeSet，如果輸入不符合下列要求，請求將會失敗並顯示 HTTP 錯誤。

非同步錯誤

下列錯誤專屬於 中的UpdateInformation動作AWS Marketplace Catalog API。當您在變更集處理DescribeChangeSet後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet取得變更請求狀態的詳細資訊，請參閱 使用變更集。

限制轉售授權

您可以使用目錄 API，將限制規則設定為 中的轉售授權AWS Marketplace。

頻道合作夥伴無法再使用受限制的轉售授權來建立私有優惠。現有的私有優惠不會受到影響。

若要限制您的轉售授權，請使用RestrictResaleAuthorization變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "RestrictResaleAuthorization",
      "Entity": {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

提供要新增RestrictResaleAuthorization變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

結構描述驗證專屬於 AWS Marketplace Catalog API 中的RestrictResaleAuthorization動作。當您呼叫 時，會執行這些驗證StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的RestrictResaleAuthorization動作AWS Marketplace Catalog API。當您在變更集處理DescribeChangeSet後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet取得變更請求狀態的詳細資訊，請參閱 使用變更集。

發佈轉售授權並讓通路合作夥伴可見

您可以使用目錄 API 將 啟動ResaleAuthorization為 Active 狀態。

ReleaseResaleAuthorization 會啟用您的轉售授權，讓通路合作夥伴可以使用您的轉售授權來建立私有優惠。

若要釋出您的轉售授權，請使用ReleaseResaleAuthorization變更類型呼叫 StartChangeSet API 操作，如下列範例所示。

請求語法

POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "ReleaseResaleAuthorization",
      "Entity":
      {
        "Type": "ResaleAuthorization@1.0",
        "Identifier": "resaleauthz-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

提供要新增ReleaseResaleAuthorization變更類型的欄位資訊：

回應語法

為您的請求建立變更集。對此請求的回應為您提供變更集ChangeSetIdChangeSetArn的 和 ，如下所示。

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

變更請求會新增至佇列並進行處理。這包括驗證資訊，以確保其符合AWS Marketplace準則。驗證程序可能需要幾分鐘到幾小時。

您可以透過 檢查請求的狀態AWS Marketplace 管理入口網站，或使用 API 操作直接透過目錄 DescribeChangeSet API。

同步驗證

結構描述驗證專屬於 中的ReleaseResaleAuthorization動作AWS Marketplace Catalog API。當您呼叫 時，會執行驗證StartChangeSet。如果請求不符合下列要求，它會失敗並顯示 HTTP 回應。

非同步錯誤

下列錯誤專屬於 中的ReleaseResaleAuthorization動作AWS Marketplace Catalog API。當您在處理變更集DescribeChangeSet之後呼叫 時，會傳回這些錯誤。如需使用 DescribeChangeSet取得變更請求狀態的詳細資訊，請參閱 使用變更集。

描述現有的轉售授權

若要描述轉售授權詳細資訊，請使用 ResaleAuthorization@1.0實體類型呼叫 DescribeEntity API 操作，如下列範例所示。

請求語法

GET /DescribeEntity?catalog=<Catalog>&entityId=<EntityId> HTTP/1.1

提供要新增DescribeEntity變更類型的欄位資訊：

回應語法

對此請求的回應會為您提供優惠詳細資訊，如下所示。

{
  "EntityType": "ResaleAuthorization@1.0",
  "EntityIdentifier": "resaleauthz-123456789",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:111122223333:AWSMarketplace/ResaleAuthorization/resaleauthz-123456789",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "DetailsDocument": {
    "Name": "TestResaleAuthorization",
    "Description": "ResaleAuthorization for Test Product",
    "ProductId": "prod-ad8EXAMPLE51",
    "ProductName": "TestProduct",
    "Status": "Active", /*Draft, Active, Restricted*/
    "PreExistingBuyerAgreement": {
      "AcquisitionChannel": "Unknown",
      "PricingModel": "Unknown"
    },
    "CreatedDate": "2023-07-18T16:39:31.335Z",
    "ManufacturerLegalName": "ChannelCAPI.Inc",
    "ManufacturerAccountId": "123456789012",
    "Dimensions": [
      {
        "Name": "Protected Resources",
        "Description": "Additional 100 protected resources",
        "Key": "hundredresources",
        "Unit": "Units",
        "Types": [
          "Entitled"
        ]
      }
    ],
    "OfferDetails": {
      "OfferExtendedStatus": "Not Started", /* Not Started, Completed-Used, Completed-Usable*/
      "OfferCreatedCount": 0
    },
    "Terms": [
      {
        "Type": "ResaleUsageBasedPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "resource_number",
                "Price": "0.05"
              },
              {
                "DimensionKey": "scanned_data",
                "Price": "0.05"
              }
            ]
          }
        ]
      },
      {
        "Type": "ResaleConfigurableUpfrontPricingTerm",
        "Id": "term_id_placeholder",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P24M"
            },
            "RateCard": [
              {
                "DimensionKey": "hundredresources",
                "Price": "0.04"
              },
              {
                "DimensionKey": "tenTBData",
                "Price": "0.03"
              },
              {
                "DimensionKey": "channel_custom",
                "Price": "0.02"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "ResaleFixedUpfrontPricingTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Duration": "P180D",
        "Price": "0.0",
        "Grants": [
          {
            "DimensionKey": "sdf73rbns93nl120d10xm1",
            "MaxQuantity": 1
          }
        ]
      },
      {
        "Type": "ResalePaymentScheduleTerm",
        "Id": "term-sdh27fb2",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2018-07-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          },
          {
            "ChargeDate": "2019-05-01T00:00:00.000Z",
            "ChargeAmount": "200.00"
          }
        ]
      },
      {
        "Type": "BuyerLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardEula",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/a85cace8-6d9d-40ca-a053-78fc265479bf?isSigned=yes"
          }
        ]
      },
      {
        "Type": "ResaleLegalTerm",
        "Id": "term_id_placeholder",
        "Documents": [
          {
            "Type": "StandardResellerContract",
            "Url": "https://resale-auth-legal-terms-iad-beta.s3.us-east-1.amazonaws.com/09ae57d6-c75a-3a4c-aadf-9b866bae64ab/bed55b56-7ab4-4c4c-b633-3bf4f6efcb98?isSigned=yes"
          }
        ]
      },
      {
        "Type": "BuyerValidityTerm",
        "Id": "term_id_placeholder",
        "MaximumAgreementStartDate": "2023-09-25T23:59:59.000Z"
      },
      {
        "Type": "BuyerTargetingTerm",
        "Id": "term_id_placeholder",
        "PositiveTargeting": {
          "BuyerAccounts": [
            {
              "AwsAccountId": "444455556666"
            }
          ]
        }
      }
    ],
    "Rules": [
      {
        "Type": "AvailabilityRule",
        "Id": "availability_rule_id_placeholder",
        /* If the AvailabilityEndDate and OffersMaxQuantity not present Usage will be Unlimited*/
        "Usage": "Limited",
        "AvailabilityEndDate": "2022-05-31T23:59:59Z",
        "OffersMaxQuantity": 1
      },
      {
        "Type": "PartnerTargetingRule",
        "Id": "partner_targeting_rule_id_placeholder",
        "ResellerAccountId": "777777777777",
        "ResellerLegalName": "ChannelCAPICP.Inc"
      }
    ]
  }
}

以下是您在DescribeEntity回應中看到的欄位的相關資訊。