本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS Marketplace 上的 SaaS 产品入门
AWS Marketplace 卖家可以将软件即服务（SaaS）产品添加到 AWS Marketplace。这包括根据 SaaS 产品的计费模式将其与相应的 AWS Marketplace API 操作集成。本主题概述了创建和配置 SaaS 产品的过程，从开始着手操作所需的必要先决条件开始介绍。
## 先决条件
在开始之前，您必须满足以下先决条件：
1. 访问和使用 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/)。您可以使用此工具注册为卖家，然后管理在 AWS Marketplace 上销售的产品。有关更多信息，请参阅[AWS Marketplace 管理门户](user-guide-for-sellers.md#aws-marketplace-management-portal)。
1. 注册为卖家并提交您的税务和银行信息。有关更多信息，请参阅 [注册过程](registration-process.md)。
1. 规划如何在 AWS Marketplace 中创建和集成 SaaS 产品。有关更多信息，请参阅 [规划您的 SaaS 产品](saas-prepare.md)。
## 后续步骤
完成所需的先决条件后，您就可以创建和配置 SaaS 产品。
**Topics**
+ [先决条件](#saas-prereqs)
+ [后续步骤](#saas-next-steps)
+ [AWS Marketplace 中的 SaaS 产品生命周期](saas-product-lifecycle.md)
+ [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)
+ [在上创建初始 SaaS 产品页面 AWS Marketplace](saas-create-product-page.md)
+ [在中配置 SaaS 产品设置 AWS Marketplace](saas-product-settings.md)
+ [将您的 SaaS 订阅或 Pay-As-You-Go产品与 AWS Marketplace](saas-integrate-subscription.md)
+ [将你的 SaaS 合同产品与 AWS Marketplace](saas-integrate-contract.md)
+ [将基于合同的 SaaS 产品与 AWS Marketplace](saas-integrate-contract-with-pay.md)
+ [部署无服务器 SaaS 集成](deploy-serverless-saas.md)
# AWS Marketplace 中的 SaaS 产品生命周期
当您在 AWS Marketplace 中创建软件即服务（SaaS）产品时，该产品最初受限发布，因此只有您的账户才能访问它。准备就绪后，您可以将其发布到 AWS Marketplace 目录中，以允许买家订阅和购买您的产品。以下主题提供了有关 SaaS 产品生命周期的信息。有关创建 SaaS 产品的更多信息，请参阅 [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。
在 SaaS 产品页面上，您可以查看您的产品列表。根据其在产品生命周期中的阶段，产品将具有以下状态之一：
+ **暂存** – 未完成的产品，您仍在为其添加信息。在第一次**保存并退出**自助服务体验时，成功的变更请求会使用您提交的完成步骤中的信息创建未发布的产品。在此状态下，您可以继续向产品添加信息或通过变更请求更改已提交的详细信息。
+ **受限** – 产品在提交给系统并通过系统中的所有验证后即已完成。然后，产品将发布到**受限**状态。此时，该产品有一个详细信息页面，只有您的账户和您列入允许列表的人才能访问该页面。您可以通过详细信息页面测试您的产品。如需更多信息或帮助，请联系 [AWS Marketplace 卖家运营](https://aws.amazon.com/marketplace/management/contact-us/)团队。
+ **公开** – 当您准备发布产品以便买家可以查看和订阅产品时，您可以使用**更新可见性**更改请求。此请求将启动AWS Marketplace 卖家运营团队根据 AWS 策略审查和审核您的产品的工作流程。产品获得批准并处理变更请求后，产品将从**受限**状态更改为**公开**。有关 AWS准则的信息，请参阅 [SaaS 产品准则](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html)。
+ **受限** – 果您想阻止新用户订阅您的产品，则可以使用**更新可见性**更改请求来限制该产品。**受限**状态表示现有用户可以继续使用该产品。但是，该产品将不再对公众可见，也不会再向新用户提供。
您可以在**暂存**、**受限**和**公开**状态下更新您的产品。有关更多信息，请参阅[更新产品信息](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-product-settings.html#update-product-information)。
# 在中创建 SaaS 产品 AWS Marketplace
作为 AWS Marketplace 卖家，您可以将软件即服务 (SaaS) 产品添加到 AWS Marketplace。这包括根据您的计费模式创建您的 SaaS 产品并将其与相应的 AWS Marketplace API 操作集成。要将软件作为 SaaS 产品进行销售 AWS Marketplace，请遵循以下主要步骤：
+ 在中创建 SaaS 产品 AWS Marketplace。
+ 将 SaaS [订阅](saas-integrate-subscription.md)、[合同](saas-integrate-contract.md)或[合同与 pay-as-you-go](saas-integrate-contract-with-pay.md)产品集成 AWS Marketplace。
+ 测试 pay-as-you-go产品[与集成的[订阅](saas-integrate-subscription.md#saas-subscription-integration-testing)、[合同](saas-integrate-contract.md#saas-contract-integration-testing)](saas-integrate-contract-with-pay.md#saas-contract-consumption-integration-testing)或合同 AWS Marketplace。
+ 提交产品以完成发布。
以下过程向您展示了如何在中创建 SaaS 产品 AWS Marketplace。
## 创建 SaaS 产品
**要创建 SaaS 产品，请执行以下操作：**
1. **决定上架一款 SaaS 产品**
有一款你想销售的 SaaS 产品 AWS Marketplace。查看并了解如何[规划您的 SaaS 产品](saas-prepare.md)。
1. **确定定价和优惠类型**
SaaS 产品有三种优惠类型：订阅、合同和合同 pay-as-you-go。您选择的优惠类型会影响您的 SaaS 产品与集成的方式 AWS Marketplace。有关更多信息，请参阅 [规划您的定价](saas-prepare.md#plan-pricing)。
1. **收集资产**
收集所需的资产以提交产品。资产包括：
+ 产品徽标 URL – 一个可公开访问的 Amazon S3 URL，其中包含您提供的产品徽标的清晰图像。
+ 最终用户许可协议 (EULA) URL – 您的产品必须具有以 PDF 文件形式提供的 EULA。您必须提供指向 Amazon S3 存储桶的链接，客户可以在您的产品 AWS Marketplace 页面上查看 EULA。
+ 产品注册 URL – 这是买家在 AWS Marketplace中成功订阅您的产品后被重定向的 URL。
+ 有关产品的元数据 – 您在 AWS Marketplace 管理门户的产品创建向导中提供元数据。
+ 产品的支持信息-此信息包括电子邮件地址和 URLs 产品支持渠道。
1. **提交您的产品进行集成**
使用您的卖家账户 AWS Marketplace 和管理门户[在上创建初始 SaaS 产品页面 AWS Marketplace](saas-create-product-page.md)。 AWS Marketplace 会将您的产品作为限量产品发布，这意味着它只能用于集成和测试。您的产品代码和 Amazon EventBridge 事件配置将在产品概述页面上提供。
**注意**
您的商品必须保持较低的价格，这样您和 AWS Marketplace 卖家运营团队就可以在不产生高额成本的情况下测试您的商品。当您请求公开产品时，我们会要求您提供产品的实际价格。
1. **与集成 AWS Marketplace**
您的产品必须支持客户载入和使用您的产品，包括在向他们提供访问权限之前验证他们的订阅，在某些情况下，还要计量他们的用量。您的集成方式 AWS Marketplace 取决于您为产品使用的优惠类型。有关集成的更多信息（基于优惠类型），请参阅以下主题：
+ [订阅集成](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-integrate-subscription.html)
+ [合同集成](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-integrate-contract.html)
+ [ pay-as-you-go集成合同](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-integrate-contract-with-pay.html)
将您的产品与集成的最后一步 AWS Marketplace 是对其进行测试，以确保集成工作正常。
1. **产品测试和合同取消**
完成集成过程后，我们建议您订阅自己的产品以评估和确认客户体验。通过创建测试订阅，您可以：
+ 查看产品信息
+ 检查可用的购买选项
+ 处理测试付款
+ 验证指向您自己的产品网站的链接
**重要**
按照取消 [SaaS pay-as-you-go 订阅中的说明取消您的订阅，然后再将产品的知名度从限定](https://docs.aws.amazon.com/marketplace/latest/buyerguide/cancel-subscription.html#cancel-saas-subscription)更改为公开。要取消合同，请[提交支持工单](https://aws.amazon.com/marketplace/management/contact-us/)，联系 AWS Marketplace 卖家运营团队。
1. **提交您的产品以供发布**
验证集成并准备好让产品上线后，选择**更新可见性**。 AWS Marketplace 卖家运营团队将审查您的产品并更新价格，然后才能将可见性更新为公开。
**注意**
AWS Marketplace 卖家运营部门使用手动流程来验证和更新 SaaS 产品。将可见性更改为公开状态的过程需要 7-10 个工作日，如果团队发现错误，则需要更长时间。有关时间的更多信息，请参阅本指南中的[时间和预期](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#timing-and-expectations)。
# 在上创建初始 SaaS 产品页面 AWS Marketplace
您可以使用，使用软件即服务 (SaaS) 应用程序元数据在 AWS Marketplace 目录中创建初始 SaaS 产品页面 AWS Marketplace 管理门户。然后，您可以添加产品信息、产品部署详细信息和公开优惠详细信息。您可以选择将账户添加到允许列表中以测试产品。有关更多信息，请参阅以下步骤。
**要创建初始 SaaS 产品页面，请执行以下操作：**
1. 登录到 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/homepage)。
1. 选择**创建 SaaS 产品**，然后选择 **SaaS 产品**。
1. 生成 SaaS 产品 ID 和代码。您也可以添加可选标签以支持基于标签的授权。
**注意**
有关基于标签的授权的信息，请参阅《*AWS Identity and Access Management 用户指南》*中的[使用标签控制对 AWS 资源的访问权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)。
1. 使用自助服务体验创建 AWS Marketplace 房源。添加产品信息、产品部署详细信息和公开优惠详情。或者，您可以将账户添加到允许列表中以测试产品。
**注意**
如果您需要在完成步骤之前结束会话，请选择**保存并退出**选项，将您当前的选择保存到暂存区域。此选项会创建验证您提供的信息的请求。验证您的请求期间，您无法编辑产品。如果您的请求成功，则可以通过选择**恢复产品创建**来继续创建产品。
如果您的请求失败，则是由于验证错误所致，该错误可在产品请求日志中看到。选择查看错误的请求，然后从**操作**下选择**复制到新的**来更正错误，然后重新提交请求。要更新之前的步骤，请打开产品详细信息页面并提交更改请求。
**注意**
对于使用非免费定价模式（合同、使用或带消费的合同）的产品，在测试期间，您的价格将默认为每个维度 0.001 美元。这个价格允许您在**受限**状态下测试您的产品，而不会产生大笔账单。对于使用免费定价模式的商品，尺寸将默认为 0.00 美元。对于非免费定价模式，您将在公开产品时提供实际价格。请注意，如果所有尺寸都设置为 0.00 美元，则产品将自动转换为免费定价模式。
1. 选择**提交**。然后， AWS Marketplace 验证信息。如果验证成功，则以 “**受限**” 状态 AWS Marketplace 发布产品。验证成功后，您可以预览、集成和测试您的产品。
**注意**
验证过程中，您无法编辑产品。当您的商品最初发布 AWS 账户 时，只有创建商品的用户和 AWS Marketplace 卖家运营团队的测试账户才能访问该商品。如果您从 **SaaS 产品页面查看产品**，则可以选择**查看开启 AWS Marketplace**以查看产品详情，因为它们将显示在 AWS Marketplace 买家面前。其他 AWS Marketplace 用户看不到此详细信息列表。
# 在中配置 SaaS 产品设置 AWS Marketplace
在中[创建软件即服务 (SaaS) 产品](saas-create-product.md)后 AWS Marketplace，您可以修改许多产品设置。以下各节介绍了如何提交更改请求和修改产品设置，例如更新定价详情、产品可见性和其他设置。
**Topics**
+ [管理更改请求](#create-change-request)
+ [更新产品信息](#update-product-information)
+ [更新架构细节](#updating-architecture-details)
+ [更新允许名单 AWS 账户 IDs](#update-allowlist)
+ [更新产品知名度](#saas-update-visibility)
+ [更新定价条款](#saas-update-pricing-terms)
+ [添加定价维度](#saas-add-pricing-dimensions)
+ [更新定价维度](#saas-update-dimension)
+ [限制定价维度](#restrict-pricing-dimensions)
+ [确定买家将如何访问您的产品](#configure-product-access)
+ [配置快速启动](#saas-quick-launch)
+ [按国家/地区更新可用性](#saas-availability-by-country)
+ [更新产品的退款政策](#update-refund-policy)
+ [更新最终用户许可协议 (EULA)](#saas-update-eula)
## 管理更改请求
在[自助服务列表](saas-create-product.md#saas-creating-self-service)中，您可以使用*更改请求*对产品进行更改。您当前的请求可以在[**请求**选项卡 AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management/requests)上找到。您可以通过导航栏下方的**请求更改**下拉列表提出新的请求。
**要为 SaaS 产品创建更改请求，请执行以下操作：**
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在**产品**选项卡中，从下拉列表中选择 **SaaS**。
1. 提交请求后，就会开始处理。变更请求将处于以下状态：**审核中**、**正在准备更改**和**正在应用更改**。
1. 请求的处理完成后，其状态将更改为以下值之一：
+ **成功** - 此状态表示您请求的更改已处理并且更改已反映在系统中。
+ **失败** - 此状态表示请求出现点问题，更改未得到处理。如果状态为**失败**，您可以选择请求以查找**错误代码**，这些错误代码提供了有关如何更正问题的建议。您可以对错误进行故障排除，并创建新的更改请求。为了加快处理速度，您可以使用**复制到新请求**功能来复制**失败**请求的详细信息。您可以进行必要的更改并重新提交请求。
以更新开头的更改请求将加载项目的当前详细信息。然后，您可以进行更新，从而覆盖现有的详细信息。添加和限制请求对专门用于在每次请求成功后预置的更新（在自助服务体验中选择**保存并退出**和**提交**操作之后）。也就是说，现有订阅用户可以继续使用该产品，直到他们的订阅或合同到期。但是，不能向处于**受限**状态的产品添加新的订阅用户。
## 更新产品信息
创建产品后，您可能需要在 AWS Marketplace中更改与其关联的信息。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)页面的 **SaaS 产品**选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新产品信息**。
1. 更新以下任何您想要更改的字段：
+ **产品标题**
+ **SKU**
+ **简短描述**
+ **详细描述**
+ **产品徽标 URL**
+ **要点**
+ **产品类别**
+ **关键词**
+ **产品视频 URL**
+ **资源**
+ **支持信息**
**注意**
有关徽标格式的详细信息，请参阅[公司和产品徽标要求](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos)。
1. 要更新产品信息，请选择**提交**。
1. 验证请求是否显示在**请求**选项卡上，状态为**正在审核**。您可能需要刷新页面才能看到您的新请求。
## 更新架构细节
要获得部署产品的特殊名称，请通过选择托管模式并上传架构图，在 AWS Marketplace 管理门户 (AMMP) 中更新产品的架构详细信息。 AWS有关 AWS 考虑在上部署的主机模式列表 AWS，请参阅[指南要求](saas-guidelines.md#march-saas-guidelines)。
**更新架构细节**
1. 登录到 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)。
1. 在**产品**菜单上，选择 **SaaS**。
1. 在 **SaaS 产品**表中，选择您的产品。
1. 对于**请求更改**，选择**更新架构细节**。
1. 选择一种托管模式。如果您选择的托管模式 AWS Marketplace 认为已在上部署 AWS，请完成以下两个额外步骤。有关考虑部署的模式的更多信息 AWS[指南要求](saas-guidelines.md#march-saas-guidelines)，请参阅本指南前面的。
1. 根据提示，在**架构图**部分选择**选择文件**，以 PNG 或 JPG 格式上传架构图。有关架构图的更多信息，请参阅[创建架构图](saas-guidelines.md#arch-diagram)。
1. 根据提示，在**应用平面**中选择应用的运行位置。有关更多信息，请参阅[控制平面与应用平面](https://docs.aws.amazon.com//whitepapers/latest/saas-architecture-fundamentals/control-plane-vs.-application-plane.html)。
1. 选择**更新架构细节**。
请求完成后，**请求状态**将更改为**成功**。要查看请求状态，请在 **SaaS 产品**表中选择您的产品，然后选择**请求日志**选项卡。
要查看评估结果，请在 **SaaS 产品**表中选择您的产品，然后选择**架构细节**选项卡。
## 更新允许名单 AWS 账户 IDs
您可以更改可以在 AWS 账户 IDs 受限状态下查看您的产品的列表。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)页面的 **SaaS 产品**选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新允许列表**。列表显示了当前 AWS 账户 IDs已列入许可名单的。
1. 在 “**允许名单 AWS 账户**” 字段中，输入 AWS 账户 IDs 并使用逗号分隔它们。
1. 要更新允许名单 AWS 账户 IDs，请选择**提交**。
## 更新产品知名度
要更改哪些买家可以查看您的快速启动体验 AWS Marketplace，您可以使用 “**更新” 可见性**。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://console.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html)页面上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新可见性**。
**注意**
您可以使用此更改请求请求将产品从**受限**态更改为**公开**状态。但是，变更请求必须经过 AWS Marketplace 卖家运营团队的批准才能移至**公开**。
1. 当您向公众发布时，你需要提供产品的实际价格。此价格将在您的列表获得公开批准后应用。
1. 要提交请求以供审核，请选择**提交**。
1. 确认**请求**选项卡将**请求状态**显示为**正在审核**。请求完成后，状态变为**成功**。
## 更新定价条款
要更改 SaaS 产品的每个维度的定价，可以使用**更新定价条款**。
**注意**
任何维度的定价上调都将导致定价更新选项至少在接下来的 90 天内不可用。如果同时更新降价和上调，请先更新降价。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)页面的 **SaaS 产品**选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新公开优惠**，然后选择**更新定价条款**。
1. 当前定价已在字段中预先填写。您可以删除当前价格，然后添加新价格。
1. 要提交请求以供审核，请选择**提交**。
1. 确认**请求**选项卡将**请求状态**显示为**正在审核**。请求完成后，状态将更新为**成功**或**失败**。
## 添加定价维度
您可以添加要用于向产品收费的维度。维度是买家在使用您的产品时需要支付的基本计量单位。
**注意**
要更新现有定价维度的名称或描述，请参阅[更新定价维度](#saas-update-dimension)。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新定价维度**，然后选择**添加定价维度**。
1. 提供维度 API 标识符、显示名称和描述以向您的产品添加新维度，然后选择**下一步**。
**注意**
API 标识符与名称在所有维度中必须唯一。维度创建后，您无法更改 API 标识符与单位。
1. 为您添加的每个维度定义价格，然后选择**下一步**以查看您的更改。
**注意**
您只能为为产品选择的定价模型添加维度（例如，合同、使用量、含消费的合同或免费）。对于使用非免费定价模式的限量产品，新增尺寸的价格设置为0.01美元。对于使用免费定价模式的商品，新添加的尺寸必须设置为 0.00 美元。对于非免费定价模式，您可以在产品准备好公开时更新价格。如果所有尺寸都设置为 0.00 美元，则产品将自动转换为免费定价模式。
1. 选择**提交**，提交您的请求以供审核。
1. 在**请求**选项卡中，验证请求状态是否为**正在审核**。在请求完成后，状态将更改为**成功**。
## 更新定价维度
您可以更新要用于向产品收费的维度。维度是买家在使用您的产品时需要支付的基本计量单位。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新定价维度**，然后选择**更新维度信息**。
1. 找到要更新的维度，然后选择名称或描述。
1. 提供新的名称或描述，然后选中**复选标记**以确认更新。维度名称必须唯一。
1. 选择**提交**，提交您的请求以供审核。
1. 在**请求**选项卡中，验证请求状态是否为**正在审核**。在请求完成后，状态将更改为**成功**。
## 限制定价维度
您可以限制产品中当前列出的维度。此请求会将所选维度从产品中删除。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新定价维度**，然后选择**限制定价维度**。
1. 对于受限及公开产品，系统会提示您使用**[联系我们](https://aws.amazon.com/marketplace/management/contact-us/)**按钮联系 AWS Marketplace 卖家运营团队。使用此表单提供要从产品列表中删除维度的详细信息。
**注意**
运营团队未必总能限制定价维度。
## 确定买家将如何访问您的产品
您可以选择以下选项之一，作为买家访问您产品的方式：
+ [更新 SaaS URL 交付选项](#update-fulfillment-options) – 客户使用站点的 URL，他们在 AWS Marketplace中订阅您的产品后，会被重定向到该站点。
+ [配置快速启动](#saas-quick-launch) – 客户使用简化的流程来配置和启动您的产品。您可以为具有“受限”或“公开”可见性的现有产品完成此配置。
### 更新 SaaS URL 交付选项
要更新用于交付 SaaS 产品的 URL，请使用**更新交付选项**选项卡。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)页面的 **SaaS 产品**选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新交付选项**，然后选择**编辑默认的交付 URL**。
1. 在**交付 URL** 字段中，输入 SaaS 产品交付选项的新 URL。
1. 要提交请求以供审核，请选择**提交**。
1. 确认**请求**选项卡将**请求状态**显示为**正在审核**。请求完成后，状态将更新为**成功**或**失败**。
## 配置快速启动
中列出的 SaaS 产品 AWS Marketplace 通常需要在订阅购买者的账户中部署 AWS 资源（例如，IAM 角色）。Quick Launch 允许您使用 CloudFormation 模板为买家提供指导、 step-by-step说明和资源部署。买家使用 CloudFormation 模板来配置和发布产品。要了解有关快速启动配置过程的更多信息，请参阅[启用 SaaS 快速启动](https://catalog.workshops.aws/mpseller/en-US/saas/quick-launch-integration)实验室。
要配置客户可用于启动您的 SaaS 产品的快速启动体验，请使用**交付选项**选项卡。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)页面的 **SaaS 产品**选项卡上，选择要修改的产品。
**注意**
要配置快速启动体验，产品必须具有“受限”或“公开”可见性。
1. 在产品详细信息页面上，选择**交付选项**选项卡。
1. 对于**快速启动**，请选择**激活并配置**按钮。
1. 有关**账户登录详细信息**，请提供买家可以登录或创建账户的站点 URL。此 URL 将在买家体验中打开一个新的标签页。然后，买家登录或创建一个账户，然后返回 AWS Marketplace 以启动模板。
1. 创建 CloudFormation 模板。
**提示**
创建用于 AWS CloudFormation 将资源部署到买家 AWS 账户的模板时，请按照 Well-Architected Framework 进行操作。 AWS 如需更多信息和资源，请访问 [AWS Well-Architected](https://aws.amazon.com/architecture/well-architected/) 并阅读 [AWS Well-Architected Framework](https://docs.aws.amazon.com/wellarchitected/latest/framework/welcome.html)。
对于 **CloudFormation 模板**，选择**添加 CloudFormation 模板**按钮并提供以下信息：
+ **标题**-提供 CloudFormation 部署的名称。
+ **描述** – 提供模板的描述。
+ **堆栈名称** – 提供堆栈的名称。此名称是中买方的堆栈名称 CloudFormation。
+ **CloudFormation 模板 URL** — 提供 Amazon 简单存储服务将审核此模板。
**注意**
为了简化客户的启动过程，我们建议尽量减少与配置过程相关的模板数量。理想情况下，您需要一个模板来部署使用产品所需的资源。有关 CloudFormation 模板的问题，请联系您的 AWS Marketplace 业务发展合作伙伴或[AWS Marketplace 卖家运营](https://aws.amazon.com/marketplace/management/contact-us/)团队。
+ **所需的 IAM 权限**-提供部署 CloudFormation 模板所需的权限。如果您想共享部署参数（这些参数作为密钥存储在 [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) 中，以供买家使用），您的策略必须包含以下操作：
+ `secretsManager:ListSecrets`
+ `secretsManager:DescribeSecret`
+ `secretsManager:ReplicateSecretToRegions`
+ `secretsManager:GetSecretValue`
**注意**
如果您的产品需要卖家提供的 CloudFormation 部署参数（例如 API 密钥和[外部](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html)参数 IDs），请使用该`PutDeploymentParameter`操作与您的客户共享该参数。有关更多信息，请参阅《AWS Marketplace 部署服务 API 参考》**中的 [https://docs.aws.amazon.com/marketplace-deployment/latest/api-reference/API_PutDeploymentParameter.html](https://docs.aws.amazon.com/marketplace-deployment/latest/api-reference/API_PutDeploymentParameter.html)。
1. （可选）有关**手动配置说明**，请为想要手动配置产品的买家提供说明。考虑包含产品入门指南和文档的链接。
1. 有关**发布详情，请**提供 CloudFormation 堆栈部署后买家访问产品的 URL。
1. （可选）**对于快速启动的允许名单账户**，请提供一个以逗号分隔的列表 AWS 账户 ，这些账户可以在有限的可见性下查看快速启动体验。
1. 选择**提交**按钮。快速启动体验的可见性状态将为“受限”，这意味着只有您的账户和列入许可名单的账户才能看见。在“受限”可见性下，您可以在订阅产品并选择**设置账户**按钮后，使用**配置和启动**页面测试您的配置。
+ 要从买家的角度预览页面，请选择**预览**。当两个页面都处于打开状态时，您的配置更改将反映在预览中。
1. 准备就绪后，可以在 AWS Marketplace 目录中发布快速启动体验。在产品详细信息页面上，使用**交付选项**选项卡上的**更新快速启动可见性**按钮。
当您将可见性更改为 “公开” 时， AWS Marketplace 卖家运营团队将审查配置、进行买家测试并发布体验。
**注意**
如果您在启用快速启动体验时需要支持，请联系 [AWS Marketplace 卖家运营](https://aws.amazon.com/marketplace/management/contact-us/)团队。
## 按国家/地区更新可用性
您可以定义提供产品的国家/地区。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新公开优惠**，然后选择**按国家/地区更新可用性**。
1. 请选择以下选项之一：
+ 所有国家/地区 – 适用于所有受支持的国家/地区。
+ 所有国家/地区（部分除外） – 在所有受支持的国家/地区均可用，部分国家/地区除外。
+ 仅加入允许列表的国家/地区 – 提供产品的国家/地区的具体列表。
1. 选择**提交**，提交您的请求以供审核。
1. 在**请求**选项卡中，验证请求状态是否为**正在审核**。在请求完成后，状态将更改为**成功**。
## 更新产品的退款政策
您可以使用**更新退款政策**来更新产品的退款政策。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)页面的 **SaaS 产品**选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新公开优惠**，然后选择**更新退款政策**。
1. 文本框中提供了当前退款政策的详细信息。根据需要查看和修改详细信息。提交请求会改写当前的退款政策。
1. 要提交请求以供审核，请选择**提交**。
1. 确认**请求**选项卡将**请求状态**显示为**正在审核**。请求完成后，状态将更新为**成功**或**失败**。
## 更新最终用户许可协议 (EULA)
您可以为订阅您的产品的新用户更新您的 EULA。
1. 打开 [AWS Marketplace 管理门户](https://aws.amazon.com/marketplace/management)，登录到卖家账户。
1. 在 [SaaS 产品](https://aws.amazon.com/marketplace/management/products/saas)选项卡上，选择要修改的产品。
1. 从**请求更改**下拉列表中，选择**更新公开优惠**，然后选择**更新 EULA**。
1. 您可以选择 [AWS Marketplace (SCMP) 的标准合同](https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html)，也可以提交自定义 EULA。对于自定义 EULA，您必须提供合同的 Amazon Simple Storage Service (Amazon S3) 网址。您的 Amazon S3 存储桶必须可公开访问。
1. 选择**提交**，提交您的请求以供审核。
1. 在**请求**选项卡中，验证请求状态是否为**正在审核**。在请求完成后，状态将更改为**成功**。
# 将您的 SaaS 订阅或 Pay-As-You-Go产品与 AWS Marketplace
**2026 年 6 月 1 日，新 SaaS 产品的集成要求发生变化**
AWS Marketplace 正在推出对并发协议的支持，允许在同一协议期限内使用单个 AWS 账户多次购买同一产品。从 2026 年 6 月 1 日起，所有新的 SaaS 产品都必须支持更新的集成要求。[查看并发协议的新集成](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements)。
将您的产品与集成 AWS Marketplace 仅一步之遥[在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。要将您的软件即服务 (SaaS) 订阅产品与集成 AWS Marketplace，您必须编写代码并证明它可以成功响应多种客户场景。以下各节介绍如何将 SaaS 订阅模式与集成 AWS Marketplace。
**重要**
本指南适用于 *Pay-As-You-Go (PAYG)* SaaS 产品。如果您正在实施*基于合同*的 SaaS 产品，请改为参考[将基于合同的 SaaS 产品与 AWS Marketplace](saas-integrate-contract-with-pay.md)。PAYG 产品不使用授权 SNS 主题或 API。 GetEntitlements
**注意**
在开始之前，请确保您已为自己的 software-as-a-service（SaaS）产品选择了正确的定价模式 AWS Marketplace。有关更多信息，请参阅 [规划您的 SaaS 产品](saas-prepare.md)。
**Topics**
+ [场景：您的服务验证新客户](#saas-subscription-validate-customer)
+ [场景：计量用量](#saas-subscription-meter-usage)
+ [场景：监控用户订阅的更改](#saas-subscription-monitor-changes)
+ [场景：验证客户订阅](#saas-subscription-verify-subscriptions)
+ [测试您的 SaaS 订阅产品集成](#saas-subscription-integration-testing)
## 场景：您的服务验证新客户
当客户订阅您的产品时，他们会被重定向到您的注册 URL，这是一个带有临时 `x-amzn-marketplace-token` 令牌的 HTTP POST 请求。通过下列方式来响应此请求：
1. `ProductCode`通过调用中的 `[ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作将令牌兑换`CustomerAWSAccountId``LicenseArn`、、和 AWS Marketplace Metering Service。`CustomerIdentifier`
1. 在系统中保留`CustomerIdentifier``CustomerAWSAccountId``LicenseArn`、、和`ProductCode`，以备将来调用。您必须存储客户是否拥有有效的订阅，以及您需要的有关该客户的任何信息。
1. 作为对请求的响应，您必须展示用户的首次使用体验（如果适用于您的服务）。
## 场景：计量用量
当客户开始使用您的服务时，您必须每小时发送一次计量记录。有关如何计量的详细信息，请参阅[配置 SaaS 订阅用量的计量](metering-for-usage.md)。
我们建议您使用 AWS CloudTrail 监控活动，以确保账单信息已发送至 AWS。在发送计量记录时，请记住以下几点：
+ 将按小时去除重复的计量请求。
+ 每小时发送的记录是累积的。
+ 即使过去一小时内没有记录，我们也强烈建议实施最佳实操，即每小时发送一次计量记录（用量为 0）。
## 场景：监控用户订阅的更改
设置 Amazon Simple Queue Service (Amazon SQS) 队列，并订阅您的产品的 Amazon SNS 主题。您的 SNS 主题信息包含在您创建商品时从 AWS Marketplace 卖家运营团队收到的电子邮件中。有关更多信息，请参阅 [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。订阅 SNS 主题后，您将收到有关客户订阅变更的通知，包括为特定客户提供或撤消访问权限。
**注意**
Amazon SNS 主题 Amazon 资源名称 (ARN) 与 `arn:aws:sns:us-east-1::aws-mp-subscription-notification-` 类似。
您必须响应的通知有：
+ `subscribe-success` – 客户已订阅，您可以成功地根据他们的客户 ID 进行计量。
+ `unsubscribe-pending` – 客户正在取消订阅。您应该发送所有最后的计量记录。
+ `unsubscribe-success` – 客户已取消订阅。将不再接受客户的计量记录。执行您关闭客户资源的实操，遵守您的保留策略。
+ `subscribe-fail` – 客户订阅失败。您不应根据他们的客户 ID 进行计量或代表客户创建资源。
## 场景：验证客户订阅
在代表客户创建资源之前，请确认客户应该有权访问您的产品。存储您通过 Amazon SQS 收到的通知中客户的最新状态，以了解客户是否有权访问。
## 测试您的 SaaS 订阅产品集成
将 SaaS 订阅产品与集成后 AWS Marketplace，必须进行深入测试以确保集成成功。以下过程概述了验证产品集成的步骤。
**注意**
使用您自己的账户订阅您的产品并测试集成是否成功。可以暂时降低价格，以便您能够测试购买流程，而不会在这些账户中产生较高的费用。有关暂时降低价格或允许其他测试账户访问您的产品的更多信息，请联系 [AWS Marketplace 卖家运营](https://aws.amazon.com/marketplace/management/contact-us/)团队。
产品推出后，该服务必须继续对新客户的这些情形做出响应。
1. 使用允许的账户通过订阅产品来测试客户体验。
1. 使用允许的账户进行订阅后，请确保该账户被重定向到注册 URL，并且重定向是一个包含临时令牌的 POST 请求。请确保您的应用程序保留客户 ID，以备将来调用。这测试了[场景：您的服务验证新客户](#saas-subscription-validate-customer)中的一部分。
1. 在上一步中验证测试账户后，将该账户注册到应用程序中。例如，您可以让测试客户填写表单来创建新的用户。或者，向这些客户提供其他后续步骤以获取对 SaaS 应用程序的访问权限。这测试了[场景：您的服务验证新客户](#saas-subscription-validate-customer)中的一部分。
1. 测试客户入职后，使用中的 `BatchMeterUsage` API 操作提出请求，将计量记录发送到以 AWS 用于计费。 AWS Marketplace Metering Service这测试了[场景：计量用量](#saas-subscription-meter-usage)。
1. 测试订阅变更。可能的情况包括取消订阅、成功订阅和订阅失败。这测试了[场景：监控用户订阅的更改](#saas-subscription-monitor-changes)。
1. 确认订阅成功。在收到测试账户的 Amazon SNS 通知以及成功订阅消息后，可以开始计量。 AWS Marketplace Metering Service 在您收到 Amazon SNS 通知之前发送到的记录不会被计量。这测试了[场景：验证客户订阅](#saas-subscription-verify-subscriptions)。
**注意**
为了防止出现计费问题，我们强烈建议您以编程方式等待此通知，然后代表您的客户启动资源。
1. 完成所有集成要求并测试解决方案后，请通知 AWS Marketplace 卖家运营团队。他们将通过验证您是否已使用 `BatchMeterUsage` API 操作成功发送计量数据，来对解决方案运行一系列的最终测试。
集成和测试完成后，您可以进行最终审核并将您的产品公之于众 AWS Marketplace。有关更多信息，请参阅 [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。
# 将你的 SaaS 合同产品与 AWS Marketplace
**2026 年 6 月 1 日，新 SaaS 产品的集成要求发生变化**
AWS Marketplace 正在推出对并发协议的支持，允许在同一协议期限内使用单个 AWS 账户多次购买同一产品。从 2026 年 6 月 1 日起，所有新的 SaaS 产品都必须支持更新的集成要求。[查看并发协议的新集成](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements)。
将您的软件即服务 (SaaS) 合同产品与集成 AWS Marketplace 是第一步[在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。要将您的软件即服务 (SaaS) 合同产品与集成 AWS Marketplace，您必须编写代码并证明它可以成功响应多种客户场景。以下各部分描述了这些场景，讲解了如何应对这些场景，并概述了测试集成的情况。
**注意**
在开始之前，请确保您已为 AWS Marketplace中的软件即服务 (SaaS) 产品选择正确的定价模式。有关更多信息，请参阅 [规划您的 SaaS 产品](saas-prepare.md)。
**Topics**
+ [场景：您的服务验证新客户](#saas-contract-validate-customer)
+ [场景：您的服务处理客户请求](#saas-contract-customer-requests)
+ [场景：监控用户订阅的更改](#saas-contract-monitor-changes)
+ [测试您的 SaaS 合同产品集成](#saas-contract-integration-testing)
## 场景：您的服务验证新客户
当客户订阅您的产品时，他们会被重定向到您的注册 URL，这是一个带有临时 `x-amzn-marketplace-token` 令牌的 HTTP POST 请求。通过下列方式来响应此请求：
1. `ProductCode`通过调用中的 `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作将令牌兑换`CustomerAWSAccountId``LicenseArn`、、和 AWS Marketplace Metering Service**。`CustomerIdentifier`
1. 通过调用 AWS Marketplace Entitlement Service中的 `[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)` API 操作来验证客户可以访问的订阅和数量（如适用）。
1. 在系统中保留`CustomerIdentifier``CustomerAWSAccountId``LicenseArn`、、和`ProductCode`，以备将来调用。存储客户是否拥有有效的订阅，以及您需要的有关该客户的任何信息。
1. 作为对请求的响应，您必须展示用户的首次使用体验（如果适用于您的服务）。
## 场景：您的服务处理客户请求
当客户向您的服务提出请求时，您必须通过适当的操作或消息来响应以下情形：
+ 他们在系统中没有客户 ID。这表明他们尚未订阅。您应该告知用户如何订阅。
+ 他们有客户 ID，且 `GetEntitlements` API 操作返回了相应的权利。在这种情况下，您应该满足请求。
+ 他们确实有客户 ID，但是 `GetEntitlements` API 操作未返回任何权利，或者返回的数量不足以满足请求。在这种情况下，您必须确定如何处理访问权限和管理他们的体验。
## 场景：监控用户订阅的更改
**重要**
S AWS Marketplace aaS 产品的 SNS 通知已被亚马逊 EventBridge 通知所取代。如果您已将现有的 SaaS 产品与 SNS 集成，它们将继续运行。新上架商品最终将过渡到使用Amazon EventBridge 而不是SNS。有关更多信息，请参阅 [通过亚马逊管理 SaaS 订阅事件 EventBridge](saas-eventbridge-integration.md)。
设置亚马逊简单队列服务 (Amazon SQS) Simple Queue SQUEE 队列作为您的 EventBridge 亚马逊规则的目标，以接收有关客户权利变更的事件。您的 Amazon EventBridge 事件配置是在您创建产品时提供的。有关更多信息，请参阅 [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。通过配置 Amazon EventBridge 规则，您会收到有关客户权利变更的事件，包括为特定客户提供或撤销访问权限。
您必须响应的唯一通知是：
+ 许可证已更新 Amazon EventBridge 事件 — 客户权利已更改，您必须调用 `GetEntitlements` API 操作才能查看新状态。更新您的客户商店，如果适用（例如，客户的合同已失效），请执行关闭客户资源的实操，遵守您的保留策略。
**注意**
有关更多信息，请参阅 [使用检查权利 AWS Marketplace Entitlement Service](checking-entitlements.md)。
## 测试您的 SaaS 合同产品集成
将 SaaS 合同产品与集成后 AWS Marketplace，必须进行深入测试以确保集成成功。以下过程概述了验证产品集成的步骤。
**注意**
使用您自己的账户订阅您的产品并测试集成是否成功。可以暂时降低价格，以便您能够测试购买流程，而不会在这些账户中产生较高的费用。有关暂时降低价格或允许其他测试账户访问您的产品的更多信息，请[联系我们](https://aws.amazon.com/marketplace/management/contact-us/)。
产品推出后，该服务必须继续对新客户的这些情形做出响应。
1. 使用允许的账户通过获取产品合同来测试客户体验。
1. 在该账户获得合同后，请确保它被重定向到注册 URL，并且重定向是一个包含临时令牌的 POST 请求。确保您的应用程序保留客户 ID 以备将来调用之用，并正确处理客户拥有的权利。这测试了[场景：您的服务验证新客户](#saas-contract-validate-customer)中的一部分。
1. 在上一步中验证测试账户后，将该账户注册到应用程序中。例如，您可以让测试客户填写表单来创建新的用户。或者，向这些客户提供其他后续步骤以获取对 SaaS 应用程序的访问权限。这测试了[场景：您的服务验证新客户](#saas-contract-validate-customer)中的一部分。
1. 如果 `GetEntitlements` API 操作未返回任何权利，无论是在载入期间还是验证通过期间，您的应用程序都必须正确管理未授权用户的访问权限和体验。这测试了[场景：您的服务处理客户请求](#saas-contract-customer-requests)。
1. 测试订阅变更。验证您的应用程序是否正确处理取消订阅、成功订阅和订阅失败的情况。这测试了[场景：监控用户订阅的更改](#saas-contract-monitor-changes)。
1. 完成所有集成要求并测试解决方案后，请通知 AWS Marketplace 运营团队。然后，他们将通过验证您是否已成功调用 `GetEntitlements` API 操作并充分载入新客户来测试解决方案。
集成和测试完成后，您可以进行最终审核并将您的产品公之于众 AWS Marketplace。有关更多信息，请参阅 [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。您也可以通过填写退款申请表来取消测试订阅。有关取消订阅的更多信息，请参阅[申请账单调整（退款）](refunds.md#refund-process)。
# 将基于合同的 SaaS 产品与 AWS Marketplace
**2026 年 6 月 1 日，新 SaaS 产品的集成要求发生变化**
AWS Marketplace 正在推出对并发协议的支持，允许在同一协议期限内使用单个 AWS 账户多次购买同一产品。从 2026 年 6 月 1 日起，所有新的 SaaS 产品都必须支持更新的集成要求。[查看并发协议的新集成](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements)。
将您的产品与集成 AWS Marketplace 仅一步之遥[在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。要将您的软件即服务 (SaaS) 合同产品与集成 AWS Marketplace，您必须编写代码并证明它可以成功响应多种客户场景。以下各部分描述了这些场景，讲解了如何应对这些场景，并概述了测试集成的情况。
**注意**
本指南仅适用于*基于合同*的 SaaS 产品。如果您正在实施 *Pay-As-You-Go （即收现付）S* aaS 产品，请[将您的 SaaS 订阅或 Pay-As-You-Go产品与 AWS Marketplace](saas-integrate-subscription.md)改用。PAYG 产品不使用授权 SNS 主题或 API。 GetEntitlements
在开始之前，请确保您已为 AWS Marketplace中的软件即服务 (SaaS) 产品选择正确的定价模式。有关更多信息，请参阅 [规划您的 SaaS 产品](saas-prepare.md)。
**Topics**
+ [场景：您的服务验证新客户](#saas-contract-with-pay-validate-customer)
+ [场景：您的服务处理客户请求](#saas-contract-with-pay-customer-requests)
+ [场景：计量用量](#saas-contract-with-pay-meter-usage)
+ [场景：监控用户权利的变化](#saas-contract-with-pay-monitor-changes)
+ [通过集成测试你的 SaaS pay-as-you-go 合同](#saas-contract-consumption-integration-testing)
## 场景：您的服务验证新客户
当客户订阅您的产品时，他们会被重定向到您的注册 URL，这是一个带有临时 `x-amzn-marketplace-token` 令牌的 HTTP POST 请求。通过下列方式来响应此请求：
1. `ProductCode`通过调用中的 `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作将令牌兑换`CustomerAWSAccountId``LicenseArn`、、和 AWS Marketplace Metering Service。`CustomerIdentifier`
1. 通过调用 AWS Marketplace Entitlement Service中的 `[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)` 操作来验证客户可以访问的订阅和数量（如适用）。
1. 在系统中保留`CustomerIdentifier``CustomerAWSAccountId``LicenseArn`、、和`ProductCode`，以备将来调用。存储客户是否拥有有效的订阅，以及您需要的有关该客户的任何信息。
1. 作为对请求的响应，您必须展示用户的首次使用体验（如果适用于您的服务）。
## 场景：您的服务处理客户请求
当客户向您的服务提出请求时，您必须通过适当的操作或消息来响应以下情形：
+ 他们在系统中没有客户 ID。这表明他们尚未订阅。您应该给他们发送消息，描述如何订阅。
+ 他们有客户 ID，且 `GetEntitlements` API 操作返回了相应的权利。在这种情况下，您应该满足请求。
+ 他们确实有客户 ID，但是 `GetEntitlements` API 操作未返回任何权利，或者返回的数量不足以满足请求。在这种情况下，您必须确定如何处理访问权限和管理他们的体验。
## 场景：计量用量
当客户开始使用您的服务时，您必须每小时发送一次计量记录。有关如何计量的详细信息，请参阅[配置 SaaS 订阅用量的计量](metering-for-usage.md)。
我们建议您使用 AWS CloudTrail 监控活动，以确保账单信息已发送至 AWS。在发送计量记录时，请记住以下几点：
+ 将按小时去除重复的计量请求。
+ 每小时发送的记录是累积的。
+ 即使过去一小时内没有记录，我们也强烈建议实施最佳实操，即每小时发送一次计量记录（用量为 0）。
## 场景：监控用户权利的变化
设置 Amazon Simple Queue Service (Amazon SQS) 队列，并订阅您产品的 Amazon SNS 主题，有两个 SNS 主题，一个用于权利变更，另一个用于订阅变更。您的主题信息包含在您创建商品时从 AWS Marketplace 卖家运营团队收到的电子邮件中。有关更多信息，请参阅 [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。订阅 SNS 主题后，您将收到有关客户订阅变更的通知，包括为特定客户提供或撤消访问权限。
**注意**
订阅变更的 SNS 主题 Amazon 资源名称 (ARN) 与 `arn:aws:sns:us-east-1::aws-mp-subscription-notification-` 类似。权利变更的 SNS 主题 ARN 与 `arn:aws:sns:us-east-1::aws-mp-entitlement-notification-` 类似。
您必须响应的通知如下：
+ `entitlement-updated`（在权利 SNS 主题中）– 客户权利已更改，您必须调用 `GetEntitlements` API 操作才能查看新状态。更新您的客户商店，如果适用（例如，客户的合同已失效），请执行关闭客户资源的实操，遵守您的保留策略。
+ `subscribe-success`（在订阅 SNS 主题中）– 客户已订阅，您可以成功地根据他们的客户 ID 进行计量。
+ `unsubscribe-pending`（在订阅 SNS 主题中）– 客户正在取消订阅。您应该发送所有最后的计量记录。
+ `unsubscribe-success`（在订阅 SNS 主题中）– 客户已取消订阅。将不再接受客户的计量记录。执行您关闭客户资源的实操，遵守您的保留策略。
+ `subscribe-fail`（在订阅 SNS 主题中）– 客户订阅失败。您不应根据他们的客户 ID 进行计量或代表客户启用资源。
**注意**
有关更多信息，请参阅 [使用检查权利 AWS Marketplace Entitlement Service](checking-entitlements.md)。
## 通过集成测试你的 SaaS pay-as-you-go 合同
将合同与 pay-as-you-go产品整合后 AWS Marketplace，必须进行深入测试，以确保集成成功。以下过程概述了验证产品集成的步骤。
**注意**
使用您自己的账户订阅您的产品并测试集成是否成功。可以暂时降低价格，以便您能够测试购买流程，而不会在这些账户中产生较高的费用。有关暂时降低价格或允许其他测试账户访问您的产品的更多信息，请联系 [AWS Marketplace 卖家运营](https://aws.amazon.com/marketplace/management/contact-us/)团队。
产品推出后，该服务必须继续对新客户的这些情形做出响应。
1. 使用允许的账户通过获取产品合同来测试客户体验。
1. 在该账户获得合同后，请确保它被重定向到注册 URL，并且重定向是一个包含临时令牌的 POST 请求。确保您的应用程序保留客户 ID 以备将来调用之用，并正确处理客户拥有的权利。这测试了[场景：您的服务验证新客户](#saas-contract-with-pay-validate-customer)中的一部分。
1. 在上一步中验证测试账户后，将该账户注册到应用程序中。例如，您可以让测试客户填写表单来创建新的用户。或者，向这些客户提供其他后续步骤以获取对 SaaS 应用程序的访问权限。这测试了[场景：您的服务验证新客户](#saas-contract-with-pay-validate-customer)中的一部分。
1. 如果 `GetEntitlements` API 操作未返回任何权利，无论是在载入期间还是验证通过期间，您的应用程序都必须正确管理未授权用户的访问权限和体验。这测试了[场景：您的服务处理客户请求](#saas-contract-with-pay-customer-requests)。
1. 测试客户入职后，使用中的 `BatchMeterUsage` API 操作提出请求，将计量记录发送到以 AWS 用于计费。 AWS Marketplace Metering Service这测试了[场景：计量用量](#saas-contract-with-pay-meter-usage)。
1. 测试订阅变更。验证您的应用程序是否正确处理取消订阅、成功订阅和订阅失败的情况。这测试了[场景：监控用户权利的变化](#saas-contract-with-pay-monitor-changes)。
1. 完成所有集成要求并测试解决方案后，请通知 AWS Marketplace 卖家运营团队。然后，他们将通过验证您是否已成功调用 `GetEntitlements` API 操作并充分载入新客户来测试解决方案。他们还将验证您是否已通过 `BatchMeterUsage` API 操作成功发送计量记录。
集成和测试完成后，您可以进行最终审核并将您的产品公之于众 AWS Marketplace。有关更多信息，请参阅 [在中创建 SaaS 产品 AWS Marketplace](saas-create-product.md)。
# 部署无服务器 SaaS 集成
当您拥有需要与 AWS Marketplace 集成的 SaaS 解决方案时，可采用多种架构方案实现集成。
为帮助您理解 SaaS 集成概念，AWS 提供了一个参考实验室，演示了一种使用无服务器架构的方法。
访问参考实验室：[将 SaaS 与无服务器 SaaS 集成参考集成](https://aws.amazon.com/quickstart/architecture/aws-marketplace-saas/)
**注意**
本参考实施仅供学习和演示之用，尚未达到生产环境使用标准，切勿直接在生产环境中部署。在生产环境中实施类似解决方案之前，需确保能够满足您具体用例对应的安全性、可扩展性、监控及合规性要求。