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

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

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

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

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

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

调用变更类型的先决条件是，您必须已收到一份或多份转售授权并且熟悉使用。 AWS Marketplace Catalog API

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

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

CPPO 先决条件

Service-linked 角色for 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"
}

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

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

对该请求的回复将向您提供请求的状态。如果状态为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获取变更请求状态的更多信息，请参阅使用变更集。

创建渠道合作伙伴私下替换报价

您可以使用 Catalog API 在中创建渠道合作伙伴私有替代报价 AWS Marketplace。

您可以使用ResaleAuthorization针对您的内容和您作为提案人的协议通过调用CreateReplacementOfferUsingResaleAuthorization变更类型来创建目录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"
}

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

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

同步验证

以下架构验证特定于中的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 指南。验证过程可能需要几分钟到几小时不等。

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

同步验证

以下架构验证特定于中的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 准则。验证过程可能需要几分钟到几小时不等。

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

同步验证

以下架构验证特定于中的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 指南。验证过程可能需要几分钟到几小时不等。您可以通过或在目录 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 准则。验证过程可能需要几分钟到几小时不等。

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

同步验证

以下架构验证特定于中的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 准则。验证过程可能需要几分钟到几小时不等。

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

同步验证

以下架构验证特定于中的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 准则。验证过程可能需要几分钟到几小时不等。

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

同步验证

以下架构验证特定于中的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 准则。验证过程可能需要几分钟到几小时不等。

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

同步验证

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

异步错误

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

发布 CPPO

您可以使用 Catalog 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 准则。验证过程可能需要几分钟到几小时不等。

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

同步验证

以下架构验证特定于中的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响应的输入字段提供信息：