本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 上開始使用 SaaS 產品 AWS Marketplace
身為 AWS Marketplace 賣方，您可以將軟體新增為服務 (SaaS) 產品 AWS Marketplace。這包括根據 SaaS 產品的帳單模型，將您的 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. 規劃您將如何建立和整合 SaaS 產品 AWS Marketplace。如需詳細資訊，請參閱[規劃您的 SaaS 產品](saas-prepare.md)。
## 後續步驟
完成必要的先決條件後，您可以建立和設定 SaaS 產品。
**Topics**
+ [
## 先決條件
](#saas-prereqs)
+ [
## 後續步驟
](#saas-next-steps)
+ [
# 中的 SaaS 產品生命週期 AWS Marketplace
](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)
# 中的 SaaS 產品生命週期 AWS Marketplace
當您在 中建立軟體即服務 (SaaS) 產品時 AWS Marketplace，最初發佈時可見性有限，因此只有您的帳戶可以存取它。當您準備好時，您可以將其發佈至 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。
+ 使用隨需付費產品與 整合來測試[訂閱](saas-integrate-subscription.md#saas-subscription-integration-testing)、[合約](saas-integrate-contract.md#saas-contract-integration-testing)或合約 AWS Marketplace。 [ pay-as-you-go](saas-integrate-contract-with-pay.md#saas-contract-consumption-integration-testing)
+ 提交您的產品以啟動。
下列程序說明如何在 中建立 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 – 這是在 中成功訂閱您的產品後，買方重新導向的 URL AWS Marketplace。
+ 您產品的中繼資料 – 您可以在 的產品建立精靈中提供中繼資料 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訂閱。 [ SaaS ](https://docs.aws.amazon.com/marketplace/latest/buyerguide/cancel-subscription.html#cancel-saas-subscription) 若要取消合約，請 AWS Marketplace [提交支援票證](https://aws.amazon.com/marketplace/management/contact-us/)來聯絡賣方營運團隊。
1. **提交您的產品以啟動**
驗證整合並準備好讓產品上線後，請選擇**更新可見**性。 AWS Marketplace 賣方營運團隊會檢閱您的產品並更新價格，之後可見性才能更新為公開。
**注意**
AWS Marketplace Seller Operations 使用手動程序來驗證和更新 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 美元。對於非免費定價模型，您將在公開產品時提供實際價格。請注意，如果所有維度都設為 \$10.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](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，請在 AWS Marketplace 管理入口網站 (AMMP) 中選擇託管模式並上傳架構圖表，以更新產品的架構詳細資訊。如需 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 的允許清單，請選擇**提交**。
## 更新產品可見性
若要變更哪些買方可以在 中檢視您的 Quick Launch 體驗 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 美元。對於非免費定價模型，您可以在產品準備好公開可見性時更新價格。如果所有維度都設為 \$10.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/](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 角色）。快速啟動可讓您使用 CloudFormation 範本為買方提供引導step-by-step指示和資源部署。買方使用 CloudFormation 範本來設定和啟動產品。若要進一步了解 Quick Launch 組態程序，請參閱[啟用 SaaS Quick Launch](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 資源部署到買方 AWS 帳戶的 CloudFormation 範本時，請遵循 AWS Well-Architected Framework。如需詳細資訊和資源，請參閱 [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 Simple Storage Service 將檢閱此範本。
**注意**
為了簡化客戶的啟動程序，我們建議將與您組態程序相關聯的範本數量降至最低。理想情況下，您希望有一個範本部署使用產品所需的資源。有關 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 金鑰和[外部 IDs](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html))，請使用 `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 目錄中發佈 Quick Launch 體驗。使用產品詳細資訊頁面上**履行選項**索引標籤上的**更新快速啟動可見**性按鈕。
當您將可見性變更為公開時， 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) URL。您的 Amazon S3 儲存貯體必須可公開存取。
1. 選擇**提交**以提交您的請求以供檢閱。
1. 在**請求**索引標籤中，確認請求狀態為**審核中**。當請求完成時，狀態會變更為**成功**。
# 將您的 SaaS 訂閱或Pay-As-You-Go產品與 整合 AWS Marketplace
**新 SaaS 產品的整合需求將於 2026 年 6 月 1 日變更**
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 主題或 GetEntitlements API。
**注意**
開始之前，請確定您已為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. 呼叫 中的 `[ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作，`ProductCode`以交換 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 的字符 AWS Marketplace Metering Service。
1. `ProductCode` 在您的系統中保留 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 以供日後呼叫。您必須存放客戶是否擁有有效的訂閱，以及您需要的客戶相關資訊。
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 Resource Name (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 通知並顯示成功的訂閱訊息後，即可開始計量。在您收到 Amazon SNS 通知 AWS Marketplace Metering Service 之前傳送到 的記錄不會計量。這會測試 [案例：驗證客戶訂閱](#saas-subscription-verify-subscriptions)。
**注意**
為了避免帳單問題，我們強烈建議以程式設計方式等待此通知，再代表您的客戶啟動資源。
1. 在您完成所有整合要求並測試解決方案之後，請通知 AWS Marketplace 賣方營運團隊。他們會透過 API `BatchMeterUsage`操作驗證您已成功傳送計量記錄，對解決方案執行一系列最終測試。
整合和測試完成後，您可以執行最終審核並在公開上列出您的產品 AWS Marketplace。如需詳細資訊，請參閱[在 中建立 SaaS 產品 AWS Marketplace](saas-create-product.md)。
# 將您的 SaaS 合約產品與 整合 AWS Marketplace
**新 SaaS 產品的整合需求將於 2026 年 6 月 1 日變更**
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，您必須撰寫程式碼，並示範它可以成功回應數個客戶案例。下列各節說明這些案例、說明如何回應這些案例，並提供測試整合的概觀。
**注意**
開始之前，請確定您已為其中的軟體即服務 (SaaS) 產品選擇正確的定價模式 AWS Marketplace。如需詳細資訊，請參閱[規劃您的 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. 呼叫 中的 `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作，`ProductCode`以交換 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 的字符 AWS Marketplace Metering Service**。
1. 透過呼叫 中的 `[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)` API 操作，確認客戶可存取的訂閱和數量 （如適用） AWS Marketplace Entitlement Service。
1. `ProductCode` 在您的系統中保留 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 以供日後呼叫。存放客戶是否擁有有效的訂閱，以及您需要的客戶相關資訊。
1. 為了回應請求，您必須顯示使用者的第一次使用體驗 （適用於您的服務）。
## 案例：您的服務處理客戶請求
當客戶對您的服務提出請求時，您必須以適當的動作或簡訊回應下列案例：
+ 它們在您的系統中沒有客戶 ID。這表示他們尚未訂閱。您應該告訴使用者如何訂閱。
+ 他們有客戶 ID，API `GetEntitlements`操作會傳回適當的權利。在此案例中，您應該完成請求。
+ 它們確實有客戶 ID，但 `GetEntitlements` API 操作不會傳回任何權利，或沒有足夠的數量來滿足請求。在此案例中，您必須決定如何處理存取和管理他們的體驗。
## 案例：監控使用者訂閱的變更
**重要**
正在以 Amazon EventBridge 通知取代 AWS Marketplace SaaS 產品的 SNS 通知。如果您有與 SNS 整合的現有 SaaS 產品，它們將繼續運作。新的清單最終將轉換為使用 Amazon EventBridge 而非 SNS。如需詳細資訊，請參閱[使用 Amazon EventBridge 管理 SaaS 訂閱事件](saas-eventbridge-integration.md)。
將 Amazon Simple Queue Service (Amazon SQS) 佇列設定為 Amazon 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
**新 SaaS 產品的整合需求將於 2026 年 6 月 1 日變更**
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(PAYG)* SaaS 產品，請[將您的 SaaS 訂閱或Pay-As-You-Go產品與 整合 AWS Marketplace](saas-integrate-subscription.md)改用 。PAYG 產品不會使用權利 SNS 主題或 GetEntitlements API。
開始之前，請確定您已為其中的軟體即服務 (SaaS) 產品選擇正確的定價模式 AWS Marketplace。如需詳細資訊，請參閱[規劃您的 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)
+ [
## 使用隨需pay-as-you-go整合測試您的 SaaS 合約
](#saas-contract-consumption-integration-testing)
## 案例：您的服務會驗證新客戶
當客戶訂閱您的產品時，它們會重新導向至您的註冊 URL，這是具有臨時`x-amzn-marketplace-token`字符的 HTTP POST 請求。以下列方式回應此請求：
1. 呼叫 中的 `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作，`ProductCode`以交換 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 的字符 AWS Marketplace Metering Service。
1. 透過在 中呼叫 `[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)`動作，驗證客戶可存取的訂閱和數量 （如適用） AWS Marketplace Entitlement Service。
1. `ProductCode` 在您的系統中保留 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 以供日後呼叫。存放客戶是否擁有有效的訂閱，以及您需要的客戶相關資訊。
1. 為了回應請求，您必須顯示使用者的第一次使用體驗 （適用於您的服務）。
## 案例：您的服務處理客戶請求
當客戶對您的服務提出請求時，您必須以適當的動作或簡訊回應下列案例：
+ 它們在您的系統中沒有客戶 ID。這表示他們尚未訂閱。您應該向他們提供說明如何訂閱的訊息。
+ 他們有客戶 ID，API `GetEntitlements`操作會傳回適當的權利。在此案例中，您應該完成請求。
+ 它們確實有客戶 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 Resource Name (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)。
## 使用隨需pay-as-you-go整合測試您的 SaaS 合約
將合約與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 整合
當您有想要整合的 SaaS 解決方案時 AWS Marketplace，您可以使用各種架構方法來整合。
為了協助您了解 SaaS 整合概念， AWS 提供參考實驗室，示範使用無伺服器架構的一種方法。
存取參考實驗室：[將您的 SaaS 與 Serverless SaaS 整合參考整合](https://aws.amazon.com/quickstart/architecture/aws-marketplace-saas/)
**注意**
此參考實作僅供學習和示範之用。它尚未可供生產使用，不應在生產環境中正常使用。在生產環境中實作類似的解決方案之前，請務必解決使用案例特有的安全性、可擴展性、監控和合規要求。