对 AWS Marketplace API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 AWS 市场 API 参考。

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

使用渠道合作伙伴的私人优惠 AWS Marketplace API

您可以使用自动执行渠道合作伙伴私人优惠 (CPPO) 的任务。 AWS Marketplace Catalog API

当您创建或更新 CPPO 时，报价草稿将包含转售授权中的条款和规则，买家看不见。在组织中加入多个角色来创建私人报价是可能的，但不是必需的。

例如，一个角色可以负责更新价格，而另一个角色可以负责更新付款时间表。然后，第三方可以负责更新法律条款。您可以向角色授予更新优惠某些部分的权限。但是，您只能向转售授权授予读取权限。

作为调用变更类型的先决条件，您必须获得一项或多项转售授权并熟悉使用方法。 AWS Marketplace Catalog API

有关更多信息，请参阅《AWS Marketplace 卖家指南》中的渠道合作伙伴私人优惠。

以下主题介绍如何使用目录 API 来创建和更新 cpPO：

CPPO 的先决条件

Service-linked 角色设置 ResaleAuthorization (SLR) 是使用转售授权创建 CPPO 的必备先决条件。要使用转售授权，独立软件供应商 (ISV) 和 AWS Marketplace 渠道合作伙伴都必须创建服务相关角色，为提供资源共享权限。 AWS如果两个小组都不执行此先决条件，则 AWS 无法将授权资源从 ISV 共享给 AWS Marketplace 渠道合作伙伴。有关更多信息，请参阅《AWS Marketplace 卖家指南》 AWS Marketplace中的使用角色进行转售授权。

创建 CPPO

您使用针对您的转售授权在Draft州内创建渠道合作伙伴私人报价 (CPPO)。 AWS Marketplace

如果您的请求成功处理，则会根据转售授权条款为您 AWS Marketplace Catalog API 生成Draft州内报价。您可以使用DescribeEntity转售授权中查看适用于报价草稿的条款。这是一份不完整的报价，买家看不到 AWS Marketplace。然后，您可以使用与 CPPO 相关的变更类型来完成报价。

报价完成后，您可以使用ReleaseOffer更改类型来完成报价创建流程并发布报价。这将验证整个报价，让买家看到您的报价 AWS Marketplace。

要创建渠道合作伙伴私有报价，请调用CreateOfferUsingResaleAuthorization变更类型StartChangeSet的 API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "resaleauthz-123456789",
        "Name": "Test Offer",
        "OfferSetId": "offerset-b3f9EXAMPLE27"
      }
    }
  ]
}

为字段提供信息以添加CreateOfferUsingResaleAuthorization更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

对该请求的响应会向您提供请求的状态。如果状态为SUCCEEDED，则会生成一个新OfferId的。

{
  "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": "CreateOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "resaleauthz-123456789",
        "Name": "Test Offer"
      },
      "ErrorDetailList": []
    }
  ]
}

您可以使用该GETDescribeEntity请求来描述 AWS Marketplace Catalog API 参考资料ResaleAuthorization中创建的报价规则和条款草案。有关更多信息，请参阅 DescribeChangeSet。

条款和规则来自 ResaleAuthorization

{
  "EntityType": "Offer@1.0",
  "EntityIdentifier": "offer-a5EXAMPLEwzpu@1",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:444555666777:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "DetailsDocument": {
    "Id": "offer-3rb23tu92rn",
    "Name": "Test Offer",
    "Description": "Worldwide private offer for Test Product",
    "ProductId": "prod-0bc848d78b51",
    "ResaleAuthorizationId": "resaleauthz-123456789",
    "Terms": [
      {
        "Type": "LegalTerm",
        "Documents": [
          {
            "Type": "CustomEula",
            "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
          }
        ]
      },
      {
        "Type": "ConfigurableUpfrontPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P12M"
            },
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "300.00"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "400.00"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "UsageBasedPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "0.10"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "0.20"
              }
            ]
          }
        ]
      },
      {
        "Type": "PaymentScheduleTerm",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2020-12-01T00:00:00.000Z",
            "ChargeAmount": "1000.00"
          },
          {
            "ChargeDate": "2021-06-15T00:00:00.000Z",
            "ChargeAmount": "1250.00"
          }
        ]
      }
    ],
    "Rules": [
      {
        "Type": "TargetingRule",
        "PositiveTargeting": {
          "BuyerAccounts": [
            "111222333444"
          ]
        }
      }
    ]
  }
}

同步验证

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

异步错误

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

创建渠道合作伙伴私人替换优惠

您可以使用目录 API 在中创建渠道合作伙伴的私人替换优惠 AWS Marketplace。

您使用ResaleAuthorization针对您的和您作为提案人的协议，通过调用CreateReplacementOfferUsingResaleAuthorization变更类型，在 Catalog API 中创建Draft处于状态的渠道合作伙伴私StartChangeSet有替代报价，如以下示例所示。替换优惠可用于在之前的报价到期之前取代协议。

CreateReplacementOfferUsingResaleAuthorization将与协议接受者一起制定报价草案，确定目标。此后无法更改此目标。报价草案还将包含协议的来源报价 ID。

要创建渠道合作伙伴私有替换优惠，请调用CreateReplacementOfferUsingResaleAuthorization变更类型StartChangeSet的 API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateReplacementOfferUsingResaleAuthorization",
      "Entity": {
        "Type": "Offer@1.0"
      },
      "DetailsDocument": {
        "ResaleAuthorizationId": "2bd2c761-3b7f-3771-a9a7-e8ad36517698",
        "Name": "CAPI-saas-abo-contract-fps",
        "AgreementId": "agmt-f2ooEXAMLEamtm7mjj0j59gu"
      }
    }
  ]
}

为字段提供信息以添加CreateReplacementOfferUsingResaleAuthorization更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

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

异步错误

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

更新标记

您可以使用目录 API 按报价中的百分比值更新定价条款 AWS Marketplace。

这将对制造商在中定义的所有定价条款和付款条件（用于未来的付款计划）应用给定的百分比加价。 ResaleAuthorization任何现有标记都将被覆盖。您可以使用查看更新的定价和付款条款DescribeEntity。

要更新标记，请使用UpdateMarkup更改类型调用 StartChangeSet API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateMarkup",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Percentage": "5.0"
      }
    }
  ]
}

为字段提供信息以添加UpdateMarkup更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

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

异步错误

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

更新定位配置

您可以使用目录 API 完全替换中的现有定位配置 AWS Marketplace。

未包含在最新请求中的任何现有定位选项都将从报价中移除。制造商可以在中提及特定的目标买家ResaleAuthorization。渠道合作伙伴可以在UpdateTargeting变更类型PositiveTargeting中向一部分买家提供私人报价。

要更新报价的定位配置，请调用UpdateTargeting变更类型StartChangeSet的 API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateTargeting",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "PositiveTargeting": {
          "CountryCodes": [
            "US",
            "CA"
          ],
          "BuyerAccounts": [
            "111222333444"
          ]
        },
        "NegativeTargeting": {
          "CountryCodes": [
            "XX"
          ]
        }
      }
    }
  ]
}

为字段提供信息以添加UpdateTargeting更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

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

异步错误

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

更新法律资源

您可以使用目录 API 合并转售授权法律条款，并在中 AWS Marketplace完全替换现有的法律条款。

此变更不影响现有协议。最新申请中未包含的法律条款将从优惠中删除。您可以致电查看合并的法律条款DescribeEntity。

要更新报价的法律条款，请调用UpdateLegalTerms变更类型StartChangeSet的 API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateLegalTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "LegalTerm",
            "Documents": [
              {
                "Type": "CustomEula",
                "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
              }
            ]
          }
        ]
      }
    }
  ]
}

为字段提供信息以添加UpdateLegalTerms更改类型：

系统会为您的请求创建变更集。对该请求的响应会为您提供变更集的 ID。

响应语法

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

变更请求将添加到队列中并进行处理。这包括向 AWS Marketplace 卖家运营团队验证信息，以确保其符合 AWS Marketplace 指南。验证过程可能需要几分钟到几小时不等。您可以通过或在 Catalog API 中使用DescribeChangeSet操作检查请求的状态。 AWS Marketplace 管理门户

同步验证

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

异步错误

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

更新 CPPO 的可发现性

您可以使用目录 API 来管理您的报价在中的 AWS Marketplace可见性。这种变更类型不会影响现有协议。

您可以选择将来的特定日期设置为限制报价的可曝光度，也可以选择在过去将报价过期。

要管理报价的可发现性，请调用UpdateAvailability变更类型StartChangeSet的 API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateAvailability",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "AvailabilityEndDate": "2024-05-31"
      }
    }
  ]
}

为字段提供信息以添加UpdateAvailability更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

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

异步错误

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

定义协议的到期日期

您可以使用目录 API 来定义在中使用此优惠创建的协议的到期日期 AWS Marketplace。

此更改不影响现有协议。制造商可以在转售授权中提及协议的最大起始日期。但是，渠道合作伙伴不能提供晚于该日期的协议开始日期。

要定义协议的到期日期，请使用UpdateValidityTerms更改类型调用 StartChangeSet API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateValidityTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "ValidityTerm",
            "AgreementDuration": "P12M",
            "AgreementStartDate": "2021-08-01",
            "AgreementEndDate": "2022-08-01"
          }
        ]
      }
    }
  ]
}

为字段提供信息以添加UpdateValidityTerms更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

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

异步错误

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

更新定价

您可以使用目录 API 完全替换现有定价条款。

最新请求中未包含的定价条款将从报价中删除。渠道合作伙伴只能使用这种变更类型来通过FixedUpFrontPricingTerm。

要更新报价的定价条款，请调用UpdatePricingTerms变更类型StartChangeSet的 API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdatePricingTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "Details": {
        "PricingModel": "Contract",
        "Terms": [
          {
            "Type": "FixedUpfrontPricingTerm",
            "CurrencyCode": "USD",
            "Price": "200.00",
            "Duration": "P465D",
            "Grants": [
              {
                "DimensionKey": "Users",
                "MaxQuantity": 10
              }
            ]
          }
        ]
      }
    }
  ]
}

为字段提供信息以添加UpdatePricingTerms更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

以下架构验证特定于中的UpdatePricingTerms AWS Marketplace Catalog API操作。这些验证是在您致电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": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "PaymentScheduleTerm",
            "Schedule": [
              {
                "ChargeDate": "2021-12-01",
                "ChargeAmount": "200.00"
              },
              {
                "ChargeDate": "2022-03-01",
                "ChargeAmount": "250.00"
              }
            ]
          }
        ]
      }
    }
  ]
}

为字段提供信息以添加UpdatePaymentScheduleTerms更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

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

异步错误

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

更新净付款条款

如果您用于创建渠道合作伙伴私人报价 (CPPO) 的转售授权包含净付款期限，则该期限是您可以向买家提供的最长期限。当您创建 CPPO 时，转售授权中的术语将自动应用于您的 CPPO。

要为买家提供比卖家授权的更短的付款期限，请使用报价的UpdateNetPaymentTerms更改类型调用 StartChangeSet API 操作，如以下示例所示。如果您想使用卖家授权的相同期限，则无需致电UpdateNetPaymentTerms。

如果转售授权不包含净付款期限，则您无法在 CPPO 中添加净付款期限，而买家的付款条款也不能适用。 AWS 当转售授权包含净付款期限时，您也无法从 CPPO 中删除净付款期限。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateNetPaymentTerms",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {
        "Terms": [
          {
            "Type": "NetPaymentTerm",
            "PaymentDuePeriod": "P30D"
          }
        ]
      }
    }
  ]
}

为字段提供信息以添加UpdateNetPaymentTerms更改类型：

同步验证

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

异步错误

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

发布 CPPO

您可以使用目录 API 合并从所有更新变更类型收集的信息，然后在中发布报价 AWS Marketplace。

在发出通知之前，Draft报价将保持ReleaseOffer不变。优惠发布后，可以在中 AWS Marketplace找到。

要发布您的报价，请使用ReleaseOffer更改类型调用 StartChangeSet API 操作，如以下示例所示。

请求语法

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

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseOffer",
      "Entity": {
        "Type": "Offer@1.0",
        "Identifier": "offer-123456789"
      },
      "DetailsDocument": {}
    }
  ]
}

为字段提供信息以添加ReleaseOffer更改类型：

响应语法

系统会为您的请求创建变更集。对该请求的响应为您提供了变更集的和，如下所示。ChangeSetId ChangeSetArn

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

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

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

同步验证

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

异步错误

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

定义现有的 CPPO

您可以使用目录 API 在中定义 CPPO 详细信息。 AWS Marketplace

要定义现有 CPPO，请使用Offer@1.0实体类型调用 DescribeEntity API 操作，如以下示例所示。

请求语法

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

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

响应语法

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

{
  "EntityType": "Offer@1.0",
  "EntityIdentifier": "offer-a5oEXAMPLEzpu@1",
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:446235747164:AWSMarketplace/Offer/offer-a5oEXAMPLEzpu",
  "LastModifiedDate": "2021-03-10T21:57:16Z",
  "Details": {
    "Id": "offer-3rEXAMPLErn",
    "State": "Released",
    "Name": "Test Offer",
    "Description": "Worldwide private offer for Test Product",
    "PreExistingAgreement": {
      "AcquisitionChannel": "External",
      "PricingModel": "Contract"
    },
    "ProductId": "prod-0bEXAMPLEb51",
    "ResaleAuthorizationId": "resaleauthz-123456789",
    "MarkupPercentage": "5.0",
    "Terms": [
      {
        "Type": "LegalTerm",
        "Documents": [
          {
            "Type": "CustomEula",
            "Url": "https://s3.amazonaws.com/EULA/custom-eula-1234.txt"
          }
        ]
      },
      {
        "Type": "ConfigurableUpfrontPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "Selector": {
              "Type": "Duration",
              "Value": "P12M"
            },
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "300.00"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "400.00"
              }
            ],
            "Constraints": {
              "MultipleDimensionSelection": "Allowed",
              "QuantityConfiguration": "Allowed"
            }
          }
        ]
      },
      {
        "Type": "UsageBasedPricingTerm",
        "CurrencyCode": "USD",
        "RateCards": [
          {
            "RateCard": [
              {
                "DimensionKey": "m3.large",
                "Price": "0.10"
              },
              {
                "DimensionKey": "m4.xlarge",
                "Price": "0.20"
              }
            ]
          }
        ]
      },
      {
        "Type": "PaymentScheduleTerm",
        "CurrencyCode": "USD",
        "Schedule": [
          {
            "ChargeDate": "2020-12-01T00:00:00Z",
            "ChargeAmount": "1000.00"
          },
          {
            "ChargeDate": "2021-06-15T00:00:00Z",
            "ChargeAmount": "1250.00"
          }
        ]
      }
    ],
    "Rules": [
      {
        "Type": "TargetingRule",
        "PositiveTargeting": {
          "CountryCodes": [
            "US",
            "CA"
          ],
          "BuyerAccounts": [
            "118033953248"
          ]
        },
        "NegativeTargeting": {
          "CountryCodes": [
            "XX"
          ]
        }
      },
      {
        "Type": "AvailabilityRule",
        "AvailabilityEndDate": "2050-08-30T01:56:03Z"
      }
    ]
  }
}

为DescribeEntity响应的输入字段提供信息：