View a markdown version of this page

使用转售授权AWS MarketplaceAPI - AWS Marketplace
转售授权先决条件创建新的转售授权更新买家定位更新可用性更新 future 协议的有效性更新法律资源更新定价更新付款时间表更新转售授权详情限制转售授权发布转售授权并向渠道合作伙伴公开描述现有的转售授权

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

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

使用转售授权AWS MarketplaceAPI

您可以使用自动执行处理AWS Marketplace Catalog API转售授权的任务。

虽然产品描述了销售的内容AWS Marketplace，但转售授权（也称为机会）描述了有关如何授权转售该产品的条款和规则。AWS MarketplaceCPPO 是转售授权的目标。

转售授权包含一系列条款和规则，制造商和渠道合作伙伴之间的经销商协议需要接受。接受转售授权的条款允许经销商根据条款中规定的条件为产品创建报价。

转售授权中有两种类型的规则：

  • AvailabilityRule— 控制中转售授权的生命周期。AWS Marketplace

  • PartnerTargetingRule — 指定是否应允许一组特定的渠道合作伙伴访问转售授权。

请参阅以下资源：

以下主题介绍如何使用目录 API 创建和更新转售授权：

转售授权先决条件

要使用转售授权，独立软件供应商 (ISV) 和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更改类型：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

  • DetailsDocument（对象）（必填）-请求的细节。

    • ProductId（字符串）（必填）-要为其创建转售授权的产品编号。

    • 名称（字符串）（必填）— 与之关联 ResaleAuthorization 的名称，便于您和您的渠道合作伙伴阅读。

    • 描述（字符串）（可选）-用于添加有关详细信息的自由格式文本字段。 ResaleAuthorization

    • ResellerAccountId（字符串）（必填）— 添加可以描述并使用它AWS 账户ResaleAuthorization来创建私人报价的目标渠道合作伙伴。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

请求完成后（如果Status是SUCCEEDED），则会生成一个新的ResaleAuthorization请求。尽管SUCCEEDED状态表明CreateResaleAuthorization更改类型调用已完成，但ResaleAuthorization状态仍处于Draft状态。

以下显示了 DescribeChangeSetAPI 操作的响应。

{
  "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":
      []
    }
  ]
}

同步验证

架构验证特定于中的CreateResaleAuthorizationAWS Marketplace Catalog API操作。验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则 HTTP 代码
ProductId

必填

不能为空或为空

长度必须介于 1 到 50 个字符之间

422
ProductId 必须授权用户 ResaleAuthorization 为给定产品创建 403
ProductId 必须是目录中的现有商品，且未处于Draft状态

应支持产品转售

 404
Name

必填

不能为空或为空

长度必须介于 1 到 100 个字符之间

不允许使用特殊字符

 422
说明

可选

长度必须介于 1 到 255 个字符之间

不允许使用特殊字符

 422
ResellerAccountId

必填

不能为空

AWS 账户身份证必须采用有效格式（12 位数字）

 422
BulkRequestId

可选

长度必须介于 1 到 50 个字符之间

必须采用 UUID 格式

 422
一个未知的财产 不允许使用其他属性 422

异步错误

以下错误特定于中的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更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。

    • 条款（结构数组）（可选）— 买家定位您要更新的术语列表。如果目的不是针对任何特定的买家，则可以跳过 “条款” 字段。ResaleAuthorization默认情况下ResaleAuthorization，针对所有买家。支持的术语有：

      • BuyerTargetingTerms（object）（可选）— 为您的客户定义特定买家定位。 ResaleAuthorization

        • 类型（字符串）（必填）-正在更新的术语的类别。

        • PositiveTargeting（object）（必填）— 定义任何买家的个人资料都必须满足才能访问的标准ResaleAuthorization。

          • BuyerAccounts（字符串数组）（可选）-列出为可选。您可以添加目标买家AWS 账户。如果目的不是针对ResaleAuthorization特定的买家，则应省略此字段。默认情况下，所有买家都是定向的。如果指定，目标渠道合作伙伴可以选择创建私有报价并定位一部分买家。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括向AWS Marketplace卖家运营团队验证信息，以确保其符合AWS Marketplace指南。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

架构验证特定于中的UpdateBuyerTargetingTermsAWS Marketplace Catalog API操作。这些验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则
术语

可选

不能为空或为空

列表中只允许 BuyerTargetingTerm “”

列表大小必须为 1（目前没有需要多个买家条款的用例）
BuyerTargetingTerm.PositiveTargeting

必填

不能为空
BuyerTargetingTerm.PositiveTargeting.BuyerAccounts

可选

AWS 账户身份证必须采用有效格式（12 位数字）

不得包含超过 25 个账户
一个未知的财产 不允许使用其他属性

异步错误

以下错误特定于中的UpdateBuyerTargetingTerms操作AWS Marketplace Catalog API。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅使用变更集。

错误代码 错误消息
不兼容的买家定位 必须至少有一个买家账户 PreExistingBuyerAgreement。 ResaleAuthorization

更新可用性

您可以使用 Catalog 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更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。

    • AvailabilityEndDate（字符串）（可选）-定义渠道合作伙伴可以利用创建报价之前的结束日期。ResaleAuthorization渠道合作伙伴可以在指定的结束日期之前ResaleAuthorization多次使用此功能。日期以 ISO_8601 格式表示。

    • OffersMaxQuantity（整数）（可选）-定义可使用创建的私人优惠的最大数量 ResaleAuthorization。这并不能定义订阅数量。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括向AWS Marketplace卖家运营团队验证信息，以确保其符合AWS Marketplace指南。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

架构验证特定于中的UpdateAvailabilityAWS Marketplace Catalog API操作。验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应

输入字段 验证规则
OffersMaxQuantity

可选

必须是非负整数

仅允许值 “1”（目前没有支持多个数量的用例）
AvailabilityEndDate

可选

必须采用 ISO_8601 格式化

必须是 future 中的日期
可用性 提供 OffersMaxQuantity 或 AvailabilityEndDate。
一个未知的财产 不允许使用其他属性

异步错误

以下错误特定于 AWS Marketplace Catalog API 中的UpdateAvailability操作。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅使用变更集。

错误代码 错误消息
无效可用性结束日期 提供一个 AvailabilityEndDate 在所有内容之前 ChargeDate 的 ResalePaymentScheduleTerms。
无效可用性结束日期 提供未来 AvailabilityEndDate。

更新 future 协议的有效性

您可以使用目录 API 来修改和控制中将来的服务开始日期AWS Marketplace。

此变更集不是发布转售授权的必备条件。

要修改和控制转售授权的产品协议期限，请使用UpdateBuyerValidityTerms更改类型调用 StartChangeSet API 操作，如以下示例所示。

注意

Future-dated 协议仅支持 SaaS 产品类型。

请求语法

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更改类型：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。

    • 条款（结构数组）-要更新的协议有效性条款列表。支持的术语有：

      • BuyerValidityTerm（对象）— 定义您的 ResaleAuthorization产品中某项服务的可用性。

        • 类型（字符串）-正在更新的术语类别。

        • MaximumAgreementStartDate（字符串）（必填）-定义所提供产品的协议开始日期。未来日期的优惠不能超过此服务的开始日期。日期以 ISO_8601 格式表示。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括向AWS Marketplace卖家运营团队验证信息，以确保其符合AWS Marketplace指南。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

架构验证特定于中的UpdateBuyerValidityTermsAWS Marketplace Catalog API操作。验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则
术语

必填

不能为空或为空

列表中只允许 BuyerValidityTerm “”

列表大小必须为 1（目前没有需要多个服务可用性条款的用例）
MaximumAgreementStartDate

必填

不能为空或为空

必须是 future 日期，并且从现在起不应超过 3 年

必须采用 ISO_8601 格式化
一个未知的财产 不允许使用其他属性

异步错误

以下错误特定于中的UpdateBuyerValidityTerms 操作AWS Marketplace Catalog API。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅使用变更集。

错误代码 错误消息
不兼容的产品 BuyerValidityTerm 该产品不支持。
无效的最大协议开始日期 提供一个在允许限额 MaximumAgreementStartDate 之内的 future。

您可以使用目录 API 来完全替换中的现有法律条款AWS Marketplace。

最新申请中未包含的法律条款将从转售授权中删除。 BuyerLegalTerm包含 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更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。

    • 条款（结构数组）（必填）-法律术语列表。支持的法律条款有：

      • BuyerLegalTerm（object）（必填）— 定义要向接受者提出的文本协议清单。例如，最终用户许可协议 (EULA)。

      • 类型（字符串）（必填）-正在更新的术语的类别。

      • 文件（结构阵列）（必填）— 向买方提出的法律资源参考清单。例如，最终用户许可协议。每个引用都由 a Type 和 a 组成URL：

        • 类型（字符串）（必填）-文档类型。可用的文件类型有：

          • StandardEula— 标准合同AWS Marketplace. 有关更多信息，请参阅《AWS Marketplace卖家指南》中的 SCMP。您无需为此类型提供 URL，因为它由管理AWS Marketplace。

          • EnterpriseEula— 企业合同AWS Marketplace. 有关更多信息，请参阅《AWS Marketplace卖家指南》中的 DSA。您无需为此类型提供 URL，因为它由管理AWS Marketplace。

          • CustomEula— 由您作为制造商提供的定制最终用户许可协议。此文档类型需要存储在可访问的 S3 存储桶中的 EULA 的 URL。

        • 网址（字符串）（有条件必填）— 供买家阅读的法律文件的 URL。当类别类型为时，这是必填项CustomEula。

      • ResaleLegalTerm（object）（可选）— 定义仅向渠道合作伙伴提出的文本协议列表。此术语不适用于买家。

        • 类型（字符串）（必填）-正在更新的术语类别。

        • 文档（结构阵列）（必填）— 向渠道合作伙伴推荐的经销商法律资源参考清单。

          • 类型（字符串）（必填）-文档的类别。可用的文件类型有：

            • StandardResellerContract— 标准经销商合同. AWS Marketplace

            • CustomResellerContract— 您作为制造商签订的定制经销商合同。经销商合同的 URL 存储在可访问的 S3 存储桶中，此文档类型是必需的。

          • 网址（字符串）（有条件要求）— 经销商合同文档的网址，供渠道合作伙伴阅读。当 “类型” 为 “时，这是必需的 CustomResellerContract。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括验证信息以确保其符合AWS Marketplace准则。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

架构验证特定于中的UpdateLegalTermsAWS Marketplace Catalog API操作。验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则 HTTP 代码
术语

必填

不能为空或为空

 422
条款 []。 BuyerLegalTerm

必填

不能为空或为空

 422
条款 []。 ResaleLegalTerm

可选

如果存在，则不能为空或为空

 422
条款 []。 BuyerLegalTerm.Documents

必填

不能为空或为空

 422
条款 []。 BuyerLegalTerm.Documents[] .Type

必填

不能为空或为空

允许的值：

  • StandardEula

  • EnterpriseEula

  • CustomEula

 422
条款 []。 BuyerLegalTerm.Documents[] .Url “类型” 为 “” 时必填且必须是有效的 URL CustomEula

当 “类型” 是 [” “、”StandardEula] 之一时，不得提供 EnterpriseEula

 422
条款 []。 ResaleLegalTerm.Documents

必填

不能为空或为空

 422
条款 []。 ResaleLegalTerm.Documents[] .Type

必填

不能为空或空允许的值：

  • StandardEula

  • CustomResellerContract

 422
条款 []。 ResaleLegalTerm.Documents[] .Url

“类型” 为 “” 时必填且必须是有效的 URL CustomResellerContract

当 “类型” 是 [” StandardContract “] 之一时，不得提供

 422
一个未知的财产 不允许使用其他属性 422

异步错误

以下错误特定于中的UpdateLegalTerms操作AWS Marketplace Catalog API。在处理更改集之后DescribeChangeSet，当您调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅使用变更集。

错误代码 错误消息
买家法律文件无效 为存储在可访问的 S3 存储桶中的买家法律文件提供网址。
无效的转售法律文件 提供存储在可访问的 S3 存储桶中的转售法律文件的 URL。
缺少强制性条款 提供一个 BuyerLegalTerm.

更新定价

您可以使用目录 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更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。

    • PricingModel（字符串）（必填）-报价的定价模型。定价模型的可能值为：

      • 用法 — Usage-based 定价模式，将向买家收取使用您产品的费用。

      • 合同 — 在基于合同的定价模式中，要么提前向买家收取产品使用费，要么为买家提供灵活的付款时间表。买家还可以为合同之外的额外使用付费。渠道合作伙伴可以将他们的加价添加到此付款计划和每个维度的定价中。

    • 条款（结构数组）（必填）-要更新的定价术语列表。支持的定价条款有：

      • ResaleUsageBasedPricingTerm（object）— 定义一种即用即付 (PAYG) 定价模型，其中根据产品使用情况向客户收费。

        • 类型（字符串）（必填）-术语的类别。

        • CurrencyCode（字符串）— 定义本术语中提及的价格的货币。目前，仅支持美元。

        • RateCards（结构数组）-价目表列表。

          • RateCard（结构数组）— 价目表定义产品维度的单位费率。

            • DimensionKey（字符串）-给定权利适用的维度。尺寸代表产品的容量类别，在列出产品时指定AWS Marketplace。

            • 价格（字符串）-用于计算要收取的金额的产品维度的每单位价格。

          • 约束（对象）（可选）-定义接受者如何配置术语的限制。

            • MultipleDimensionSelection（字符串）（可选）-确定是否允许买家在价目表中选择多个维度。可能的值为 Allowed 和 Disallowed。默认值为 Allowed。

            • QuantityConfiguration（字符串）（可选）-确定是否允许接受者在价目表中为每个维度配置数量。可能的值为 Allowed 和 Disallowed。默认值为 Allowed。

      • ResaleFixedUpfrontPricingTerm（object）— 定义一种预付费定价模型，在该模型中，向客户收取固定的预付金额。

        • 类型（字符串）（必填）-正在更新的术语的类别。

        • CurrencyCode（字符串）— 定义本术语中提及的价格的货币。定义本术语中提及的价格的货币。支持美元、澳元、欧元、英镑和日元。

        • 价格（字符串）（必填）-接受此条款时向客户收取的固定金额。

        • 期限（字符串）（必填）-合同期限 ResaleAuthorization。此字段支持 ISO 8601 格式。

        • 补助（结构数组）（必填）— 作为协议执行的一部分，将授予固定预付定价接受者的权利。

          • DimensionKey（字符串）（必填）-产品文档中定义的唯一维度密钥。尺寸代表产品的容量类别，在列出产品时指定AWS Marketplace。

          • MaxQuantity（整数）（必填）-买方有权获得产品给定尺寸的最大容量。如果 MaxQuantity 未提供，则买家将能够无限量使用给定维度。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括验证信息以确保其符合AWS Marketplace准则。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

以下架构验证特定于 AWS Marketplace Catalog API 中的UpdatePricingTerms操作。验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则
术语

必填

不能为空或为空

每个学期只能出现一次允许的条款：

  • * ResaleUsageBasedPricingTerm

  • * ResaleConfigurableUpfrontPricingTerm

  • * ResaleFixedupfrontPricingTerm
条款 []。 ResaleUsageBasedPricingTerm.CurrencyCode

必填

允许的值：美元
条款 []。 ResaleUsageBasedPricingTerm.Validity

必填

不能为空或为空

预期格式：ISO 8601 持续时间
条款 []。 ResaleUsageBasedPricingTerm.RateCards

必填

不能为空或为空
条款 []。 ResaleUsageBasedPricingTerm.RateCards[]。 DimensionKey

必填

不能为空或为空

长度必须介于 1 和 60 之间
条款 []。 ResaleUsageBasedPricingTerm.RateCards[] .Price

必填

不能为空或为空

数据类型为 “字符串”

必须为非负数

Support 最多支持 8 个十进制

不支持特殊字符
条款 []。 ResaleConfigurableUpfrontPricingTerm.CurrencyCode

必填

允许的值：[“美元”、“澳元”、“欧元”、“英镑”、“日元”]

条款 []。 ResaleConfigurableUpfrontPricingTerm.RateCards[]。 Selector.Type

必填

不能为空或为空

允许的值：持续时间

条款 []。 ResaleConfigurableUpfrontPricingTerm.RateCards[]。 Selector.Value

必填

不能为空或为空

预期格式：ISO 8601 持续时间

条款 []。 ResaleConfigurableUpfrontPricingTerm.RateCards[]。 RateCard.DimensionKey

必填

不能为空或为空

长度必须介于 1 和 60 之间

条款 []。 ResaleConfigurableUpfrontPricingTerm.RateCards[]。 RateCard.Price

必填

不能为空或为空

数据类型为 “字符串”

必须为非负数

Support 最多支持 6 个十进制

不支持特殊字符

条款 []。 ResaleConfigurableUpfrontPricingTerm.RateCards[]. 约束

 可选
条款 []。 ResaleFixedUpfrontPricingTerm.CurrencyCode 必填

允许的值：[“美元”、“澳元”、“欧元”、“英镑”、“日元”]
条款 []。 ResaleFixedUpfrontPricingTerm.Price

必填

不能为空或为空

数据类型为 “字符串”

必须为非负数

Support 最多支持 6 个十进制

不支持特殊字符

允许的值：0.0
条款 []。 ResaleFixedUpfrontPricingTerm.Duration

必填

不能为空或为空

预期格式：ISO 8601 持续时间
条款 []。 ResaleFixedUpfrontPricingTerm.Grants[]。 DimensionKey

必填

不能为空或为空

长度必须介于 1 和 60 之间
条款 []。 ResaleFixedUpfrontPricingTerm.Grants[]。 MaxQuantty

必填

不能为空或为空
一个未知的财产 不允许使用其他属性

异步错误

以下错误特定于中的UpdatePricingTerms操作AWS Marketplace Catalog API。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅使用变更集。

错误代码 错误消息
无效的货币代码 CurrencyCode 所有定价和付款条件均相同。
不兼容的产品 在 [x] 中使用产品中现有的可用尺寸。
重复的维度密钥 在 [x] 中为价目表提供唯一的维度键列表
无效的费率卡 提供在 [x] 中具有相同单位的尺寸
无效的费率卡 在中仅提供计量尺寸的价目表。 ResaleUsageBasedPricingTerm
无效的费率卡 为中所有可用的计量维度提供基于使用量的费率。 ResaleUsageBasedPricingTerm
费率太多了 在允许的限制 RateCards 范围内提供 ResaleUsageBasedPricingTerm。
重复选择器 在中提供唯一的选择器列表。 ResaleConfigurableUpfrontPricingTerm
无效的费率卡 ConfigurableUpfrontPricingTerm 在持续时间 [x] 内缺少一个或多个维度键。提供所有持续时间内同一组维度密钥的价格。
无效的费率卡 在 [x] 中提供所有计量尺寸或所有授权尺寸。
不兼容的费率卡片约束 将 “ MultipleDimensionSelection 和 QuantityConfiguration ” 设置为 “ PricingModel不允许”。 ResaleConfigurableUpfrontPricingTerm
评分卡太多了 该产品只允许 ConfigurableUpfrontPricingTerm使用一张价目表。
不兼容条款 以下术语与 PricingModel:[x, y, z] 不兼容。
费率太多了 RateCards 在 [x 期限] 的允许限制内提供。
补助金太多了 在 [x 期限] 内提供最多 [N] 笔补助金。
选择器持续时间值无效 提供介于 [x] 和 [y] 个月之间的持续时间 ResaleConfigurableUpfront
补助金太多了 提供介于 [x] 和 [y] 个月之间的持续时间。
选择器持续时间值无效 确保中计量维度的持续时间粒度为日级别 ResaleConfigurableUpfront
无效持续时间 确保中计量维度的持续时间粒度为日级别。 FixedUpfront
无效的费率卡 在 [x] 中仅提供授权尺寸。
缺少持续时间 在 [x] 中提供持续时间。
重复的维度密钥 在 [x] 中为 Grants 提供唯一的维度键列表。
不兼容的付款设置 更新您的付款设置以使其与兼容 CurrencyCode。
不兼容卖家验证 完成所有必需的卖家验证流程。
无效的货币代码 提供支持的 CurrencyCode。
无效的货币代码 CurrencyCode 所有定价和付款条件均相同。
不兼容的货币代码 CurrencyCode 优惠发布后无法更改。

更新付款时间表

您可以在中使用目录 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更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。

    • 条款（结构数组）-您要更新的付款条件列表。支持的付款条件有：

      • ResalePaymentScheduleTerm（object）— 定义一种基于分期付款的定价模型，在该模型中，在协议有效期内的不同日期向客户收取固定价格。

        • 类型（字符串）-正在更新的术语的类别。

        • CurrencyCode（字符串）（必填）-定义附表中提及的付款货币。支持美元、澳元、欧元、英镑和日元。

        • 附表（结构数组）-付款时间表列表，其中每个要素定义一期付款。它包含计算要支付的价格和向客户收取费用的日期所需的信息。

          • ChargeDate（字符串）（必填）-客户支付此付款时间表条款中定义的价格的日期。此字段支持 ISO 8601 格式。

          • ChargeAmount（字符串）（必填）—客户在预定日期要支付的价格（ChargeDate）。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括验证信息以确保其符合AWS Marketplace准则。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

架构验证特定于中的UpdatePaymentScheduleTermsAWS Marketplace Catalog API操作。验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则 HTTP
Terms.Type

必填

[x] 产品不支持

允许的条款： ResalePaymentScheduleTerm

 422
条款 []。 CurrencyCode

必填

允许的值：美元

 422
条款 []。 ResalePaymentScheduleTerm.Schedule

必填

长度必须介于 1 和 60 之间

 422
条款 []。 ResalePaymentScheduleTerm.Shedule.ChargeDate

必填

必须采用 ISO 8601 格式

日期必须是 future

 422
条款 []。 ResalePaymentScheduleTerm.Shedule.ChargeAmount

必填

必须为非负数

 422
一个未知的财产 不允许使用其他属性 422

异步错误

以下错误特定于中的UpdatePaymentScheduleTerms操作AWS Marketplace Catalog API。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅。使用变更集

错误代码 错误消息
不兼容条款 OffersMaxQuantity 并且 AvailabilityEndDate 必须随身携带 ResalePaymentScheduleTerm。
计划付款太多了 提供多达 60 笔定期付款 ResalePaymentScheduleTerm。
重复充电日期 在中提供唯一的收费日期 ResalePaymentScheduleTerm。
无效的收费日期 提供未来 ChargeDate。
无效的收费日期 请提供在 [x] 之前的最后一次充电日期。
缺少强制性条款 ResalePaymentScheduleTerm 一起提供 a ResaleFixedUpfrontPricingTerm 和。
无效的货币代码 CurrencyCode 所有定价和付款条件均相同。
不兼容的付款设置 更新您的付款设置以使其与兼容 CurrencyCode。
不兼容卖家验证 完成所有必需的卖家验证流程。
无效的货币代码 提供支持的 CurrencyCode。
无效的货币代码 CurrencyCode 所有定价和付款条件均相同。
不兼容的货币代码 CurrencyCode 优惠发布后无法更改。

更新转售授权详情

您可以使用目录 API 更新中的转售授权详细信息。AWS Marketplace

要更新转售授权详细信息，请使用UpdateInformation更改类型调用 StartChangeSet API 操作，如以下示例所示。

注意

UpdateInformation变更类型仅更新请求中提供的部分；所有其他信息保持不变。

请求语法

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更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（object）（必填）-请求的详细信息，包括您要更新转售授权信息的信息。

    • 名称（字符串）（可选）— 与之关联的 ResaleAuthorization 名称，以便您和您的渠道合作伙伴更容易阅读。

    • 描述（字符串）（可选）-描述为自由格式文本，您可以在其中添加有关该的 ResaleAuthorization详细信息。

    • PreExistingBuyerAgreement（object）（可选）— 确定此优惠是否为与现有客户签订的相同基础产品的现有协议的续订。现有协议可以是内部协议，也可以是外部协议AWS Marketplace。 AWS可能会审核并确认您的报价是否为续订。AWS如果无法验证您的报价，则AWS可以撤销客户的报价和权利。

      • AcquisitionChannel（字符串）（必填）— 表示现有买家协议是在外部AWS Marketplace还是内部签署AWS Marketplace。

        可能的值：External、AwsMarketplace

      • PricingModel（字符串）（必填）— 表示退出协议使用哪种定价模式。

        可能的值：Contract、Usage、BYOL、Free

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括验证信息以确保其符合AWS Marketplace准则。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

以下架构验证特定于中的UpdateInformationAWS Marketplace Catalog API操作。这些验证是在您调用时执行的StartChangeSet，如果输入不符合以下要求，则请求将失败并出现 HTTP 错误。

输入字段 验证规则 HTTP 代码
Name

可选

不能为空或为空

长度必须介于 1 到 100 个字符之间

模式 ^ [A-Za-z0-9] *$

不允许使用特殊字符或空格

 422
说明

可选

长度必须介于 1 到 255 个字符之间

模式 ^ [A-Za-z0-9\\ s] *$

不允许使用特殊字符

 422
一个未知的财产 不允许使用其他属性 422

异步错误

以下错误特定于中的UpdateInformation操作AWS Marketplace Catalog API。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅。使用变更集

错误代码 错误消息
不兼容的买家定位 必须至少有一个买家账户 PreExistingBuyerAgreement。 ResaleAuthorization

限制转售授权

您可以使用目录 API 在中为转售授权设置限制规则。AWS Marketplace

渠道合作伙伴不能再使用受限制的转售授权来创建私人报价。现有的私募报价不会受到影响。

要限制您的转售授权，请使用RestrictResaleAuthorization更改类型调用 StartChangeSet API 操作，如以下示例所示。

重要

这是不可逆的操作。转售授权标记为后Restricted，就不能再处于Active状态。

请求语法

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

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

为要添加RestrictResaleAuthorization更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。它必须是一个空对象RestrictResaleAuthorization。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括验证信息以确保其符合AWS Marketplace准则。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

架构验证特定于 AWS Marketplace Catalog API 中的RestrictResaleAuthorization操作。这些验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则 HTTP 代码
DetailsDocument 必须为空 422
RestrictResaleAuthorization

ResaleAuthorization 无法将已过期标记为 Restricted

 422
一个未知的财产 不允许使用其他属性 422

异步错误

以下错误特定于中的RestrictResaleAuthorization操作AWS Marketplace Catalog API。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多信息，请参阅。使用变更集

错误代码 错误消息
不兼容状态 已过期 ResaleAuthorization 不能标记为受限。

发布转售授权并向渠道合作伙伴公开

您可以使用目录 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更改类型的字段提供信息：

  • 实体（对象）（必填）-您的转售授权。

    • 类型（字符串）（必填）-始终Type为ResaleAuthorization@1.0。

    • 标识符（字符串）（必填）-您的转售授权 ID。有关更多信息，请参阅 标识符。

  • DetailsDocument（对象）（必填）-请求的细节。必须为空ReleaseResaleAuthorization。

响应语法

已根据您的请求创建更改集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

变更请求被添加到队列中并进行处理。这包括验证信息以确保其符合AWS Marketplace准则。验证过程可能需要几分钟到几小时不等。

您可以通过，也可以使用 API 操作直接通过 Catalog API 检查请求的DescribeChangeSet状态。AWS Marketplace 管理门户

同步验证

架构验证特定于中的ReleaseResaleAuthorizationAWS Marketplace Catalog API操作。验证是在您致电StartChangeSet时执行的。如果请求不符合以下要求，它将失败并显示 HTTP 响应。

输入字段 验证规则 HTTP 代码
一个未知的财产 不允许使用其他属性 422

异步错误

以下错误特定于中的ReleaseResaleAuthorization操作AWS Marketplace Catalog API。当您在处理更改集DescribeChangeSet之后调用时，会返回这些错误。有关使用DescribeChangeSet获取变更请求状态的更多详细信息，请参阅使用变更集。

错误代码 错误消息
缺少强制性条款 提供一个 BuyerLegalTerm.
缺少强制性条款 提供一个 PricingTerm.
不兼容的产品 在有限状态或公共状态下使用有效产品。
不兼容的定价条款 PaymentScheduleTerm 并且 FixedUpfrontPricingTerm 必须一起出席。
不兼容的买家定位 必须至少有一个买家账户 PreExistingBuyerAgreement。 ResaleAuthorization
缺少强制性条款 至少提供 [x, y, z] 中的一个。
不兼容状态 [x] 在发布转售授权后无法执行。

描述现有的转售授权

要描述转售授权的详细信息，请使用ResaleAuthorization@1.0实体类型调用 DescribeEntity API 操作，如以下示例所示。

请求语法

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

为要添加DescribeEntity更改类型的字段提供信息：

  • 目录（字符串）-与请求相关的目录。固定值:AWSMarketplace.

  • E@@ ntityId（字符串）-ResaleAuthorization 要描述的的唯一 ID。

响应语法

对该请求的回复将为您提供报价详情，如下所示。

{
  "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响应中看到的字段的相关信息。

  • EntityType（字符串）-实体的命名类型，即 ResaleAuthorization @1 .0。

  • EntityIdentifier（字符串）-实体的标识符，格式为 EntityId @ RevisionId。

  • EntityArn（字符串）-与此请求中引用的更改集的唯一标识符关联的 ARN。

  • LastModifiedDate（字符串）— 实体的最后修改日期，采用 ISO 8601 格式（2018-0 T13:45:22Z 2-27）。

  • DetailsDocument（对象）（必填）-此 JSON 字符串包含实体的详细信息。

    • 名称（字符串）-与之关联的 ResaleAuthorization 名称，以便您和您的渠道合作伙伴更容易阅读。它作为协议信息的一部分显示。

    • 描述（字符串）-描述是一种自由格式的文本，仅供您使用，永远不会向买家公开。

    • ProductId（字符串）— 描述是一种自由格式的文本，仅供您使用，永远不会向买家公开。

    • AgreementToken（字符串）-从中的内容生成 ResaleAuthorization。它包含有关创建协议时的条款、规则和提案人的信息。它用于采购期间的授权检查和验证。

    • 条款（结构数组）-提交供接受的术语列表。

    • 规则（结构数组）-规则列表或指令集。