AWS Marketplace - 賣方指南

AWS Marketplace賣方指南

AWS Marketplace 賣方指南

AWS Marketplace: 賣方指南Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Amazon 的商標和商業外觀不得用於任何非 Amazon 的產品或服務，也不能以任何可能造成客戶混淆、任從何貶低或使Amazon 名譽受損的方式使用 Amazon 的商標和商業外觀。所有其他非 Amazon 擁有的商標均為其各自擁有者的財產，這些擁有者可能隸屬於 Amazon，或與 Amazon 有合作關係，亦或受到 Amazon 贊助。


Table of Contents什麼是 AWS Marketplace？ ................................................................................................................. 1

使用AWS Marketplace為賣方 ........................................................................................................ 1開始為賣方 ........................................................................................................................................ 3

出版自由軟體產品的賣家要求 ........................................................................................................ 3付費產品的其他賣方要求 .............................................................................................................. 3

付費產品的合格司法管轄區 ................................................................................................... 3AWS Marketplace 管理入口網站 ................................................................................................... 4註冊 .......................................................................................................................................... 5

建立您的公開個人檔案 ......................................................................................................... 5提供稅務資訊 ..................................................................................................................... 5提供美國銀行帳戶資訊 ......................................................................................................... 6AWS Marketplace 稅收計算服務 ........................................................................................... 6支付與買家帳單 .................................................................................................................. 7已經是賣方了嗎？ ............................................................................................................... 8

賣方工具組 ................................................................................................................................ 8AWS MarketplaceCommerce Analytics Service ....................................................................... 8AWS Marketplace實地示範計劃 ........................................................................................... 18產品 Support 連線 ............................................................................................................. 18更多資源AWS Marketplace 管理入口網站 .............................................................................. 25

準備您的產品 .................................................................................................................................... 26產品定價 .................................................................................................................................. 27

AWS費用與軟體費用 .......................................................................................................... 27每年定價 .......................................................................................................................... 28使用定價 .......................................................................................................................... 28私人優惠 .......................................................................................................................... 29SaaS 訂閱定價 ................................................................................................................. 29SaaS 合約定價定價 ........................................................................................................... 29AMI 定價模式 ................................................................................................................... 29使用 SaaS 為您的軟體定價 ................................................................................................. 31年度產品 .......................................................................................................................... 35Refunds ........................................................................................................................... 35

區域和國家 ............................................................................................................................... 37AWS 區域 ........................................................................................................................ 37Countries ......................................................................................................................... 37

私人提議 .................................................................................................................................. 38私人優惠的運作方式 .......................................................................................................... 38透過諮詢合作夥伴私人優惠 ................................................................................................. 38私有優惠 .......................................................................................................................... 38支援的產品類型 ................................................................................................................. 39優惠提交流程 .................................................................................................................... 39報告私人優惠 .................................................................................................................... 40靈活的付款排程 ................................................................................................................. 40諮詢合作夥伴私人優惠 ....................................................................................................... 41私人優惠升級與續約 .......................................................................................................... 45

標準化授權條款 ......................................................................................................................... 46的標準合約AWS Marketplace(SCMP) ................................................................................... 46的企業合約AWS Marketplace(ECMP) ................................................................................... 47

類別和中繼資料 ......................................................................................................................... 47命名和描述您的產品 .......................................................................................................... 47選擇類別和關鍵字 .............................................................................................................. 49

搜尋引擎最佳化 ......................................................................................................................... 49Keywords ......................................................................................................................... 49軟體類別 .......................................................................................................................... 50亮光區段 .......................................................................................................................... 50

iii


簡短描述 .......................................................................................................................... 50Example .......................................................................................................................... 50

AWS Marketplace適用於桌面應用程式 (AMDA) ...................................................................................... 51開始上線程序 .......................................................................................................................... 51產品提交與包裝 ......................................................................................................................... 51應用程式封裝類型 ...................................................................................................................... 52建立 AMDA 套件 ....................................................................................................................... 52應用中繼資料 ............................................................................................................................ 52擷取和新版本更新 ...................................................................................................................... 53

基於阿美的產品 ................................................................................................................................. 54AMI 為基礎的產品交付方式 ......................................................................................................... 54瞭解 AMI 產品 .......................................................................................................................... 54

產品生命週期 .................................................................................................................... 55AMI 產品代碼 ................................................................................................................... 55變更請求 .......................................................................................................................... 56產品載入表單 .................................................................................................................... 56

單一 Ami 產品 .......................................................................................................................... 57Prerequisites .................................................................................................................... 57建立產品 .......................................................................................................................... 57建立變更請求 .................................................................................................................... 58取得請求的狀態 ................................................................................................................. 59更新產品資訊 .................................................................................................................... 59更新版本資訊 .................................................................................................................... 60新增新的版本 .................................................................................................................... 60給予AWS Marketplace存取 AMI .......................................................................................... 61限制版本 .......................................................................................................................... 62從中移除產品AWS Marketplace ........................................................................................... 63提交變更請求時的常見錯誤 ................................................................................................. 63

使用 CloudFormation 的 AMI 交付 ............................................................................................... 64建立您的產品清單 .............................................................................................................. 64正在準備您的AWS CloudFormation範本 ................................................................................ 65取得範本基礎結構的成本估算 .............................................................................................. 66拓樸圖 ............................................................................................................................. 66符合提交要求 .................................................................................................................... 66提交您的產品請求 .............................................................................................................. 67新增無伺服器應用程式元件 ................................................................................................. 67

私有映像 .................................................................................................................................. 73套件群組需求 .................................................................................................................... 73提交您的套件群組 .............................................................................................................. 74掃描狀態 .......................................................................................................................... 74提交您的產品至AWS Marketplace ........................................................................................ 75

建立 AMI 的最佳實務 ................................................................................................................. 76驗證 AMI ......................................................................................................................... 76保護轉售權利 .................................................................................................................... 76建置 AMI ......................................................................................................................... 76確認您的軟體正在您的AWS MarketplaceAMI ......................................................................... 77保護 AMI ......................................................................................................................... 77

計量服務 .................................................................................................................................. 78計量服務概念 .................................................................................................................... 78為您的軟體定價 ................................................................................................................. 79將您的產品新增至AWS Marketplace ..................................................................................... 80修改軟體以使用計量服務 .................................................................................................... 81致電 AWS Marketplace Meting Service ................................................................................ 34失敗處理 .......................................................................................................................... 35限制 ................................................................................................................................ 83

AMI 產品檢查表 ........................................................................................................................ 84AMI 安全政策 ........................................................................................................................... 85

iv


安全政策 .......................................................................................................................... 85存取原則 .......................................................................................................................... 85客戶資訊政策 .................................................................................................................... 86產品使用政策 .................................................................................................................... 86架構 ................................................................................................................................ 87

以貨櫃為基礎的產品 .......................................................................................................................... 88取得說明 .................................................................................................................................. 88開始使用容器產品 ...................................................................................................................... 88

建立容器產品 .................................................................................................................... 89建立容器產品的產品識別碼 ................................................................................................. 89建立或更新容器產品的定價 ................................................................................................. 89為您的容器產品整合計量 .................................................................................................... 90新增產品的新版本 .............................................................................................................. 90更新版本資訊 .................................................................................................................... 92建立或更新容器產品的產品資訊 ........................................................................................... 93發佈容器產品 .................................................................................................................... 94容器產品會掃描安全性問題 ................................................................................................. 94

以貨櫃為基礎的產品需求 ............................................................................................................ 94安全性需求 ....................................................................................................................... 95存取要求 .......................................................................................................................... 95客戶資訊要求 .................................................................................................................... 95產品使用需求 .................................................................................................................... 95架構要求 .......................................................................................................................... 95

定價容器產品 ............................................................................................................................ 96容器產品的定價模式 .......................................................................................................... 96

AWS Marketplace計量服務整合 ................................................................................................... 97Entitlement ....................................................................................................................... 97整合指導方針 .................................................................................................................... 97支援的 AWS 區域 ............................................................................................................. 98防止計量修改 .................................................................................................................... 98自訂計量 .......................................................................................................................... 98每小時計量 ..................................................................................................................... 104

機器學習產品 .................................................................................................................................. 111開始使用機器學習產品 ............................................................................................................. 111

模 SageMaker 套件 ......................................................................................................... 111SageMaker 演算法 .......................................................................................................... 111部署推論模型 .................................................................................................................. 111

安全和智慧財產權 ................................................................................................................... 112保護智慧財產 ................................................................................................................. 112無網路存取 ..................................................................................................................... 112客戶資料的安全性 ........................................................................................................... 112

為 Machine Learning 產品定價 .................................................................................................. 112基礎設施定價 .................................................................................................................. 112軟體定價 ........................................................................................................................ 113

準備您 SageMaker 產品 ........................................................................................................... 114將您的程式碼封裝成影像 ................................................................................................... 114上傳影像 ........................................................................................................................ 127創建您 Amazon SageMaker .............................................................................................. 128

發行您的產品AWS Marketplace ................................................................................................. 132發佈程序概觀 .................................................................................................................. 132必要許可 ........................................................................................................................ 132建立您的產品清單 ............................................................................................................ 133測試您的產品 .................................................................................................................. 134更新您的產品 .................................................................................................................. 134

建立機器學習產品的需求和最佳做法 ........................................................................................... 135必要資產 ........................................................................................................................ 136ML 產品的一般最佳實務 ................................................................................................... 136

v


使用資訊的要求 ............................................................................................................... 1366. 对于输入和输出的要求 .................................................................................................. 137Jupyter 筆記型電腦的需求 ................................................................................................. 137ML 產品清單的需求和建議摘要 .......................................................................................... 138

服務限制與配額 ....................................................................................................................... 140網路隔離 ........................................................................................................................ 140影像大小 ........................................................................................................................ 140儲存空間大小 .................................................................................................................. 140執行個體大小 .................................................................................................................. 140推論的承載大小 ............................................................................................................... 141推斷的處理時間 ............................................................................................................... 141服務配額 ........................................................................................................................ 141受管 Spot 訓練 ............................................................................................................... 141Docker 影像和AWSACCOMPT .......................................................................................... 141從內建演算法或AWS Marketplace ..................................................................................... 141支援AWS要發佈的區域 ..................................................................................................... 141

Troubleshooting ...................................................................................................................... 142Reporting ............................................................................................................................... 142

每日業務報告 .................................................................................................................. 143每月收入報告 .................................................................................................................. 143支付報告 ........................................................................................................................ 143其他報告與分析 ............................................................................................................... 143

軟體即服務 (SaaS) 型產品 ................................................................................................................ 144入門 ...................................................................................................................................... 144

Prerequisites .................................................................................................................. 144SaaS 訂閱 ...................................................................................................................... 144SaaS 合約 ...................................................................................................................... 146含消費量的 SaaS 合約 ..................................................................................................... 147

規劃 SaaS 產品 ...................................................................................................................... 149規劃定價 ........................................................................................................................ 149規劃您的帳單整合 ............................................................................................................ 149規劃您的 Amazon SNS 整合 ............................................................................................. 150規劃客戶存取您產品的方式 ................................................................................................ 150

SaaS 產品指導方針 ................................................................................................................. 150產品設定指導方針 ............................................................................................................ 151客戶資訊要求 .................................................................................................................. 151產品使用指導方針 ............................................................................................................ 151架構指導方針 .................................................................................................................. 151

定價 SaaS 產品 ...................................................................................................................... 152SaaS 訂閱的定價 ............................................................................................................ 152SaaS 合約的定價 ............................................................................................................ 153

SaaS 客戶上線 ....................................................................................................................... 155設定您的 SaaS 產品以接受新買家 ...................................................................................... 155

SaaS 產品的 Amazon SNS 通知 ............................................................................................... 156SaaS 產品 Amazon SNS 訊息主體 .................................................................................... 156SaaS 產品 Amazon SNS 行動 ........................................................................................... 157訂閱 SQS 佇列至 SNS 主題 .............................................................................................. 157輪詢 SQS 佇列以尋找通知 ................................................................................................ 157

正在存取AWS Marketplace計量與權利服務 API ............................................................................ 157使用方式的計量 ............................................................................................................... 157檢查權利 ........................................................................................................................ 158SaaS 產品整合檢查清單 ................................................................................................... 159

Reporting ............................................................................................................................... 160程式碼範例 ............................................................................................................................. 161

ResolveCustomer 程式碼範例 ............................................................................................ 161輸入 GetEntitlement 程式碼範例 ........................................................................................ 162BatchMeterUsage 程式碼範例 ........................................................................................... 163

vi


使 AWS PrivateLink 時搭配AWS Marketplace .............................................................................. 164Introduction .................................................................................................................... 164設定您的產品 .................................................................................................................. 164將您的產品提交至AWS Marketplace ................................................................................... 165購買者存取 VPC 端點 ...................................................................................................... 165附錄：檢查清單 ............................................................................................................... 166

專業服務產品 .................................................................................................................................. 167取得說明 ................................................................................................................................ 167入門使用專業服務產品 .............................................................................................................. 167

Prerequisites .................................................................................................................. 167創造專業服務產品 ............................................................................................................ 168建立私有優惠 .................................................................................................................. 168編輯產品資訊 .................................................................................................................. 169編輯產品定價 .................................................................................................................. 170編輯產品可見度 ............................................................................................................... 170移除專業服務產品 ............................................................................................................ 170

產品詳細資訊 .......................................................................................................................... 171產品描述 ........................................................................................................................ 171其他資源 ........................................................................................................................ 172Support 資訊 .................................................................................................................. 172定價維度 ........................................................................................................................ 172產品可見度 ..................................................................................................................... 172

產品需求 ................................................................................................................................ 172產品設定指導方針 ............................................................................................................ 173客戶資訊要求 .................................................................................................................. 173產品使用指導方針 ............................................................................................................ 173架構指導方針 .................................................................................................................. 173

Data Exchange ............................................................................................................................... 175提交您的產品 .................................................................................................................................. 176

使用產品標籤 .......................................................................................................................... 176公司和產品標誌要求 ................................................................................................................. 177提交付費重新封裝軟體的需求 ..................................................................................................... 177AWS CloudFormation-推出的產品（免費或付費）或基於使用量的付費 AMI 產品 ................................ 178

提交您的產品 .................................................................................................................. 178更新您的產品 .................................................................................................................. 178

產品變更與更新 ....................................................................................................................... 179時間與期望 ............................................................................................................................. 179將 AMI 提交至AWS Marketplace ................................................................................................ 179

AMI 自助式掃描 .............................................................................................................. 179AMI 複製和產品代碼分配 .................................................................................................. 180

最終檢查清單 .......................................................................................................................... 180行銷您的產品 .................................................................................................................................. 182

180 天的 GTM 學院 ................................................................................................................. 182宣佈產品的可用性 .................................................................................................................... 182AWS Marketplace簡訊 ............................................................................................................. 182上的AWS Marketplace ............................................................................................................. 183連結至AWS Marketplace .......................................................................................................... 183使用AWS Marketplace標誌 ....................................................................................................... 183直接鏈接到您的產品AWS Marketplace ........................................................................................ 183新聞稿 ................................................................................................................................... 184AWS Marketplace商標使用指導方針 ........................................................................................... 184

賣家報告和資料摘要 ......................................................................................................................... 186賣方報告 ................................................................................................................................ 186

存取報告 ........................................................................................................................ 186每日業務報告 .................................................................................................................. 186每日客戶訂閱報告 ............................................................................................................ 192支付報告 ........................................................................................................................ 194

vii


每月計費收入報告 ............................................................................................................ 198銷售報告 ........................................................................................................................ 203美國銷售與使用稅務報表 ................................................................................................... 204

資料饋送 ................................................................................................................................ 207資料饋送的儲存與結構 ...................................................................................................... 207存取資料饋送 .................................................................................................................. 208使用資料饋送 .................................................................................................................. 209資料摘要表格概觀 ............................................................................................................ 210資料摘要查詢範例 ............................................................................................................ 216帳戶資料饋送 .................................................................................................................. 226位址資料饋送 .................................................................................................................. 228帳單事件資料饋送 ............................................................................................................ 229舊式對映資料饋送 ............................................................................................................ 237優惠資料饋送 .................................................................................................................. 238提供產品資料饋送 ............................................................................................................ 239提供目標資料饋送 ............................................................................................................ 240產品資料饋送 .................................................................................................................. 241稅務項目資料饋送 ............................................................................................................ 242

安全性 ............................................................................................................................................. 85IAMAWS Marketplace .............................................................................................................. 247

建立使用者 .................................................................................................................... 248建立或使用群組 ............................................................................................................... 249以 IAM 使用者身分登入 .................................................................................................... 250

的政策和許可AWS Marketplace賣方 ........................................................................................... 250政策 .............................................................................................................................. 250許可 .............................................................................................................................. 251

AWS 受管政策 ........................................................................................................................ 252安全地方治療 .................................................................................................................. 253智慧安裝完整存取 ............................................................................................................ 254可能的智慧放置位置 ......................................................................................................... 255安裝計量完整存取 ............................................................................................................ 256安全放置計量註冊使用 ...................................................................................................... 256智慧位置設定員完整存取 ................................................................................................... 256AwSmartAller 產品完整存取 .............................................................................................. 258AwSmartAller 產品僅供讀取 .............................................................................................. 258政策更新 ........................................................................................................................ 259

AWS MarketplaceCommerce Analytics Service 帳戶權限 ............................................................... 259AWS Marketplace產品 Support 連線帳戶權限 .............................................................................. 260Amazon SQS 權限 .................................................................................................................. 260AWS Marketplace計量和權利 API 權限 ....................................................................................... 261

SaaS 產品的 IAM 政策 ..................................................................................................... 261AMI 產品的 IAM 政策 ....................................................................................................... 261容器產品的 IAM 政策 ....................................................................................................... 262

使用 AWS CloudTrail 記錄 AWS Marketplace API 呼叫 ................................................................. 262範例: AWS Marketplace 日誌檔案項目 ................................................................................ 262相關主題 ........................................................................................................................ 263

文件歷史記錄 .................................................................................................................................. 264AWS 詞彙表 ................................................................................................................................... 267................................................................................................................................................. cclxviii

viii

AWS Marketplace 賣方指南使用AWS Marketplace為賣方

什麼是 AWS Marketplace？AWS Marketplace是精選的數位目錄，客戶可用來尋找、購買、部署和管理第三方軟體、資料和服務，而客戶需要這些軟體和軟體，來建置解決方案並執行其業務。AWS Marketplace包含來自安全性、網路、儲存、機器學習、商業智慧、資料庫等熱門類別的數千種軟體清單，以及相關的專業服務，協助您管理和支援這些解決方案。AWS Marketplace也可透過彈性的定價選項和多個部署方法，簡化軟體授權和採購。除此之外，AWS Marketplace包括 AWS Data Exchange 所提供的資料產品。

客戶只需按幾下滑鼠即可快速啟動預先設定的軟體，並在 Amazon Machine Images (AMI)、軟體即服務(SaaS) 和其他格式中選擇軟體解決方案。您可以瀏覽並尋找與軟體相關的專業服務。您可以瀏覽並訂閱資料產品。彈性的定價選項包括免費試用、每小時、每月、每年、多年和自攜服務，並從單一來源收費。AWS處理帳單和付款，費用會出現在客戶上AWS法案。

您可以使用AWS Marketplace作為買方（用戶），賣方（供應商），或兩者。任何擁有AWS帳戶可以使用AWS Marketplace作為買方，並可以註冊成為賣方。銷售者可以是獨立軟體廠商 (ISV)、諮詢合作夥伴、代管服務提供者 (MSP)，或是個人可以提供適用於AWS產品與服務。

Note

資料產品供應商必須符合 AWS Data Exchange 資格要求。如需詳細資訊，請參閱「」在 AWSData Exchange 中提供資料產品中的AWS Data Exchange 使用者指南。

每個軟體產品AWS Marketplace已經通過策劃過程。在產品頁面上，可以有一個或多個產品供應項目。當賣方提交產品AWS Marketplace，他們定義了產品的價格和使用條款和條件。當消費者訂閱產品供應項目時，他們同意針對該優惠設定的定價和條款與條件。

該產品可以免費使用，也可以有相關的費用。收費會成為您的AWS賬單，並在您付款後，AWS Marketplace支付賣方。產品可以採用多種形式。例如，一個產品可以提供為使用實例化的 Amazon MachineImage（AMI）訂閱者的 AWS帳戶。產品也可以配置為使用AWS CloudFormation模板傳遞給消費者。產品也可以是 ISV、Web ACL、一組規則或AWS WAF。此產品也可能是 ISV、諮詢合作夥伴或 MSP 提供的專業服務。

您可以使用 ISV 的標準終端使用者授權合約 (EULA) 以上列出價格購買軟體產品，或透過私人優惠提供客製定價和 EULA。產品也可以根據指定的時間或使用限制的合約購買。產品訂閱完成後，消費者可以將產品複製到他們的AWS Service Catalog來管理產品在消費者組織中存取和使用的方式。

使用AWS Marketplace為賣方身為賣家，請前往AWS Marketplace 管理入口網站註冊。如果您是為了使用產品而收取費用，您也必須在註冊時提供稅務和銀行資訊。當您註冊時，您可以為您的公司或您自己建立可在AWS Marketplace。您也可以使用AWS Marketplace 管理入口網站，為您的產品建立和管理產品頁面。

符合資格的合作夥伴可以以AWS Marketplace產品以外AWS Marketplace。如需成為合格合作夥伴的詳細資訊，請聯絡您的AWS Marketplace業務發展夥伴。

如需有關在AWS Marketplace，請參閱下列內容：

• AWS Marketplace適用於桌面應用程式 (AMDA) (p. 51)• 基於阿美的產品 (p. 54)• 以貨櫃為基礎的產品 (p. 88)• 機器學習產品 (p. 111)• 軟體即服務 (SaaS) 型產品 (p. 144)

1

https://docs.aws.amazon.com/data-exchange/latest/userguide/providing-data-sets.html


http://aws.amazon.com/marketplace/management


AWS Marketplace 賣方指南使用AWS Marketplace為賣方

• 專業服務產品 (p. 167)

如需資料產品的詳細資訊，請參閱什麼是 AWS Data Exchange？中的AWS Data Exchange 使用者指南。

註冊為賣家後，你可以使用AWS Marketplace 管理入口網站管理您的帳戶和產品，以及存取產品的使用報告。

2

https://docs.aws.amazon.com/data-exchange/latest/userguide/what-is.html

AWS Marketplace 賣方指南出版自由軟體產品的賣家要求

開始為賣方如果您想在AWS Marketplace，請檢閱相關規定，然後按照步驟註冊為賣家。根據您居住的地點和銷售的產品類型，有不同的註冊要求。註冊為賣方AWS Marketplace，您可使用現有AWS帳戶或建立新帳戶。All (全部)AWS Marketplace互動會繫結至您選擇的帳戶。

Notes

• 註冊為AWS Marketplace賣方是成為 AWS Data Exchange 資料提供者的先決條件。如需這些需求的詳細資訊，請參閱在 AWS Data Exchange 中提供資料產品中的AWS Data Exchange 使用者指南。

• 如需許可的詳細資訊，請參閱AWS Marketplace賣家需要，請參閱的政策和許可AWSMarketplace賣方 (p. 250)。

出版自由軟體產品的賣家要求無論您是否為您的產品收費，當您在AWS Marketplace，您正在銷售該產品。客戶的費用是 $0.00，但您和客戶同意使用該產品的共同合同。如果您只提供免費產品，您不需要提供銀行資訊給AWS Marketplace。若要建立並提供免費產品AWS Marketplace，您必須：

• 銷售可公開取得的全功能生產就緒軟體。• 擁有定義的客戶支援程序和支援組織。• 提供一種方法，讓軟體定期更新且沒有漏洞。• 在行銷您的產品時，請遵循最佳做法和準則AWS Marketplace。• 成為AWS客戶在良好的地位，並符合要求的條款和條件AWS Marketplace賣方。

付費產品的其他賣方要求如果您收取產品費用或提供自攜授權模式 (BYOL) 產品，您也必須符合下列需求，並提供此額外資訊：

• 您必須是永久居民或合格的管轄區 (p. 3)，或在其中一個領域組織或合併的商業實體。• 您必須提供稅金和銀行帳戶資訊。對於以美國為基地的實體，需要 W-9 表格和美國銀行的銀行帳戶。• 非美國賣家必須提供 (i) W-8 表格、增值稅 (VAT) 或商品及服務稅 (GST) 登記號碼，以及 (ii) 美國銀行資

訊。如果您還沒有美國銀行帳戶，您可以從超公事包。• 若要提供資料產品，您也必須透過建立案例AWS Support。

若要銷售到AWS GovCloud (US) Region，賣方必須擁有AWS GovCloud (US)account。如需 ITAR 需求的詳細資訊，請參閱AWS GovCloud (US)使用者指南。

如有任何問題AWS Marketplace賣方需求或註冊程序，請聯絡AWS Marketplace賣方營運團隊。

付費產品的合格司法管轄區若要銷售付費軟體AWS Marketplace，您必須是下列其中一個國家或 SAR 的永久性居民或公民，或在其中組織或成立的商業實體：

• 澳大利亞 ¹

3


https://wssellers.hyperwallet.com/

https://console.aws.amazon.com/support/cases?#/create?issueType=customer-service

http://aws.amazon.com/govcloud-us/getting-started/

https://docs.aws.amazon.com/govcloud-us/latest/UserGuide/getting-started-sign-up.html

http://aws.amazon.com/marketplace/management/contact-us/

AWS Marketplace 賣方指南AWS Marketplace 管理入口網站

• 巴林 ¹ ²• 歐盟 (歐盟) 成員國 ¹• 香港特別行政區• 日本 ² ³• 紐西蘭 ¹• 挪威 ¹ ²• 卡達• 瑞士 ¹ ²• 阿拉伯聯合大公國 (阿聯酋) ¹ ²• 英國 (UK) ¹• 美國 (美國)

¹ 付費產品在這些國家/地區的賣家必須提供所屬國家/地區的增值稅註冊資訊。

² 如果您作為賣家位於買家所在國家/地區，您可能需要負責開立稅款發票、收款和匯款。請諮詢您的稅務顧問。

³ 位於日本的賣家有義務自行計算刊登費用的日本消費稅（JCT）。位於其他司法管轄區的賣家可能有類似的義務。請諮詢您的稅務顧問。

如需有關 VAT、開立發票以及作為賣家的稅務義務的詳細資訊，請參閱AWS Marketplace上的亞馬遜 Web服務稅幫助。

AWS Marketplace 管理入口網站所以此AWS Marketplace 管理入口網站是您用來註冊為AWS Marketplace賣方，然後管理的產品，你賣AWSMarketplace。您可以在入口網站上完成下列作業：

• 註冊為AWS Marketplace賣方。• 使用產品頁面提交新軟體產品並更新現有軟體產品。• 監控您的請求狀態。• 上傳建立和管理新軟體產品所需的檔案。• 利用進入市場活動，將軟體產品管理成增加的通路收益。• 在推出後數小時內測量行銷成果的結果，包括廣告活動所帶來的使用量和收益。• 讓客戶服務代表即時擷取客戶資料。• 啟動自動 AMI 掃描以偵測弱點。

Note

資料產品是從 AWS Data Exchange 主控台發佈和管理。AWS Data Exchange 提供者可以使用AWS Marketplace 管理入口網站註冊為賣方、申請 AWS Data Exchange 上線、存取賣方報告以及提交退款請求。

所有已註冊的賣家都可以存取AWS Marketplace 管理入口網站使用他們的AWS認證，用來建立其產品的帳戶。您使用的帳戶被定義為當客戶訂閱您的產品時的記錄賣方。如果您需要協助判斷產品記錄銷售商的特定帳戶，請聯絡AWS Marketplace賣方營運團隊。

AWS Marketplace強烈建議使用AWS Identity and Access Management(IAM) 角色，以登入AWSMarketplace 管理入口網站，而不是使用根帳戶認證。如需詳細資訊，請參閱「」IAM 使用者中的IAM UserGuide。

4

http://aws.amazon.com/tax-help/marketplace/

http://aws.amazon.com/tax-help/


http://aws.amazon.com/marketplace/management/tour


https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html#intro-identity-users

AWS Marketplace 賣方指南註冊

若要讓您的公司人員登入AWS Marketplace 管理入口網站，請為您想要存取的每個人建立 IAM 使用者，並定義AWS Marketplace 管理入口網站。我們也建議您建立根或帳戶擁有者 IAM 進行存取。

註冊註冊為AWS Marketplace，您可以將您的產品和服務銷售給其他AWS Marketplace客戶。

註冊為賣方需要執行下列步驟：

1. 建立您的公開個人檔案— 您可以提供顯示在AWS Marketplace告知他們您的公司資訊，例如您的公司名稱和標誌。完成此程序後，您可以免費銷售產品。若要銷售付費產品，您必須完成步驟 2 和 3。

2. 提供您的稅務資訊— 若要適當地評估、報告及 (如適用) 您已付銷售的代扣稅，您必須提供您的稅捐和增值稅 (VAT) 資訊。

3. 提供您的銀行資訊— 您提供您的美國銀行資訊，以便AWS Marketplace可以支付您的銷售額。4. (選用)註冊美國稅務計算服務— 您可以選擇性地註冊此服務，以計算您在AWS Marketplace。

下列各節將更詳細的說明這些步驟。

完成註冊成為賣家後，你可以建立商品，透過AWS Marketplace。如需更多詳細資訊，請參閱準備您的產品 (p. 26)。

您可以使用AWS Identity and Access Management(IAM) 來設定您的主要AWS帳戶，以允許多個具有各種權限的使用者存取AWS Marketplace 管理入口網站。如需詳細資訊，請造訪 the section called “IAMAWSMarketplace” (p. 247)。

建立您的公開個人檔案註冊的第一個步驟是選擇AWS帳戶作為您的主要AWS Marketplace帳戶，並提供信息，顯示給潛在買家在AWS Marketplace主控台。

Note

一旦你使用AWS帳戶以在AWS Marketplace，則無法變更與產品相關聯的帳戶。您可以使用現有帳戶或註冊新帳戶。此帳戶將成為您的產品記錄的賣家AWS Marketplace，並將用於報告，支付和通信AWS Marketplace給您。

建立公開設定檔

1. 從AWS Marketplace 管理入口網站(AMMP)，選擇立即註冊然後登入你選擇的賣家AWS帳戶。2. 選擇新增公開設定檔，提供賣家資料。

完成公開設定檔後，您就可以發佈和銷售免費產品。若要銷售付費產品，您必須提供稅務和銀行資訊。

提供稅務資訊您必須提供您的稅金和增值稅 (VAT) (如適用) 資訊，以便AWS Marketplace可以準確地報告和預扣您的產品銷售額的稅金。

提供您的稅務資訊

1. 登入。AWS Marketplace 管理入口網站，然後選擇設定。2. 選擇完整的稅務資訊中的付款資訊] 區段。3. 在您完成稅務資訊後，返回設定頁面並選取完整的增值稅資訊(如果可用)。

5

http://aws.amazon.com/marketplace/management/tour/

http://aws.amazon.com/marketplace/management/

AWS Marketplace 賣方指南提供美國銀行帳戶資訊

Note

增值稅資訊區段僅適用於AWS支援增值稅的區域。

提供美國銀行帳戶資訊所有想要在AWS Marketplace。AWS Marketplace只支付給美國銀行帳戶。

Note

如需提供付費產品的國家/地區清單AWS Marketplace，請參閱付費產品的合格司法管轄區 (p. 3)。

提供銀行資料

1. 登入。AWS Marketplace 管理入口網站，然後選擇設定。2. 選擇完整的銀行資訊中的付款資訊] 區段。3. 提供有關您美國銀行帳戶的必要資訊。

Note

如果您尚未提供稅務資料（以及增值稅資料，如適用），您將無法提供您的銀行資料。

如果您還沒有美國銀行帳戶，您可以透過超值錢包取得帳戶。超級錢包可以為您提供美國帳戶，您可以提供該帳戶給AWS Marketplace適用於您的AWS Marketplace支出。

超級錢包是獨立的服務供應商，可讓您以支援的貨幣將資金轉移到另一個銀行帳戶。在有限的時間內，您無需支付與AWS Marketplace支出。

• 只要將您的超電子錢包帳戶詳細資料新增至AWS Marketplace賣家帳戶，您同意並確認AWS Marketplace將與超電子錢包分享您的姓名、電子郵件地址和帳號，以確認您的身份為AWS Marketplace賣方。

• 您使用「超級錢包」服務可能需要支付額外費用（包括匯款手續費和匯款至您當地貨幣所需的外匯費用），以及匯率。超級電子錢包的服務費將於限定時間內豁免，而且僅限於AWS Marketplace將您已付款產品的收益支付至您的「超級錢包」帳戶。請參閱超電子錢包網站的「費用」部分或聯絡超電子錢包以取得更多資訊並檢視適用的費用。請造訪超電子錢包支援網站了解更多有關他們的服務。

使用超電子錢包開始註冊並取得您的美國銀行帳戶資料

1. 登入。AWS Marketplace 管理入口網站，然後選擇設定，然後選取完整的銀行資訊中的付款資訊] 區段。

2. 如果您還沒有超級錢包帳戶，而且需要使用帳戶AWS Marketplace中，選擇否為了回應您是否具備美國銀行帳戶？和您是否已使用超級錢包註冊？您將獲得個人識別碼 (PIN)，以及註冊超級錢包的連結。

3. 在您啟動超電子錢包帳戶後，請按照超電子錢包註冊入口網站上說明的步驟完成註冊並接收您的存款帳戶資訊。

4. 當您從「超電子錢包」取得帳戶時，請將您的超電子錢包帳戶資訊新增至AWS帳戶，方法是登入AWSMarketplace 管理入口網站。然後，選擇設定，然後選取完整的銀行資訊中的付款資訊] 區段。

AWS Marketplace 稅收計算服務AWS Marketplace稅捐計算服務提供計算和收取美國銷售和使用稅的功能，以及現有和新產品的使用稅。某些州不符合稅捐計算服務的資格，因為AWS Marketplace根據法律規定，收集並匯出您的產品應課稅銷售給客戶的適用銷售稅。若要使用此服務，請針對您的賣家設定檔設定您的稅務連結設定，然後將產品稅碼指派給您的產品。

6


https://wssellers.hyperwallet.com/hw2web/consumer/page/contact.xhtml




AWS Marketplace 賣方指南支付與買家帳單

若要進行稅務連結設定，請開啟AWS Marketplace 管理入口網站，以及在設定索引標籤設定適用的稅捐連結設定。然後，將產品稅碼 (PTC) 指派給您的產品，透過AWS Marketplace 管理入口網站。建議您檢閱AWSMarketplace和AWS Marketplace 產品稅法指南在其全部完成這個過程之前。對於不支援的產品類型產品索引標籤提交程序中，選擇檔案上傳來自資產] 索引標籤。您必須編輯並上傳更新的產品載入表單。

完成上述兩個步驟後，將啟用美國銷售和使用稅金計算。注意下列事項：

• 啟動您的稅務連接設定需要 5 至 48 小時。• 您必須先設定稅務連結，才能指派 PTC。• PTC 指派會在AWS Marketplace團隊核准並發佈您的產品，這可能需要 3-5 天的時間，從您提交產品變更

請求。• 稅額計算開始時，預估的營業稅費用將包含在客戶發票中。銷售稅將根據各種因素來計算，包括但不限於

客戶的帳單地址、產品的稅務代碼，以及您的稅務連結設定。產生的營業稅費用 (如果適用) 將包含在客戶的發票中，並在貴公司銷售的特定產品中識別為美國營業稅費用。請注意，客戶發票會顯示貴公司的法定名稱，您在註冊成為AWS Marketplace賣方。

• 收集的營業稅基金會隨每月支付一起傳送，而美國營業與使用稅報表則會在該月十五日提供給您，詳細說明所收取的稅金。您有責任匯出自己的稅款。

如果您註冊AWS Marketplace稅務計算服務，我們還建議您註冊亞馬遜免稅計劃（阿提普）。您不需要使用此服務。不過，我們建議所有AWS Marketplace使用稅務計算服務的賣家參與 ATEP。參與有助於減少在ATEP 註冊的合格客戶所需處理的僅稅款退款次數。

您可以編輯或刪除稅捐計算服務設定值] 頁面上的AWS Marketplace 管理入口網站。

如需詳細資訊，請造訪AWS Marketplace上的亞馬遜 Web 服務稅幫助進一步了解AWS對您的銷售收取營業稅、增值稅或商品及服務稅，並以AWS, Inc.

Note

您對稅務計算服務的使用受AWS Marketplace美國徵稅 Support 條款與條件

支付與買家帳單AWS會代表您進行計費。買家最常見的兩種付款方式是信用卡和開立發票。

以下是關於AWS Marketplace訂閱：

• 使用預付款的購買項目會在訂閱時立即收取費用。• 私人優惠的計費時間表是買方和賣方之間的協議。• 買家與買家同意發票付款條件 (包括帳單到期日)AWS。條款有些許差異。非向供應商披露。• 使用彈性付款排程器的私人優惠必須在開立發票作為付款選項。• 您可以使用每月計費收入報告 (p. 198)。此報表總結了開立商業發票的依據AWS會代表您。此報表包含

要比對的「交易參考」索引鍵，並提供商業發票建立日期與商業發票到期日的可見性。

以下是賣家如何取得款項的相關資料：

• 一個有效的付款方式，一個註冊美國銀行帳戶，並提交 W9 表格以便支付。• 付費產品的賣家必須提供 W-8、增值稅 (VAT) 或商品稅 (GST) 登記號碼，以及美國銀行帳戶。超公事包可

以為您提供美國銀行帳戶，您可以提供該帳戶給AWS Marketplace適用於您的AWS Marketplace支出。• AWS支付每月款項直接向銀行帳戶與賣方帳戶，減去AWS Marketplace服務費用。• AWS在買家支付發票後，透過 ACH 轉帳支付款項。• AWS支付每月一次之間的 7 日和 10 日的一個月。賣家每個月的日期都相同。所以此支付報告 (p. 194)將

反映您的支付日期。• AWS支出涵蓋每月滾動期間（從創建賣家帳戶時開始）。

7

http://aws.amazon.com/marketplace/management/settings


https://s3.amazonaws.com/aws-mp-seller-tax-terms/AWS_Marketplace_Tax_Methodology_Doc.pdf

https://s3.amazonaws.com/aws-mp-seller-tax-terms/AWS_Marketplace_Tax_Methodology_Doc.pdf

https://s3.amazonaws.com/aws-mp-seller-tax-terms/Product_Tax_Codes_for_US_Sales_Tax.pdf



http://aws.amazon.com/tax-help/marketplace/


https://s3.amazonaws.com/aws-mp-seller-tax-terms/AWS_Marketplace_Tax_Support_Terms_and_Conditions.pdf?icmpid=docs_marketplace_helppane

http://portal.aws.amazon.com/gp/aws/developer/account?ie=UTF8&action=payment-method

http://aws.amazon.com/marketplace/management/seller-settings/account/bank

https://wssellers.hyperwallet.com/

AWS Marketplace 賣方指南已經是賣方了嗎？

• 只有在向客戶收集資金後才會支付。• 付款大約需要 1 至 2 個工作日才能到達賣家的銀行。確切的時間取決於銀行和時區。• 支付報表會在AWS Marketplace 管理入口網站支付後的 3 至 5 天。• 有關已支付資金和未收款資金的詳細資料，請參閱每月支付報告，包括任何未結帳應收帳款。• 如果您參與AWS Marketplace稅務計算服務、任何向客戶收取的美國銷售和使用稅將包含在您的每月支付

中。

已經是賣方了嗎？利用上市活動，將您的產品管理成增加的通路收益，方法是利用AWS Marketplace 管理入口網站。活動包括下列項目：

• 在數小時內測量行銷成果的結果，包括廣告活動所帶來的使用量和收益。• 讓客戶服務代表即時擷取客戶資料。• 上傳建立和管理產品所需的檔案，並在我們處理產品時監控進度。

賣方工具組所以此AWS Marketplace 管理入口網站是您銷售產品的主要工具AWS Marketplace。下列其他工具可讓您更深入了解客戶群，並協助您深入了解銷售情況。

• AWS MarketplaceCommerce Analytics Service (p. 8)• AWS Marketplace實地示範計劃 (p. 18)• 產品 Support 連線 (p. 18)• 賣家報告和資料摘要 (p. 186)• 更多資源AWS Marketplace 管理入口網站 (p. 25)

AWS MarketplaceCommerce Analytics Service所以此AWS Marketplace商務分析服務可讓您透過程式設計方式存取產品和客戶資料AWS Marketplace。註冊服務後，您可以透過AWS開發套件。

8



AWS Marketplace 賣方指南AWS MarketplaceCommerce Analytics Service

您使用 SDK 工具請求的資料會傳遞至您的AWS帳戶作為資料集。大部分的資料集對應至與AWSMarketplace 管理入口網站。您可以請求特定日期的資料集，並將資料傳遞到提供的 Amazon S3 儲存貯體。Amazon Simple Notification Service (Amazon SNS) 提供資料傳遞通知。

使用條款及細則這些AWS Marketplace商務分析服務條款與條件（以下稱」CAS 條款」) 包含您使用及存取AWSMarketplaceCommerce Analytics ServiceCA 服務」)，且自您按一下「我接受」按鈕或核取方塊之日起生效，或者在您使用任何 CA 服務供應項目時 (如果較早的話)。這些 CAS 條款是AWS Marketplace賣家（」AWS Marketplace賣方條款」) 您和 Amazon Web Services 之間，Inc. (AWS、」we、」我們」或」我們的」），其條款在此納入。如果這些 CAS 條款與AWS Marketplace賣家條款、本 CAS 條款的條款和條件適用，但僅限於此類衝突的範圍內，且僅限於您對 CA 服務的使用。在此處使用但未定義的大寫術語，應具有AWS Marketplace賣方條款。

1. CA 服務和 CAS 資料。若要符合存取 CA 服務的資格，您必須是AWS Marketplace賣家受現有約束AWS Marketplace賣方條款。您接收或可存取與 CA 服務相關的資訊和資料 (」CAS 資料」) 構成訂閱者資訊，並受制於AWS Marketplace賣方條款。您可以在保密的基礎上使用 CAS 資料來改善和鎖定與您的AWS Marketplace內容前提是您不 (a) 向任何第三方披露 CAS 資料；(b) 以任何不符合適用隱私權政策或法律的方式使用任何 CAS 資料；(c) 聯絡訂閱者以影響他們在AWS Marketplace；(d) 貶低我們、我們的附屬公司或其任何或我們各自的產品；或 (e) 基於預定收件人為AWS Marketplace訂閱者。

2. CA 服務限制與安全性。您只能透過 CA 服務文件中所述的方式存取 (或嘗試存取) CA 服務。當您使用CA 服務時，您不會失實陳述或遮罩您的身份或客戶的身份。我們保留自行決定對您使用 CA 服務的權利，設定和強制執行限制，包括但不限於在任何時間段內允許存取 CA 服務的連線數量、呼叫和伺服器數量。您同意且不會試圖規避這些限制。如果我們認為您可能違反本 CAS 條款或濫用 CA 服務，我們保留限制、暫停或終止您存取 CA 服務的權利。

3. CA 服務認證機密性與安全性。 CA 服務認證 (例如密碼、金鑰和用戶端識別碼) 旨在供您識別 API 用戶端。您必須自行負責確保您的憑證保密，並採取一切合理措施，以避免披露、傳播或未經授權使用該等憑證，包括您至少採取的措施保護您自己屬於類似性質的機密資訊。CA 服務認證可能不會內嵌在開放原始碼專案中。您必須對透過您的憑證存取 CA 服務的任何及所有存取負全責。

4. 修改。我們可以隨時修改這些 CAS 條款，方法是在 AWS 網站上張貼修訂版本，或根據AWSMarketplace賣方條款。修改後的條款將於張貼時生效，或者如果我們透過電子郵件通知您，如電子郵件訊息中所述。如果您在本 CAS 條款的任何修改生效日期後繼續使用或存取 CA 服務，即表示您同意受修改後的條款約束。

5. 終止。本 CAS 條款以及本文所授予之 CAS 資料的使用權利，將在您的AWS Marketplace賣家條款由於任何理由。此外，我們得隨時基於任何或無理由停止提供 CA 服務或終止您對 CA 服務的存取權。

入門指南您必須設定AWS帳戶和AWS服務來使用AWS MarketplaceCommerce Analytics Service

若要使用 AWS for WordPressAWS MarketplaceCommerce Analytics Service

1. 設定您的AWS具有許可的帳戶 (p. 9).2. 建立目的地 Amazon S3 儲存貯體 (p. 10).3. 設定用於回應通知的 Amazon SNS 主題 (p. 10).4. 註冊商務分析服務計劃 (p. 10).5. 確認您的組態 (p. 10).

設定您的AWS具有許可的帳戶

AWS Marketplace 強烈建議使用AWS Identity and Access Management(IAM) 角色，以登入AWSMarketplace 管理入口網站，而不是使用根帳戶認證。請參閱the section called “的政策和許可AWSMarketplace賣方” (p. 250)以取得特定 IAM 權限AWS MarketplaceCommerce Analytics Service 請參閱建

9





立 IAM 使用者以取得詳細資訊。為存取您帳戶的人建立個別 IAM 使用者，即可將一組唯一的安全登入資料授予每個 IAM 使用者。您也可以將不同的許可授予每個 IAM 使用者。如有需要，您隨時可以變更或撤銷IAM 使用者的許可。

建立目的地 Amazon S3 儲存貯體

商務分析服務將您請求的資料交付到您指定的 Amazon S3 儲存貯體。如果您已有一個 Amazon S3 儲存貯體可以使用，請移至下一個步驟。

如果您沒有 Amazon S3 儲存貯體，或想要為此資料建立 Amazon S3 儲存貯體，請參閱如何建立 S3 儲存貯體。

設定用於回應通知的 Amazon SNS 主題

商務分析服務使用 Amazon SNS 提供回應通知。服務會將訊息發佈至此主題，以便在您的資料集可用或發生錯誤時通知您。如果您已有 Amazon SNS 主題，則為此目的，請移至下一個步驟。

如果您沒有為此服務設定 Amazon SNS 主題，請立即設定一個主題。如需說明，請參閱「」建立主題。

為您建立之主題的 Amazon Resource Name (ARN) 記錄主題，因為 ARN 是呼叫該服務時需要 ARN。

註冊商務分析服務計劃

在您針對儲存貯體的主題和名稱使用 ARN 設定服務之後，商務分析服務會存取 Amazon S3 儲存貯體和Amazon SNS 主題。

若要啟用存取

1. 登入AWS Marketplace 管理入口網站使 AWS 您用來管理AWS Marketplace產品。2. 導覽至。Commerce Analytics Service。3. 輸入 Amazon S3 儲存貯體名稱和 Amazon SNS 主題 ARN，然後選擇註冊。4. 在許可頁面上，選擇Allow。5. 在AWS Marketplace 管理入口網站，請記錄角色角色 ARN在成功訊息中。您需要 ARN 才能呼叫該服

務。

Note

商務分析服務的登入會在您的AWS帳戶，允許AWS Marketplace以寫入 Amazon S3 儲存貯體，並將通知發佈到 Amazon SNS 主題。

確認您的組態

最後一個步驟是確認您的組態如預期般運作。

測試組態

1. 下載、安裝及設定AWS 命令列界面(AWS CLI。2. 使用AWS CLI，請執行此命令。

aws marketplacecommerceanalytics generate-data-set \--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \--data-set-publication-date "{TODAY'S-DATE}" \--role-name-arn "{YOUR-ROLE-NAME-ARN}" \--destination-s3-bucket-name "{YOUR-S3-BUCKET}" \--destination-s3-prefix "test-prefix" \

10


https://docs.aws.amazon.com/AmazonS3/latest/UG/CreatingaBucket.html

https://docs.aws.amazon.com/AmazonS3/latest/UG/CreatingaBucket.html

https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html


http://aws.amazon.com/marketplace/management/cas/enroll

https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html


--sns-topic-arn "{YOUR-SNS-TOPIC-ARN}"

• 適用於--data-set-publication-date，取代{TODAY'S DATE}與當前日期使用 ISO-8601 格式，YYYY-MM-DDT00:00:00Z，其中YYYY是四位數年份，MM是二位數月份，DD是二位數日期。

• 適用於--role-name-arn，取代{YOUR-ROLE-NAME-ARN}與您從註冊程序中收到的角色的 ARN註冊商務分析服務計劃 (p. 10)。

• 適用於-目的地-3 桶名稱，取代{你的-S3-BUCKET}您在中建立的 Amazon S3 儲存貯體建立目的地Amazon S3 儲存貯體 (p. 10)。

• 適用於—sns-topic-arn，取代{Y-SNS-TOPIC-ARN}您在中建立的 Amazon SNS 主題設定用於回應通知的Amazon SNS 主題 (p. 10)。

如果您收到包含dataSetRequestId回應，表示您已完成上線程序。成功回應如下所示：

{ "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"}

技術實施指南所以此AWS Marketplace商務分析服務是透過AWS 開發套件。本指南說明如何使用AWS CLI與AWS SDKfor Java。

Commerce Analytics Service

若要允許您的 IAM 使用者使用商務分析服務，請將下列內嵌政策附加至您的使用者。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ]}

如需詳細資訊，請參閱「」在 IAM 主控台中建立政策中的IAM User Guide。

透過提出請求AWS CLI

若要開始使用，請下載 AWS CLI。如下所示AWS CLI範例會對每小時/每月訂閱資料集，以供 2017 年 10 月1 日使用。此資料集會發佈至示範儲存貯體使用前綴的 Amazon S3 儲存貯體示範前置，並且通知訊息會傳遞至示範主題Amazon SNS 主題

aws marketplacecommerceanalytics generate-data-set \--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \--data-set-publication-date "2017-10-01T00:00:00Z" \--role-name-arn "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole" \--destination-s3-bucket-name "demo-bucket" \--destination-s3-prefix "demo-prefix" \

11

http://aws.amazon.com/tools/

http://aws.amazon.com/cli/

http://aws.amazon.com/sdk-for-java/


https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor



--sns-topic-arn "arn:aws:sns:us-west-2:123412341234:demo-topic"

此要求會傳回每個要求唯一的識別碼。您可以使用此識別碼，將請求與發佈至 Amazon SNS 主題的通知產生關聯。下列範例是此識別符的範例。

{ "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"}

透過提出請求AWS SDK for Java

若要開始，請下載AWS Java 開發套件。如下所示AWS SDK for Java範例會對每小時/每月訂閱資料集，供2015 年 10 月 1 日使用。此資料集會發佈至示範儲存貯體使用前綴的 Amazon S3 儲存貯體示範前置，並且通知訊息會傳遞至示範主題Amazon SNS 主題

/** Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.** Licensed under the Apache License, Version 2.0 (the "License").* You may not use this file except in compliance with the License.* A copy of the License is located at** http://aws.amazon.com/apache2.0** or in the "license" file accompanying this file. This file is distributed* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either* express or implied. See the License for the specific language governing* permissions and limitations under the License.*/import java.text.DateFormat;import java.text.ParseException;import java.text.SimpleDateFormat;import java.util.Date;import java.util.TimeZone;import com.amazonaws.AmazonClientException;import com.amazonaws.AmazonServiceException;import com.amazonaws.auth.AWSCredentials;import com.amazonaws.auth.profile.ProfileCredentialsProvider;import com.amazonaws.regions.Region;import com.amazonaws.regions.Regions;import com.amazonaws.services.marketplacecommerceanalytics.AWSMarketplaceCommerceAnalyticsClient;import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetRequest;import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetResult;/*** This sample demonstrates how to make basic requests to the AWS Marketplace Commerce * Analytics service using the AWS SDK for Java.* * Prerequisites: Follow the on-boarding guide: {URL OR SOMETHING}* * Fill in your AWS access credentials in the provided credentials file* template, and be sure to move the file to the default location* (~/.aws/credentials) where the sample code will load the credentials from.* * WARNING: To avoid accidental leakage of your credentials, DO NOT keep* the credentials file in your source directory.* * http://aws.amazon.com/security-credentials

12



*/public class MarketplaceCommerceAnalyticsSample {public static void main(String[] args) throws ParseException {/** The ProfileCredentialsProvider will return your [default]* credential profile by reading from the credentials file located at* (~/.aws/credentials).*/AWSCredentials credentials = null;try {credentials = new ProfileCredentialsProvider().getCredentials();} catch (Exception e) {throw new AmazonClientException("Cannot load the credentials from the credential profiles "+ "file. Make sure that your credentials file is at the correct "+ "location (~/.aws/credentials), and is in validformat.", e);}AWSMarketplaceCommerceAnalyticsClient client = new AWSMarketplaceCommerceAnalyticsClient(credentials);Region usEast1 = Region.getRegion(Regions.US_EAST_1);client.setRegion(usEast1);System.out.println("===============================================================");System.out.println("Getting Started with AWS Marketplace Commerce Analytics Service"); System.out.println("===============================================================\n");// Create a data set request with the desired parametersGenerateDataSetRequest request = new GenerateDataSetRequest();request.setDataSetType("customer_subscriber_hourly_monthly_subscriptions");request.setDataSetPublicationDate(convertIso8601StringToDateUtc("2014-06-09T00:00:00Z"));request.setRoleNameArn("arn:aws:iam::864545609859:role/MarketplaceCommerceAnalyticsRole");request.setDestinationS3BucketName("awsmp-goldmine-seller");request.setDestinationS3Prefix("java-sdk-test");request.setSnsTopicArn("arn:aws:sns:us-west-2:864545609859:awsmp-goldmine-seller-topic");System.out.println(String.format("Creating a request for data set %s for publication date %s.",request.getDataSetType(), request.getDataSetPublicationDate()));try {// Make the request to the serviceGenerateDataSetResult result = client.generateDataSet(request);// The Data Set Request ID is a unique identifier that you can use to correlate the// request with responses on your Amazon SNS topic System.out.println("Request successful, unique ID: " + result.getDataSetRequestId());} catch (AmazonServiceException ase) {System.out.println("Caught an AmazonServiceException, which means your request made it "+ "to the AWS Marketplace Commerce Analytics service, but was rejected with an " + "error response for some reason.");System.out.println("Error Message: " + ase.getMessage());System.out.println("HTTP Status Code: " + ase.getStatusCode());System.out.println("AWS Error Code: " + ase.getErrorCode());System.out.println("Error Type: " + ase.getErrorType());System.out.println("Request ID: " + ase.getRequestId());} catch (AmazonClientException ace) {System.out.println("Caught an AmazonClientException, which means the client encountered "+ "a serious internal problem while trying to communicate with the AWS Marketplace"+ "Commerce Analytics service, such as not being able to access the "+ "network.");System.out.println("Error Message: " + ace.getMessage());}}private static Date convertIso8601StringToDateUtc(String dateIso8601) throws ParseException {TimeZone utcTimeZone = TimeZone.getTimeZone("UTC");DateFormat utcDateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX");utcDateFormat.setTimeZone(utcTimeZone);return utcDateFormat.parse(dateIso8601);}}

13


您應該預期類似於這個範例。

===============================================================Getting Started with AWS Marketplace Commerce Analytics Service ===============================================================Creating a request for data set customer_subscriber_hourly_monthly_subscriptions for publicationdate Sun Jun 08 17:00:00 PDT 2014.Request successful, unique ID: c59aff81-6875-11e5-a6d8-fd5dbcaa74ab

技術文件該服務公開了一種方法，GenerateDataSet，可讓您請求將資料集發佈至您的 Amazon S3 儲存貯體。下表列出GenerateDataSet。

資料集參數

欄位描述

資料集類型此數據集將作為請求的結果返回。

資料集發佈日期發佈資料集的日期。

對於每日資料集，請為所需日期提供具有日期層級粒度的日期。

對於每月資料集，請提供所需月份的月份層級粒度的日期。日期值會被忽略。

角色角色 ARN 具有附加權限原則的角色 ARN，可提供服務存取您的資源。

目的地 Amazon S3 儲存貯體名稱目標 Amazon S3 儲存貯體的名稱 (易記名稱，而非ARN)。您的資料集會發佈至此位置。

目的地 Amazon S3 字首 (選擇性) 已發佈資料集的 Amazon S3 前置詞，類似於標準檔案系統中的目錄路徑。

例如，如果給定桶名稱mybucket和字首myprefix/mydatasets，則輸出檔案會發佈至s3://DOC-EXAMPLE-BUCKET/myprefix/mydatasets/outputfile。

如果前置詞目錄結構不存在，則會建立該結構。

如果未提供前置詞，則會將資料集發佈至 AmazonS3 儲存貯體根目錄。

SNS Topic ARN (SNS 主題 ARN) 資料集發佈或發生錯誤時，會通知 Amazon SNS 主題的 ARN。

Responses所以此AWS Marketplace商務分析服務返回兩個響應。第一個是同步的，它會立即傳回，第二個是非同步的，這是使用 Amazon SNS 傳回的。同步回應類似於此範例。

14


資料集參數

欄位描述

資料集要求 ID 代表服務的特定要求的唯一識別碼。此識別碼可用於將請求與 Amazon SNS 主題上的通知產生關聯。

非同步回應會以 JSON 格式的文件張貼至您的 Amazon SNS 主題，與此範例類似。

資料集參數

欄位描述

資料集 S3 位置交付資料集的儲存貯體名稱和金鑰。

資料集中繼資料 S3 位置交付的資料集中繼資料檔案的儲存貯體名稱和金鑰。


Success (成功) 如果作業成功，則為「真」；如果沒有，則為「假」。

Message (選擇性) 如果發生錯誤 (例如，「成功」為「false」)，則此訊息會包含失敗的相關資訊。

JSON 格式化的異步響應示例

{ "dataSetS3Location":{ "bucketName":"demo-bucket", "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv" }, "dataSetMetaDataS3Location":{ "bucketName":"demo-bucket", "key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json" }, "dataSetRequestId":"f65b7244-6862-11e5-80e2-c5127e17c023", "success":true }

Outputs

成功請求後，請求的資料集會以 .csv 檔案的形式傳送到您的 Amazon S3 儲存貯體。JSON 格式的中繼資料檔案會發佈至與資料集檔案相同的位置。中繼資料檔案提供有關資料集和原始要求參數的有用資訊。中繼資料檔案的名稱與資料集檔案相同，但以副檔名 .meta.json 結尾。下表列出 .csv 檔案中的中繼資料欄位。

中繼資料欄位

欄位描述


15


欄位描述

資料集涵蓋範圍定義資料涵蓋範圍的開始日期/時間和結束日期/時間。這些日期是 ISO 8601 格式。

資料集請求參數 GenerateDataSet 方法的原始要求參數。



以下是 JSON 格式的元數據內容的一個例子。

{"dataSetRequestId": "43d7137b-8a94-4042-a09d-c41e87f371c1","dataSetCoverageRange": {"startDateTime": "2014-06-08T00:00:00.000Z","endDateTime": "2014-06-08T23:59:59.000Z"},"dataSetRequestParameters": {"sellerAccountId": "123412341234","dataSetType": "customer_subscriber_hourly_monthly_subscriptions","dataSetPublicationDate": "2014-06-09T00:00:00.000Z","roleNameArn": "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole","destinationS3BucketName": "demo-bucket","destinationS3Prefix": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions","snsTopicArn": "arn:aws:sns:us-west-2:123412341234:demo-topic"},"dataSetS3Location": {"bucketName": "demo-bucket","key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"},"dataSetMetaDataS3Location": {"bucketName": "demo-bucket","key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"}}

如需可用資料集的完整清單，包括可用日期，請參閱AWS 開發套件文件。

Troubleshooting本節說明您可能遇到的問題的解決方案AWS MarketplaceCommerce Analytics Service

由於允許列表問題，我無法訪問該服務。

如果你尚未在AWS Marketplace，請造訪AWS Marketplace 管理入口網站註冊。如果你已在AWSMarketplace，請聯絡AWS Marketplace賣方營運團隊。

我無法請求過去的日期的數據集，即使 SDK 文檔說它應該在這個日期可用。

即使資料集在過去的特定日期列為可用，我們也只有自您加入AWS Marketplace。如果您認為這是錯誤的，請連絡AWS Marketplace賣方營運團隊。

當我呼叫服務時，收到錯誤訊息「無法連線到端點 URL：https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/」

16

https://docs.aws.amazon.com/cli/latest/reference/marketplacecommerceanalytics/generate-data-set.html#options





TheAWS Marketplace商務分析服務僅在美國東部 (維吉尼亞北部) 區域提供。您必須致電商務分析服務至us-east-1端點。

如果您使用的是AWS CLI，新增」--region標誌添加到每個調用中，並指定AWS區域us-east-1，如下列範例所示。

aws marketplacecommerceanalytics generate-data-set \--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \--data-set-publication-date "2016-04-21T00:00:00Z" \--role-name-arn "arn:aws:iam::138136086619:role/MarketplaceCommerceAnalyticsRole" \--destination-s3-bucket-name "marketplace-analytics-service" \--destination-s3-prefix "test-prefix" \--sns-topic-arn "arn:aws:sns:eu-central-1:138136086619:Marketplace_Analytics_Service_Notice" \ --region us-east-1

我想要使用與我完成上線程序時選取的不同的 Amazon S3 儲存貯體或 Amazon SNS 主題。

當註冊AWS Marketplace商務分析服務，您指定了 Amazon S3 儲存貯體和 Amazon SNS 主題。上架程序會設定您的 IAM 權限，以允許服務僅存取這些特定資源。若要使用不同的資源，您需要修改 IAM 政策：

1.登入 AWS Management Console，並開啟位於 https://console.aws.amazon.com/iam/ 的 IAM 主控台。

2. 選擇角色位於 IAM 主控台的左側。3. 選擇MarketplaceCommerceAnalyticsRole。4. 展開內嵌角色區段中，如果尚未展開。5. 找出名稱為開頭的政策OneClick_ 市場商業分析角色，然後選擇編輯政策。6. 在原則文件中，找出指定您想要修改之服務相關動作的區段。例如，若要變更 Amazon S3 儲存貯體，

請找到包含以s3：並將其各自的資源選擇指定您的新 Amazon S3 儲存貯體。

如需 IAM 政策的詳細資訊，請參閱下列指南：https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html

我得到一個AccessDeniedException錯誤，當我調用GenerateDataSetaction

如果您的 IAM 使用者沒有呼叫GenerateDataSet。下列程序概述了使用 IAM 主控台以這些權限更新 IAM政策所需的步驟。

取得 GenerateDataSet 權限

1. 登入 AWS Management Console，並開啟位於 https://console.aws.amazon.com/iam/ 的 IAM 主控台。2. 從右側導覽窗格中，選擇使用者。3. 選擇您要將其認證用於marketplacecommerceanalytics AWS CLI命令來開啟摘要(憑證已建立！)

頁面上的名稱有些許差異。4. 從Permissions (許可)索引標籤中，選擇新增內嵌政策5. 開啟JSON索引標籤並貼上下方程式碼：

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet",

17

https://console.aws.amazon.com/iam/

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html


AWS Marketplace 賣方指南AWS Marketplace實地示範計劃

"Resource": "*" } ]}

6. 選擇審核政策，為內嵌原則提供描述性名稱，例如GenerateDataSetPolicy，然後選擇建立政策。

更新權限之後，請執行AWS CLI命令，並使用與此 IAM 使用者相同的認證來完成該動作。


這裡沒有列出我的問題。

請聯絡AWS Marketplace賣方營運團隊。

AWS Marketplace實地示範計劃所以此AWS Marketplace現場展示計畫 (FDP) 允許AWS欄位小組 (內部核准AWS員工）使用一些產品和解決方案，通過AWS Marketplace免費。

已核准的範例AWS員工可能包括解決方案架構師和銷售和行銷專業人員。FDP 可讓這些員工展示適用於教育的產品能力，以及可能納入客戶工作負載中的產品能力。

目前支援下列產品類型：

• Amazon Machine Images (AMI) (p. 54)• 容器 (p. 88)• 機器學習演算法和模型套件 (SageMaker) (p. 111)• 資料集 (AWS Data Exchange)

Note

對於 AWS Data Exchange 產品，FDP 僅適用於公開發售 $0 (免費) 的產品。對於已啟用訂閱驗證的 AWS Data Exchange 產品，供應商需要核准訂閱請求。如需訂閱驗證的詳細資訊，請參閱訂閱者的訂閱驗證中的AWS Data Exchange 使用者指南。

當您註冊成為AWS Marketplace賣方。若要退出，請將支援請求提交至受管理的類別目錄作業 (MCO) 團隊。

若要檢視此程式下產品使用情形的資訊，請參閱AWS欄位示範使用方式 (p. 202)的區段每月計費收入報告 (p. 198)。

產品 Support 連線AWS Marketplace產品 Support 連線 (PSC) 是一項功能，可讓AWS Marketplace客戶提供聯絡資訊AWSMarketplace網站，以取得並存取產品支援AWS Marketplace賣方。AWS Marketplace透過 API 與參與的賣家分享提供的資料，以提供更好的支援體驗。客戶可以選擇在購買啟用 PSC 功能的期間或之後新增連絡人詳細資料AWS Marketplace產品，賣方可透過呼叫提取式 API 擷取客戶連絡資料以及相關產品訂閱詳細資料。

您的員工可以使用「客戶 Support 資格」工具，存取客戶訂閱產品的近乎即時資訊，並提供快速、個人化的服務。AWS Marketplace 管理入口網站可讓您輕鬆地開始使用：輸入客戶的 AWS 帳戶 ID，從其帳戶擷取訂閱和使用資訊。

您也可以選擇在AWS Marketplace產品 Support 連線 (PSC)。對於已註冊 PSC 的產品，AWS Marketplace客戶可以選擇透過AWS Marketplace網站，以取得及存取產品支援。如果您註冊 PSC，AWS Marketplace透過 API 與您共用提供的資料，以協助提供更順暢的支援體驗。

18



https://docs.aws.amazon.com/data-exchange/latest/userguide/what-is.html

https://docs.aws.amazon.com/data-exchange/latest/userguide/subscription-verification-sub.html


AWS Marketplace 賣方指南產品 Support 連線

Note

Data 產品不支援此功能。

技術實施指南本節涵蓋 API 規格詳細資訊，以及如何使用產品支援連線功能上線。PSCstart-support-data-exportAPI 是AWS Marketplace商務分析服務 (CAS)。若要與 PSC 的 API 整合，您必須先註冊 CAS。如果您已經註冊 CAS，請使用相同的AWS Identity and Access Management(IAM) 角色，您在上架時建立。

PSC 適用 IAM 政策若要允許 IAM 使用者存取AWS Marketplace產品支援連線功能，您必須將下列內嵌原則附加至您的使用者。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:StartSupportDataExport", "Resource": "*" }, ]}


使用 AWS 命令列界面 (CLI) 傳送請求您可以要求匯出 PSC 資料，使用AWS CLI或任何AWS 軟體開發套件 (開發套件)。

如果您已經使用 CAS 呼叫generate-data-set作業時，您必須同時針對generate-data-set和start-support-data-export。

為確保透過產品 Support 連線計畫取得的客戶聯絡資料的安全性，建議您將 Amazon SSimple StorageService (Amazon S3) 儲存貯體用於start-support-data-export與您使用的 S3 儲存貯體分開generate-data-set。驗證 IAM 角色的權限允許存取您想要使用的所有 S3 儲存貯體。

aws marketplacecommerceanalytics start-support-data-export --data-set-type "test_customer_support_contacts_data" \ --from-date “{START-DATE}” \ --role-name-arn "{YOUR-ROLE-NAME-ARN}” \ --destination-s3-bucket-name “{YOUR-S3-BUCKET}” \ --destination-s3-prefix “test-prefix” \ --sns-topic-arn “{YOUR-SNS-TOPIC-ARN}”

服務的成功回應會傳回dataSetRequestIddataSetRequestId要求。

Example

{

"dataSetRequestId":

"646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"

}

19



http://aws.amazon.com/tools/


API 請求參數和回應StartSupportDataExport 方法所以此StartSupportDataExport方法可讓您要求客戶針對已啟用 PSC 的產品提交的聯絡詳細資料。資料會從要求中指定的開始日期匯出至要求時間前 15 分鐘。成功的請求會導致資料集發佈到指定的 AmazonS3 儲存貯體。

在這個時候，您可以查詢 API 來要求資料集。這會匯出包含與任何真實客戶資料不對應的資料的靜態測試資料集。您應該使用測試數據進行測試和集成。客戶 _support_contacts_data 選項會傳回您支援 PSC 之產品的真實客戶連絡資料，直到在 2016 年稍後正式發佈此功能之後。

請求參數

Input 描述

資料集類型要求匯出的資料集類型。資料集的有效選項如下：

測試客戶支援連絡人資料

客戶支援連絡人資料

該數據集提供了用於測試和整合目的的樣本數據，並可立即使用。客戶連絡人資料資料集目前無法使用。此選項將包含實際客戶資料，並在 PSC 正式上市時提供。

起始日期匯出的資料的最早日期。匯出的資料將包含從指定的「起始日期」到要求時間前 15 分鐘的資訊。

「起始日期」必須以 ISO 8601 日期/時間字串表示。

如果您想要接收完整的資料集，而不是一組更新，請指定您登入程式日期之前的任何日期。若只要接收自上次要求以來的累加資料，請從先前請求產生的中繼資料 JSON 檔案中，從資料集覆蓋範圍指定endDateTime。如需中繼資料 JSON 檔案的詳細資訊，請參閱下列資訊。

角色角色 ARN IAM 角色的 Amazon Resource Name (ARN)，具有附加許可政策，該政策可為服務提供您的資源存取。

Destination S3 儲存貯體名稱目的地名稱 (易記名稱，並非 ARN)Amazon S3 儲存貯體。您的資料集將會發佈至此位置。

Destination S3 字首 (選擇性) 已發佈資料集所需的 Amazon S3 前置詞，類似於標準檔案系統中的目錄路徑。

例如，如果給定存儲桶名稱「mybucket」和前綴「myprefix/mydata 集」，則輸出文件「輸出文件」將被發佈到「s3：//文文文文文/我的前綴/我的數據集/輸出文件」。

如果前置詞目錄結構不存在，則會建立該結構。

如果未提供前置詞，則資料集將發佈至 Amazon S3儲存貯體根目錄。

20

https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html

https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html


Input 描述

SNS Topic ARN (SNS 主題 ARN) Amazon SNS 主題的 Amazon Resource Name(ARN)，將在資料集發佈或發生錯誤時收到通知。

Responses呼叫 API 會立即傳回具有資料集要求識別碼的回應。

欄位描述


包含中繼資料的其他回應將張貼至原始請求中指定的 Amazon Simple Notification Service (Amazon SNS) 主題。下表詳列了該帖子的內容。

欄位描述




Success (成功) 如果作業成功，則為「真」；如果沒有，則為「假」。

Message (選擇性) 如果發生錯誤 (例如，「成功」為「false」)，此訊息將包含失敗的相關資訊。

中繼資料檔案為 JSON 格式化，並包含下列欄位。

欄位描述


資料集涵蓋範圍定義資料涵蓋範圍的開始日期/時間和結束日期/時間。這些日期是 ISO 8601 格式。

資料集請求參數原始請求參數到GenerateDataSet方法。



請求收到日期時間接收請求的日期/時間 (ISO 8601 格式)。

請求完成日期時間完成請求的日期/時間 (ISO 8601 格式)。

21


Example JSON 格式化的中繼資料內容

{ "dataSetRequestId": "c3c84ee0-5aba-11e6-8d9c-235dc080841d", "dataSetCoverageRange": { "startDateTime": "2016-08-18T00:00:00.000Z", "endDateTime": "2016-08-05T03:14:50.334Z" }, "dataSetRequestParameters": { "fromDate": "2016-08-18T00:00:00.000Z", "dataSetType": "test_customer_support_contacts_data", "roleNameArn": "arn:aws:iam::123456789012:role/MarketplaceCommerceAnalyticsRole", "destinationS3BucketName": "mybucket", "destinationS3Prefix": "mydata", "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:mynotification" }, "dataSetS3Location": { "bucketName": "mybucket", "key": "mydata/test_customer_support_contacts_data_2015-01-18T00-00-00Z_to_2016-08-05T03-14-50Z.csv" }, "dataSetMetaDataS3Location": { "bucketName": "mybucket", "key": "mydata/test_customer_support_contacts_data_2015-01-18T00-00-00Z_to_2016-08-05T03-14-50Z.meta.json" }, "requestReceivedDateTime": "2016-08-05T03:14:50.108Z", "requestCompletedDateTime": "2016-08-05T03:14:50.334Z"}

輸出資料格式輸出資料包含客戶連絡人記錄、產品代碼、產品識別碼、訂閱開始日期，以及AWS客戶的帳戶 ID。下表顯示欄位的摘要。每個輸出檔案都包含逗號分隔的標頭，後面接著包含客戶資料和訂閱資訊的記錄。每個記錄都包含「建立」、「更新」或「刪除」作業類型，以指出記錄是否新建立、修改或刪除，因為 API 要求中指出的「起始日期」。整體檔案格式符合 RFC4180 標準。

如果在「起始日期」參數 API 要求所指定的時間範圍內的記錄上發生了多項作業，則只會反映或匯出最新的資料。例如，如果客戶建立，然後更新記錄，傳回的記錄會根據指定的「起始日期」而有所不同。如果「起始日期」是在該記錄的創建日期之前，只有 CREATE 記錄將在輸出數據集中傳遞，並且該記錄將反映最近輸入的詳細信息。如果「起始日期」是在創建記錄之後，但在更新之前，只有 UPDATE 記錄將在輸出數據集中傳遞。如果從日期是記錄被更新後，沒有記錄將被傳遞。同樣地，如果客戶建立並刪除記錄，則只有「DELETE」會出現在輸出檔案中。

如果您想要接收完整資料集，而不是一組更新，請指定您上載程式日期之前的任何日期。若只要接收自上次要求以來的增量資料，請指定endDateTime來自dataSetCoverageRange從先前請求產生的元數據 JSON文件。

欄位格式描述

產品 ID 36 個字元的十六進位字串中產品的唯一識別符AWSMarketplace(GUID)。

必填欄位；永遠出現在每個記錄中。

產品代碼 25 個字元的英數字串產品的唯一識別碼，與帳單相關聯，並可在 Amazon ElasticCompute Cloud (Amazon EC2)執行個體中繼資料取得。

22


欄位格式描述必填欄位；永遠出現在每個記錄中。

客戶 Guid 36 個字元的十六進位字串識別客戶聯絡資料記錄的唯一GUID。這對於出現在輸出檔案中的每個記錄都是唯一的。


訂閱 GUID 36 個字元的十六進位字串對應於客戶的產品訂閱的唯一GUID。客戶可以有多個訂閱相同產品。


訂閱開始日期 ISO 8601 日期/時間，使用世界標準時區。

格式是年-月-日-日-日-日-日-日-日-日，日-日，日-日，時-日，時-時-時-從 00-23，毫米是從 00-59的小時分鐘，s 是從 00-59 分鐘的第二分鐘，而 nnn 是從 000-9999的第二毫秒，例如 .275Z」

客戶產品訂閱的開始日期。


組織長度上限為 255 個字元的字串客戶提供的組織名稱。

永遠出現在具有作業類型「更新」或「建立」的記錄中。不會顯示在作業類型為「刪除」的記錄中。

AWS客戶 ID 12 位數字字符串，其中可能包含前導零

所以此AWS訂閱產品之客戶的客戶 ID。


給定名稱最大長度為 100 個字元的字串由客戶提供的聯繫點給定姓名或名字。


Surname 最大長度為 100 個字元的字串客戶提供的聯絡點姓氏（姓氏或姓氏）。


23


欄位格式描述

電話號碼長度上限為 25 個字元的字串。可能包括國際電話號碼。

客戶提供的電話號碼。


電子郵件最大長度為 254 個字元的字串客戶提供的電子郵件地址。


標題長度上限為 255 個字元的字串由客戶提供的 Job 稱。

選填欄位。有時會發生在具有作業類型「更新」或「建立」的記錄中。不會顯示在作業類型為「刪除」的記錄中。

國家代碼 2 個字元的 ISO 國家/地區代碼由客戶提供的國家代碼。


郵遞區碼 5 位數字串由客戶提供的郵遞區號；僅適用於美國。


作業時間 ISO 8601 日期/時間，使用世界標準時區。格式為年-月-日-日-日-日-日-日-日-日-日-日-日-日-日-日-日-日-日-日-日-日-日的小時從00-23，毫米是從 00-59 的小時分鐘，秒是從 00-9999 分鐘的第二毫秒），例如」

指出客戶最近建立、更新或刪除記錄的日期/時間。


作業類型字串；可能的值為「建立」、「更新」或「刪除」

建立：表示自 API 請求中指定的起始日期以來，記錄已新建立。

更新：表示自 API 要求中指定的起始日期以來，記錄已經更新。

刪除：表示自 API 請求中指定的起始日期以來，記錄已被刪除。


24

AWS Marketplace 賣方指南更多資源AWS Marketplace 管理入口網站

輸出檔案格式的範例如下所示。

產品識別碼、產品代碼、客戶 GUID、訂閱 GUID、訂閱開始日期、組織、AWS 客戶識別碼、指定名稱、姓氏、電話號碼、電子郵件、標題、國家/地區碼、郵遞區碼、操作時間、操作類型

4F-4F-4F-4F-4F-4F-94F-4F-4F-6F-6F-6F-6F-4F-4F-6F-4F-4F-4F-4F-6F-4F-4F-6F-4F-4F-4F-4F-4F-4F-4F-4F-4F-4F-4F-4F-4F-4F-4D-高達公司範例公司 — 服務部門, 尤金, 附屬公司, 尤金, 附文, 555-947-8228, [email protected],,,

4B898955-84F-4F-94D-對稱是一個非常適合的選擇範例公司 — 服務部門, 德安吉拉, 德安吉拉,555-294-4528, 美國 [email protected], 美國,

參加者可以參加，參加者可以參加，參加者可以參加，參加者可以參加，參加者可以參加，參加者可以參加，參加者可以參加，參加者可以參加，參加者可以參加。範例公司 — 歐洲銷售部，拉維，史密斯，德國，IT 部門主管，[email protected]，創造

4B898955-84F-4F-94D-對稱是一個非常適合的選擇上午 12 時正, 中午 12 時正,,,,,,,,,

3F4300EB-BFA-4610-8D68-D8BAA-氧化物配方, 91C72621-6cf4-4D69-8E-高達 79-高達 9-高達 9-高達96-55C-高達 9-高達 9-高達 9-高達 9-高達 9-高達美國彌敦市真元區 333344445555 設計部範例公司 — 設計部，[email protected]，美國舊項目經理，美國，98109,04-07T，美國，舊項目經理，建立

四百零六氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯一氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二苯二氯乙烯二氯乙烯二氯乙烯二氯乙烯二氯乙烯中國股份有限公司 — 設計部門，阿爾維斯，阿爾維斯，阿爾維斯，德國設計部門，中國設計部門，更新 [email protected]

...

Note

當客戶從 PSC 程式刪除其連絡人資訊時，您會在輸出 .csv 檔案中看到記錄，指出作業類型「DELETE」。客戶刪除資料後，API 將不再傳輸聯絡資訊，例如姓名、電話號碼、電子郵件等。每個刪除記錄由唯一識別要刪除的記錄所需的數據組成。刪除記錄包含產品識別碼、產品代碼、操作時間、客戶 GUID、訂閱 GUID、訂閱開始日期、AWS客戶 ID、作業時間及作業類型。如果客戶刪除連絡資訊以選擇退出「產品 Support 連線」，您也應該從記錄中移除連絡資訊。因為客戶連絡資料不會包含在 DELETE 記錄中，您必須使用唯一的客戶 GUID 查詢系統中的記錄。如果客戶終止訂閱，也會傳送刪除記錄。

如果您有任何問題，或想要取得更多資訊，請參與AWS Marketplace產品 Support 連線，請連絡AWSMarketplace賣方營運團隊。

更多資源AWS Marketplace 管理入口網站您可以在AWS Marketplace 管理入口網站。如果開啟AWS Marketplace 管理入口網站並登入，您可以在首頁上看到其他資源的連結，位於Marketplace 資源部分。

例如，若要在啟動後 90 天內取得行銷產品的支援，以及上市後 90 天內，您可以參閱180 天的 GTM 學院 (p. 182)，它是從AWS Marketplace 管理入口網站首頁位於Marketplace 資源。

25





準備您的產品準備將產品發佈至AWS Marketplace包括設定您的套件、設定定價方案、決定要列出您產品的相關類別，以及新增關鍵字，讓您的產品出現在相關搜尋中。

以下清單說明您可以提供產品的方式、AWS Marketplace採購員會找到各種交付項目型態，以及建立各種交付項目型態的程序連結：

• Amazon Machine Image (AMI)— 您可透過以下方式提供 AMI 產品：• 作為一個單一的 AMI。

買家可以使用Amazon Machine Image傳送方式篩選器。

如需詳細資訊，請參閱基於阿美的產品 (p. 54)。• 由於 AMI 使用AWS CloudFormation範本。

買家可以使用CloudFormation傳送方式篩選器。

如需以 AMI 做為AWS CloudFormation範本，請參閱基於 AMI 的交付使用AWSCloudFormation (p. 64)。如需有關的詳細資訊AWS CloudFormation範本，請參閱AWSCloudFormation概念中的AWS CloudFormation使用者指南。

• 作為私有映像構建。使用此方法，您提供產品的方式可讓買方將您的產品安裝在符合其內部作業系統組態標準的基礎黃金映像上。

買家可以使用Amazon Machine Image傳送方式篩選器。

如需詳細資訊，請參閱私有映像 (p. 73)。• 容器-您可以在 Docker 容器中交付產品。容器產品由履行選項組成，這些選項是一組容器映像和一起運作

的部署範本。

買家可以使用容器傳送方式篩選器。

如需詳細資訊，請參閱開始使用容器產品 (p. 88)。• 以檔案為基礎的資料集— 若要傳遞以檔案為基礎的資料集，您可以使用 AWS Data Exchange，另一個

AWS服務。

買家可以使用AWS Data Exchange傳送方式篩選器。

如需透過 AWS Data Exchange 發佈和管理資料產品和優惠的相關資訊，請參閱在 AWS Data Exchange中提供資料產品中的AWS Data Exchange 使用指南。

• 機器學習演算法和模型套件-使用此方法，您可以使用 Amazon SageMaker，一個單獨的AWS服務，以建立演算法或模型套件，然後將其發佈到AWS Marketplace。

買家可以使用SageMaker傳送方式篩選器。

如需傳遞機器學習演算法和模型套件的相關資訊，請參閱機器學習產品 (p. 111)。如需的 SageMaker 關資訊，請參閱什麼是 SageMaker 瑪中的Amazon SageMaker 開發指南。

• 軟體即服務 (SaaS)— 您可以使用訂閱型或合約型定價模式來提供 SaaS 產品。

買家發現這些產品使用SaaS傳送方式篩選器。

如需詳細資訊，請參閱軟體即服務 (SaaS) 型產品 (p. 144)。• 專業服務— 您可以提供支援或與其他AWS Marketplace產品。

買家發現這些產品使用專業服務傳送方式篩選器。

26

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-whatis-concepts.html

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-whatis-concepts.html



https://docs.aws.amazon.com/sagemaker/latest/dg/whatis.html

AWS Marketplace 賣方指南產品定價

如需詳細資訊，請參閱專業服務產品 (p. 167)。

每種遞送方式都有多種包裝、定價和遞送選項。有些方法不適用於以賣家身份的AWS Marketplace直到您註冊支援它的程式為止。您可以使用標準定價和使用者授權合約 (EULA) 來建立產品，也可以使用自訂定價和EULA，為個別客戶建立私人優惠。如果您需要對合約條款進行額外的變更，您可以使用AWS Marketplace團隊建立自訂私人優惠。

Tip

若要簡化採購程序，您可以使用標準化授權條款 (p. 46)查看公開產品清單和私人優惠。

主題• 產品定價 (p. 27)• 為您提供的區域和國家AWS Marketplace產品 (p. 37)• 私人提議 (p. 38)• 標準化授權條款 (p. 46)• 類別和中繼資料 (p. 47)• 搜尋引擎最佳化 (p. 49)

產品定價以下是有關產品的一般定價資訊AWS Marketplace。所有價格均以美元 (USD) 計算。如需退款的詳細資訊，請參閱Refunds (p. 35)。

• 對於付費產品，AWS Marketplace向客戶收集軟體費用。• 自攜授權 (BYOL) 的產品將不收取任何服務費。AWS Marketplace。• 為了實現客戶選擇的承諾，我們要求所有 BYOL 產品都有付費選項。如此一來，沒有現有授權的客戶就可

以選擇購買和使用這些產品。• 對於 BYOL 產品，我們意識到網上購買軟件是一種偏離某些公司營運的方式。有鑑於此，在推

出後的前 90 天，我們將放鬆這個軟件伴隨著可購買的版本的要求AWS Marketplace。在這段期間，AWS Marketplace帳戶管理團隊將與您合作，解決各種挑戰，並判斷軟體是否可以以及如何在AWSMarketplace。

• 免費或開放原始碼軟體免費提供給客戶免費使用服務費。

AWS費用與軟體費用Amazon Machine Image (AMI) 的產品費用分成兩類。

• 所有以 AMI 為基礎的產品都會產生相關AWS基礎設施收費取決於所使用的服務和基礎設施。這些費率和費用的定義和控制AWS，並且可以在AWS區域。如需詳細資訊，請參閱 Amazon EC2 定價。

• 對於付費產品，賣方定義了使用軟件的費用。

這兩種類型的價格會分別顯示在AWS Marketplace詳細資料頁面，協助客戶瞭解使用產品的潛在成本。

免費試用單一 AMI 每小時產品符合選擇性的免費試用計劃的資格，客戶可以訂閱產品並使用單一執行個體最多 31天，而無需支付產品的軟體費用。適用AWS基礎結構費用仍然適用。只要定義試用期間 (5 至 31 天)，並通知AWS Marketplace受管理的類別目錄作業 (MCO)團隊。

27

http://aws.amazon.com/ec2/pricing/


AWS Marketplace 賣方指南每年定價

當客戶訂閱免費試用產品時，他們會收到歡迎使用電子郵件訊息，其中包括免費試用期限、計算的到期日，以及取消訂閱的詳細資料。提醒電子郵件訊息會在過期日期的前三天傳送。

如果您提供的免費試用產品AWS Marketplace，表示您同意遵守退款政策。

Note

單一 AMI 產品可免費試用。AMI 產品使用AWS CloudFormation不允許免費試用。

變更價格您可以透過AWS Marketplace 管理入口網站。

若要變更价格

1. 登入 AWS Marketplace 管理入口網站。2. 在中產品索引標籤中，您會找到您所建立的目前產品清單。在目前產品的表格中，選擇Action欄位以編

輯您的產品。

變更定價模型定價模型的變更必須由AWS Marketplace以確保客戶獲得正面的體驗，並降低對各方的風險。討論您想要進行的定價模型變更，方法是聯絡AWS Marketplace受管理的類別目錄作業 (MCO)團隊。所有訂價模型變更的請求可能需要 30 至 90 天的時間來處理和檢閱。

每年定價年度定價模式可讓您向可以購買 12 個月訂閱的客戶提供產品。訂閱定價最多可節省 40% 的費用，相較於長時間每小時執行相同產品。客戶在訂閱時需支付合同的全部金額發票。如需如何向客戶呈現年度訂閱的詳細資訊，請參閱AMI 訂閱。

使用年度訂閱時的注意事項包括：

• 每年定價是依執行個體類型而定義。對於所有 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體類型，也可以是相同的，也可以是每個執行個體類型的不同。

• 所有年度執行個體類型也必須定義「每小時」執行個體類型。AWS Marketplace不在同一產品上提供僅限年費定價或沒有年費的每小時費用。對於提供年度定價的任何產品，還需要指定每小時定價。

• 如果每小時價格也是 $0，且定義了其他非 $0 的年度執行個體類型，則特定執行個體類型允許每年 $0 的年度價格。

• 在年度訂閱期結束時，客戶將開始按小時價格收費。• 如果客戶購買 X 年度訂閱，但是在 Y 執行個體上執行 Y 軟體，則針對年度訂閱不涵蓋的 (Y-X) 執行個體，

客戶將按每小時軟體價格收費。因此，所有年度定價執行個體類型都必須包含每小時費率。• 使用賣家私人優惠，您可以提供多年（最長 3 年）或自定義的 AMI，並提供預付款或靈活的付款時間表。

如需多年期和自訂持續時間合約的詳細資訊，請參閱私人提議 (p. 38)和the section called “靈活的付款排程” (p. 40)。

如果您提供年度產品AWS Marketplace，表示您同意年度產品的特定退款政策，位於檔案上傳程式「文件」區段中AWS Marketplace 管理入口網站。

使用定價所以此AWS Marketplace計量服務可讓您定義額外的維度，以便針對您的軟體提供的價值向客戶收取費用。身為賣家，您可以從下列其中一個使用類別：

28



https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-ami-subscriptions.html


AWS Marketplace 賣方指南私人優惠

• 使用者• 主機• 頻寬• 資料

您也可以為產品定義多達 24 個尺寸。所有費用必須每小時從客戶帳戶中部署的軟體進行測量和報告。所有使用量均按月計算，並使用與現有AWS Marketplace軟體。

使用 AWS Marketplace 計量服務，您可以處理數個新的定價案例。例如，如果您的軟體監控主機，您可以針對每個受監控的主機收費，並根據主機大小設定不同的定價。如果您的軟體允許整個組織中的多位使用者，您可以依使用者收費。客戶每小時都需支付已佈建的使用者總數的費用。

Note

在產品載入表單中，相關資料行會命名為「彈性消費定價」(FCP)。

適用於AWS Marketplace計量服務產品，請留意以下事項：

• 如果您的軟體已開啟AWS Marketplace，您將需要建立產品以啟用替代使用方式維度。您無法將標準產品轉換為使用 AWS Marketplace 計量服務。新產品發佈後，您可以移除舊產品或將兩者保留在現場。

• AWS Marketplace 計量服務要求您的軟體每小時報告使用量，並記錄客戶每小時的使用量。如果計量服務記錄的傳輸或接收失敗，AWS將無法為此類用途付款。您負責確保成功接收計量記錄。

• 使用 AWS Marketplace 計量服務的產品不支援單鍵操作。買方必須啟動您的軟體，並且具有AWS Identityand Access Management(IAM) 角色，並具有網際網路閘道。

• 免費試用和年度定價與 AWS Marketplace 計量服務不相容。• 不支援變更維度 (使用者、主機、頻寬和資料) 或維度名稱。您將需要建立新的產品。

私人優惠所以此AWS Marketplace賣家私人講價計劃允許AWS Marketplace賣家協商自訂定價，以及與個別使用者授權合約AWS Marketplace客戶（買家）。如需更多詳細資訊，請參閱私人提議 (p. 38)。

SaaS 訂閱定價對於軟體即服務 (SaaS) 訂閱，AWS Marketplace根據我們收到的計量記錄向您的客戶收取費用。所有費用必須每小時從客戶帳戶中部署的軟體進行測量和報告。然後，所有用量將按月計算，並使用與 AMI 相同的機制按月計費AWS Marketplace方案。我們能否向客戶收取產品使用量，取決於您收到的計量記錄。您必須負責確保產品的計量記錄成功傳輸和接收。

SaaS 合約定價定價對於 SaaS 合約，客戶會啟動購買您的軟體，並與您簽訂合約。根據協議，客戶有權獲得指定數量的 SaaS產品使用。AWS Marketplace會將這些權利傳達至您的 SaaS 應用程式。這項操作會通過AWS Marketplace權利服務。使用 SaaS 合約定價模型時，您的應用程式永遠不會傳送計量記錄。相反地，它會透過呼叫AWSMarketplace權利服務。您可以定義使用方式類別、維度和合約的長度。

AMI 定價模式AWS Marketplace有多種 AMI 產品的定價模式。透過賣家私人優惠，您可以選擇多年期和自訂期限合約。如需多年期和自訂持續時間合約的詳細資訊，請參閱私人提議 (p. 38)和the section called “靈活的付款排程” (p. 40)。下表提供定價模型的一般資訊。

29

AWS Marketplace 賣方指南AMI 定價模式

Note

您必須能夠提供 W-9 稅單 (適用於美國實體) 或 W-8 表單 (適用於歐盟實體)，如the section called“註冊” (p. 5)。

定價方式描述

使用自有授權 (BYOL) AWS Marketplace不會向客戶收取軟體使用費用，但客戶必須提供授權金鑰才能啟動產品。此金鑰購買外AWS Marketplace。權利和授權強制執行，以及所有定價和帳單，都由您處理。

免費客戶可以執行與 Amazon EC2 支援的執行個體數量盡可能多，而不會產生額外的軟體費用。

每小時每小時— 軟體按小時計費。每個執行個體類型的價格可以不同 (但不需要)，並且使用量會四捨五入到最接近的整個小時。

每小時一次免費試用— 客戶只能執行一個軟體執行個體，而不會產生任何費用。您可以定義 5 到 30 天之間的持續時間。免費試用適用於正在執行的最昂貴的執行個體類型，並且在 1 個執行個體以外的任何並行使用均以小時費率計費。注意：這是一個不同的模型AWSAmazon EC2 使用量的免費方案，讓客戶每月可免費使用 750 小時。

每小時一次使用— 每小時和每月收費均獨立計算；每月收費不論使用量為何，每小時收費僅以小時收費計算。

每小時一次使用— 客戶可以選擇預先為一個執行個體類型的一個 Amazon EC2 執行個體購買一年的使用量。您可以設定每個執行個體類型的定價，並且可以提供每小時價格的淨節省。超過所購買年度訂閱數量的客戶使用量，都會以您為該執行個體類型設定的每小時費率計費。

每小時含多年和自訂持續時間— 此類優惠只能透過賣家私人優惠提供。使用賣家私人優惠時，您可以指定自訂合約期限，最長可達 3 年。您可以指定預付款，或包含彈性的付款時間表。您設定每個執行個體類型的定價。如果優惠中有彈性的付款排程，您也可以針對優惠中包含的每個執行個體類型，設定發票日期、付款金額以及執行個體數目。對於具有彈性付款排程的有效賣家私人優惠，客戶啟動指定數量的執行個體後，任何其他啟動的執行個體都會按賣家私人優惠中指定的小時費率收費。如需多年期和自訂持續時間合約的詳細資訊，請參閱私人提議 (p. 38)和the section called “靈活的付款排程” (p. 40)。

每小時免費試用和每年— 這與具有年度選項的每小時模型相同，不同之處在於包含免費試用，允許客戶在您決定的指定天數內免費執行任何執行個體類型的 1 個執行個體。您可以隨時購買年度訂閱，並與免費試用訂閱合併。

30

AWS Marketplace 賣方指南使用 SaaS 為您的軟體定價

定價方式描述

每月每月— 不論客戶執行的執行個體數目為何，軟體都會以固定的每月付費。每月費用在註冊和取消時按比例計算。範例：客戶訂閱當月 1 日，將收取當月1/30 的費用。

每月使用，每小時— 每小時和每月費用均獨立計算。不論使用量如何，每月都會收取月費，每小時費用僅以小時使用量計算。

注意：免費試用和年度定價不能與每月定價合併使用。

年度每小時一次— 與年度定價模式的每小時相同。客戶可以選擇預先為一個執行個體類型的 Amazon EC2執行個體購買一年的使用量。您可以設定每個執行個體類型的定價，並且可以提供每小時價格的淨節省，但不需要節省提供項目。超過所購買年度訂閱數量的客戶使用量，都會以您為該執行個體類型設定的每小時費率計費。

多年度和自訂持續時間 (每小時)-這只能透過使用私人提議 (p. 38)。使用賣家私人優惠時，你可以指定長達三年的自訂期限合約。您可以要求預付款，也可以為客戶提供靈活的付款時間表。您可以設定合約期間內每個執行個體類型的定價，以及啟動其他執行個體的每小時定價。如果您提供彈性的付款排程，您也可以針對優惠中包含的每個執行個體類型，設定發票日期、付款金額以及執行個體數目。對於具有彈性付款排程的有效私人優惠，在啟動指定數量的執行個體後，客戶啟動的任何額外執行個體都會按私人優惠中指定的小時費率收費。如需多年期和自訂持續時間合約的詳細資訊，請參閱私人提議 (p. 38)和the section called “靈活的付款排程” (p. 40)。

用量用途— 軟體會根據您提供的價值，以及四種使用類別之一：使用者、資料、頻寬或主機。您最多可以為產品定義 24 個維度。所有費用仍然由客戶每小時產生。所有使用量均按月計算，並使用與現有AWS Marketplace軟體。使用量定價也稱為 AWSMarketplace 計量服務。

注意：免費試用和年度定價不能與每月定價合併使用。

使用 SaaS 為您的軟體定價若要設定價格，請先定義代表軟體中價值單位的定價維度，然後將價格指派給每個維度。例如，維度可以是受保護的主機、使用者或儲存磁碟區。您最多可以定義 24 個維度。接下來，您還將為那些可以是我們預設類別之一的維度（頻寬，數據，主機，請求，層和用戶）選擇一個類別。如果沒有任何預置符合您的使用案例，您可以選擇一般「單位」品類，並在標註描述中描述單位。

31


範例：使用非線性定價的佈建頻寬想像一下，你提供了網絡設備軟件。您可以選擇依佈建的頻寬計費。對於您的使用類別，請選取頻寬。除了按頻寬收費外，您還希望在買家向上擴展時收取不同的價格。您可以在頻寬類別中定義多個維度。您可以定義 25 Mbps、100 Mbps 和 1 Gbps 的獨特價格。

範例：具有多個維度的並行主機想像一下，您提供的軟體可監控其他 Amazon EC2 執行個體。您可以選擇依正在監視的主機數目計費。對於您的使用類別，請選取host。除了依主機充電之外，您還希望為監控較大型主機的額外價值進行充電。您可以在主體品類中使用多個標註。您可以為微型、小型、中型、大型、大型、2XL、4XL 和 8XL 執行個體定義明確的價格。您的軟體負責將每個特定主機映射到您定義的維度之一。您的軟體必須負責為使用類別的每個維度傳送個別的計量記錄 (如果適用)。

列出您的 SaaS 產品AWS Marketplace若要使用計量服務，您必須建立新的產品。如果您的產品已經在AWS Marketplace，您將需要決定新的除了您目前的產品之外，AWS Marketplace 計量服務還會提供，或是將其取代為新使用者唯一可用的版本。如果您選擇更換，現有的產品將從AWS Marketplace因此不再適用於新的買家。現有客戶將繼續可以存取其舊產品和執行個體，但他們可以在方便的情況下移轉至新產品。新產品必須計量 AWS Marketplace 計量服務的使用量。

完成 AMI 後，請按照標準流程使用自助服務工具分享和掃描 AMI。此外，使用管理入口網站上提供的範本，填寫產品載入表單並上傳表單以開始擷取程序。

下列定義將協助您填寫 AWS Marketplace 計量服務的產品載入表單欄位。在產品載入表單上，這些欄位會標示為「彈性消費定價」(FCP)，以區別於每小時和每月定價的產品。

• 標題— 如果您已經擁有產品，並且要在 AWS Marketplace 計量服務中新增相同的產品，請在括號中包含FCP 類別/維度，以區分兩者。例如，「產品標題 (資料)」。

• 定價方式— 從下拉式清單中選擇用途。• FCP 類別— 客戶將收取付費產品的類別用途定價元件。從下拉式功能表中，選擇使用者、主機、資料,

或頻寬。• FCP 單位— 客戶需支付付費產品的測量單位，其中包含用途定價元件。選項會根據您選擇的 FCP 類別顯

示在下拉式功能表中。

下表列出每個品類的有效單位。

類別有效單位

使用者 UserHrs 間

主機 HostHrs

資料 MB, GB, TB

頻寬 Mbps, Gbps

• FCP 維度名稱— 傳送計量記錄時使用的名稱，藉由呼叫MeterUsageAPI 操作。它在計費報告中可見，但因為它不是面向外部的，所以名稱不需要易於使用。該名稱不得超過 15 個字元，且只能包含英數和底線字元。設定名稱之後，您將無法變更名稱。變更名稱需要新的 AMI。

• FCP 維度說明— 描述產品維度的客戶面向陳述式。說明 (例如，管理員每小時、佈建的每 Mbps 頻寬) 不得超過 70 個字元，而且應該是易於使用的。產品發佈之後，您將無法變更此描述。

• FCP 速率— 本產品每單位的軟體費用。此欄位支援 3 位小數。

32


Note

• 您無需填寫每小時和每年的定價欄位。• 免費試用和年度定價不相容。• 使用叢集和AWS資源功能無法使用 AWS Marketplace 計量服務。• 價格、執行個體類型或區域變更將遵循其他AWS Marketplace產品。• 具有 AWS Marketplace 計量服務的產品無法轉換為其他定價模式，例如每小時、每月或 BYOL。• 我們建議將AWS Identity and Access Management(IAM) 政策資訊在您的使用說明或文件中。

如有任何問題，請聯絡AWS Marketplace受管理的類別目錄作業 (MCO)

修改 SaaS 軟體以使用計量服務您將需要修改軟體以記錄客戶使用情況、傳送每小時使用報告至計量服務，以及處理新的失敗模式。軟體運作獨立於定價，但軟體需要知道使用類別、如何使用，以及任何維度。

測量耗用

您的軟體必須決定選取的使用類別中的多少，以及客戶已使用的維度。此值將每小時傳送一次到 AWSMarketplace 計量服務。在所有情況下，都假設您的軟體能夠測量、記錄和讀取資源的使用量，以便每小時將其傳送至計量服務。

對於佈建的耗用，通常會從軟體組態讀取為取樣值，但也可能是每小時記錄的最大設定值。對於並行消耗，這可能是週期性樣本或每小時記錄的最大值。對於累積耗用量，這將是每小時累積的值。

對於多個維度的定價，必須測量多個值並將其傳送至「計量服務」，每個維度一個。這需要您的軟體在提供產品 AMI 時使用已知的尺寸組進行編程或配置。建立產品後，尺寸集就無法變更。

此表格會針對每個定價案例說明測量每小時使用量的建議方式。

案例測量方式

佈建使用者目前已佈建的使用者數目 (範例)。

-或是-

已佈建的使用者數目上限 (看到該小時)。

並行使用者目前同時使用者的數目 (取樣)。

-或是-

同時上線使用者的數目上限 (看到該小時)。

-或是-

不同使用者的總數 (看到該小時)。

佈建主機已佈建主機的目前數目 (取樣)。

-或是-

已佈建的主機數目上限 (看到該小時)。

並行主機目前並行主機的數目 (取樣)。

-或是-

33



案例測量方式並行主機數目上限 (看到該小時)。

-或是-

不同主機的總數 (看到該小時)。

佈建頻寬目前佈建的頻寬設定 (取樣)。

-或是-

佈建頻寬上限 (看到該小時)。

累加資料目前儲存的 GB 資料 (取樣)。

-或是-

儲存的最大 GB 資料 (看到該小時)。

-或是-

該小時新增或處理的資料總 GB。

-或是-

該小時處理的資料總 GB。

呼叫 AWS Marketplace place Metering Service

您的軟體必須每小時呼叫計量服務，並記錄該小時的耗用值。

當你的軟件啟動時，它應該記錄它開始的小時分鐘。這將被稱為起始-分鐘。開始分鐘的每一小時，您的軟體必須擷取該小時的耗用值，然後呼叫計量服務。

若要在開始分鐘每小時喚醒，您的軟體必須使用下列三種方法之一：

• 軟體中的一個執行緒。• 以執行個體或軟體啟動的常駐程式程序。• 在應用程序啟動期間配置的 cron 作業。

您的軟體必須使用在客戶執行個體上設定的 IAM 角色呼叫 AWS Marketplace 計量服務，並指定耗用維度和金額。

您的軟體可以使用AWS開發套件，以呼叫 AWS Marketplace place Metering Service。以下是典型的實作：

1. 使用執行個體描述檔來建立服務用戶端。這需要為 Amazon EC2 執行個體配置的角色。SDK 會自動重新整理角色認證。

Example

AmazonMeteringService meteringClient = new AmazonMeteringService(new InstanceProfileCredentialsProvider());

2. 每個小時，請閱讀您的軟體組態和狀態，以判斷該小時的耗用值。這可能包括收集每個維度的值。3. 呼叫MeterUsage動作，其中包含下列參數 (另外呼叫具有使用量的每個維度)：

• Timestamp— 正在記錄的小時的時間戳記 (使用 UTC)。

34

AWS Marketplace 賣方指南年度產品

• ProductCode— 指派給軟體的產品代碼。• UsageDimension— 指派給軟體的維度。• UsageQuantity— 小時的耗用值。

此外，您的軟體必須呼叫區內AWS Marketplace計量服務端點。您的產品必須設定正確的區域端點，因此美國東部 (維吉尼亞北部) 會將記錄傳送至美國東部 (維吉尼亞北部) 端點，而美國西部 (奧勒岡) 會將記錄傳送至美國西部 (奧勒岡) 端點。撥打區內通話可為買家提供更穩定的體驗，並防止不相關區域的可用性影響在其他區域執行的軟體的情況。

當您將計量記錄傳送至服務時，必須連線至您區域中的 AWS Marketplace 計量服務。使用getCurrentRegion動作來確定執行 Amazon EC2 執行個體的區域，然後將此區域資訊傳遞給MeteringServiceClient構造函數。如果您未在 SDK 建構函式中指定區域，則預設為美國東部 (維吉尼亞北部) 區域。如果您的應用程序嘗試對服務進行跨地區呼叫，它將被拒絕。

失敗處理您的產品必須將計量記錄傳送至服務 (公用網際網路端點)，以便擷取和計費使用量。因為客戶可能會修改網路設定，以避免傳送您的計量記錄，所以您的產品應該藉由選擇失敗模式來考量這個問題。

一般而言，軟體可能無法開啟 (提供警告訊息，但維持完整功能) 或關閉失敗 (停用應用程式中的所有功能，直到重新建立連線為止)。您可以選擇無法開啟、關閉或特定於您的應用程式的項目。我們建議您不要在計量失敗兩小時之後關閉失敗。

作為部分開啟失敗的範例，您可以繼續允許存取軟體，但不允許買方修改軟體設定。或者，買方仍然可以存取軟體，但無法建立其他使用者。您的軟體必須負責定義和強制執行此失敗模式。提交 AMI 時必須包含您軟體的失效模式，且無法變更。

年度產品這些準則適用於所有在AWS Marketplace提供年度定價。

价格變更您可以視需要變更年度價格 ($ 值，例如 $1000 /年為 $1200 /年)，但需要 90 天通知現有客戶年度定價。新價格將適用於新訂閱，但不會影響現有訂閱。只有在價格在自動續訂日期前至少 90 天變更時，價格變更才會對自動續訂生效。客戶會在自動續約前收到一封電子郵件訊息，其中包含新價格。

終端使用者授權合約AWS客戶在年度訂閱下使用 12 個月的軟體，受到您在產品詳細資料頁面上提供的 EULA 保障AWSMarketplace。

Refunds所有付費產品 (不論定價模式為何) 都必須具有規定的軟體費用退款政策。政策必須包含退款條款，以及聯絡賣家要求退款的方法。雖然退款政策的細節取決於您，但我們鼓勵您向客戶提供一些退款方式，以便使用該產品。您必須遵守已公佈的退款政策。

退款請求類型客戶可以申請不同類型的退款AWS Marketplace產品。如果客戶直接向AWS，我們會指示他們使用您發佈的支援聯絡資訊與您聯絡。任何退款AWS基礎設施費用取決於自行決定AWS，並且獨立處理軟體退款。

如果您使用AWS Marketplace稅務計算服務，客戶可能會聯絡您申請僅限稅項退款。如果客戶要求僅限稅項退款，您可以自行決定授予僅限稅項退款或全套軟體退款及稅項。

35

AWS Marketplace 賣方指南Refunds

退款政策及審批下列清單概述AWS Marketplace退款政策以及是否需要您的核准：

• 免費試用

如果您將軟體列為免費試用產品，AWS可代表您針對從免費試用版轉換為付費訂閱後七天內累積的軟體費用發出退款。與免費試用轉換相關的退款不需要採取任何行動。在產品上啟用免費試用，即表示您同意此政策。

• 私人優惠

所有私人優惠的退款必須經過您授權AWS可以處理它們。• 軟體計量退款

如果您使用AWS Marketplace Metering Service、AWS可代表您針對軟體計量錯誤所產生的軟體費用發出退款。如果這些錯誤在多個客戶中常見，AWS保留決定適當退款給每位客戶，並直接向每位客戶申請退款的權利。退款發出的有關AWS Marketplace Metering Service必須與賣家確認一次，但不要求賣家確認每個個別退款。藉由使用AWS Marketplace Metering Service與產品，即表示您同意此政策。

• 購買後 48 小時內取消訂閱

如果買方在非私人優惠購買後的 48 小時內取消訂閱，AWS將發出全額退款（取消 100％退款）。在購買後 48 小時內因取消而發出的退款，您不需要採取任何行動。48 小時後，買家要求將由你自行決定。將您的產品刊登於AWS Marketplace，表示您同意此政策。

• 訂閱升級

如果買方以較昂貴的訂閱或同等價值的訂閱取代現有的非私人優惠訂閱，AWS可以代表您為較低層級的訂閱發出退款。這是一個兩個步驟：購買新的訂閱，然後要求取消舊訂閱並退款。

• 降級訂閱

所有降級訂閱退款要求必須先經過您授權AWS可以處理它們。

All (全部)AWS授權退款會自動處理，您不需要採取任何動作。

退款程序您可以為您的產品軟體使用情況啟動退款，方法是提交退款申請表。一旦收到AWS Marketplace買家Support 團隊，相關的支援個案將會在AWS SupportCenter Console，並在主旨行中註明退款狀態。透過這些情況，我們會直接提供退款相關支援。如需詳細資訊，請參閱「」存取AWS Support。

下列程序概述如何為外部客戶或內部測試帳戶申請退款。

啟動客戶的軟體退款

1. 向客戶收集下列資訊：

• 與其相關聯的客戶電子郵件地址AWS 帳戶。• 客戶的AWS 帳戶訂閱產品所使用的帳戶號碼。提醒您的客戶，如果他們是組織的付款人，他們需要向

您提供AWS 帳戶訂閱您產品的連結帳戶 ID。• 客戶希望退款的帳單期間。

2. 請登入您的AWS 帳戶，接著前往退款申請表。3. 在表單中輸入客戶資訊。4. 輸入客戶要求退款之產品的產品識別碼。您可以在找到產品 ID每日客戶訂閱報告 (p. 192)。5. 對於客戶要求退款、升級或降級的年度產品，您必須執行下列任務：

36

http://aws.amazon.com/marketplace/management/support/refund-request

https://console.aws.amazon.com/support/home?

https://docs.aws.amazon.com/awssupport/latest/user/getting-started.html#accessing-support

http://aws.amazon.com/marketplace/management/support/refund-request

AWS Marketplace 賣方指南區域和國家

a. 確認客戶已使用您的每日客戶訂閱報告購買年度訂閱 (可能有 24 小時延遲)。b. 提供訂閱取消日期在註解欄位中。c. 在意見欄位中提供您授權的變更說明 (退款、升級或降級)。

6. 提交表格。我們會收到通知，並開始處理退款並發出給客戶。7. 輸出案例將在AWS SupportCenter Console，並提供退款申請的狀態資訊。主旨列將包含下列其中一個

主旨：

• 已完成— 已處理退款，且無須採取進一步的動作。• 待定— 退款將在目前的帳單週期結束後處理。• 需執行的動作— 無法處理要求，我們需要您提供額外資訊。您可以直接回覆支援案例；不過，您也需

要提交新的退款申請表。8. 一旦成功處理退款，退款將在 24 至 48 小時內反映在客戶的帳戶上。不過，資金最多可能需要五個工作

天才會出現在客戶的財務帳戶中。

為您提供的區域和國家AWS Marketplace產品當您在中建立產品AWS Marketplace，您可以選擇AWS可在其中使用。您也可以選擇買家可以從哪些國家購買您的產品。這兩個屬性類似，但它們不相同。例如，買方可能位於美國，並從美國購買，但正在歐洲 (法蘭克福) 區域安裝您的產品。為了讓這位買家購買您的產品，您必須在您的國家/地區清單中同時包含美國和歐洲 (法蘭克福) 地區在您的地區清單中。

AWS 區域建立或編輯伺服器或機器學習產品資訊時，您可以將產品限制為特定AWS您的使用者可以安裝和使用產品的區域。

對於伺服器產品，包括 Amazon Machine Image (AMI) (伺服器產品 (AMI)))，容器和AWS CloudFormation產品，您可以選取產品可供使用的特定區域。您也可以選擇在新的美國地區、非美國地區或所有地區上市時自動提供產品。

對於機器學習產品，您可以選取特定區域，或選取包括未來區域在內的所有區域。

如需有關的詳細資訊AWS區域，請參閱AWS服務端點在 AWS General Reference 中。

Countries根據預設，您的產品可供所有AWS Marketplace可在取得。對於新的和現有的伺服器和軟體即服務 (SaaS)產品，您可以針對稅務、合規性、支援或行銷目的，控制特定國家的產品可用性。

此功能有例外情況：

• 先前購買項目— 將產品更新為新的國家/地區清單後，已訂閱您產品的買家仍然可以存取，而他們的訂閱處於有效狀態。

• 私人方案— 當您將產品限制在特定國家/地區的買家時，它不會限制私人優惠。當您向特定買家建立私人講價時，該買家仍可使用該講價，即使他們所在的國家/地區並未包含在您指定的國家/地區。

Note

客戶資格取決於AWS連結帳戶層級。如需詳細資訊，請參閱「」AWS 如何確定您帳戶的位置？共用其權利的客戶只能在您允許的地區啟用權利。如需如何管理權利的詳細資訊，請參閱在組織中共用訂閱中的AWS Marketplace買方指南。

37

https://console.aws.amazon.com/support/home?

https://docs.aws.amazon.com/general/latest/gr/rande.html

http://aws.amazon.com/tax-help/location/

https://docs.aws.amazon.com/marketplace/latest/buyerguide/organizations-sharing.html

https://docs.aws.amazon.com/marketplace/latest/buyerguide/organizations-sharing.html

AWS Marketplace 賣方指南私人提議

私人提議私人優惠是一種購買方案，可讓賣方和買方協商自訂價格和使用者授權合約 (EULA) 條款，以便AWSMarketplace。

Tip

您可以協商每個私人優惠的 EULA 條款，也可以使用或修改標準化授權條款 (p. 46)以簡化採購流程。

私人優惠的運作方式您可以建立和管理所有私有優惠，從Offers(在) 頁面中)AWS Marketplace 管理入口網站。您可以指定要提供的產品，以及AWS您要建立講價的買家的帳戶 ID（或 ID）。AWS Marketplace 管理入口網站會產生優惠的唯一 ID 和 URL。如需建立私有優惠的詳細資訊，請參閱諮詢合作夥伴建立。

當您建立私人優惠時，您可以將優惠延長至最多 25 個帳戶。此優惠只會顯示給您建立優惠的帳戶。買家無法檢視講價，除非你將講價延伸至他們的連結帳戶或管理帳戶。您無法在優惠中強制服務限制，因此買方可以根據他們想要的議定價格使用您的產品，除非產品已經有限制。

AWS Marketplace買家可以訪問第三方融資私人優惠。如需詳細資訊，請參閱「」客戶融資現在可在AWSMarketplace。

Note

買家不會收到你建立私人講價的通知。您可以為買方提供自訂優惠的 URL，或者他們可以透過AWSMarketplace。

當買方瀏覽至您產品的訂閱頁面時，會出現橫幅，指出有私人優惠。買方接受優惠後，就會使用與所有AWSMarketplace交易。已接受的優惠協議，也稱為合約或訂閱。

對於軟體即服務 (SaaS) 合約與消費產品的 SaaS 合約，您可以針對購買者接受私人優惠時所訂立的合約提供升級與續約。例如，您可以這樣做來授與新的權利、提供定價折扣、調整付款排程，或變更使用者授權合約 (EULA) 以使用標準化的授權條款。如需更多詳細資訊，請參閱私人優惠升級與續約 (p. 45)。

私人講價會在賣家報告中追蹤。如需詳細資訊，請參閱「」報告私人優惠 (p. 40)與賣方檢舉指南。

為買家提供私人優惠體驗建立私人講價並通知潛在買家後，他們必須採取步驟才能接受講價。如需私有優惠之買方體驗的詳細資訊，請參閱私人提議中的AWS Marketplace買方指南。

若要接收講價條款，買家必須在講價到期日之前接受講價。優惠過期之後，條款即不再有效。你必須重新建立私人講價，讓買家接受條款。身為賣家，您可以提供優惠的履行頁面的 URL，或者客戶可以瀏覽至AWSMarketplace，然後選擇橫幅上的連結以檢視私有優惠。

透過諮詢合作夥伴私人優惠如果您是諮詢合作夥伴，您可以與 ISV 協商特殊條款，將他們的產品提供給買家。有了這種優惠，您就會被列為銷售者紀錄。

如需更多詳細資訊，請參閱諮詢合作夥伴私人優惠 (p. 41)。

私有優惠與私有優惠合作時，請注意下列各項：

38


https://s3.us-west-2.amazonaws.com/external-mp-channel-partners/Consulting+Partner+Creates+(1).pdf

https://s3.us-west-2.amazonaws.com/external-mp-channel-partners/Financing+External+Briefing+Document+Customer+Facing.pdf


https://s3.us-west-2.amazonaws.com/external-mp-channel-partners/Seller+Reports+Guide.pdf

https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-private-offers.html

AWS Marketplace 賣方指南支援的產品類型

• 您無法為第二方、Amazon Machine 映像 (AMI) 每月或使用AWS CloudFormation產品，或限制客戶使用。

• 對於具有彈性付款排程器的私人優惠，如果買家符合開立發票條件，則可以將預付款分成多筆付款AWS。• 如果您私人報價的買方帳戶是透過私人交易平台管理，您必須在報價中同時包含買方的帳戶，以及包含其

私人交易平台管理員的帳戶。

支援的產品類型AMI，容器，專業服務和 SaaS 產品都支持私人優惠。

AMI 產品的私人優惠您可以為 AMI 合約提供私人優惠價格。此優惠可以是任何自訂持續時間 (以天為單位)，最長可達 3 年 (1,095天)。授權權利從買方接受私人優惠的日期開始。對於具有靈活付款時間表的 AMI 私人優惠，您可以在合約期間設置合約中同意的實例數量。如果買方使用較多，您也可以為這些相同執行個體定義自訂的小時價格。

Note

私人優惠不適用於每月計費合約。

容器產品的私人優惠您可以針對以容器為基礎的產品合約提供私人優惠價格。此優惠可以是任何自訂持續時間 (以天為單位)，最長可達 3 年 (1,095 天)。授權權利從買方接受私人優惠的日期開始。對於具有靈活的付款時間表的集裝箱私人報價，您可以設置合同中同意的數量單位，在合同的期間。如果買方使用較多單位，您也可以定義相同單位的自訂每小時價格。

Note

私人優惠不適用於每月計費合約。

專業服務產品的私人優惠所有專業服務產品都是通過私人優惠完成的。如需更多詳細資訊，請參閱建立私有優惠 (p. 168)。

SaaS 產品的私人優惠SaaS 私人優惠產品無法根據時間變更指定定價層級的定價層級。例如，優惠方案在三個月內無法收取每小時 0.80 USD 的費用，然後將相同定價層的定價變更為 0.60 USD。對於 SaaS 合約，私人優惠不會監控使用情況。

買家可隨時手動升級至新的合約層級。不過，獨立軟體廠商 (ISV) 必須定義合約層、強制執行服務限制，並建議購買者在需要時手動升級至較高的合約層。所以此合約持續時間可以與公開產品清單相符，也可以是以個月為單位的自訂持續時間 (最多 60 個月)。

優惠提交流程您可以使用AWS Marketplace 管理入口網站請使用下列程序。

建立私有優惠

1. 登入AWS Marketplace 管理入口網站，然後選擇Offers。2. 在管理私有優惠頁面上，選擇建立優惠。3. 在建立私有優惠頁面上，從下拉式清單中選擇產品，然後輸入AWS帳戶 ID (或 ID)AWS Marketplace買

方。如果您的買家分期付款產品，請選取允許買家分期付款此產品。請確認您輸入的資訊，然後選擇下一個。

39


AWS Marketplace 賣方指南報告私人優惠

Note

選取允許買家分期付款此產品（僅限 ISV）可讓你向買家提供付款時間表，其中包含未均勻分配的年度付款、多年期交易的多次付款，或每季付款。買家必須符合開立發票條件，AWS，以獲得靈活的付款時間表在他們的私人報價。如需更多詳細資訊，請參閱 the section called “靈活的付款排程” (p. 40)。

4. 在建立優惠頁面上，確認產品名稱和買家 ID。5. 如果產品是每小時的 AMI 產品、AMI 年度或 SaaS 合約定價模型中，指定合約期間，方法是選擇一個選

項按鈕或輸入天數的自定義持續時間或 SaaS 合約的月數。

Note

優惠的持續時間可長達 1,095 天訂購 AMI 產品，或訂購 SaaS 合約最長 60 個月。6. In輸入講價價中，輸入您與客戶協商的定價資訊。如果您有私人報價的分期付款，請指定合約期間的單

位數量和付款排程。如需分期付款的詳細資訊，請參閱the section called “靈活的付款排程” (p. 40)。7. In上傳使用者授權合約，請從可用選項中選取或上傳您的 EULA PDF 檔案。8. In講價到期與接受日期下，輸入講價的有效天數。

Note

這是客戶接受協議條款有效的優惠後的天數。在天數過期後，價格和最終用戶特許協議恢復為公開發售中提供的條款。

9. 適用於買家需要接受報價，請輸入如果不接受優惠，則不再提供的日期。

Note

這是該要約變為無效和無效的日期。在該日期，買家將無法根據你指定的自訂條款接受講價。10. 選擇檢閱 PROTIONS。11. 在檢閱講價頁面上，確認優惠資訊和 PDF 檔案，然後執行下列其中一項動作：

• 若優惠無誤，請選擇擴展講議。• 如果報價不正確，請選擇編輯講議，然後進行任何必要的變更。

優惠應該會出現在管理私有優惠頁面，大約 45 分鐘。若要檢視優惠，請登入AWS Marketplace 管理入口網站，然後選擇私人優惠。這會開啟管理私有優惠登錄頁面。

報告私人優惠私人講價會顯示在現有賣家報告中，以及與講價相關的報告中。所以此the section called “每月計費收入報告” (p. 198)每月產生一次，並具有提供可見性和優惠 ID 資訊。當為買方產生發票時，它會出現在報表中，涵蓋適當的帳單週期。如需詳細資訊，請參閲。賣方檢舉指南。

所以此Oftions ID欄位包含針對私人優惠產生的唯一優惠 ID。除非報表項目用於私人報價，否則它是空白的。所以此優惠可見度欄位會指出報告項目是公開還是私人報價。對於所有私人優惠，條目標記為私人。

靈活的付款排程靈活的付款排程器可讓您透過自訂付款排程延長私人優惠。時間表可以分開長達三年，並且客戶定期支付支付。訂閱後，您的客戶可以在排程上查看所有付款，並在AWS發票，幫助他們跟踪他們的支出。AMI 多年期和 SaaS 合約產品的私人優惠可提供靈活的付款排程。

任何發票條款的客戶，例如 net-30 或 net-60 條款，都可以透過彈性的付款排程訂閱私人優惠。客戶誰支付AWS法案使用信用卡不能。如果您嘗試建立私人優惠與自訂付款排程不符合發票條件的客戶，您會收到錯誤訊息。

40

https://s3.us-west-2.amazonaws.com/external-mp-channel-partners/Seller+Reports+Guide.pdf

AWS Marketplace 賣方指南諮詢合作夥伴私人優惠

建立付款排程使用彈性付款排程器建立自訂付款排程的程序是建立私人優惠的程序的一部分。建立私人優惠時，當您新增產品和購買者帳戶資訊時，請選擇允許買家分期付款此產品。這可讓您建立具有彈性的付款排程的優惠。當您選擇下一頁繼續，彈性的付款排程器功能會驗證任何AWS帳戶是發票條款上的帳戶。如果您提供的帳戶不符合發票條件，則您會收到錯誤訊息。

Note

如果帳戶位於AWS Organizations帳單系列，目標帳戶可以是任何符合淨付款條件的帳戶AWS。如需詳細資訊，請參閱「」的合併帳單AWS Organizations中的AWS Billing and Cost Management使用者指南。

之後AWS帳戶或帳戶已確認，請在下一頁自訂您的優惠詳細資料。選擇此優惠的合約期限，並指定優惠詳情。

Note

對於具有彈性付款排程器的私人優惠，針對多年期和自訂持續時間 Amazon Machine Image (AMI)產品，請針對優惠中包含的每個執行個體類型設定執行個體數量，以及任何其他已啟動執行個體的每小時定價。客戶啟動指定數量的執行個體後，啟動的任何額外執行個體都會按私人優惠中指定的小時費率收費。

之下付款排程，新增客戶將進行的所有分期付款的商業發票日期和商業發票金額。您可以新增最多 36 個分期付款。每次新增分期付款時，買家應付總金額已更新。

Note

第一次分期付款的商業發票日期是第一次針對您的私人優惠開立商業發票。您會收到該第一張發票的付款後AWS Marketplace收到付款從客戶。

彈性付款排程器功能會驗證商業發票日期是否在合約持續時間內。如果您的最後一個發票日期是在合約期間之後，您會收到錯誤訊息。

新增所有發票日期和金額之後，請確認買家應付總金額符合您希望客戶在私人優惠過程中支付的總價。若要完成建立私人優惠，請上傳客戶的使用者授權合約 (EULA)，並設定優惠接受日期。

Note

只有一個發票日期可在您延伸至客戶的提案接受日期之前發生。

您的客戶會根據您定義的排程開立商業發票，而發票會在他們接受優惠後開始。如果第一個發票日期排定在接受講價之前，則會在接受講價之後立即處理此發票。

Note

你無法修改已延長至買家訂閱之私人優惠的付款時間表。若要進行變更，您必須建立新的提議。

提供靈活的付款排程器報告透過靈活的付款時間表報告私人優惠，請參閱第 4 節：靈活付款時間表的合約 (p. 202)，每月計費的收入報告。

諮詢合作夥伴私人優惠AWS Marketplace諮詢合作夥伴私人方案可讓諮詢合作夥伴在AWS Marketplace。諮詢合作夥伴和 ISV 建立合約，以轉售一或多個 ISV 的產品，然後他們將私人報價延伸給該產品的買方。

下圖顯示 ISV、諮詢合作夥伴和買方之間的關係。

41

https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/consolidated-billing.html


Note

如需以 ISV 身分建立諮詢合作夥伴轉售商機的詳細資訊，請參閱ISV 設定轉售商機 (p. 42)。如需以諮詢合作夥伴身分為買方建立私人優惠的詳細資訊，請參閱建立經銷商機的諮詢合作夥伴 (p. 43)。

每個諮詢合作夥伴私人優惠只有單一買家可以看到，具有自訂定價格和獨特的商業條款，以滿足買家的需求。建立私人優惠時，您會從 ISV 設定的批發成本開始。然後，您可以標示該價格，以建立買家的講價價。批發費用有兩種方式可確定：

• 週期性折扣— ISV 授權諮詢合作夥伴以同意的折扣從定價中轉售他們的產品或產品，並有經常性的商機。此折扣可讓諮詢合作夥伴繼續轉售產品，而無需與 ISV 進一步協商價格。此折扣可設定為持續到指定的日期，或無限期地，直到 ISV 或諮詢合作夥伴結束為止。

• 非週期性折扣— ISV 提供諮詢合作夥伴的機會是一次性折扣擬用於僅與特定買家。

在這兩種情況下，買方支付私人報價後，AWS Marketplace會使用標準程序，根據同意的定價將資金分配給諮詢合作夥伴和 ISV。

Tip

身為 ISV 或諮詢合作夥伴，您可以檢視您已經授與或收到合作夥伴(的) 選單AWS Marketplace 管理入口網站。

如需建立私有優惠的詳細指示，請參閱諮詢合作夥伴建立。

如需第三方私有優惠融資的詳細資訊，請參閱客戶融資現在可在AWS Marketplace。

其他資訊如需其他資訊和問題，我們鼓勵 ISV 和諮詢合作夥伴與AWS Marketplace頻道團隊。如果您不知道該特別聯絡誰，請傳送電子郵件訊息至<[email protected]>，團隊成員將在一個工作天內回覆您。

ISV 設定轉售商機身為 ISV，您可以透過建立轉售授權諮詢合作夥伴轉售您的產品機會為了那個合作夥伴。您可以指定每個產品維度的折扣百分比或自訂價格，以建立諮詢合作夥伴的批發價格。合作夥伴可以在創建他們的諮詢

42



https://s3.us-west-2.amazonaws.com/external-mp-channel-partners/Consulting+Partner+Creates+(1).pdf



合作夥伴私人報價時標記批發價格。如需諮詢合作夥伴私有優惠的詳細資訊，請參閱根據機會擴展私人報價 (p. 44)。

Note

如果您想要建立的授權特定條款不可能使用AWS Marketplace 管理入口網站，您可以填寫 AWSMarketplace經銷商作者表單。若要申請並交回表格，請聯絡您的AWS Marketplace頻道客戶經理或傳送電子郵件訊息至[email protected]。

下列程序概述 ISV 如何為諮詢合作夥伴建立商機。若要使用此功能，您必須有權限才能使用合作夥伴(位於)索引標籤AWS Marketplace 管理入口網站。如需更多詳細資訊，請參閱適用於的政策AWS Marketplace賣方 (p. 250)。

為諮詢合作夥伴創造機會

1. 登入 AWS Marketplace 管理入口網站。2. 選擇合作夥伴索引標籤，然後選擇建立機會。3. 輸入機會名稱和機會說明。

Note

您輸入的資訊機會名稱和機會說明將可見的諮詢合作夥伴在他們的賣家報告。4. 選擇經銷商您要授權。您可以依名稱或帳戶 ID 選取經銷商。

Note

如果經銷商未出現在清單中，則他們可能需要先註冊。只有已註冊的經銷商才能獲得商機的授權。如需更多詳細資訊，請參閱建立經銷商機的諮詢合作夥伴 (p. 43)。

5. 選取您的產品是這個機會的一部分，Discount您要套用的。6. 選取Duration (持續時間)的機會。7. (選擇性) 對於 SaaS 合約產品，請新增或移除自訂產品尺寸，然後修改額外使用費來自訂您的商機。8. (選擇性) 設定一或多個買方帳戶指定機會只適用於那些買家。9. (選用) 選取使用者授權合約(EULA) 版本或上傳要包含在商機中的 EULA。10. 選擇檢閱機會，並確認資訊正確無誤。11. 選擇建立機會最終確定的機會，並授權諮詢合作夥伴。

一旦建立，機會就無法延長其日期。不過，您可以隨時撤銷商機並重新建立商機。當您撤銷商機時，新優惠將無法使用該折扣。任何現有優惠均不受影響，並保留其機會折扣。

建立經銷商機的諮詢合作夥伴若要建立諮詢合作夥伴私人優惠，您必須透過AWS Marketplace 管理入口網站作為AWS Marketplace賣方。下列主題可協助您以AWS Marketplace賣方。

• 開始為賣方 (p. 3)• 準備您的產品 (p. 26)• 提交您的產品以供出版 (p. 176)• 賣家報告和資料摘要 (p. 186)

如果您是初次使用AWS Marketplace，下列主題可協助您進一步瞭解可用的產品種類：

• 基於阿美的產品 (p. 54)

43

mailto://[email protected]




• 軟體即服務 (SaaS) 型產品 (p. 144)

與 ISV 簽訂協議

在您身為諮詢合作夥伴建立產品的私人優惠之前，ISV 必須授權您轉售他們的產品。ISV 會藉由建立機會為你。如需更多詳細資訊，請參閱 ISV 設定轉售商機 (p. 42)。若要建立商機，ISV 必須提供：

• 他們授權您轉售的產品。• 他們想為您提供的降價。• 所以此AWS您用來註冊為AWS Marketplace賣方。

建立商機之後，您將成為該產品的授權經銷商。然後，您可以延長從 ISV 所提供的價格標示的私人優惠。

根據機會擴展私人報價

針對週期性的私人折扣優惠，ISV 授權諮詢合作夥伴在AWS Marketplace。折扣，稱為批發價格，是產品定價的同意價格或百分比折扣。諮詢合作夥伴可以使用折扣與任何數量的買家。

下列程序概述諮詢合作夥伴如何根據週期性折扣延長私人優惠。

根據週期性折扣延長私人優惠

1. 將批發價格標記為百分比，以確定您的講價價格。2. 登入AWS Marketplace 管理入口網站。3. 選擇合作夥伴從螢幕頂端的選單中選擇。4. 從您收到的商機清單，c通過機會與產品和折扣你想提供給買家、然後select 建立講價。5. 逐步完成建立私有優惠屏幕，輸入必要的信息，包括買方的帳戶，有關優惠的定價詳情（包括以百分比

計算的標註修訂價格）、一般使用者授權合約 (EULA)，以及優惠的日期。然後，選擇檢閱講價。6. 檢閱優惠，然後選擇擴展產品。

此優惠的發佈程序最長可能需要 45 分鐘的時間才能完成。完成之後，優惠就會顯示在管理提議(憑證已建立！) 頁面上的名稱有些許差異。

已接受的優惠

買方接受諮詢合作夥伴的私人報價後，報價和任何資金支付都會以相同的方式發生：

1. AWS Marketplace發票買方在其現有AWS法案每條款的私人報價。如果私人優惠延伸至連結帳戶，則與該連結帳戶相關聯的付款人帳戶上會顯示已開立的發票金額。

2. 買方支付其AWS法案按照淨支付條款，他們同意AWS。私人優惠程序可針對每筆交易啟用自訂條款，但是無法自訂淨付款條款。

3. AfterAWS收到來自買方的付款，AWS支付款項給您和 ISV。ISV 會收到批發成本減去AWS Marketplace費用。您會收到您的標記減去AWS Marketplace處理費用。所有費用均適用於所列交易金額的百分比。如果您不確定費用百分比，而且需要這些資訊以作報價用途，請聯絡AWS Marketplace通路客戶經理。如果您不知道是誰，請傳送電子郵件訊息至AWS Marketplace頻道團隊<[email protected]>，團隊成員會在 24 小時內回覆您。

4. AWS Marketplace提供電子報告給 ISV，以及使用AWS Marketplace 管理入口網站。這些報表會根據私人優惠的類型有下列差異：• 針對週期性的折扣私人優惠，ISV 會將您視為買方，而您會看到訂閱者為買方。• 非週期性的折扣私人優惠，ISV 和諮詢合作夥伴會看到訂閱者為買方。

如需有關的詳細資訊AWS Marketplace報表，請參閱賣方檢舉。

44



https://docs.aws.amazon.com/marketplace/latest/userguide/Reporting.html

AWS Marketplace 賣方指南私人優惠升級與續約

私人優惠升級與續約對於 SaaS 合約和與消費產品的 SaaS 合約，您可以在任何有效合約上使用私人優惠，以提供升級和續約。例如，您可以這樣做來授與新的權利、提供定價折扣、調整付款排程，或變更使用者授權合約 (EULA) 以使用標準化授權條款 (p. 46)。您也可以變更單位數和付款排程，並新增自訂的結束日期。

之間的差異Protions以及協議是買方是否接受其條款：

• 同時Protions是一組用於買方使用產品的條款。優惠可以是公共或私人。• 同時協議是買家接受的報價。協議包括銷售商透過公開或私人優惠提供的購買和免費產品。

本頁說明如何修改 SaaS 合約和 SaaS 合約與消費產品的有效協議。

此功能適用於所有AWS Marketplace銷售商，包括獨立軟體廠商 (ISV) 和諮詢合作夥伴。你不能修改合約，指定與原始合約不同的記錄賣家記錄的賣家。

若要使用此功能，您必須有權限才能使用協議(位於) 索引標籤AWS Marketplace 管理入口網站。如需相關資訊，請參閱「的許可AWS Marketplace賣方 (p. 251)」。

支援的產品類型T他以下產品類型支援私人供應項目續約和升級：

• SaaS 合約• 含消費量的 SaaS 合約

升級和續約的提交程序您可以建立私人優惠升級和續約，從AWS Marketplace 管理入口網站使用下列程序。

建立私人優惠升級與續約

1. 登入AWS Marketplace 管理入口網站，然後選擇協議。2. 在協議頁面上，請以下列其中一種方式建立升階或續約私有優惠：

• 選擇合約旁的核取方塊，然後選擇合約) 旁的核取方塊，以建立以合約為基礎的優惠。• 選擇協議識別碼以檢視協議明細。在協議摘要頁面上，檢閱合約的現有資訊和條款，以確認這是您要

修改的合約，然後選擇建立以合約為基礎的優惠。3. 在合約優惠詳細資訊頁面上，輸入自訂優惠名稱。

Tip

輸入描述性的自訂優惠名稱可協助您區分Offers(憑證已建立！) 頁面上的名稱有些許差異。買家也可以看到自訂講價名稱。AWS建議您指定包含任何其他識別詳細資料的自訂優惠名稱，例如您自己的 ID 和採購單編號。使用高階描述 (例如)upgrade或renewal和自訂公司名稱也建議使用。請勿使用任何個人識別資料 (例如名字或姓氏、電話號碼或地址)。此欄位最多可輸入 150 個字元。

4. 編輯您想要變更的任何日期、維度、付款排程和 EULA 的資訊。然後選擇 Next (下一步)。5. 在Review and create (檢閱和建立)頁面上檢閱資訊。準備就緒時，選擇建立以合約為基礎的優惠。

新的私人優惠會顯示在管理私有優惠頁面，大約 45 分鐘。若要檢視優惠，請登入AWS Marketplace 管理入口網站，然後選擇Offers開啟管理私有優惠(憑證已建立！) 頁面上的名稱有些許差異。

與建立私人講價的程序類似，買方不會收到您建立新的私人講價的通知。請改為提供新私人講價給買家的URL。從那裡，買方可以選擇接受或繼續在原來的協議下運作：

45


AWS Marketplace 賣方指南標準化授權條款

• 如果買方接受私人優惠升級或續約，新的合約會立即生效，而合約會列在協議(在) 頁面中)AWSMarketplace 管理入口網站。先前協議中的任何剩餘排定付款都會被取消。

買方接受以協議為基礎的私人優惠，就像接受私人優惠的方式一樣。如需私有優惠之買方體驗的詳細資訊，請參閱私人提議中的AWS Marketplace買方指南。

• 如果買方在私人優惠到期前不接受私人優惠升級或續約，原始合約仍然有效，不會有任何變更。

報告升級和續約升級和續約私人優惠會顯示在現有賣家報告中，以及與優惠相關的報告中。所以此the section called “每日客戶訂閱報告” (p. 192)報告和the section called “每日業務報告” (p. 186)報告會每天產生。所以此thesection called “每月計費收入報告” (p. 198)報告會每月產生一次。

在每日客戶訂閱者報告中，訂閱意圖欄位會指出報告項目是否為新的私人優惠。所以此前的優惠 ID欄位會指出新提議前面的提議 ID (如果有的話)。對於所有私人優惠，條目標記為私人。

A問候語資料不會顯示在資料摘要中。

標準化授權條款當你經歷的過程準備產品 (p. 26)，您需要決定產品的最終使用者授權合約 (EULA) 中要包含哪些內容。您可以建立和自訂自己的 EULA，或者您可以使用AWS Marketplace提供，有助於加速交易並簡化採購。

AWS Marketplace提供下列選項，可為您的產品清單提供標準化授權條款：

• 的標準合約AWS Marketplace(SCMP) (p. 46)— 這些授權條款旨在滿足買方和賣方的基本要求。

此選項適用於所有AWS Marketplace賣家和訪問所有買家。• 的企業合約AWS Marketplace(ECMP) (p. 47)— 這些授權條款旨在滿足企業購買者更嚴格的要求。

此選項適用於所有AWS Marketplace賣家註冊，而且只有已登記的企業買家才能存取。當您註冊成為ECMP 計劃的賣家時，您仍然可以向非企業買家提供南華早報。

Disclaimer

您必須負責判斷這些文件是否符合您的特定要求。對於任何特定事實或情況，這些文件不應被解釋為法律意見。

的標準合約AWS Marketplace(SCMP)南華早報是一套標準化的授權條款，旨在規範買家和賣家的使用和定義義義務。AWS Marketplace賣家可以提供《南華早報》作為公開產品清單的最終用戶協議。購買者可以搜尋、購買並快速部署提供標準合約條款的銷售者的軟體。適用於Private (p. 38)，您可以修改《南華早報》，以處理雙方同意的客戶交易要求。

入門本節說明如何檢閱條款並向買家提供南華早報。

若要將「南華早報」用於新的和現有的AWS Marketplace清單

1. 檢閱條款的標準合約AWS Marketplace。2. 登入 AWS Marketplace 管理入口網站。3. 當您建立商品或編輯現有商品時，請選擇SCMP 使用者作為 EULA。

46

https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-private-offers.html

https://s3.amazonaws.com/EULA/Standard+Contract+for+AWS+Marketplace+2019-04-24.pdf


AWS Marketplace 賣方指南的企業合約AWS Marketplace(ECMP)

如需建立產品的詳細資訊，請參閱提交您的產品以供出版 (p. 176)。

要求協助更新《南華早報》

1. 從左下角處理AWS Marketplace 管理入口網站中，選擇聯絡我們。2. 輸入您的電子郵件地址，然後完成表格的其餘部分，如下所示：

• 對於您的問題的主題，請選擇商業 Marketplace。• 對於類別，請選擇產品清單。• 對於子類別，請選擇標準合約請求。• 在提供要求詳細資料的文字方塊中，輸入Enable SCMP for AWS Marketplace productlistings。

如果您對《南華早報》有任何疑問，請聯絡<[email protected]>。

的企業合約AWS Marketplace(ECMP)像南華早報一樣，ECMP 是一套標準化的授權條款，用於管理買家和賣家的使用和定義義義務。適用於Private (p. 38)，您可以修改 ECMP，以滿足雙方同意的客製化交易要求。

《華早報》與《南華早報》的差異如下所示：

• ECMP 旨在滿足大型企業更嚴格的要求。• 如要在刊登物品上提供 ECMP，你必須註冊參加此計劃。• 您可以在公開產品清單和私人優惠上提供 ECMP 作為 EULA僅登記的企業購房者。

註冊 ECMP 計劃後，您仍然可以提供南華早報作為您的公用 EULA，以滿足非企業客戶的授權要求。

ECMP 入門本節說明如何檢閱條款並註冊 ECMP 計畫。

啟用的 ECMPAWS Marketplace清單

1. 檢閱條款的企業合約AWS Marketplace。2. 完成註冊表單，然後選擇立即註冊。

如果您對於 ECMP 計畫有任何疑問，請聯絡<[email protected]>。

類別和中繼資料以下是提供產品中繼資料的最佳作法和資訊。AWS Marketplace修改產品中繼資料，僅用於品質保證和錯誤修正。

命名和描述您的產品買家可以看到您提供的產品相關資訊。確保潛在買家擁有足夠的資訊，以便在購買產品時做出明智的決定。

建立產品名稱建立產品名稱時，請記住下列準則：

47


https://s3.amazonaws.com/EULA/Enterprise+Contract+for+AWS+Marketplace+2019.pdf

https://pages.awscloud.com/awsmp_ent_contracts.html

AWS Marketplace 賣方指南命名和描述您的產品

• 使用標題大小寫 (將每個重要單字的第一個字母變成大寫)• 確保買方可以單獨使用名稱識別產品• 使用品牌或製造商的名稱• 避免描述性資料或超曲線

範例產品名稱：智慧解決方案 Load Balancer-高級版。

撰寫產品說明產品說明會列出產品的功能、優點和使用方式。它也可以提供其他相關的特定產品資訊。描述的長度最多可包含 350 個字元。

撰寫產品說明時，請謹記下列準則：

• 避免不必要的大寫• 避免不必要的標點符號• 請勿包含重新導向資料• 檢查拼字和文法• 僅包含重要、有用的資訊

產品解決方案範例：智慧解決方案會自動將傳入的應用程式流量分配給多個 Amazon EC2 執行個體。其可讓您達成更高層級的應用程式容錯能力，同時提供所需的負載平衡容量，以回應傳入的應用程式流量。SmartSolutions 會偵測集區中狀況不良的執行個體，並會自動將流量重新路由至狀況良好的執行個體，直到狀況不良的執行您可以在單一 AWS 可用區域或跨多個可用區域啟用智慧解決方案，以確保應用程式效能更一致。

撰寫產品亮點產品資訊頁面最多會顯示三個產品亮點。請使用這些要點來簡短描述產品的主要銷售點。

產品亮點範例：預估成本：使用智慧型解決方案，您只需按實際用量付費。您的帳單會根據帳單，針對該執行的每個小時或部分小時計費。

撰寫版本備註每次更新 AMI 產品時，您都必須在版本說明中提供變更的說明。版本說明應包含特定資訊，以協助使用者決定是否要安裝更新。針對更新使用清除標籤，例如安全性更新的「重要」，針對其他類型的更新使用「重要」或「選擇性」。

撰寫使用說明提供使用指示，協助確保購買者可以成功設定及執行軟體。您提供的使用說明會在 AMI 配置過程中顯示。

若要撰寫有效的使用指示，請依照下列準則：

• 以新的或適度的技術觀眾撰寫這些內容。• 請勿假設使用者具有產品、電腦作業系統、工程或 IT 作業的先前經驗或廣泛知識。• 讓買方從啟動到使用產品，包括任何設定或特殊步驟，讓應用程式執行。

範例使用指示：

1. 只要按一下就能啟動產品。2. 使用網頁瀏覽器存取該應用 <EC2_Instance_Public_DNS> 程式。

48

AWS Marketplace 賣方指南選擇類別和關鍵字

3. 使用下列登入資料進行登入：

• 用戶名：用戶• 密碼：執行處理的實例 ID

撰寫升級指示提供購買者如何從舊版產品升級的詳細資料。包括如何在建立另一個執行個體時保留資料和設定的相關資訊。如果沒有升級路徑，請編輯此欄位以特別提及。

升級說明範例：

1. 做 ****，然後 ****。2. 通過執行 ***，檢查您的項目使用的所有插件是否與版本 * 兼容。如果它們不兼容，請執行 ***。3. 建立資料的備份，通過做 ***。

選擇類別和關鍵字當您列出產品時，您最多可以為您的產品選擇三種軟體類別和對應的子類別。這有助於買家在瀏覽或搜尋產品時發現您的產品AWS Marketplace。只選擇與您的產品相關的類別；在大多數情況下，只適用於一個類別。產品載入表單和產品標籤都包含完整的類別清單。

類別與關鍵字不同。可用的類別和子類別預先定義為AWS Marketplace，然後您可以在產品請求程序期間從清單中選取適用於您產品的項目，以決定哪些項目適用於您的產品。關鍵字不是預先定義的，但是會在程序期間建立。您不需要將類別新增為關鍵字。

建立搜尋關鍵字在產品請求過程中，您可以輸入最多三個關鍵字（單一字詞或詞組），協助買家透過網站搜尋來探索您的產品。關鍵字欄位最多可包含 250 個字元。

下列秘訣可協助您建立一組相關的搜尋關鍵字：

• 使用相關術語。• 請勿使用其他賣家發佈的產品名稱，或使用其他賣家的名稱。• 從買家的詞彙中選擇關鍵字，也就是買家在考慮您的產品類型時可能會使用的字詞和詞組。• 根據產品中的特定功能建立關鍵字。• 請勿使用產品標題作為關鍵字。產品標題已在搜尋中建立索引。

請注意：關鍵字與軟體類別不同。關鍵字是與產品相關的更具體術語。

搜尋引擎最佳化所以此AWS Marketplace網站使用類似於整個業界所使用的搜尋最佳化技術，將搜尋查詢的結果排名。通過了解AWS Marketplace排名並傳回搜尋結果，您可以建立針對AWS Marketplace搜尋引擎。建議您在建立產品詳細資料頁面時，將此指南納入考量。

Keywords在產品建立過程中，您最多可以提交三個關鍵字 (單一字詞或片語)，協助客戶透過網站搜尋探索您的產品。關鍵字文字方塊最多可包含 250 個字元。使用以下秘訣建立搜尋關鍵字：

49

AWS Marketplace 賣方指南軟體類別

• 使用相關術語，以便客戶可以輕鬆找到您的產品。• 從客戶的詞彙中選擇關鍵字 — 也就是他們在考慮您的產品類型時可能會使用的字詞和詞組。• 根據產品中的特定功能建立關鍵字。• 請勿在您提交的條款中包含產品標題。產品標題已在搜尋中建立索引。

Note

關鍵字與軟體類別不同。關鍵字是與您的產品相關的更具體術語。

您可以透過編輯產品的中繼資料，在建立產品後編輯關鍵字。對於您使用產品載入表單 (PLF) 建立的產品，您也可以使用 PLF 對這些產品進行變更。對於您使用產品標籤AWS Marketplace 管理入口網站，您也可以使用產品索引標籤以進行變更。如需更多詳細資訊，請參閱產品變更與更新 (p. 179)。

軟體類別當您列出產品時，您最多可以為您的產品選擇三種軟體類別和對應的子類別。這可協助客戶在瀏覽或搜尋AWS Marketplace。只選擇與您的產品相關的類別。在大多數情況下，只適用一個類別。產品載入表單和產品網頁包含完整的類別。

Note

類別與關鍵字不同。可用的類別和子類別已預先定義AWS Marketplace。您可以從清單中選擇要套用到您的產品。關鍵字不是預先定義的，但是會在程序期間建立。

亮光區段產品詳細資料頁面會以項目符號點顯示最多三個產品亮點。客戶可以依重點搜尋產品，因此在建立產品時加入重點。重點顯示應該以簡短且資訊豐富的語言描述產品的主要銷售點。例如：「預測成本：使用 AnyanyCompany 的智慧解決方案，您只需按實際用量付費。您的帳單只要收取費用，不足一小時以一小時計算。」

簡短描述產品說明會列出產品的功能、優點、使用說明，以及其他相關及特定產品資訊。建立產品說明時，請謹記下列準則：

• 避免不必要的大小寫和標點符號• 不包括重新導向資訊• 檢查拼字和文法• 僅包含重要和有用的資訊

ExampleAnycompany 的智慧型解決方案會自動將傳入的應用程式流量分散到多個 Amazon EC2 執行個體。這可讓您完美提供負載平衡容量，以回應傳入的應用程式流量，藉此改善應用程式容錯能力。Smart Smart Solutions會偵測集區中狀況不良的執行個體，並會自動將流量重新路由至狀況良好的執行個體，直到狀況不良的執行客戶可以在單一AWS可用區域或跨多個可用區域，以提供更一致的應用程式效能。

所以此AWS Marketplace受管理的類別目錄作業團隊可協助重新導向具有類似聲音的查詢或具有類似意義的字詞：例如，當客戶搜尋汽車當你期望他們搜索car。

50

AWS Marketplace 賣方指南開始上線程序

AWS Marketplace適用於桌面應用程式 (AMDA)

AWS Marketplace是在 Amazon WorkSpaces 上執行的虛擬化桌面應用程式類別目錄。AMDA 可讓您輕鬆尋找並訂閱橫跨 11 種軟體類別的免費和付費應用程式。應用程式會在虛擬化容器中執行，就像是以原生方式安裝，而購買者則按使用者每月收費。

買方使用 Amazon WorkSpaces 應用程式管理員 (WAM) 主控台，將桌面應用程式部署到其 WorkSpaces。應用程式會透過 WAM 用戶端應用程式傳遞至每個 WorkSpace。

虛擬化技術可快速傳遞程式，通常不需重新開機，因此使用者可以快速啟動並使用其訂閱的應用程式。使用者只會針對已指派的應用程式向使用者收費，費用會從第一次啟動時每月累積，直到指派撤銷為止。其他資訊:

• WorkSpaces 產品頁面• WorkSpaces 見證• AMDA 說明頁面和常見問題集• AWS Marketplace 桌面應用程式目錄

開始上線程序根據我們的AWS Marketplace針對桌面應用程式發行者增補合約 (以下稱「AMDA 增補合約」)，AmazonWeb Services, Inc. 是您選擇透過 AMDA 通道提供之應用程式的記錄銷售者。由於賣方的記錄，AWS需要知道您將收取的價格AWS查看您計劃擁有的產品AWS Marketplace。定價應以每月為單位，每位使用者為單位。AWS將幫助您確定最終價格給買家。

為了讓您的產品在非美國地區發佈，AWS也需要您提供某些出口分類資訊，包括適用的出口管制分類編號(ECCN)。

在您的產品初次測試期間和之後，AMDA 業務開發團隊的成員可以回答您可能遇到的任何問題。然後，您將收到<[email protected]>，以便您填寫、簽署及退回櫃檯簽署。請注意，AMDA 增補合約是AWS Marketplace賣家，所以你需要建立一個AWS Marketplace賣家帳戶，並在開始上線程序之前按一下這些條款，以便在 AMDA 上提供您的申請。

產品提交與包裝虛擬化和封裝是由AWS Marketplace受管理的類別目錄作業 (MCO) 團隊。AMDA 廠商提供軟體安裝程式、安裝指示和產品中繼資料。MCO 將與您一起完成包裝並完成 AMDA 的流程。目前，所有 AMDA 軟體都必須使用具有存放套件之 Amazon S3 儲存貯體許可的 MCO 管理帳戶來封裝。AWS無法接受共享套件。送出產品之前，請檢閱下列指導方針。MCO 將在收到以下物品後開始處理您的包裝請求：

1. 軟體安裝程式和授權金鑰：a. 用於託管安裝程式檔案的 Amazon S3 儲存貯體或外部 URL (.msi、.exe 等)b. 與 Windows Server 2008 R2 相容的伺服器授權金鑰

2. 安裝說明：a. Windows Server 2008 R2 的已知問題b. 無訊息安裝命令列引數

51

http://aws.amazon.com/workspaces/

http://aws.amazon.com/workspaces/testimonials/

http://aws.amazon.com/marketplace/help/buyer-desktop-apps?ref=help_ln_sibling

http://aws.amazon.com/marketplace/desktop/search?ref_=footer_nav_desktop_view_products

https://www.bis.doc.gov/index.php/licensing/commerce-control-list-classification/export-control-classification-number-eccn

https://www.bis.doc.gov/index.php/licensing/commerce-control-list-classification/export-control-classification-number-eccn

AWS Marketplace 賣方指南應用程式封裝類型

c. 發牌機制注意事項：i. 授權儲存在哪裡？ii. 授權如何驗證？iii. 哪些動作會觸發授權檢查？

d. 自動更新i. 如果啟用，請描述如何停用此功能

e. 服務或登錄需求：i. 列出每個必要的服務或登錄機碼，以及其用途的簡要說明

3. 測試伺服器、資料檔案及其他外部元件a. 如果需要安裝，請提供外部元件 (例如，SQL Server) 的測試環境b. 如果您的程序處理數據文件，請包含測試文件，以便我們可以確保性能和功能性

4. 列出所有程式相依性，例如：a. C++ 可轉散發b. Java、QuickTime 輸入等c. GPU /硬體需求

5. 計畫技術聯絡a. 在測試和包裝過程中遇到的技術問題或問題，該聯絡人是誰？

應用程式封裝類型AMDA 封裝可透過兩種方式完成：虛擬化安裝或無訊息安裝。

虛擬化安裝需要 AMDA 封裝工具來監控安裝過程中的所有檔案變更。AWS將指向安裝程式可執行檔，然後按一下安裝，它將監控所有文件更改。AWS然後對登錄、服務和檔案結構進行自訂變更，以確保程式的穩定性和效能。

某些進階程式需要無訊息安裝機制。在此情況下，AMDA 只會虛擬化安裝程式檔案，以便只有在使用者的WorkSpace 上首次啟動應用程式時，才會實際安裝軟體。執行指令碼移除無訊息安裝程式時，需要執行其他步驟。

建立 AMDA 套件封裝程序依賴於建立目標安裝機器的差異，也就是 Windows 伺服器 2008 R2 虛擬機器 (VM)。封裝工具會在安裝過程中監控虛擬機器、建立已變更檔案的資訊清單，然後將其捲入要內嵌的套件中。

以編程方式捕獲更改後，AWS技術人員會檢查檔案、服務和登錄項目，以確保正確擷取所有變更。在此程序期間，技術人員會移除所有解除安裝和自動更新參考，以確保應用程式保持在虛擬化套件的範圍內。

依賴特定 Windows 服務 (背景執行的 Windows 服務、.dll 需求等) 的程式可能需要額外的測試和封裝。依預設，所有程式屬性都會虛擬化為依需求執行。某些服務可能需要提高權限，以確保它們在運行時可供程序使用。

在封裝過程中會擷取授權金鑰，以協助確保使用者享有順暢的單鍵體驗。如果您的程式在第一次啟動時需要授權碼，請包含有關如何手動將授權加入至應用程式檔案的詳細注意事項。

應用中繼資料在 AMDAProductDataLoad.xlsx 載入表單中輸入應用程式中繼資料，並將其包含在應用程式提交中。目前的資料載入表單永遠可在https://s3.amazonaws.com/aws-mp-vendor-guide/AMDAProductDataLoad.xlsx

52

https://s3.amazonaws.com/aws-mp-vendor-guide/AMDAProductDataLoad.xlsx

AWS Marketplace 賣方指南擷取和新版本更新

• 標題-這是產品的標題。• 完整描述 — 此顯示在產品詳細資訊頁面上。• 簡短描述 — 顯示在搜尋結果頁面上。• 終端使用者授權合約 — 這是適用於買方使用產品的最終用戶授權合約。• 圖片 — 這是顯示在產品詳細資料頁面、搜尋結果中以及 AMDA 網站上其他地方的產品圖片或標誌。提供

正方形格式影像標誌的 URL• 類別 — 這是產品的軟體類別。請參閱 AMDA 首頁以檢視可用的類別。• 軟體依據 — 這是顯示在產品頁面上的軟體開發人員，通常是您的公司名稱。• 供應商 URL — 這是您網站的連結，或顯示產品詳細資訊的特定頁面。

• Support 文本/電子郵件/URL（只需輸入一個字段，但鼓勵多個聯繫點）

擷取和新版本更新每個 AMDA 產品的攝入均由AWS MarketplaceMCO 團隊目前的管道支援星期四的發行版本。AWS將在PST 星期二中午鎖定中繼資料和最終封裝。在星期二中午 PST 之後的要求將符合下週的發佈日的資格。新版本更新會依照相同的排程進行。

如果未要求中繼資料更新，則只需要安裝程式和相關聯的檔案。

如果您要更新中繼資料，請將更新的產品資料載入表單傳送至AWS Marketplace賣方操作團隊。

53


AWS Marketplace 賣方指南AMI 為基礎的產品交付方式

基於阿美的產品將產品交付給買家的其中一個方法是Amazon Machine Image (AMI)。AMI 提供啟動 Amazon ElasticCompute Cloud (Amazon EC2) 執行個體所需的資訊。您可以為您的產品創建自定義 AMI，買方可以使用它來創建 EC2 實例，其中您的產品已經安裝並準備好使用。

當買方使用您提供的 AMI 時，他們會按照您為產品建立的定價和計量選項，為他們建立的任何執行個體收費。買家可以使用您的產品 AMI，就像在AWS，包括製作 AMI 的新自定義版本。從 AMI 創建的 EC2 實例仍然會根據 AMI 產品代碼計費為您的產品。

請參閱下列資源：

• 如需定價的詳細資訊AWS Marketplace產品，請參閱產品定價 (p. 27)。• 如需建立產品自訂計量的詳細資訊，請參閱計量服務 (p. 78)。

AMI 為基礎的產品交付方式有三種方式可以交付 AMI 產品：

• 單一 AMI— 購買者選擇 AMI 做為 EC2 執行個體的範本。買家可以使用Amazon Machine Image傳送方式篩選器。

如需詳細資訊，請參閱單一 Ami 產品 (p. 57)。• AWS CloudFormation範本— 您可以建立範本，讓買方能夠將具有不同角色的多個執行個體系統當作單一

單位來安裝。買家可以使用CloudFormation傳送方式篩選器。

如需詳細資訊，請參閱基於 AMI 的交付使用AWS CloudFormation (p. 64)。• 私人影像建置— 此方法可讓買方將您的產品安裝在符合其內部需要作業系統配置。他們Create一個新的

AMI，其中包含您的產品代碼以進行追蹤和帳單。買家可以使用Amazon Machine Image傳送方式篩選器。

如需詳細資訊，請參閱私有映像 (p. 73)。

請參閱下列資源：

• 如需購買者使用 AMI 時如何追蹤 AMI 的詳細資訊，請參閱AMI 產品代碼 (p. 55)。• 如需 AMI 產品及其生命週期的詳細資訊，請參閱瞭解 AMI 產品 (p. 54)。

瞭解 AMI 產品本節概述了使用 AMI 產品的關鍵概念。

主題• 產品生命週期 (p. 55)• AMI 產品代碼 (p. 55)• 變更請求 (p. 56)• 產品載入表單 (p. 56)

54

https://docs.aws.amazon.com/general/latest/gr/glos-chap.html#AmazonMachineImage

AWS Marketplace 賣方指南產品生命週期

產品生命週期AMI 產品包括一組或多個版本的software，以及整體產品的中繼資料。當您建立產品時，您可以在AWSMarketplace，包括您產品的名稱、說明和價格。您也可以為您的產品決定適當的類別，並新增關鍵字，讓您的產品出現在相關搜尋中。

您也可以建立軟體的第一個版本。根據您提供軟件的方式，這可能是一個 AMI，一組或多個 AMI 與AWSCloudFormation範本或軟體套件，供買方在建立自己的 AMI 時使用。如需詳細資訊，請參閱 AMI 為基礎的產品交付方式 (p. 54)。

對於付費產品，購買者將按安裝的執行個體數量計費。若要計量軟體追蹤的不同維度 (例如產品的使用者數目)，請將您的產品與AWS Marketplace計量服務。如需詳細資訊，請參閱計量服務 (p. 78)。

當您建立產品和軟體的第一個版本時，產品最初會在有限的範圍內發佈，因此只有您的帳戶才能存取產品。當您就緒時，您可以將它發佈到AWS Marketplace目錄，讓買家可以訂閱和購買您的產品。

以 AMI 為基礎的產品的生命週期AWS Marketplace不會在您發佈第一個版本之後結束。您應該讓產品保持在最新版本的軟體以及基礎作業系統的安全性修補程式。

作為完整基於 AMI 的產品生命週期的範例，想像一下賣方想要在AWS Marketplace。以下是賣方如何創建和維護產品隨著時間的推移：

1. 建立產品— 賣方建立產品，並將版本 1.0.0 發佈至AWS Marketplace。買家可以創建 1.0.0 版實務並使用它。

2. 新增新的版本— 之後，賣方將新功能新增至產品，並新增包含該功能的新版本 1.1.0。買家仍然可以使用原始版本 1.0.0，或者他們可以選擇新版本 1.1.0。

Note

與新產品不同，新版本會發佈至完整的公開可用性。您只能在AWS Marketplace沒有客戶看到他們，如果產品作為一個整體是有限的版本。

3. 更新產品資訊— 有了 1.1.0 版本，賣家通過更新產品信息，以描述該功能的新亮點文本，讓買家了解新功能。

4. 新增次要版本— 當賣家修正 1.1.0 版中的錯誤時，他們會透過新增 1.1.1 版來釋放該錯誤。買家現在可以選擇使用版本 1.0.0、1.1.0 或 1.1.1。

5. 限制版本-賣方決定該錯誤足夠嚴重，他們不希望買家能夠使用 1.1.0 版本，因此他們限制了該版本。然後，沒有新客戶可以購買 1.1.0（他們只能選擇 1.0.0 或 1.1.1），儘管現有買家仍然可以訪問它。

6. 更新版本資訊— 為了幫助現有買家，賣家更新 1.1.0 版的版本資料，並建議升級至 1.1.1 版。7. 監控用量— 當買方購買並使用產品時，賣方會使用AWS Marketplace 賣家報告和資料摘要 (p. 186)。8. 移除產品— 當產品不再需要時，賣方會將其從AWS Marketplace。

在此範例中，賣方在產品中建立了三個不同版本的 AMI，但只有兩個版本可供新買方使用（在移除產品之前）。

若要修改版本或產品資訊，請建立變更請求 (p. 56)中的AWS Marketplace 管理入口網站。

如需建立及管理 AMI 產品之步驟的詳細指示，請參閱單一 Ami 產品 (p. 57)。

AMI 產品代碼唯一的產品代碼會指派給您的產品，當您在AWS Marketplace。該產品代碼與您產品的 AMI 相關聯，用於追蹤您產品的使用情況。當買家使用軟體時，產品代碼會自動傳播。例如，客戶訂閱並啟動 AMI，對其進行配置，並產生新的 AMI。新的 AMI 仍然包含原始產品代碼，所以正確使用率追蹤，且權限會保留在原地。

55

AWS Marketplace 賣方指南變更請求

Note

該產品code與產品不同ID您的產品。每個產品AWS Marketplace會指派唯一的產品識別碼。產品識別碼是用來識別您在AWS Marketplace目錄、客戶帳單和賣方報告。產品程式碼會附加至從 AMI 建立的執行個體，做為執行個體中繼資料。當使用含有該產品代碼的 AMI 創建一個實例時，客戶將得到一個顯示相關產品 ID 的賬單。建立產品後，尋找產品代碼和產品識別碼AWS Marketplace 管理入口網站頁面以取得您的產品。

身為銷售者，您的軟體可以在執行個體中繼資料，從執行個 Elastic Compute Cloud (Amazon EC2) 行個體取得執行個體的產品程式碼。您可以使用產品代碼以獲得額外的安全性，例如在產品開始時驗證產品代碼。在產品發佈到有限狀態進行測試之前，您無法對 AMI 的產品代碼進行 API 調用。如需有關的詳細資訊驗證產品代碼，請參閱確認您的軟體正在您的AWS MarketplaceAMI (p. 77) 。

變更請求若要變更產品或版本，請在AWS Marketplace，您可以提交變更請求透過AWS Marketplace 管理入口網站。變更要求會新增至佇列，並視要求類型而定，可能需要幾分鐘到幾天才能解決。您可以在AWS Marketplace管理入口網站。

您可以針對 AMI 產品要求的變更類型包括：

• 更新向買家顯示的產品資料。• 更新版本資訊向買家顯示。• 新增產品的新版本。• 限制版本，以便新買家無法再存取該版本。• 更新AWS產品可用的區域。• 更新產品的定價和執行個體類型。• 將產品從AWS Marketplace。

如需詳細資訊，請參閱建立變更請求 (p. 58)。

Note

某些變更請求會要求您使用產品載入表單來建立請求。請參閱一節。

產品載入表單通常，w當您建立或編輯產品時，您可以在AWS Marketplace 管理入口網站使用者介面來進行所需的變更。然而，一些操作指導您使用產品載入表單（PLF）。

PLF 是一個電子表格，其中包含有關產品的所有信息。有幾種方式可以取得 PLF：

• 您可以從產品的詳細資料頁面下載現有產品的 PLFAWS Marketplace 管理入口網站。• 當您為需要它的動作選取功能表項目時，系統會提示您下載 PLF。例如，如果您選擇建立新的每月計費伺

服器產品，系統會提示您下載適當的 PLF。

如果動作是對現有產品進行編輯，則 PLF 會預先填入該產品的資訊，因此您只需要變更要更新的詳細資訊。

• 如果您需要一個新的空白 PLF，可以根據您要創建的產品類型，在AWS Marketplace 管理入口網站檔案上傳(憑證已建立！) 頁面上的名稱有些許差異。

完成 PLF 後，請將它上傳到AWS Marketplace 管理入口網站檔案上傳(憑證已建立！) 頁面上的名稱有些許差異。PLF 本身有更詳細的說明，在指示] 索引標籤。

56

http://aws.amazon.com/marketplace/management/product-load



AWS Marketplace 賣方指南單一 Ami 產品

單一 Ami 產品本節討論如何使用AWS Marketplace，這是由單一 Amazon 機器執行個體 (AMI) 組成的。客戶可以使用 AMI建立具有您已安裝和設定的產品的 Amazon EC2 執行個體。

主題• Prerequisites (p. 57)• 建立產品 (p. 57)• 建立變更請求 (p. 58)• 取得請求的狀態 (p. 59)• 更新產品資訊 (p. 59)• 更新版本資訊 (p. 60)• 新增新的版本 (p. 60)• 給予AWS Marketplace存取 AMI (p. 61)• 限制版本 (p. 62)• 從中移除產品AWS Marketplace (p. 63)• 提交變更請求時的常見錯誤 (p. 63)

Prerequisites開始之前，您必須完成下列先決條件：

1. 可以存取AWS Marketplace 管理入口網站。這是您用來註冊為賣家和管理您在AWS Marketplace。若要進一步了解如何取得AWS Marketplace 管理入口網站，請參閱的政策和許可AWS Marketplace賣方 (p. 250)。

2. 註冊成為賣家，如果你想向你的產品收取費用，請提交你的稅金和銀行資料。若要進一步了解如何成為賣家，請參閱開始為賣方 (p. 3)。

3. 擁有您想要銷售的產品。對於以 AMI 為基礎的產品，這通常表示您已建立或修改伺服器軟體，而且您已建立 AMI 供客戶使用。要了解更多有關準備 AMI 的資訊，請參閱AWS Marketplace，請參閱建立 AMI 的最佳實務 (p. 76)。

建立產品建立 AMI 型產品，藉由使用AWS Marketplace 管理入口網站。

建立單一 AMI 產品

1. 開啟AWS Marketplace 管理入口網站athttp://aws.amazon.com/marketplace/management/tour/，然後登入你的賣家帳戶。

2. 來自的產品功能表，選擇伺服器。或者，您可以直接前往伺服器產品(憑證已建立！) 頁面上的名稱有些許差異。

3. 來自的目前伺服器產品索引標籤上，選取建立伺服器產品，然後為單一 AMI 產品選取其中一種授權類型：

• 使用自有授權 (BYOL)— 使用者從您以外的地方取得授權的產品AWS Marketplace。它可以是付費或免費授權。

• 免費— 免費供訂閱者使用的產品。(他們仍會支付任何相關的 Amazon Elastic Compute Cloud(Amazon EC2) 執行個體或其他AWS資源。)

• 每小時或每小時付費— 買方每小時或每小時以年度合約支付的產品。AWS根據 AMI 上的產品代碼進行測量。

57


http://aws.amazon.com/marketplace/management/products/server

AWS Marketplace 賣方指南建立變更請求

• 每月已支付— 買方每月收費的產品AWS。

Note

以 AMI 為基礎的產品還有另一種授權類型：以使用方式為基礎。此授權類型適用於您的產品與AWS Marketplace 計量服務整合，以根據客戶的使用情況提供自訂計量。若要建立以使用量為基礎的定價產品，您必須下載、填寫及上傳「產品載入表單」(PLF)。如需 PLF 的詳細資訊，請參閱產品載入表單 (p. 56)。如需不同授權類型的詳細資訊，請參閱AMI 定價模式 (p. 29)。

4. 根據您的選擇，填寫新產品的資訊，然後選擇提交。

Note

如果您選取每月已支付，系統會要求您下載產品載入表格 (PLF)。5. 確認要求出現在請求索引標籤審核中狀態。您可以返回此頁面查看請求處理時的狀態。

Note

產品驗證和發佈是手動程序，由AWS Marketplace賣家營運團隊。如果沒有錯誤，可能需要 3至 5 天才能發佈您的初始產品版本。如需計時的詳細資訊，請參閱時間與期望 (p. 179)。

當您的產品最初發佈時，只有您的AWS帳戶 (您用來建立產品的帳戶)。如果您從伺服器產品頁面上，您可以選取檢視AWS Marketplace以檢視產品詳細資訊，因為它將出現在AWS Marketplace買家。這個詳細資料清單不會顯示給其他AWS Marketplace使用者。

此功能可讓您在公開發行產品之前先測試產品 (甚至發行多個版本以進行測試)。如果您需要將產品提供給其他測試帳戶，或是要公開發佈您的產品，請聯絡AWS Marketplace 賣方營運團隊。

如需準備產品資訊並提交以供發佈的詳細資訊，請參閱以下資源：

• 準備您的產品 (p. 26)• 提交您的產品以供出版 (p. 176)

如需詳細資訊，準備 AMI 提交到AWS Marketplace的詳細資訊，請參閱以下資源：

• 建立 AMI 的最佳實務 (p. 76)• AMI 產品檢查表 (p. 84)• AMI 安全政策 (p. 85)

建立變更請求若要修改版本或產品資訊，您可以建立變更請求中的AWS Marketplace 管理入口網站。

Note

您也可以使用建立變更要求。AWS Marketplace目錄 API。

建立變更請求

1. 開啟AWS Marketplace 管理入口網站athttp://aws.amazon.com/marketplace/management/tour/，登入你的賣家帳戶，然後前往伺服器產品(憑證已建立！) 頁面上的名稱有些許差異。

2. 在目前伺服器產品索引標籤上，選擇您想要修改的產品。3. 從中選擇選項請求變更下拉式選單。

58


https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/seller-products.html



AWS Marketplace 賣方指南取得請求的狀態

對於大多數的變更請求，您只需填寫 UI 表單並提交即可。不過，對於某些變更，您必須下載、完成，然後上傳「產品載入表單」(PLF)。這是一個試算表，其中包含可供您填寫所需資訊的表單。當您選擇其中一個變更請求時，系統會提示您下載正在嘗試建立的請求的正確 PLF。PLF 會預先填入您現有產品詳細資訊中的資訊。您可以將完成的 PLF 上傳至AWS Marketplace 管理入口網站檔案上傳(憑證已建立！) 頁面上的名稱有些許差異。

Note

強烈建議您下載並使用最新的 PLF。表單會定期更新為新資訊，包括執行個體類型和可用區域。有關產品的最新 PLF，您可以從伺服器產品頁面中，選取產品，然後選擇下載產品載入表格。

如需變更請求狀態的詳細資訊，請參閱the section called “取得請求的狀態” (p. 59)。如需深入瞭解變更請求的潛在問題，請參閱提交變更請求時的常見錯誤 (p. 63)。

如需特定變更請求的詳細資訊，請參閱下列資源：

• 更新產品資訊 (p. 59)• 更新版本資訊 (p. 60)• 新增新的版本 (p. 60)• 限制版本 (p. 62)

取得請求的狀態當您提交變更請求後，您可以從請求的標籤伺服器產品的頁面AWS Marketplace 管理入口網站。狀態可以是以下任何一項：

• 正在审核中表示正在審核您的請求。有些要求需要由AWS Marketplace團隊，但大部分都會在系統中自動審查。

• Succeeded表示您的請求已完成。您的產品或版本已按照您的要求更新。• 需執行的動作表示您需要更新您的請求以修正問題或回答有關請求的問題。選取要求以查看詳細資料，包

括任何問題。• 失敗意味著請求出現問題，並且您應該使用相同的數據為更改創建一個新的請求。

更新產品資訊建立產品之後，您可能會想要變更與產品相關聯的部分資訊，AWS Marketplace。例如，如果新版本修改產品的描述或亮點，您可以使用新資料編輯產品資訊。

更新產品資訊


2. 前往伺服器產品頁面上，並在目前伺服器產品索引標籤上，選擇您想要修改的產品。3. 來自的請求變更下拉式清單，選擇更新產品資訊。4. 更新任何您需要變更的任何以下欄位：

• 產品標題• SKU• 簡短描述• 完整描述• 產品標誌影像網址• 要點

59





AWS Marketplace 賣方指南更新版本資訊

• 產品類別• Keywords• 產品影片 URL• 資源• Support 資訊

Note

如需標誌格式的詳細資訊，請參閱公司和產品標誌要求 (p. 177)。5. 選取 Submit (提交)。6. 確認要求出現在請求索引標籤正在审核中狀態。您可能需要重新整理頁面，才能在列表中看到請求。

您可以隨時從請求的標籤伺服器產品(憑證已建立！) 頁面上的名稱有些許差異。如需詳細資訊，請參閱取得請求的狀態 (p. 59)。

更新版本資訊建立版本後，修改與版本相關的資訊，向買家提供更新的資訊會很有幫助。例如，如果您計劃在 1.1 版發行後限制 1.0 版，您可以更新 1.0 版的說明，將買方引導至 1.1 版，以限制版本的日期。您可以從更新版本資訊AWS Marketplace 管理入口網站。

更新版本資訊


2. 前往伺服器產品頁面上，並在目前伺服器產品索引標籤上，選擇您想要修改的產品。3. 從請求變更下拉式清單，選擇更新版本資訊。4. 在更新版本頁面上，選取您要更新的版本。5. 更新任何您需要修改的下列資訊：

• 版本備註• 使用說明• 64 位元 (x86) Amazon Machine Image (AMI)— 關於使用和安全性群組的詳細資料

6. 選取 Submit (提交)。7. 確認要求出現在請求索引標籤正在审核中狀態。

Note

您無法使用此程序來更新版本標題或與版本相關聯的 AMI。在此案例中，建立新的版本 (p. 60)和限制前一個 (p. 62)。


新增新的版本您可以在變更產品、基本影像或任何其他需要修改產品的 AMI 時，新增產品的新版本。新增產品的新版本，請從AWS Marketplace 管理入口網站。

Note

如需有關建立 AMIAWS Marketplace，請參閱建立 AMI 的最佳實務 (p. 76)。

60





AWS Marketplace 賣方指南給予AWS Marketplace存取 AMI

新增新版本


2. 前往伺服器產品頁面上，並在目前伺服器產品索引標籤上，選擇您想要修改的產品。3. 從請求變更下拉式清單，選擇新增版本。所以此新增新的版本表單，並預先填入您最新版本的資訊。4. 在中版本資訊區段中，提供下列資訊：

• 版本標題— 輸入有效的字串 (例如1.1或2.0 文。在整個產品中必須是唯一的。• 版本備註— 輸入文字以描述此版本的詳細資料。

5. 在中新的 Amazon Machine Image (AMI)區段中，提供下列資訊：

• Amazon Machine Image ID— 輸入您要用於此版本的 AMI AMI ID。您可以從主控台中 AMI 清單。AMI 必須存在於美國東部 (維吉尼亞北部) 區域，並且在AWS Marketplace賣方帳戶。

• IAM 存取角色 ARN-輸入 Amazon Resource Name (ARN)AWS Identity and AccessManagement(IAM) 角色，允許AWS Marketplace以存取您的 AMI。如需如何建立 IAM 角色的詳細資訊，請參閱。給予AWS Marketplace存取 AMI (p. 61)。使用 IAM ARN 的標準格式，例如：arn:aws: iam文 123456789012: role/roName。ARN 必須存在於AWS Marketplace賣方帳戶。

• OS 使用者名稱— 針對 Linux 型 AMI，輸入可用來登入執行個體的使用者名稱。我們建議您使用ec2-user。

• 掃描連接埠— 輸入可用來登入作業系統的連接埠號碼：Linux AMI 的 SSH 連接埠或 Windows AMI 的RDP 連接埠。

6. 如果尚未開啟，請展開組態設定，以將 AMI 發佈至AWS Marketplace客戶網站區段中，然後提供下列資訊：

• 使用說明— 輸入使用 AMI 的說明，或輸入有關使用 AMI 的詳細資訊的連結。例如：文文文文文文文文文文文文文 https://example.com/usage.htm文

• 端點 URL— 提供購買者在建立執行個體後如何存取軟體的相關資訊。輸入通訊協定(https或http)，相對 URL(例如，/index.html)，以及連接埠(例如，443)，買家可以用來存取您的產品。（主機名取決於 EC2 實例，因此您只需要提供相對路徑）。

• 作業系統— 輸入 AMI 使用的作業系統名稱 (例如Amazon Linux。• 作業系統版本— 在 AMI 中輸入特定版本的作業系統。• 建議的例項類型— 選擇買方預設取得的執行個體類型。• 安全群組建議— 輸入一或多個建議的資訊，包括通訊協定 (TCP或UDP)、要允許的連接埠範圍，以及

CIDR IP 清單 (格式為.xxx.xxx.xxx.nn，例如，192.0.2.0/24。7. 選擇提交以提交新增新版本的要求。8. 確認要求出現在請求索引標籤正在审核中狀態。如果有需要修正的錯誤，頁面會在頁面頂端的表格中顯

示錯誤，而需要更新的特定欄位則會以紅色顯示。

您可以隨時從請求的標籤伺服器產品(憑證已建立！) 頁面上的名稱有些許差異。系統會檢閱新版本，如果成功，則會以新的公開版本的形式發佈。如果發生問題，狀態可能會顯示需執行的動作。選取要求以查看詳細資料，包括任何問題。

如果您的要求成功，您現有的使用者會收到一封電子郵件，通知他們有新版本可供使用、連結至版本的版本說明，並建議他們升級至最新版本。您也會收到根目錄中的電子郵件副本。AWS帳戶電子郵件。

給予AWS Marketplace存取 AMI當您建立包含將 AMI 新增至AWS Marketplace，AMI 必須複製到AWS Marketplace系統，然後掃描是否有安全性問題。你必須給AWS Marketplace存取 AMI，方法是建立AWS Identity and Access Management(IAM)角色，具有對 AMI 執行動作的權限，以及允許AWS Marketplace來擔任這個角色。您只需建立 IAM 角色一次。

61



https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#Images:sort=name

https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#Images:sort=name


AWS Marketplace 賣方指南限制版本

建立的角色AWS MarketplaceAMI 資產擷取

1. 登入AWS Management Console，開啟 IAM 主控台並移至角色頁面。2. 選擇建立角色。3. 在建立角色頁面上，進行以下選擇：

• 選取信任的實體類型— 選擇AWS 服務。• 選擇使用案例— 選擇AWS Marketplace。• 選擇您的使用案例— 選擇Marketplace — AMI 資產攝入。• 若要移至下一頁，選取下一頁: Permissions (許可)。

4. 選取安全地方治療政策。視需要新增權限界限，然後選取下一頁: 標籤以繼續進行。

Note

您可以使用權限界限來限制您提供的存取AWS Marketplace具有這個角色。如需詳細資訊，請參閱「」IAM 實體的許可界限中的AWS Identity and Access Management使用者指南。

5. 若要繼續，請選取下一頁: Review (檢閱)。6. 提供角色的名稱，然後選擇建立角色。7. 您應該會看到「角色roleName」，並且角色應該會出現在角色清單中。

在此頁面上，當您選取剛才建立的角色時，您可以透過arn: aws: iam# 123456789012: role/Explrole。請將ARN 用於IAM 存取角色 ARN，例如，當您建立變更請求時新增新的版本 (p. 60)新增至您的產品。

限制版本如果你想防止買家存取你的公開產品的特定版本，你可以限制該版本。

Note

以前的買家s訂閱產品仍可以使用該版本。AWS Marketplace指南規定，你必須在限制版本後 90 天內繼續為現有買家提供支援。

若要限制版本


2. 前往伺服器產品頁面上，並在目前伺服器產品索引標籤上，選擇您想要修改的產品。3. 從請求變更下拉式清單，選擇限制版本。4. 在限制版本頁面，選擇您要限制的版本 (或版本)。5. 選擇提交提交您的要求以供審核。6. 請驗證請求索引標籤會顯示請求狀態作為正在审核中。當請求完成時，狀態為Succeeded。

Note

您無法限制產品的所有版本。如果您嘗試限制產品的最後一個公開版本，您將會收到錯誤訊息。若要完全移除產品，請參閱the section called “從中移除產品AWS Marketplace” (p. 63)。


Note

限制版本最長可能需要 3 天的時間才能完成。

62

https://console.aws.amazon.com/iam/home?region=us-east-1#/roles

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html




AWS Marketplace 賣方指南從中移除產品AWS Marketplace

如果您的要求成功，您現有的使用者會收到一封電子郵件，通知他們版本限制，並建議他們使用最新版本。您也會收到根目錄中的電子郵件副本。AWS帳戶電子郵件。

從中移除產品AWS Marketplace產品發佈後，您可以移除 (也稱為日落）它來自AWS Marketplace。若要移除產品，請識別產品並提交移除要求，以及移除原因和您的連絡人電子郵件地址。如果您要以新的產品取代目前的產品，您也可以提供替代產品識別碼。在您要求移除產品之後，新客戶將無法再訂閱產品。您必須支援任何現有客戶至少 90 天之久。我們會處理從AWS Marketplace，具有以下條件：

• 產品已從AWS Marketplace搜尋、瀏覽和其他探索工具。任何「訂閱」按鈕或功能都會停用，且頁面上的訊息清楚地表示該產品已不再可用。請注意，仍然可以使用 URL 存取產品詳細資料頁面，並且可能會在公開搜尋引擎中編製索引。

• 必須指定移除的原因 (例如，終止支援、終止產品更新或更換產品)。如需持續支援已移除產品的需求，請參閱AWS Marketplace 賣方的條款與條件。

• AWS Marketplace透過電子郵件與當前買家聯絡，通知他們產品移除、移除原因，並提供賣家聯絡資料。• 目前買方DO保留對軟體的存取權，直到他們取消訂閱為止。它們不會以任何方式受到產品移除的影響。

若要移除使用AWS Marketplace 管理入口網站


2. 選擇產品索引標籤，然後選擇伺服器。3. 在您的產品頁面上，在目前伺服器產品，找出您要移除的產品。從動作的資料行選取動作功能表，選

擇取消發佈產品。4. 在取消發佈產品(用於) 頁面上的請求原因下，輸入您要求移除產品的原因。5. (選用) 提供替代產品 ID, 如果有另一個產品將取代您要刪除的產品的地方.6. 適用於聯絡資訊，輸入AWS可以用來與您聯絡，如有任何問題。7. 檢閱資訊是否正確，然後選擇提交日落請求。

A下一步是什麼提交產品移除要求後，會顯示資訊頁面。所以此AWS Marketplace賣家營運團隊會審核並處理你的要求。透過檢視來檢查您提交的狀態。請求。

產品移除後，產品便會出現在目前產品中的清單AWS Marketplace 管理入口網站。In目前產品，您可以執行的唯一動作是下載產品的試算表。您無法編輯或送出另一個日落要求。

如果您對產品移除有任何疑問，請聯絡AWS Marketplace賣方營運團隊。

提交變更請求時的常見錯誤當您變更產品資訊時，您有時會遇到錯誤。以下是一些常見問題和如何修正這些問題的建議：

• 掃描 AMI— 掃描 AMI 時可能會發生幾個問題：• 您尚未授予AWS Marketplace權限來掃描 AMI。授予AWS Marketplace權限來存取它。或者您已授與權

限，但權限界限太嚴格。如需詳細資訊，請參閱給予AWS Marketplace存取 AMI (p. 61)。• 如果掃描發現 AMI 中的安全問題或常見漏洞 (CVE)，請確定您使用的是影像中作業系統的最新修補程

式。如需詳細資訊，請參閱 AMI 安全政策 (p. 85)。

如需有關建置 AMI 的一般指導方針，請參閱。建立 AMI 的最佳實務 (p. 76)。• AWS Marketplace 管理入口網站欄位—AWS Marketplace 管理入口網站需要非常具體的資訊：

• 如果您不確定欄位要求的內容，請嘗試檢查主控台中的詳細資料。大多數欄位在欄位上方都有文字描述，而欄位下方的格式需求。

63

http://aws.amazon.com/marketplace/management/terms



AWS Marketplace 賣方指南使用 CloudFormation 的 AMI 交付

• 如果您嘗試提交包含一或多個無效欄位的表單，則會顯示問題清單。系統會提供建議的動作來協助您修正問題。

• 如果系統要求您提供 ARN，您通常會在主控台的其他位置找到它。例如，您建立的 IAM 角色 ARN，用於將AWS Marketplace訪問您的 AMI 可以在角色頁面安裝在 IAM 主控台中。ARN 都有類似的格式。例如，IAM 角色 ARN 格式為arn: aws: iam# 123456789012: role/Explrole。

• 您的標誌和影片必須直接以 URL 形式提供給內容。如需標誌格式的詳細資訊，請參閱公司和產品標誌要求 (p. 177)。

如需提交產品和版本變更請求的詳細資訊，請參閱提交您的產品以供出版 (p. 176)。• 產品載入表格 (PLF) 問題— PLF 包含試算表中包含的指示。說明表格提供整體指示。每個欄位都有如何填

寫欄位的說明，請選取欄位以顯示指示。• 申請進行中–某些請求不能並行發生。您只能有一個請求更新特定資訊正在進行一個產品的時間。您可以查

看仍在審核中的所有要求，請參閱請求的標籤伺服器產品(憑證已建立AWS Marketplace 管理入口網站。如果您有不想要的擱置請求，您可以將其取消，然後提交包含您要進行的變更的新請求。• 當版本進行更新 (以新增或限制) 時，您無法更新版本資訊。• 如果有擱置的請求AWS Marketplace賣家營運團隊，你無法提交任何新的變更。

• 不明確的錯誤— 如果您的提交失敗且沒有解釋，請再試一次。有時候，伺服器負載會導致提交失敗。

如果您仍然無法解決變更請求，請聯絡AWS Marketplace賣方營運團隊。

基於 AMI 的交付使用AWS CloudFormationAWS Marketplace賣家可以列出以 AMI 為基礎的產品，可交付至AWS Marketplace購買者使用AWSCloudFormation範本。您可以使用範本來定義產品的叢集或分散式架構，或選取不同的 AMI 組合或產品組態。所以此AWS CloudFormation範本可配置為提供單一 Amazon 機器映像 (AMI) 或多個 AMI 以及相關的配置檔和 Lambda 函數。買家可以瀏覽選擇的解決方案AWS Marketplace、按一下購買，然後使用AWSCloudFormation您提供的範本。

多重 AMI 解決方案最多可包含 20 個 AMI 和 20 個AWS CloudFormation範本。EACEAWS CloudFormation範本可以參考解決方案中包含的 AMI 的任何組合或子集。買方購買單一解決方案，授權他們使用該產品中的所有 AMI。當產品有多個 AMI 時，每個 AMI 都有自己獨特的產品代碼，可以單獨定價和計量。不過，解決方案的個別元件無法在產品內容之外探索或可採用。

如果您有現有的單一 AMI 產品，則無法遷移或合併到新的多重 AMI 清單中。不過，您的新解決方案可以使用與現有產品使用的 AMI 相同的軟體或複本。每個刊登物品在AWS Marketplace是一個包含新產品代碼的列表。

您也可以將 Lambda 函數與 AMI 一起包含在無伺服器應用程式中，以便買家可以透過 CloudFormation 進行部署。如需如何在 AMI 中包含 Lambda 函數和無伺服器應用程式的指示，請參閱新增無伺服器應用程式元件 (p. 67)。

建立您的產品清單要提交你的產品，你需要準備和驗證你的 AMI，創建你的AWS CloudFormation範本、建立拓撲圖、填寫產品載入表單，然後將資料提交至AWS Marketplace。我們建議您先建立並驗證 AMI，然後完成並驗證AWS CloudFormation(s)。完成這些步驟之後，您應該建立拓撲圖，並估計軟體和基礎結構的價格。AWSMarketplace會驗證您的提交內容，並與您一起使您的產品公開。使用AWS定價計算機，以協助估計範本的基礎結構成本。提供者AWS Marketplace，並附上您儲存的計算機組態的連結。以下是多重 AMI 解決方案產品的限制：

• 更新現有AWS Marketplace產品從獨立產品轉換為 MultiAmi 產品。要使產品在 MultiAmi 產品中可用，請複製 AMI 並將其作為元件提交到新的 MultiAmi 產品中。產生的 AMI 有一個獨特的產品代碼，與之前的產品代碼不同。

64

https://console.aws.amazon.com/iam/home?region=us-east-1#/roles


https://calculator.s3.amazonaws.com/index.html

AWS Marketplace 賣方指南正在準備您的AWS CloudFormation範本

• 多重 Ami 解決方案在AWS Marketplace的標籤啟動執行個體頁面。• 同時AWS CloudFormation範本不得在多重 AMI 解決方案中列出的 AMI 之外啟動 AMI。• AWS CloudFormation範本必須以公用 URL 的形式提交。範本中包含的所有巢狀範本 URL 也必須公開存

取。

正在準備您的AWS CloudFormation範本若要建置您的AWS CloudFormation範本，您必須符合範本先決條件，並提供必要的輸入和安全性參數。提交您的AWS CloudFormation範本中，請使用下列各節中的指導方針。

範本必要條件• 確認範本已透過AWS CloudFormation主控台在您的產品啟用的所有地區。您可以使用此工具來測試您的

範本：https://github.com/aws-quickstart/taskcat。• 如果您正在建立單一 AMI 產品，範本只能包含一個 AMI。• AMI 必須位於映射表對每個區域。所以此AWS Marketplace團隊會在複製 AMI ID 之後更新它們。• 建置範本，使其不依賴於特定可用區域 (AZ) 中的使用。並非所有客戶都可以存取所有可用區域，而不同帳

戶的可用區域對應不同。• 您可以在 AMI 中包含相依性，例如 Lambda 函數、配置文件和腳本。如需詳細資訊，請參閱建立無伺服

器應用程式 (p. 68)。• 如果您要使用 Auto Scaling 群組建置叢集解決方案，建議您將調整事件納入考量。新節點應該會自動加入

執行中的叢集。• 即使是單節點產品，我們也建議使用Auto Scaling 群組。• 如果您的解決方案涉及多個執行個體的叢集，如果您想要低網路延遲、高網路輸送量，或兩者都可考慮使

用放置群組。• 如果您的解決方案涉及 Docker 容器，則必須將 Docker 映像合併到 AMI 中。• 為方便審查AWS Marketplace團隊和客戶透明度，建議您在UserData」一節。

範本輸入參數• 輸入範本的參數不得包含AWS Marketplace客戶的AWS認證 (例如密碼、公開金鑰、私密金鑰或憑證) 或個

人資訊 (例如電子郵件地址)。• 請勿為參數 (例如遠端存取、CIDR/IP 或資料庫的密碼) 設定預設值。客戶必須提供這些作為輸入參數。• 對於敏感輸入 (例如密碼)，請選擇NoEcho屬性，並啟用更強的規則運算式。對於其他輸入，設置最常見的

輸入與適當的輔助文本一起。• 使用AWS CloudFormation參數類型用於輸入。• 使用AWS::CloudFormation::Interface來分組和排序輸入參數。

網路和安全參數• 請確定預設的 SSH 連接埠 (22) 或 RDP 連接埠 (3389) 未開啟到 0.0.0.0。• 我們建議您使用適當的存取控制清單 (ACL) 和安全性群組來建置 VPC，而不是使用預設的虛擬私有雲

(VPC)。僅AWS帳戶，支援 EC2-Classic。• 存取客戶的AWS環境應該使用 IAM 角色來呼叫AssumeRole來自AWS Security Token Service。• 將 IAM 角色和政策設定為授予最低權限，並且僅在絕對必要時啟用寫入存取權。例如，如果您的應用程序

只需要S3:GET、PUT，以及DELETE作業，請僅指定這些動作。我們不建議使用S3:*在此案例中為。

65

https://github.com/aws-quickstart/taskcat

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/mappings-section-structure.html

https://docs.aws.amazon.com/autoscaling/latest/userguide/create-asg-from-instance.html

https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege

AWS Marketplace 賣方指南取得範本基礎結構的成本估算

收到您的範本後，AWS Marketplace會驗證產品組態和資訊，並針對任何必要的修訂提供意見反應。

取得範本基礎結構的成本估算顯示給客戶的每個範本的基礎結構成本估計是根據您使用AWS定價計算機。估計應包含要部署做為範本一部分的服務清單，以及典型部署的預設值。

計算範本的估計每月成本之後，請提供AWS Marketplace與儲存和共享連結，以取得美國東部 (維吉尼亞北部) 區域。這是提交過程的一部分。

拓樸圖您必須為每個範本提供拓樸圖。圖表必須使用AWS 產品圖示Form EeachAWS服務透過AWSCloudFormation範本，而且它必須包含服務的中繼資料。圖表的大小必須為 1100 x 700 像素。請確定您的圖表符合此尺寸需求，以避免裁剪或拉伸，如下圖所示。

符合提交要求若要提交使用AWS CloudFormation範本，您必須提供下列資源：

• AWS CloudFormation範本或範本• 一個 AMI 產品可以有一到三個AWS CloudFormation範本• 一個多重 AMI 產品最多可以有 20 個AWS CloudFormation範本

• 每個範本之預設組態的估計基礎結構價格• 拓撲圖和拓撲中繼資料

66


http://aws.amazon.com/architecture/icons/

AWS Marketplace 賣方指南提交您的產品請求

• 已填妥的產品表格 (可從AWS Marketplace 管理入口網站)• 對於單一 AMI 產品，請使用商業產品表單• 對於多重 AMI 產品，請使用多重互聯網產品表格表單

產品表單包含提交範例，供您參考。

對於每個產品，大部分必要的產品資料和中繼資料都與傳統的單一 AMI 產品相同。因此，每個 AMI 使用AWS CloudFormation範本必須繼續符合AWS Marketplace。

對每個AWS CloudFormation範本，您還必須提供下列資訊。

欄位描述限制

標題拓樸的標題。這會顯示在詳細資料和履行頁面以及顯示拓樸詳細資料的快顯視窗中。

50 個字元

簡短描述這會顯示在詳細資料和履行頁面上。

200 個字元

完整描述這會顯示在拓樸詳細資料快顯視窗中。

2000 個字元

針對多重 AMI 產品，下列是必要欄位：

• 解決方案標題• 解決方案簡短說明• 解決方案詳細說明• 適用於AWS CloudFormation範本 (每個解決方案最多 20 個)

• 部署標題 (每個範本)• 簡短描述 (每個樣板)• 完整描述 (每個樣板)• 架構圖 (每個範本)• 基礎架構定價估計 (每個範本)• 包裝在這個產品/元件列表AWS CloudFormation範本• 這個支持的地區列表AWS CloudFormation範本

提交您的產品請求使用AWS Marketplace 管理入口網站提交您的產品。在資產標籤上選擇檔案上傳。上傳任何您想要提交的檔案，並輸入簡短說明。處理請求需時三至五週，包括：

• 的審核AWS CloudFormation模板，AMI 和元數據AWS CloudFormation範本• 出版您的AWS CloudFormation到的範本AWS Marketplace產品

新增無伺服器應用程式元件您可以創建一個產品，其中包含一個或多個亞馬遜機器映像（AMI），並使用一個或多個AWSCloudFormation範本，將無伺服器元件整合到產品中。例如，您可以創建一個產品，其中一個 AMI 配

67


https://s3.amazonaws.com/awsmp-loadforms/ProductDataLoad-Current.xlsx

https://s3.amazonaws.com/awsmp-loadforms/AWS_Marketplace_Product_Load_Form_CAR_Multi_AMI.xlsx


AWS Marketplace 賣方指南新增無伺服器應用程式元件

置為控制器服務器，另一個 AMI 配置為背景工作服務器，以AWS CloudFormation堆疊。所以此AWSCloudFormation範本可以包含設定AWS Lambda函數，由其中一個伺服器中的事件觸發。

當您使用此方法來設計您的產品時，您可以簡化架構，並讓您的買家更容易上市。這種方式也可以讓您輕鬆更新您的產品。

如需針對產品建立 AMI 的詳細資訊，請參閱。基於阿美的產品 (p. 54)。如需有關完成AWSCloudFormation範本的詳細資訊，請參閱the section called “使用 CloudFormation 的 AMI 交付” (p. 64)。

當您定義無伺服器應用程式時，您可以使用AWS Serverless Application Model(AWS SAM) 範本，您儲存在AWS Serverless Application Repository。AWS SAM是一種開放原始碼架構，可用於建置無伺服器應用程式。在部署期間，AWS SAM會將 SAM 語法轉換並擴充為AWS CloudFormation語法。所以此AWSServerless Application Repository是無伺服器應用程式的受管理儲存庫。它可讓您儲存及共用可重複使用的應用程式，以便買家可組合及部署無伺服器架構。若要建立並提供此類產品，請完成下列步驟：

主題• 建立無伺服器應用程式 (p. 68)• 將您的應用程式發佈至儲存庫 (p. 69)• 建立AWS CloudFormation範本 (p. 70)• 提交您的AWS CloudFormation範本和組態檔 (p. 72)• 更新您的AWS Serverless Application Repository應用程式許可 (p. 72)• 分享您的 AMI (p. 72)• 提交您的AWS CloudFormation產品與 AMI 和無伺服器應用 (p. 72)

AWS Marketplace在刊登物品之前，會先檢閱並驗證你的產品。如果您在報價列出前必須解決問題，我們會傳送電子郵件給您。

作為履行訂閱的一部分，我們會複製 AMI、無伺服器應用程式和AWS CloudFormation範本AWSMarketplace擁有的存儲庫中的每個AWS區域。當買家訂閱您的產品時，我們會授予他們存取權限，並在您更新軟體時通知他們。

建立無伺服器應用程式您的第一個步驟是將AWS Lambda函式，用來建立無伺服器應用程式。您的應用程式結合 Lambda 函數、事件來源及其他資源，以共同執行任務。無伺服器應用程式可以像 Lambda 函數一樣簡單，也可以包含多個函數與其他資源 (如 API、資料庫和事件來源對應)。

使用AWS SAM來定義無伺服器應用程式的模型。如需內容名稱和類型的說明，請參閱AWS# Serverless在GitHub 上的 AwsLabs 中。以下是AWS SAM模板，並使用 Lambda 函式和AWS Identity and AccessManagement(IAM) 角色。

AWSTemplateFormatVersion: '2010-09-09'Transform: AWS::Serverless-2016-10-31Description: An example of SAM template with Lambda function and IAM role

Resources: SampleFunction: Type: AWS::Serverless::Function Properties: Handler: 'com.sampleproject.SampleHandler::handleRequest' Runtime: java8 CodeUri: 's3://DOC-EXAMPLE-BUCKET/2EXAMPLE-1234-4b12-ac37-515EXAMPLEe5-lambda.zip' Description: Sample Lambda function Timeout: 120 MemorySize: 1024

68

https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessapplication


Role: Fn::GetAtt: [SampleFunctionRole, Arn]

# Role to execute the Lambda function SampleFunctionRole: Type: "AWS::IAM::Role" Properties: AssumeRolePolicyDocument: Statement: - Effect: "Allow" Principal: Service: - "lambda.amazonaws.com" Action: "sts:AssumeRole" ManagedPolicyArns: - "arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole" Policies: - PolicyName: SFNXDeployWorkflowDefinitionPolicy PolicyDocument: Statement: - Effect: "Allow" Action: - "s3:Get*" Resource: "*" RoleName: "SampleFunctionRole"

將您的應用程式發佈至儲存庫若要發佈應用程式，您需先上傳應用程式程式碼。將您的程式碼成品 (例如 Lambda 函數、指令碼、組態檔)存放在您帳戶擁有的 Amazon S3 儲存貯體中。當您上傳應用程式時，應用程式最初會設定為私有，這表示只有AWS帳戶建立它。您需要建立 IAM 政策來授權AWS Serverless Application Repository權限來存取您上傳的成品。

將您的無伺服器應用程式發佈至無伺服器應用程式存放庫

1. 開啟位於 https://console.aws.amazon.com/s3/ 的 Amazon S3 主控台。2. 選擇您用於封裝應用程式的 Amazon S3 儲存貯體。3. 選擇 Permissions (許可) 標籤。4. 選擇 Bucket Policy (儲存貯體政策)。5. 貼上下列範例政策陳述式。Replace文文文文文中的Resource屬性值與儲存貯體名

稱。Replace123456789012中的Condition與你的元素AWS副音 ID。所以此Condition元素確保AWS Serverless Application Repository僅具有從指定AWS帳戶。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "serverlessrepo.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/*", "Condition" : { "StringEquals": { "aws:SourceAccount": "123456789012" } } } ]

69

https://console.aws.amazon.com/s3/


}

6. 選擇 Save (儲存)。7. 開啟位於 AWS Serverless Application Repository 的 https://console.aws.amazon.com/serverlessrepo

主控台。8. 在我的應用程式頁面，選擇發佈應用程式。9. 視需要填寫必填欄位和任何選擇性欄位。必填欄位為：

• Application name (應用程式名稱)• 作者• 描述• 原始程式碼 URL• SAM 範本

10. 選擇發佈應用程式。

若要發佈應用程式的後續版本：

1. 開啟位於 AWS Serverless Application Repository 的 https://console.aws.amazon.com/serverlessrepo主控台。

2. 在導覽窗格中，從我的應用程式下，選擇應用程式。3. 選擇 Publish new version (發佈新版本)。

如需詳細資訊，請參閱「」使用 AWS SAM CLI 發佈無伺服器應用程式。

建立AWS CloudFormation範本若要建置您的AWS CloudFormation範本，您必須符合範本先決條件，並提供必要的輸入和安全性參數。如需詳細資訊，請參閱「」範本剖析中的AWS CloudFormation使用者指南。

在您的AWS CloudFormation模板，您可以引用您的無服務器應用程序和 AMI。您也可以使用嵌套AWSCloudFormation模板和引用無服務器應用程序都在根模板和嵌套模板中。若要參考無伺服器應用程式，您可以使用AWS Serverless Application Model(AWS SAM) 範本。您可以自動產生AWS SAM範本，您的應用程式AWS Serverless Application Repository。以下是範例範本。

AWSTemplateFormatVersion: '2010-09-09'Transform: AWS::Serverless-2016-10-31Description: An example root template for a SAR application

Resources: SampleSARApplication: Type: AWS::Serverless::Application Properties: Location: ApplicationId: arn:aws:serverlessrepo:us-east-1:1234567890:applications/TestApplication SemanticVersion: 1.0.0 SampleEC2Instance: Type: AWS::EC2::Instance Properties: ImageId: "ami-79fd7eee" KeyName: "testkey" BlockDeviceMappings: - DeviceName: "/dev/sdm" Ebs: VolumeType: "io1"

70

https://console.aws.amazon.com/serverlessrepo

https://console.aws.amazon.com/serverlessrepo

https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-template-publishing-applications.html

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html


Iops: "200" DeleteOnTermination: "false" VolumeSize: "20" - DeviceName: "/dev/sdk" NoDevice: {}

所以此AWS SAM範本包含下列元素。

• ApplicationID：您的應用程序的 ARN。此資訊位於我的應用程式的區段AWS Serverless ApplicationRepository。

• SemanticVersion：無伺服器應用程式的版本。您可以從我的應用程式的區段AWS ServerlessApplication Repository。

• Parameter(選擇性)：應用程式參數。

Note

適用於ApplicationID和SemanticVersion、內部函數不受支援。你必須硬編碼這些字符串。所以此ApplicationID當它被克隆時將被更新AWS Marketplace。

如果您計劃在您的電子郵件中引用配置/腳本文件AWS CloudFormation範本，請遵循下列格式。對於嵌套模板（AWS# Cloudformation# 堆棧），只支持沒有內在函數的 TemplateURLs。請注意，Parameters範本中的內容。

AWSTemplateFormatVersion: '2010-09-09'Metadata: Name: Seller test productParameters: CFTRefFilesBucket: Type: String Default: "seller-bucket" CFTRefFilesBucketKeyPrefix: Type: String Default: "cftsolutionFolder/additionCFfiles"Resources: TestEc2: Type: AWS::EC2::Instance Metadata: AWS::CloudFormation::Init: addCloudAccount: files: /etc/cfn/set-aia-settings.sh: source: Fn::Sub: - https://${CFTRefFilesBucket}.${S3Region}amazonaws.com/${CFTRefFilesBucketKeyPrefix}/sampleScript.sh - S3Region: !If - GovCloudCondition - s3-us-gov-west-1 - s3 owner: root mode: '000700' authentication: S3AccessCreds .. .. .. SampleNestedStack: Type: AWS::CloudFormation::Stack Properties: TemplateURL: 'https://sellerbucket.s3.amazon.com/sellerproductfolder/nestedCft.template'

71

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference.html


Parameters: SampleParameter: 'test'Transform: AWS::Serverless-2016-10-31

提交您的AWS CloudFormation範本和組態檔提交您的AWS CloudFormation模板和配置/腳本文件，授予AWS Marketplace許可讀取儲存這些檔案的Amazon S3 儲存貯體。若要執行此動作，請更新儲存貯體政策以包含下列許可。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "assets.marketplace.amazonaws.com" }, "Action": ["s3:GetObject", "s3:ListBucket"], "Resource": ["arn:aws:s3:::DOC-EXAMPLE-BUCKET", "arn:aws:s3:::DOC-EXAMPLE-BUCKET/*"] } ]}

更新您的AWS Serverless Application Repository應用程式許可提交您的AWS Serverless Application Repository應用程式AWS Marketplace，您必須授予AWS Marketplace權限讀取您的應用程式。若要這樣做，請將權限新增至與無伺服器應用程式相關聯的原則。有兩種方式可以更新您的應用程式政策：

• 前往AWS Serverless Application Repository。從清單中選擇您的無伺服器應用程式。選取共享索引標籤，然後選擇建立陳述式。在陳述式組態頁面上，輸入以下服務主體：assets.marketplace.amazonaws.com中，在帳戶 ID欄位。最後選擇Save (儲存)。

• 使用下列AWS CLI命令來更新您的應用程式原則。

aws serverlessrepo put-application-policy \--region region \--application-id application-arn \--statements Principals=assets.marketplace.amazonaws.com,Actions=Deploy

分享您的 AMI所有建立的 AMI，並提交至AWS Marketplace必須遵守所有產品政策。自助式 AMI 掃描服務可在AWSMarketplace 管理入口網站。使用此功能，您可以啟動 AMI 的掃描，並在單一位置快速（通常在一小時內）接收掃描結果，並在單一位置獲得清晰的回饋。成功掃描您的 AMI 後，請提交 AMI 進行處理AWSMarketplace透過上傳您的產品載入表單，賣家和目錄操作團隊。

提交您的AWS CloudFormation產品與 AMI 和無伺服器應用送出產品前，請謹記以下事項：

• 您必須為每個範本提供拓樸圖。圖表必須使用AWS每個產品圖示AWS服務透過AWS CloudFormation範本，而且它必須包含服務的中繼資料。下載我們的官方網站AWS架構圖示，請參閱AWS 架構。

• 對於向買方顯示的每個範本，基礎結構成本估算是根據您使用AWS定價計算機。估計值應包含要部署做為範本一部分的服務清單，以及一般部署的預設值。

72

https://console.aws.amazon.com/serverlessrepo/home

http://aws.amazon.com/architecture/icons


AWS Marketplace 賣方指南私有映像

• 填寫產品載入表單。您可以從找到產品載入表單AWS Marketplace 管理入口網站。單一 AMI 產品和多個AMI 產品需要不同的產品加載表格。在產品載入表單中，您將提供公開 URL 給AWS CloudFormation範本。AWS CloudFormation範本必須以公用 URL 的形式提交。

• 使用AWS Marketplace 管理入口網站送出物品。從資產中，選擇檔案上傳，附加您的檔案，然後選擇上傳。在我們收到您的範本和中繼資料之後，AWS會開始處理您的請求。

送出物品後，AWS Marketplace會檢閱並驗證產品載入表單。此外，AWS Marketplace區域化 AMI 和無伺服器應用程式，並更新AWS CloudFormation會代表您進行的模板。如果發生任何問題，AWS Marketplace賣家和目錄營運團隊會透過電郵與你聯絡。

私有映像您可以使用私人影像版本，讓買家透過AWS Marketplace，然後將這些產品安裝在金色映像或 Amazon 機器映像 (AMI) 上，他們從可用的映像中選擇AWS帳戶。A金色映像是由購買者提供的伺服器影像，其中包含基礎作業系統，並套用修改，以協助確保軟體符合買方的 IT 標準。金色影像可讓買家更好地滿足其內部安全性、合規性和管理要求。

此主題說明如何使用AWS Marketplace Management Portal(AMMP) 上傳您的軟體二進位檔和/或指令碼，並為您的軟體將執行的每個作業系統 (OS) 建立可安裝的套件群組。AWS Marketplace執行測試建置，方法是在您指定的基礎作業系統上安裝套件群組，並掃描產生的映像中是否有某些已知弱點。映像建置和掃描完成後，您可以使用 AMMP 提交您的產品。

下圖顯示私用映像建置流程。

1. 您可以將可安裝的軟體套件上傳至AWS Marketplace。2. 買家從中選擇您的產品AWS Marketplace，但希望在 AMI 上為操作系統使用自己的黃金圖像。3. 買家要求 AMIAWS Marketplace私有映像構建服務，指定他們的黃金映像和您的可安裝軟件包。4. 所以此AWS Marketplace私人映像建置服務會建立新的私人映像，買方只能在其 AWS 帳戶中使用。然

後，他們可以從私有映像組態窗格或 Amazon Elastic Compute Cloud (Amazon EC2) 內啟動 AMI。

套件群組需求您可以提交您的套件群組，以便在AWS Marketplace基本 Linux AMI 或AWS Marketplace基本視窗伺服器AMI。

當您為產品選取作業系統平台時，您可以選擇要執行封裝群組的多個作業系統和作業系統版本。WindowsServer 套件不會在 Linux 作業系統上執行，反之亦然，因此如果您希望產品支援兩個作業系統平台的私人映

73


AWS Marketplace 賣方指南提交您的套件群組

像，您必須定義至少兩個套件群組。當您定義套件群組時，您可以上傳安裝套件或指令碼，AMMP 會為您選擇的每個作業系統建置和掃描測試映像。

若要讓您的套件群組成功完成建置和掃描程序，您必須遵守下列準則：

• 套件群組必須具有標示為安裝程式的其中一個套件或指令碼。例如，安裝程式可能是批次檔或指令碼，可協調其他套件的安裝，並提供自動安裝所需的參數。

• 對於以 Windows 伺服器為基礎的套件，支援的安裝程式類型具有 .msi、.ps1、.bat 和 .exe 副檔名。• 對於 Linux/UNIX（或任何與 POSIX 相容的）系統，支援的安裝程式類型具有 .exe、.rpm、.deb、.sh

和 .run 副檔名。• 整個安裝程序必須是自動的。它不需要任何互動式輸入，而且所有參數或參數都必須包含在安裝程式中。• 這些套件必須在不從其他網站下載修補程式或組態檔 (完整) 的情況下進行安裝。• 安裝程式/安裝程序檔必須是同步的。例如，指令碼必須等到套件完全安裝後才能結束。• 安裝成功時，安裝程式必須以結束狀態 0 結束。0 以外的任何值都會用於失敗的安裝。• 安裝程式無法在安裝期間要求重新開機。重新開機會停止追蹤套件測試和掃描程序的代理程式。如果安裝

程式重新開機，代理程式就會停止，測試和掃描將會失敗。• 安裝程式不得影響執行個體上的網路路由，使主機無法連線。

提交您的套件群組若要將套件群組提交至AWS Marketplace與私人映像構建一起使用

1. 從安培中，選擇資產、私人影像建置。2. UNDTED管理套件中，選擇啟動套件。3. In輸入套件群組的唯一名稱中，輸入產品的名稱。且該名稱長度不得超過 100 個字元，且只得

包含英數字元、底線和破折號。每個產品名稱與AWS帳戶必須是唯一的。使用名稱後（即使組建不成功），您也無法再次使用該名稱。建議使用具有檔名中包含版序號碼的命名慣例。例如：[product_group_name]<product_name><version><platform><revision_number>

4. In選取一或多個套件，從下拉式清單中選取套件，或選擇BROWSE，找到並選擇您要上傳的套件群組。5. UNDTED選取支援的作業系統平台下，選擇AWS Marketplace 基礎 Linux AMI或AWS Marketplace 基礎

視窗 AMI。6. UNDTED選取支援的作業系統，選擇您的套件群組將支援的所有作業系統，然後選擇提交。

對於您提交的每個套件群組，您選擇的每個作業系統版本都會完成建置程序。當您提交套件群組之後，會將您重新導向至掃描狀態頁面，您可以在此檢查每個套件群組的映像建立進度和掃描程序。

掃描狀態提交套件群組後，您可以在掃描狀態] 索引標籤。您提交的每個套件群組都會列出。選擇套件群組旁邊的箭頭，以展開清單，並顯示您選取之每個套件群組的組建和掃描狀態。

每個項目都會顯示 AMI ID、您提交套件群組的日期以及套件群組 (或組建) 的狀態。在此過程中，您可以追蹤已提交的套件群組和個別組建的狀態。您的套件群組提交可以處於四種狀態，而且個別組建可以處於五種狀態。

封裝群組狀態當自動化步驟完成時，套件群組狀態會更新。您可以返回掃描狀態頁面來檢查進度，或者如果頁面已開啟，您可以選擇Refresh 狀態以更新頁面上的資訊。套件群組狀態為：

• 建置— 您已提交套件群組，且正在建立對應的影像。

74


AWS Marketplace 賣方指南提交您的產品至AWS Marketplace

• 正在掃描— 您已提交套件群組，且正在掃描對應的影像。• 成功— 已成功掃描與套件群組相關聯的所有組建。提交您的產品載入表單。• 已找到問題— 您提交的一個或多個組建失敗，需要您注意。選擇資訊圖示，以取得其他疑難排解資訊。• 調查— 在建置和掃描程序期間發現問題。AWS Marketplace正在調查。

Note

如果您的狀態保留在調查州為四個或更多工作天，請聯絡AWS Marketplace賣方營運團隊。

作業系統組建狀態在掃描狀態頁面中，您可以選擇套裝程式群組名稱旁邊的箭號來展開項目，以顯示屬於套裝程式群組的每個作業系統組建。操作系統構建狀態是：

• 建置— 您在作業系統上的軟體建置正在進行中。每個組建最多需要一小時才能完成。• 正在掃描— 建置程序已順利完成，且正在進行掃描。這可能需要幾小時的時間來完成。• 成功— 組建和掃描程序已順利完成。你沒有進一步的行動。• 已找到問題— 組建或掃描程序發生問題，需要您注意。選擇資訊圖示，以取得其他疑難排解資訊。• 調查— 組建或掃描程序失敗。AWS Marketplace正在調查。

Note

如果您的狀態保留在調查州為四個或更多工作天，請聯絡AWS Marketplace賣方營運團隊。

當您的套件群組顯示成功，此階段已完成。接下來，您可以將套件群組發佈為您產品的新履行選項AWSMarketplace。

提交您的產品至AWS Marketplace將套件群組上傳至AWS Marketplace您可以提交產品載入表單，將其發佈為產品的新履行選項；如果該表單尚未存在，則可發佈為新產品。載入表單是 Excel 試算表。試算表的第一個索引標籤提供指示，說明在AWSMarketplace。

下載並填寫載入表單

1. 從安培，位於之下資產索引標籤上選擇檔案上傳。2. 在檔案上傳頁面，在產品載入表格和賣家指南中，選擇私有映像表單。3. 下載產品載入表單。4. 填寫表單。5. 來自 AMMP資產索引標籤上選擇檔案上傳。6. 選擇您要提交的檔案，然後輸入簡短描述。

AWS Marketplace會建立或更新您的產品項目。如果您的提交有任何問題，請AWS Marketplace將與您聯繫以作澄清。您的產品通常會在五個工作天內新增或更新。

新增套裝程式群組作為產品的新履行選項時，請考慮下列選項：

• 將套件群組作為額外的履行選項新增至現有的軟體版本，在AWS Marketplace。使用這種方法，AMI 上的軟件版本和軟件包履行選項必須匹配。AWS Marketplace無法取代現有軟體版本上的 AMI。

• 如果套件群組的軟體與目前存在的軟體不同AWS Marketplace，您可以將套件群組列為現有產品上的新軟體版本。使用這種方法，您必須從 AMMP 提供成功構建和掃描的 AMI套件] 索引標籤。在公開新的套裝程

75




AWS Marketplace 賣方指南建立 AMI 的最佳實務

式群組之前，您可以選擇測試套裝程式履行情況。但是，AMI 將立即顯示給買家。這與新軟體版本的目前體驗一致。

建立 AMI 的最佳實務本主題提供一些最佳做法和參考，可協助您建置 Amazon Machine Image (AMI) 以搭配使用AWSMarketplace。AMI 建立並提交至AWS Marketplace必須堅持所有AWS Marketplace產品原則。

驗證 AMI為了協助驗證 AMI 再提交為新產品或版本，您可以使用自助掃描。

從AWS Marketplace 管理入口網站中，選擇Amazon Machine Image來自資產] 功能表。按一下新增 AMI以啟動掃描程序。您可以返回此頁面來查看 AMI 的掃描狀態。

Note

了解如何給予AWS Marketplace存取，請參閱給予AWS Marketplace存取 AMI (p. 61)。

保護轉售權利您必須負責保護非自由 Linux 發行版的轉售權利，但AWS-提供了亞馬遜 Linux，RHEL，SUSE 和視窗AMI。

建置 AMI使用下列準則來建置 AMI：

• 確保您的 AMI 符合所有AWS Marketplace策略，包括停用根登入。• 在美國東部 (維吉尼亞北部) 區域建立 AMI。• 使用 Amazon Elastic Block Store (Amazon EBS) 支援的現有、維護良好的 AMI 建立產品，並提供明確定

義的生命週期，例如AWS Marketplace。• 使用最新的作業系統、套件和軟體來建置 AMI。• 確保所有 AMI 必須從使用硬體虛擬機器 (HVM) 虛擬化和 64 位元架構的公用 AMI 開始。• 開發一套可重複建置、更新及重新發佈 AMI 的流程。• 在所有版本和產品中使用一致的作業系統 (OS) 使用者名稱。我們建議ec2-user。• 設定執行中執行的執行個體，從最終 AMI 到您想要的使用者體驗，並測試所有安裝方法、功能和效能之

前提交至AWS Marketplace。• 檢查連接埠設定，如下所示：

• 以 Linux 為基礎的 AMI — 確定已開啟有效的 SSH 連接埠。預設的 SSH 連接埠是 22。• 以視窗為基礎的 AMI — 確定已開啟 RDP 連接埠。預設的 RDP 連接埠是 3389。此外，WinRM 連接埠

(預設為 5985) 必須開啟到 10.0.0.0/16。

如需建立 AMI 的詳細資訊，請參閱下列資源：

建立自己的 AMI中的Amazon EC2 Linux 執行個體使用者指南

建立自訂 Windows AMI中的Amazon EC2 Windows 執行個體使用者指南

如何從 EBS 支援的執行個體建立 Amazon Machine Image (AMI)？

Amazon Linux AMI

76

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html#creating-an-ami

https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html

http://aws.amazon.com/premiumsupport/knowledge-center/create-ami-ebs-backed/

http://aws.amazon.com/amazon-linux-ami/

AWS Marketplace 賣方指南確認您的軟體正在您的AWS MarketplaceAMI

Amazon EC2 執行個體類型和執行個體類型

確認您的軟體正在您的AWS MarketplaceAMI您可能希望在執行階段驗證軟體是否正在從 AMI 產品建立的 Amazon EC2 執行個體上執行。

若要驗證 Amazon EC2 執行個體是從 AMI 產品建立的，請使用 Amazon EC2 內建的執行個體中繼資料服務。下列步驟將帶您完成此驗證。如需使用中繼資料服務的詳細資訊，請參閱執行個體中繼資料與使用者資料中的Amazon Elastic Compute Cloud 使用者指南。

1. 取得執行個體身分證明文件

每個執行中的執行個體都有可從執行個體存取的身分識別文件，提供執行個體本身的資料。下面的例子顯示了使用從實例 curl 來檢索實例身份文件。

curl http://169.254.169.254/latest/dynamic/instance-identity/document{ "accountId" : "0123456789", "architecture" : "x86_64", "availabilityZone" : "us-east-1e", "billingProducts" : null, "devpayProductCodes" : null, "marketplaceProductCodes" : [ "0vg0000000000000000000000" ], "imageId" : "ami-0123456789abcdef1", "instanceId" : "i-0123456789abcdef0", "instanceType" : "t2.medium", "kernelId" : null, "pendingTime" : "2020-02-25T20:23:14Z", "privateIp" : "10.0.0.2", "ramdiskId" : null, "region" : "us-east-1", "version" : "2017-09-30"}

2. 驗證執行個體身分文件

您可以使用簽章來確認執行個體識別是否正確。如需此程序的詳細資訊，請參閱執行個體身分文件中的Amazon Elastic Compute Cloud 使用者指南。

3. 驗證產品代碼

當您最初提交 AMI 產品進行發佈時，您的產品會被指派一個產品代碼由AWS Marketplace。若要驗證產品代碼，請檢查marketplaceProductCodes欄位，或者您可以直接從中繼資料服務取得它：

curl http://169.254.169.254/latest/meta-data/product-codes0vg0000000000000000000000

如果產品代碼與 AMI 產品的代碼相符，則執行個體是從您的產品建立的。

您也可能希望從執行個體身份證明文件中驗證其他資訊，例如instanceId和執行個體privateIp。

保護 AMI建議您遵照下列準則來建立安全 AMI：

• 架構您的 AMI 以最小的安裝方式進行部署，以減少攻擊面。停用或移除不必要的服務和程式。• 儘可能使用網路流量端對端加密。例如，使用 Secure Sockets Layer (SSL) 保護您與買家之間的 HTTP 工

作階段。確保您的服務只使用有效且最新的憑證。

77

http://aws.amazon.com/ec2/instance-types/

http://docs.amazonwebservices.com/AWSEC2/latest/UserGuide/instance-types.html?r=2153

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html


https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-identity-documents.html

https://docs.aws.amazon.com/marketplace/latest/userguide/ami-getting-started.html#ami-product-codes

AWS Marketplace 賣方指南計量服務

• 將新版本新增至 AMI 產品時，請設定安全群組以控制對執行個體的輸入流量存取。請確定您的安全性群組設定為僅允許存取為您的服務提供必要功能所需的最低連接埠集。僅允許管理員存取必要的最小連接埠集和來源 IP 位址範圍。如需 AMI 產品新增版本的詳細資訊，請參閱新增新的版本 (p. 60)。

• 考慮對您的AWS計算環境，或考慮聘請第三方代表您進行此類測試。如需詳細資訊 (包含滲透測試請求表單)，請參閱AWS滲透測試。

• 請注意 Web 應用程式的前 10 個弱點，並相應地建置您的應用程式。如需進一步了解，請參閱開放式 Web應用程式安全專案 (OWASP)-前 10 個 Web 應用程式安全風險。當發現新的互聯網漏洞時，請立即更新AMI 中的任何 Web 應用程式。包含此資訊的資源範例如下：SecurityFocus與NIST 國家漏洞資料庫。

如需安全性相關資訊，請參閱下列資源：

• 共享 Linux AMI 的準則中的Amazon EC2 Linux 執行個體使用者指南• AWS 雲端安全• 互聯網安全中心 (CIS): 安全效能評定• 開放式 Web 應用程式安全專案 (OWASP)：安全編碼實務-快速參考指南• OWASP 十大 Web 應用程式安全風險• SANS (SysAdmin、稽核、網路和安全性) 常見弱點列舉 (CWE) 前 25 名最危險的軟體錯誤• 安全焦點• NIST 國家漏洞資料庫

計量服務AWS Marketplace 計量服務是一項定價和計量功能，銷售者可以使用以下四種用量類別之一來直接為其軟體收費：使用者、資料、頻寬或主機。您可以將計量服務搭配 AMI 型、容器型和 SaaS 型產品使用。如需詳細資訊，請參閱 AWS Marketplace 計量服務 API 參考。

所有使用計量服務的 AMI 軟體必須符合以下需求：

• 您的軟體必須從AWS Marketplace通過 Amazon Machine Image (AMI)。• 如果您有現有的產品AWS Marketplace，您必須提交新的 AMI 並建立新產品才能啟用此功能。• 所有軟體都必須使用AWS Identity and Access Management(IAM) 角色。最終客戶必須將 IAM 角色新增至

使用者以軟體佈建的 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體。T他使用 IAM 角色是選擇性的，當您透過AWS Marketplace。當您部署 AWS Marketplace 計量服務軟體時，這是必要的。

• 您的軟體必須能夠以某種方式判斷耗用量。

使用計量服務的產品必須按單一用量類別向客戶收費，但您最多可以定義單一類別的 24 個維度。根據類別而定，軟體可以依佈建的資源、並行資源或累積的資源耗用量來計價。所有費用仍然由客戶每小時產生。所有使用量均按月計算及計費，並使用與現有AWS Marketplace軟體。

AWS Marketplace 計量服務可啟用多種新案例。例如，如果您的軟體監控主機，您可以為每個受監控的主機收費。您可以根據主機大小取得不同的價格，以及每小時監控的並行主機數目收費。同樣地，如果您的軟體允許整個組織中的許多使用者登入，您可以依使用者數量收費。客戶每小時都會按已佈建的使用者總數收費。

計量服務概念AWS Marketplace 計量服務可讓軟體銷售商修改其軟體，將計量記錄傳送至終端節點以擷取使用量。賣家可以選擇用途類別，並定義該類別最多 24 個維度。這些維度每小時計量一次，彙總並根據賣家定義的價格計劃收費。作為賣家，您首先需要做的第一件事就是決定您想要使用的維度。AMI 發佈後，您將無法變更。重要的服務概念包含下列項目：

78

http://aws.amazon.com/security/penetration-testing/

https://owasp.org/www-project-top-ten/


http://www.securityfocus.com/vulnerabilities

http://nvd.nist.gov/

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/building-shared-amis.html

http://aws.amazon.com/security/

http://benchmarks.cisecurity.org/downloads/benchmarks/

https://www.owasp.org/www-project-secure-coding-practices-quick-reference-guide/migrated_content


http://www.sans.org/top25-software-errors/

http://www.securityfocus.com/vulnerabilities

http://nvd.nist.gov/

https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html

AWS Marketplace 賣方指南為您的軟體定價

• 使用方式類別— 透過使用計量服務定價的任何軟體產品，都會選取一個用途類別，以向客戶收費，包括但不限於：• 使用者 — 與單一識別碼相關聯的已定義權限集。此類別適用於客戶使用者直接連線至軟體的軟體 (例

如，用於客戶關係管理或商業智慧報告)。• 主機 — 任何伺服器、節點、執行個體、端點或運算系統的其他部分。此類別適用於監控或掃描許多客戶

擁有執行個體的軟體 (例如效能或安全性監控)。• 資料 — 儲存或資訊，以 MB、GB 或 TB 為單位。此類別適用於管理儲存資料或批次處理資料的軟體。• 頻寬 — 以 Mbps 或 Gbps 為單位。此類別適用於允許客戶指定要佈建頻寬數量的軟體。• 單位 — 測量單位；請參閱下面說明的範例。

• 使用單位— 軟體產品會選取與所選使用類別對應的特定使用單位。這通常更具體，並說明您的軟體將會充電的單位。範例包括：• NodesHrs HR (對應於「主機」類別)• 使用 UserHrs (對應於使用者類別)• GB 儲存 (對應於「資料」類別)

• 耗電量— 透過使用計量服務定價的任何軟體產品，將以下列三種方式之一收取費用：• 佈建 — 軟體可讓客戶設定特定數量的資源供使用 (例如，使用者數量或固定頻寬數量)。每個小時，客戶

都會為他們佈建的項目付費。• 並行 — 該軟件允許任意數量的不同主機或用戶連接到軟件。客戶每小時會根據存取軟體的主機或使用者

數量付費。• 累積 — 該軟體允許客戶使用任何數量的資料，無論是處理或儲存。客戶每小時都會支付總金額的費用。

• 定價— 透過使用計量服務定價的任何軟體產品，必須指定單一價格或定義最多 24 個維度，每個維度都有自己的價格。• 單一維度 — 這是最簡單的定價選項。無論大小或數量為何，客戶都需支付每小時每個資源單位的單一價

格 (例如，每個使用者每小時 0.014 USD，或每個主機每小時 0.070 USD)。• 多個維度 — 當選取的用途類別沿著多個軸變化時，此定價選項適用。例如，對於主機監控，可以根據主

機的大小設定不同的價格。或者，對於基於用戶的定價，可以根據用戶類型（例如管理員、超級用戶和只讀用戶）來設置不同的價格。

• 計量— 所有使用量都會記錄為計量事件，每小時一次。您的軟體必須設定為將適當的尺寸和使用量傳送至AWS Marketplace 計量服務。• 配置 — 您可以選擇性地按照您追蹤的屬性將使用分配到配置中。這些配置會以標籤形式表示給買方。

這些標籤可讓買家查看他們按標籤分成使用量的費用。例如，如果您依使用者收費，且使用者擁有「部門」屬性，則可以使用索引鍵為「部門」的標記和每個值一個配置來建立流量配置。這不會變更您報告的價格、維度或總使用量，但可讓您的客戶依適合您產品的類別來檢視其成本。

為您的軟體定價使用 AWS Marketplace 計量服務為軟體定價時，您必須先決定使用量類別以及使用方式。T他的服務支援六種不同的定價方案。您只能為您的產品選取下列其中一項：

• 佈建的使用者 (每小時)• 並行使用者 (每小時)• 佈建的主機 (每小時)• 並行主機 (每小時)• 佈建的頻寬 (每小時)• 累積數據 (每小時)

接下來，您必須決定如何為選取的使用量類別定價：

• 單一價格

79

AWS Marketplace 賣方指南將您的產品新增至AWS Marketplace

• 多重尺寸 (最多 24 個)

the section called “將您的產品新增至AWS Marketplace” (p. 80)說明如何提供客戶友善的維度和定價說明。

範例：使用非線性定價的佈建頻寬想像一下，你提供了網絡設備軟件。您可以選擇依佈建的頻寬計費。對於您的使用類別，請選取頻寬。除了按頻寬收費外，您還希望在買家向上擴展時收取不同的價格。您可以在頻寬類別中定義多個維度。您可以定義 25 Mbps、100 Mbps 和 1 Gbps 的獨特價格。

範例：具有多個維度的並行主機想像一下，您提供的軟體可監控其他 Amazon EC2 執行個體。您可以選擇依正在監視的主機數目計費。對於您的使用類別，請選取主機。除了依主機充電之外，您還希望為監控較大型主機的額外價值進行充電。您可以在主體品類中使用多個標註。您可以為微型、小型、中型、大型、大型、2XL、4XL 和 8XL 執行個體定義明確的價格。您的軟體負責將每個特定主機映射到您定義的維度之一。您的軟體必須負責為使用類別的每個維度傳送個別的計量記錄 (如果適用)。

將您的產品新增至AWS Marketplace若要利用計量服務，您必須為 AWS Marketplace 建立新產品以列出。如果您的產品已經在AWSMarketplace，您必須決定是否將新的 AWS Marketplace 計量服務產品除了您目前的產品之外，還是將您目前的產品取代為新使用者唯一可用的版本。如果您選擇更換，現有的產品將從AWS Marketplace因此，它不再適用於新買家。現有客戶將繼續可以存取其舊產品和執行個體，但他們可以在方便的情況下移轉至新產品。新產品必須計量 AWS Marketplace 計量服務的使用量，如修改軟體以使用計量服務 (p. 81)。

完成 AMI 後，請按照標準流程使用自助服務工具分享和掃描 AMI。除了使用管理入口網站上提供的範本之外，請填寫產品載入表單並上傳表單以開始擷取程序。

使用下列定義來完成 AWS Marketplace 計量服務的產品載入表單欄位。在產品載入表單上，這些欄位會標示為彈性消費定價 (FCP)來區分它們與每小時和每月價格的產品。

• 標題：如果您已經有產品AWS Marketplace，並且您正在添加相同的產品與AWS Marketplace計量服務，將 FCP 類別/維度納入括弧中，以區分兩者 (例如，「產品標題 (資料)」)。

• 定價方式：從下拉式清單中選擇用途。• FCP 類別：客戶收取付費產品的類別用途定價元件。從下拉式清單中選擇使用者、主機、資料, 或頻寬。• FCP 單位：客戶需支付付費產品的測量單位，其中包含用途定價元件。選項會根據您選取的 FCP 類別顯

示在下拉式清單中。下表列出每個品類的有效單位。

類別有效單位

使用者 UserHrs 間

主機 HostHrs

資料 MB, GB, TB

頻寬 Mbps

• FCP 維度名稱：傳送計量記錄時使用的名稱呼叫MeterUsageoperation. 它在計費報告中可見，但因為它不是面向外部的，所以名稱不需要易於使用。且該名稱長度不得超過 15 個字元，且只得包括英數字元和底線字元。在您設定名稱之後並使產品公開，則無法加以變更。變更名稱需要新的 AMI。

80

AWS Marketplace 賣方指南修改軟體以使用計量服務

• FCP 維度說明：描述產品維度的客戶面向聲明。說明 (例如，管理員每小時、佈建的每 Mbps 頻寬) 不得超過 70 個字元，而且應該容易使用。產品發佈之後，您無法變更此描述。

• FCP (FCP) 速率：本產品的每個單位的軟體費用。此欄位支援 3 位小數。

備註：

• 您不需要填寫每小時和每年定價欄位。• 免費試用和年度定價不相容。• P使用多個 AMI 和叢集和 AWS 資源功能的導管無法使用 AWS Marketplace 計量服務。• 價格、執行個體類型或區域變更將遵循其他AWS Marketplace產品。• 具有 AWS Marketplace 計量服務的產品無法轉換為其他定價模式，例如每小時、每月或自帶授權

(BYOL)。• AWS Marketplace建議您在使用指示或文件中新增 IAM 政策資訊。• 您最多可以包含 24 個 FCP 維度。建立並發佈之後，您就無法修改現有的維度，但是您可以新增

維度 (最多 24 個限制)。

如有任何問題，請聯絡AWS Marketplace賣方營運團隊。

修改軟體以使用計量服務您將需要修改軟體以記錄客戶使用情況、傳送每小時使用報告至計量服務，以及處理新的失敗模式。軟體運作獨立於定價，但軟體需要知道使用類別、如何使用，以及任何維度。

測量耗用量您的軟體必須決定選取的使用類別中的多少，以及客戶已使用的維度。此值會每小時傳送一次至計量服務。在所有情況下，都假設您的軟體能夠測量、記錄和讀取資源的使用量，以便每小時將其傳送至計量服務。

對於佈建的耗用，通常會從軟體組態讀取為取樣值，但也可能是每小時記錄的最大設定值。對於並行消耗，這可能是週期性樣本或每小時記錄的最大值。對於累積耗用量，這將是每小時累積的值。

對於多個維度的定價，必須測量多個值並將其傳送至「計量服務」，每個維度一個。這需要您的軟體在提供AMI 時使用已知的尺寸組進行編程或配置。建立產品後，尺寸集就無法變更。

針對每個定價案例，下表說明測量每小時使用量的建議方式。

案例測量方式

佈建使用者目前已佈建的使用者數目 (範例)。

-或-

已佈建的使用者數目上限 (看到該小時)。

並行使用者目前同時使用者的數目 (抽樣)。

-或-

同時使用者的數目上限 (看到該小時)。

-或-

不同使用者的總數 (看到該小時)。

81


AWS Marketplace 賣方指南致電 AWS Marketplace Meting Service

案例測量方式

佈建主機已佈建主機的目前數目 (取樣)。

-或-

已佈建的主機數目上限 (看到該小時)。

並行主機目前並行主機的數目 (取樣)。

-或-

並行主機數目上限 (看到該小時)。

-或-

不同主機的總數 (看到該小時)。

佈建的頻寬目前佈建的頻寬設定 (取樣)。

-或-

佈建頻寬上限 (看到該小時)。

累加資料目前儲存的 GB 資料 (取樣)。

-或-

儲存的最大 GB 資料 (看到該小時)。

-或-

該小時新增或處理的資料總 GB。

-或-

該小時處理的資料總 GB。

致電 AWS Marketplace Meting Service您的軟體必須每小時呼叫計量服務，並記錄該小時的耗用值。

當你的軟件啟動時，它應該記錄它開始的小時分鐘。這將被稱為起始-分鐘。開始分鐘的每一小時，您的軟體必須擷取該小時的耗用值，然後呼叫計量服務。如需如何取得此值的詳細資訊，請參閱the section called “測量耗用量 ” (p. 81)」一節。

若要在開始分鐘喚醒每個小時，您的軟體必須使用下列其中一種方法：

• 軟體中的一個執行緒。• 以執行個體或軟體啟動的常駐程式程序。• 在應用程序啟動期間配置的 cron 作業。

Note

您的軟體必須使用在客戶執行個體上設定的 IAM 角色呼叫 AWS Marketplace 計量服務，並指定耗用維度和金額。

您的軟體可以使用AWS開發套件來呼叫 AWS Marketplace 計量服務，類似於下列範例實作：

82

AWS Marketplace 賣方指南失敗處理

1. 使用執行個體描述檔建立服務用戶端。這需要為 EC2 執行個體配置的角色。SDK 會自動重新整理角色認證。

2. 每個小時，請閱讀您的軟體組態和狀態，以判斷該小時的耗用值。這可能包括收集每個維度的值。3. 呼叫meterUsage方法，其中包含下列參數 (另外呼叫具有使用狀況的每個維度)：

• timestamp：正在記錄的小時的時間戳記（以 UTC 表示）。• productCode：指派給軟體的產品代碼。• dimension：指定給軟體的維度 (或維度)。• quantity：小時的耗用值。• allocations: (選擇性) 您可以針對您追蹤的屬性提供使用量的配置。這些配置必須加總到記錄中的

總耗用量。對買方而言，這些項目會在其帳單工具中顯示為潛在的成本配置標記 (例如AWS Billing andCost Management主控台)。買方必須啟動帳戶中的標籤，才能使用這些標籤追蹤其成本。

此外，您的軟體必須呼叫區域內 AWS Marketplace 計量服務終端節點。您的產品必須設定正確的區域端點，因此us-east-1會將記錄傳送至us-east-1端點，和us-west-2會將記錄傳送至us-west-2端點。撥打區內通話可為買家提供更穩定的體驗，並防止不相關區域的可用性影響在其他區域執行的軟體的情況。

當您將計量記錄傳送至服務時，必須連線至您區域中的 AWS Marketplace 計量服務。使用getCurrentRegion()幫助程序方法來確定 EC2 實例正在運行的區域，然後將此區域信息傳遞給MeteringServiceClient建構子。若您未指定AWSSDK 構造函數中的區域，默認us-east-1使用區域。如果您的應用程式嘗試對服務進行跨區域呼叫，則呼叫會被拒絕。如需詳細資訊，請參閱「」決定應用模組的目前區域和getCurrentRegion ()。

失敗處理您的產品必須將計量記錄傳送至服務 (公用網際網路端點)，以便擷取和計費使用量。因為客戶可以修改網路設定，以避免傳送您的計量記錄，所以您的產品應該藉由選擇失敗模式來考量這個問題。

Note

某些計量失敗可能是暫時性的問題，在連線到AWS Marketplace計量服務。AWS Marketplace強烈建議您實作最多 30 分鐘的重試時間 (指數後退)，以避免短期中斷或網路問題。

一般而言，軟體可能無法開啟 (提供警告訊息，但維持完整功能) 或關閉失敗 (停用應用程式中的所有功能，直到重新建立連線)。您可以選擇無法開啟、關閉或特定於您的應用程式的項目。我們強烈建議您不要在計量失敗兩小時之後關閉失敗。

作為部分開啟失敗的範例，您可以繼續允許存取軟體，但不允許買方修改軟體設定。或者，買方仍然可以存取軟體，但無法建立其他使用者。您的軟體必須負責定義和強制執行此失敗模式。您的軟件故障模式必須包含在 AMI 提交時，且之後無法更改。

限制在設計和提交已啟用計量服務的軟體時，請記住下列限制：

• 為您的客戶提供 IAM 角色和網際網路閘道需求— 您的客戶必須擁有網際網路閘道，且必須以具有特定權限的 IAM 角色啟動您的軟體。如需詳細資訊，請參閱 the section called “AWS Marketplace計量和權利 API權限” (p. 261)。如果不符合這兩個條件，您的軟體就無法連線到計量服務。

• 無法新增新的或變更使用類別至現有的計量服務產品— 當客戶訂閱您的軟體產品時，即表示他們同意條款與條件。將變更使用類別需要新產品和新訂閱。

• 無法將維度變更為現有的計量服務產品— 當客戶訂閱您的軟體產品時，即表示他們同意條款與條件。使用計量服務變更產品中的尺寸需要新產品和新訂閱。您CANE為現有產品添加新的尺寸，最高限制為 24。

• 缺乏免費試用版和年度訂閱— 計量服務產品在推出時不支援免費試用和年度訂閱。

83

https://java.awsblog.com/post/Tx3GBOIEN1JJMQ5/Determining-an-Application-s-Current-Region

https://java.awsblog.com/post/Tx3GBOIEN1JJMQ5/Determining-an-Application-s-Current-Region

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/regions/Regions.html#getCurrentRegion()

AWS Marketplace 賣方指南AMI 產品檢查表

• 多執行個體或以叢集為基礎的部署考量— 部分軟體會部署為多執行個體部署的一部分。當您設計軟體時，請考慮測量消耗量的方式和位置，以及發出計量記錄的位置。

AMI 產品檢查表在提交您的 AMI 產品請求到AWS Marketplace，請檢閱此檢查清單。驗證此資訊將有助於確保您的提交順利完成發佈程序。

產品使用方式：

• 您的 AMI 必須準備就緒。• 您的 AMI 無法按時間或任何其他測量限制產品的使用。• 您的 AMI 必須與單鍵滿足體驗相容。• 使用產品所需的一切都在軟體中，包括用戶端應用程式。• 預設使用者使用隨機化的密碼，或建立初始使用者需要驗證購買者有權使用執行個體的唯一值 (例如執行

個體 ID) 來使用執行個體。

免費或付費產品：

• 不需要額外的授權即可使用產品。• 買方不需要提供個人識別資訊 (例如，他們的電子郵件地址) 即可使用產品。

AMI 準備：

• 使用 HVM 虛擬化和 64 位元架構• 不包含任何已知的漏洞、惡意軟體或病毒• 買家擁有 AMI 的作業系統層級管理權限• 透過 AMI 自助掃描執行您的 AMI

對於 Windows AMI：

• 使用最新版的EC2 配置服務• Ec2SetPassword、Ec2WindowsActivate，以及Ec2HandleUserData已在 AMI 中啟用• 沒有訪客帳戶或遠端桌面平台使用者

對 Linux AMI：

• 已鎖定或停用根登入• 未包含授權金鑰、預設密碼或其他認證

產品載入表單或產品標籤

• 所有必填欄位均已填寫• 所有值都在指定的字元限制內• 所有網址都載入沒有錯誤• 產品影像寬度至少為 110 像素，比例為 1:1 和 2:1• 針對所有啟用的執行個體類型指定定價 (針對每小時、每小時定價和每小時定價模式)• 指定每月定價 (適用於以小時為單位的每月和每月定價模式)

84

https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2config-service.html

AWS Marketplace 賣方指南AMI 安全政策

AMI 安全政策AWS Marketplace會維護所有 Amazon Machine Image (AMI) 產品和產品的政策，並在AWS Marketplace。這些政策為我們的客戶提供一個安全、安全且值得信賴的平台。

所有產品及其相關中繼資料在提交時都會進行審核，以確保產品符合或超過目前AWS Marketplace政策。這些原則經過審查和調整，以符合不斷演變的安全性準則。AWS Marketplace會持續掃描您的產品，以確認產品符合安全性指導方針的變更。如果產品不符合規定，AWS Marketplace將與您聯絡更新 AMI 產品以符合新標準。同樣地，如果發現新發現的漏洞影響 AMI，我們會要求您提供更新的 AMI，並提供相關更新。您必須使用自助式 AMI 掃描工具，然後再提交您的 AMI。此工具有助於確保 AMI 符合AWS Marketplace政策。

安全政策所有 AMI 都必須遵守下列安全政策：

• AMI 不得包含任何已知的弱點、惡意程式碼或病毒，自助式 AMI 掃描工具或AWS保護安全。• AMI 必須使用目前支援的作業系統和其他軟體套件。任何具有生命週期結束 (EOL) 作業系統或其他軟體套

件的 AMI 版本都會從AWS Marketplace。您可以使用更新的軟件包構建一個新的 AMI，並將其作為新版本發佈到AWS Marketplace。

• 所有執行個體驗證都必須使用 key pair 存取權，而非以密碼為基礎的驗證，即使使用者在啟動時產生、重設或定義密碼。AMI 不得因任何原因包含密碼、驗證金鑰、金鑰配對、安全性金鑰或其他認證。

• AMI 不得要求或使用使用者的存取或秘密金鑰來存取AWS的費用。如果您的 AMI 應用程序需要訪問用戶帳戶，則必須通過AWS Identity and Access Management(IAM) 角色AWS CloudFormation，它會創建實例並關聯適當的角色。當產品啟用單一 AMI 啟動時AWS CloudFormation交付方法時，對應的使用指示必須包含清楚的指示，以建立具有最低權限的 IAM 角色。如需詳細資訊，請參閱 the section called “使用CloudFormation 的 AMI 交付” (p. 64)。

• 以 Linux 為基礎的 AMI 不能允許 SSH 密碼驗證。停用您的密碼驗證sshd_config檔案 (依設定)PasswordAuthentication至NO。

存取原則存取原則有三種類別：一般、Linux 特定和 Windows 特定原則。

一般存取原則所有 AMI 皆須符合下列一般存取政策：

• AMI 必須允許作業系統 (OS) 層級管理功能，才能允許符合性需求、弱點更新和記錄檔存取。以 Linux 為基礎的 AMI 使用 SSH，而以 Windows 為基礎的 AMI 則使用 RDP。

• AMI 不得包含授權密碼或授權金鑰。• AMI 不得使用固定密碼進行系統管理存取。AMI 必須改用隨機化的密碼。另一種實作是擷取執行個體中繼

資料，並使用instance_id做為密碼。在允許設定或變更自己的認證之前，必須先提示系統管理員輸入這個隨機密碼。如需擷取執行個體中繼資料的資訊，請參閱。執行個體中繼資料與使用者資料中的AmazonEC2 Linux 執行個體使用者指南。

• 您必須無法存取客戶執行中的執行個體。客戶必須明確啟用任何外部訪問，並且 AMI 內置的任何可訪問性默認情況下必須關閉。

Linux 特定的存取原則Linux 架構的 AMI 必須遵守下列存取原則，以及一般存取原則：

85

http://aws.amazon.com/marketplace/management/manage-products

http://aws.amazon.com/marketplace/management/manage-products


AWS Marketplace 賣方指南客戶資訊政策

• 以 Linux 為基礎的 AMI 必須停用以密碼為基礎的遠端登入，並且只允許通過用戶帳戶進行 sudo 訪問，而不是 root 訪問。使用者必須透過使用者帳戶使用 sudo 存取，而且無法使用 root 存取權。Sudo 存取允許管理員控制哪些使用者可以執行根功能。它也會記錄稽核軌跡的活動。AMI 不得包含授權密碼或授權金鑰。

• 以 Linux 為基礎的 AMI 不能有空白或空白的根密碼。

Windows 特定存取原則Windows 型 AMI 必須遵守下列存取原則，以及一般存取原則：

• 如需 Windows Server 2016 及更新版本，請使用EC2Launch。• 對於 Windows Server 2012 R2 和更舊版本，使用最新版本的Ec2ConfigService並啟

用Ec2SetPassword、Ec2WindowsActivate，以及Ec2HandleUserData。• 移除訪客帳戶和遠端桌面平台使用者，不允許這些帳戶。

客戶資訊政策所有 AMI 皆須遵守下列客戶資訊政策：

• 除非 BYOL（攜帶您自己的授權）要求，否則軟體不得在未經客戶知情和明確同意的情況下收集或匯出客戶資料。收集或匯出客戶資料的應用程式必須遵守下列準則：• 客戶資料的收集必須是自助式、自動化且安全的。買方不需要等待賣方核准才能部署軟體。• 客戶資料的要求必須在清單的說明或使用說明中清楚說明。這包括收集的內容、儲存客戶資料的位置，

以及資料的使用方式。例如：本產品收集您的姓名和電子郵件地址。此資訊會傳送至，並由 <companyname>. 這些資料只會用於與買家聯絡 <product name>。

• 不得收集付款資訊。

產品使用政策所有 AMI 皆須符合下列產品使用政策：

• 產品不得依時間、使用者人數或其他限制來限制對產品或產品功能的存取。Beta 版和售前版產品，或其唯一目的是提供試用或評估功能的產品，均不受支援。支援開發人員、社群和 BYOL 版本的商業軟體，前提是同等付費版本的AWS Marketplace。

• 所有 AMI 必須與「從網站啟動」體驗或透過AWS CloudFormation。對於從網站啟動，AMI 無法要求創建實例時的客戶或用戶數據正常運行。

• AMI 及其軟體必須以自助方式部署，且不得要求額外的付款方式或成本。需要部署外部相依性的應用程式必須遵守以下準則：• 要求必須在清單的說明或使用說明中披露。例如：此產品需要網際網路連線才能正確部署。下列套件會

在部署時下載：<list of package>。• 賣方應負責使用並確保所有外部依賴項的可用性和安全性。• 如果外部相依性不再可用，則必須從AWS Marketplace也是如此。• 外部相依性不得要求額外的付款方式或成本。

• 對於 BYOL 以外的所有產品，履行過程不得要求客戶離開AWS Marketplace。• 需要持續連線至不受購買者直接控制的外部資源的 AMI，例如外部 API 或AWS由賣方或第三方管理的服務

— 必須遵循以下準則：• 要求必須在清單的說明或使用說明中披露。例如：本產品需要持續的網際網路連線。需要下列進行中的

外部服務才能正常運 <list of resources> 作：• 賣方應負責使用並確保所有外部資源的可用性和安全性。

86

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/building-shared-amis.html#public-amis-disable-password-logins-for-root

AWS Marketplace 賣方指南架構

• 如果外部資源不再可用，則必須從AWS Marketplace也是如此。• 外部資源不得要求額外的付款方式或成本，且連線的設定必須自動化。

• 產品軟體和中繼資料不得包含會將使用者重新導向至其他雲端平台、其他產品或追加銷售服務的語言，但AWS Marketplace。

• 如果您的產品是另一個 ISV 產品的附加元件，您的產品描述必須指出它延伸了其他產品的功能，而且如果沒有它，您的產品的公用程式非常有限。例如：本產品擴展的功能 <product name> 和沒有它，這個產品具有非常有限的實用性。請注意，此 <product name> 刊登物品可能需要自己的授權才能使用完整功能。

架構所有 AMI 皆須符合下列架構政策：

• 的來源 AMIAWS Marketplace必須提供在美國東部 (維吉尼亞北部) 區域。• AMI 必須使用 HVM 虛擬化。• AMI 必須使用 64 位元或 64 位元的 ARM 架構。• AMI 必須是 Amazon Elastic Block Store (Amazon EBS) 支援的 AMI。我們不支援 Amazon Simple

Storage Service (Amazon S3) 支援的 AMI。• AMI 不得使用加密的檔案系統。• AMI 必須建立，以便它們可以在所有AWS地區和地區不可知論。不允許針對不同區域建置不同的 AMI。

87

AWS Marketplace 賣方指南取得說明

以貨櫃為基礎的產品AWS Marketplace支援使用 Docker 容器的軟體產品。容器產品包含交付選項，這些選項是一組容器映像和一起搭配的部署範本。您至少為您的產品提交一個送貨選項，最多可提供四個送貨選項。針對每個傳遞選項，您可以提供一組容器映像、使用指示以及部署範本的連結，供客戶啟動該傳遞選項。

AWS Marketplace買家可以在已發佈的產品詳細資料頁面上看到可用的送貨選項。在他們訂閱產品並選擇他們喜歡的交付選項後，購買者會看到可用部署範本的連結、容器映像 URL，以及如何提取個別容器映像的指示。有關購買體驗的逐步解說，你可以參考這個視頻，部署AWS Marketplace亞馬遜 ECS 叢集上的容器(3:34)。

您可以在協調流程服務上執行付費容器產品Amazon Elastic Container Service、Amazon Elastic KubernetesService，以及AWS Fargate。您可以在任何 Docker 相容的執行階段上執行免費和攜帶自己的授權模式(BYOL) 容器產品。

主題• 取得說明 (p. 88)• 開始使用容器產品 (p. 88)• 以貨櫃為基礎的產品需求 (p. 94)• 定價容器產品 (p. 96)• AWS Marketplace計量服務整合 (p. 97)

取得說明如需有關容器產品的協助，請聯絡您的業務發展夥伴AWS Marketplace或聯絡我們。

開始使用容器產品本主題說明與建立、測試及發行第一個容器產品相關的所有步驟AWS Marketplace。在本練習中，我們假設您已在 Amazon 彈性容器服務 (Amazon ECS)、Amazon 彈性 Kubernetes 服務 (Amazon EKS) 中建立至少一個容器，或AWS Fargate，並且您有相關聯圖像的鏈接。我們建議您在公開發佈產品之前，先規劃定價、權益和計量策略。

Note

如需容器產品需求的詳細資訊，請參閱以貨櫃為基礎的產品需求 (p. 94)。如需設定產品定價的相關資訊，請參閱定價容器產品 (p. 96)。如需付費容器型產品之自訂計量的相關資訊，請參閱AWS Marketplace計量服務整合 (p. 97)。

主題• 建立容器產品 (p. 89)• 建立容器產品的產品識別碼 (p. 89)• 建立或更新容器產品的定價 (p. 89)• 為您的容器產品整合計量 (p. 90)• 新增產品的新版本 (p. 90)• 更新版本資訊 (p. 92)

88

https://www.youtube.com/watch?v=XaiUAiQQJtk

https://www.youtube.com/watch?v=XaiUAiQQJtk

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/

https://docs.aws.amazon.com/eks/latest/userguide/

https://docs.aws.amazon.com/eks/latest/userguide/

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/AWS_Fargate.html


AWS Marketplace 賣方指南建立容器產品

• 建立或更新容器產品的產品資訊 (p. 93)• 發佈容器產品 (p. 94)• 容器產品會掃描安全性問題 (p. 94)

建立容器產品建立容器產品包含下列步驟：

1. 建立產品 ID。2. 建立訂價詳細資料。3. 對於付費產品，請將計量整合到您的產品中。4. 新增產品的新版本，包括：

a. 為您的容器添加存儲庫。b. 將最終容器上傳到存放庫中。c. 使用您的第一個容器映像建立產品的第一個版本。

5. 更新產品資訊。6. 發佈產品給買家。

前兩個步驟必須先執行，然後才能編輯AWS Marketplace。不過，您可以依照對您最有意義的順序或並行執行其他步驟。

下列主題說明其中每一個步驟。

建立容器產品的產品識別碼若要開始使用容器產品，您必須在AWS Marketplace。產品識別碼用於追蹤您的產品整個生命週期。

使用下列程序以建立新的容器產品AWS Marketplace管理入口網站，並產生產品 ID。

若要建立容器產品識別碼

1. 開啟 Web 瀏覽器並登入AWS Marketplace入口網站。2. 從選單列展開資產，然後選擇容器。3. 為您的產品提供面向客戶的名稱，然後選擇建立。如有必要，您可以稍後變更此名稱。4. 記下產品 ID以供日後建立或更新產品定價詳細資料時使用。

Tip

如果您遺失了產品 ID，您可以在AWS Marketplace管理入口網站容器來自資產選單。所以此容器頁面會顯示產品清單及其相關產品識別碼。

您現在擁有初始容器產品和產品識別碼。接下來，新增產品的定價詳情。

建立或更新容器產品的定價若要更新容器產品的定價明細，您必須使用產品裝載表單 (PLF)。您產品的 PLF 是一個試算表，其中包含您產品的相關資訊。下列程序概述使用 PLF 來更新產品的相關資訊，包括定價詳細資訊。

Note

如需容器產品定價模型的詳細資訊，請參閱定價容器產品 (p. 96)。

89


AWS Marketplace 賣方指南為您的容器產品整合計量

您的定價和計量必須一致。如需容器產品測量的詳細資訊，請參閱AWS Marketplace計量服務整合 (p. 97)。

若要使用產品載入表單更新容器產品的定價

1. 開啟 Web 瀏覽器並登入AWS Marketplace入口網站。2. 從選單列展開資產，然後選擇檔案上傳。3. 從下載產品載入表格在右側，選擇容器產品裝載表。4. 在電腦上開啟 PLF 試算表，然後填寫欄位以定義您的產品。此資訊包括您在建立容器產品時所記下的產

品識別碼。

Tip

在 Microsoft Excel 中檢視產品載入表單時，將滑鼠游標移至每個欄位上，以顯示提供如何填入每個欄位的指引的註解。

根據您產品的定價模式，提供定價和計量維度。如需詳細資訊，請參閱下列內容：

• 用於自訂計量的產品負載表 (p. 99)• 每小時計量的產品負載表 (p. 104)

Note

必填字段有一個紅色標題，其單詞必要在試算表中。確保所有這些欄位都已填寫，以避免處理您的請求時延誤。

5. 儲存您的產品載入表單。6. 如果仍未開啟，請開啟 Web 瀏覽器並登入AWS Marketplace入口網站。7. 從選單列展開資產，然後選擇檔案上傳。8. In上傳檔案，瀏覽您的電腦並選擇您為此容器產品儲存的 PLF 檔案。9. 提供此 PLF 的簡短描述，以幫助您在上傳的其他 PLF 中識別它。10. 選擇 Upload (上傳)。您上傳的 PLF 會出現在頁面底部的資料表中。

您的定價詳細資料會由AWS Marketplace賣家營運團隊通常需要幾個工作天的時間來完成更新。您可以選擇容器來自資產] 功能表AWS Marketplace管理入口網站。當您的產品定價詳細資料檢閱完成時，系統會傳送電子郵件訊息給您。

Note

您的容器產品現在會以有限的狀態建立。您的帳戶可以檢視產品進行測試，並對其進行修改。若要讓其他測試帳戶可見，或者在準備好時，將其公開可用，請參閱發佈容器產品 (p. 94)。

您可以依照此相同程序編輯容器產品定價，直到產品公開發佈為止。

建立產品的定價詳細資料後，您可以新增其他產品詳細資料、將計量整合到產品中，以及為您的產品建立軟體版本。

為您的容器產品整合計量您使用AWS Marketplace計量服務，以檢查使用產品的權利，以及計量計費使用量。您必須為設定定價資訊時所建立的定價模型計量。如需更多詳細資訊，請參閱 AWS Marketplace計量服務整合 (p. 97)。

新增產品的新版本您的產品在其生命週期內可能有多個版本。每個版本都有一組特定於該版本的容器映像。

90




AWS Marketplace 賣方指南新增產品的新版本

Note

您必須先建立產品識別碼和產品定價，才能將版本新增至產品。如需這些步驟的詳細資訊，請參閱建立容器產品的產品識別碼 (p. 89)，以及建立或更新容器產品的定價 (p. 89)。

建立產品版本包含下列步驟：

1. 將任何需要的存儲庫添加到AWS Marketplace。2. 將容器映像和其他成品上傳至存放庫。3. 將新版本新增至您的產品。

您的產品容器圖像和其他工件存儲在存儲庫中AWS Marketplace。通常，您可以為每個需要的成品創建一個存儲庫，但存儲庫可以存儲多個版本的成品（使用不同的標籤）。

Note

產品部署中的所有映像都必須使用AWS Marketplace儲存庫。

下列程序說明如何將儲存庫新增至AWS Marketplace。如果您已經建立任何必要的儲存庫 (例如，您正在建立新版本並使用現有的儲存庫)，您可以略過此步驟。

Note

如果您先前建立了使用群組 ID 的存放庫 (AWS Marketplace），則需要為新版本創建新的存儲庫。您現有的存放庫將繼續適用於您之前新增的版本。

若要新增儲存庫

1. 開啟 Web 瀏覽器並登入AWS Marketplace入口網站。2. 選擇伺服器產品來自產品選單。3. 在目前伺服器產品索引標籤上，選取您要修改的產品，然後選擇新增儲存庫來自請求變更下拉式選單。4. 輸入您要建立之儲存器的名稱。如果您想要建立多個新儲存庫，請選擇新增儲存庫，並指定唯一的名

稱。Note

存儲庫將具有這樣的結構：<repositoryID>美國東方東方東方東方 1 號美國聯合會<sellerName>/<repositoryName>。當您將項目新增至儲存庫 (在下列程序中) 時，它們會取得標籤並具有此結構：<sellerName> <repositoryName>我們-<repositoryID> 東部-1 天-美國-美國-美國-美國-美國-美國-美國-美國-美國-美國-美國-美國 <tag>。所以此儲存庫識別碼是內部識別碼AWS Marketplace，賣家名稱是根據你為賣家帳戶建立的名稱而建立的。請定義休息名稱在此步驟中。所以此標籤在您將工件上傳到工件庫時設置。

5. 選取 Submit (提交)。

Note

每個產品最多可以有 50 個儲存庫。

系統會建立新的要求，並顯示在請求索引標籤。完成後，您可以在幾分鐘內開始將容器映像和其他成品新增至您建立的儲存庫。

Note

系統會自動掃描您的容器影像，以查看它們是否符合以貨櫃為基礎的產品需求 (p. 94)。如需更多詳細資訊，請參閱容器產品會掃描安全性問題 (p. 94)。

將容器影像和成品上傳至儲存庫

1. 如果尚未開啟 Web 瀏覽器並登入AWS Marketplace入口網站。

91



AWS Marketplace 賣方指南更新版本資訊

2. 選擇伺服器產品來自產品選單。3. 在目前伺服器產品標籤上，選取您要修改的產品。4. 選擇新增儲存庫來自請求變更下拉式選單。5. 選擇檢視存在的儲存庫。6. 選取您要上傳的目標儲存器，然後選取檢視推入命令查看指令列表，包括可用於將 Docker 容器映像和

Helm 圖表推送到該存儲庫的命令。7. 使用列出的命令，將任何需要的工件從本地存儲庫推送到AWS Marketplace儲存庫中的產品。

Note

所以此tag用於區分您上傳到存放庫的成品版本。使用對於工件所屬版本有意義的標籤。8. 針對您的版本中需要的每個容器映像或工件重複此操作。

Note

您的版本在每個傳送選項中最多可包含 50 個容器映像或成品 (如需傳送選項的詳細資訊，請參閱下列程序)。

在您上傳成品後，您就可以建立產品的版本。

若要將新版本新增至容器產品

1. 如果尚未開啟 Web 瀏覽器並登入AWS Marketplace入口網站。2. 選擇伺服器產品來自產品選單。3. 在目前伺服器產品索引標籤上，選取您要新增版本的產品，然後選擇Add (新增) 版本來自請求變更下拉

式選單。4. 在Add (新增) 版本頁面上，輸入版本標題和版本備註為您的版本。5. 針對產品的每個送貨選項，輸入標題、描述，以及使用說明，以及客戶需要的相容性資訊和成品。提供

足夠的資訊，讓您的客戶了解如何選擇適合他們的需求的正確派送選項。Note

如果您的產品支援多個具有不同容器映像的平台 (例如 Kubernetes 和 Ubuntu 部署)，您可以為客戶設定產品的每種方式建立一個傳送選項，最多可為產品建立 4 個傳送選項。

6. 對於每個傳送選項，請在AWS Marketplace存放庫，以取得產品所需的每個容器映像。如有需要，請選取新增容器映像路徑以新增其他影像。

7. 如有需要，請選取新增送貨選項以新增其他送貨選項。8. 選取 Submit (提交)。

系統會建立您對新版本的要求，並且應該在幾分鐘內完成。您可以從請求標籤伺服器產品(憑證已建立！) 頁面上的名稱有些許差異。

Note

所有買家都可以使用你的新版本。如果您的產品目前設定為有限可用性，您的版本就會提供給該產品可用的購買者。如果您的產品目前設定為公開可用性，則您的新版本可供所有AWS Marketplace買方。

如果這是您的第一個版本集，您的產品現在已準備好發佈。下一個主題說明發佈您的產品。

更新版本資訊建立版本後，修改與版本相關的資訊，向買家提供更新的資訊會很有幫助。例如，如果您計劃在 1.1 版發行後限制 1.0 版，您可以更新 1.0 版的說明，將買方引導至 1.1 版，以限制版本的日期。您可以從更新版本資訊AWS Marketplace管理入口網站。

92


AWS Marketplace 賣方指南建立或更新容器產品的產品資訊

更新版本資訊

1. 開啟AWS Marketplace管理入口網站http://aws.amazon.com/marketplace/management/tour/，然後登入你的賣方帳戶。

2. 前往伺服器產品頁面上，以及目前伺服器產品標籤上，選取您要修改的產品。3. 從請求變更下拉式選單，選擇更新版本資訊。4. 在更新版本頁面，選取您要更新的版本。5. 您可以更新版本備註，以取得版本。

Note

對於尚未公開提供的版本，您還可以編輯版本標題。6. 對於尚未限制的遞送選項，您可以編輯以下欄位：

• 描述• 使用說明• 相容的 AWS 服務

Note

對於尚未公開提供的版本中的傳送選項，您也可以變更送貨選項的標題，容器映像，以及部署資源。

7. 選取 Submit (提交)。8. 確認要求會出現在請求標籤2. 审查中狀態。

您可以隨時從請求標籤伺服器產品(憑證已建立！) 頁面上的名稱有些許差異。

建立或更新容器產品的產品資訊建立產品識別碼並設定定價之後，您可以編輯產品資訊，包括客戶在AWS Marketplace。下列程序概述了為您的產品建立產品詳細資料。

建立容器產品的產品詳細資料

1. 開啟 Web 瀏覽器並登入AWS Marketplace入口網站。2. 前往伺服器產品頁面上，以及目前伺服器產品索引標籤上，選取您要修改的容器產品。3. 從請求變更下拉式選單，選擇更新產品資訊。4. 更新任何您需要變更的欄位：

• 產品標題• SKU• 簡短描述• 完整描述• 產品標誌影像網址• 要點• 產品類別• Keywords• 產品影片 URL• 資源• Support 資訊

93






AWS Marketplace 賣方指南發佈容器產品

Note

影像 URL 必須位於可公開存取的 S3 儲存貯體中。如需標誌格式的詳細資訊，請參閱公司和產品標誌要求 (p. 177)。

5. 選取 Submit (提交)。6. 確認要求會出現在請求標籤2. 审查中狀態。您可能需要重新整理頁面來查看清單上的請求。

您可以隨時從請求標籤伺服器產品(憑證已建立！) 頁面上的名稱有些許差異。

發佈容器產品當您初次建立產品時，其可用性僅限於您的帳戶。一旦您的產品準備好進行測試 (包括填寫產品詳細資料和建立第一個版本)，您可以將產品提供給其他帳戶進行測試，或以公開產品的形式提供給所有帳戶。

Note

在公開發行之前，您應該檢閱產品以確保正確性，包括映像連結、部署範本、描述和定價。您無法針對公開發佈的產品變更您的定價模式。

若要將您的有限產品發佈至其他帳戶或公開供應，請連絡AWS Marketplace賣方營運團隊。在您的要求中，提供產品識別碼，並說明您要進行的變更。

Note

你也可以選擇限制買家不想再使用的版本。您可以在公開發佈產品的要求中包含此項，以避免測試版本出現在公開產品中。如果您的公開產品沒有公開版本，則無法限制版本。

當您公開發佈容器產品時，您可以讓所有AWS客戶，然後可以訂閱並啟動您的產品。所以此AWSMarketplace賣方營運團隊會審查您的產品資訊中的資料，以及您對AWS Marketplace計量服務。

容器產品會掃描安全性問題當您提交容器映像 URL 時，我們會掃描它並檢查是否有安全性弱點。我們會檢查您提供的影像是否有已知的安全性弱點。要做到這一點，我們在圖像上執行一層一層的靜態掃描。如果我們發現具有遠端利用風險媒介的重大漏洞，我們會為您提供已發現問題的清單。我們強烈建議您使用容器影像掃描器 (例如Clair、Twistlock、Aqua Security 或趨勢科技) 來執行自己的安全分析，以避免擷取和發佈程序延遲。

您選擇用於建置容器映像的基礎映像，可能會對最終映像的安全性設定檔產生重大影響。如果您選擇已知嚴重弱點的基礎映像，即使您的應用程式軟體層是乾淨的，它們也會因為基礎層而被標記。我們建議您先確認您是從無障礙基底容器開始，然後再建置映像並將它們提交至AWS Marketplace。

以貨櫃為基礎的產品需求AWS Marketplace維持下列所有容器型產品和產品的要求，AWS Marketplace。這些要求有助於為我們的客戶推廣安全、安全且值得信賴的目錄。我們也鼓勵銷售者檢閱其他控制和協議的實施情況，以滿足其特定產品的需求。

所有產品及其相關中繼資料在提交時都會進行審核，以確保產品符合或超過目前AWS Marketplace要求。我們會審查並調整這些政策，以符合我們不斷演變的安全性和其他使用需求。AWS Marketplace會持續驗證現有產品是否繼續符合這些需求的任何變更。如果產品不符合規定，AWS Marketplace將與您聯絡以更新您的產品。在某些情況下，您的產品可能會暫時無法供新訂閱者使用，直到問題解決為止。

94



AWS Marketplace 賣方指南安全性需求

安全性需求所有容器產品皆須符合下列安全要求：

• Docker 容器映像必須沒有任何已知的惡意程式碼、病毒或弱點。自助式容器映像擷取工具可偵測弱點。若要使用容器掃描工具，請登入AWS Marketplace管理入口網站，選取容器來自資產功能表，然後為您的產品提交影像。

• 如果您的容器型產品需要存取管理AWS資源，它必須通過服務帳戶的 IAM 角色(如果透過亞馬遜彈性金屬服務 (亞馬遜 EKS) 執行) 或IAM 角色(如果透過 Amazon Elastic Container Service (Amazon ECS) 執行)，而非向使用者要求存取金鑰。

• 以容器為基礎的產品必須只需要最少的權限才能執行。如需詳細資訊，請參閱「」ECS 安全和EKS 安全。• 容器映像應該配置為默認使用非根權限運行。

存取要求所有儲存器產品皆須符合下列要求：

• 以容器為基礎的產品必須使用初始隨機化密碼。容器型產品不得使用初始固定或空白密碼進行外部管理存取 (例如，透過 Web 介面登入應用程式)。必須先提示買方輸入這個隨機密碼，才能設定或變更他們自己的憑證。

• 客戶必須明確同意並啟用應用程式的任何外部存取權。

客戶資訊要求所有貨櫃產品皆須符合下列客戶資訊要求：

• 以貨櫃為基礎的產品必須能夠啟動，而不需要買方提供任何識別資訊來啟動產品。自有授權 (BYOL) 產品是此要求的例外。

• 未經客戶知情並明確同意，軟體不得要求、收集或匯出任何客戶資料。

產品使用需求所有容器產品皆須符合下列產品使用要求：

• 賣家只能刊登功能完整的產品。不允許試用或評估用途的 Beta 版或售前版產品。支援開發人員、社群和BYOL 版本的商業軟體，如果賣方在AWS Marketplace在提供免費版的 90 天內。

• 所有容器型產品的使用指示都必須包含部署容器型產品的所有步驟。使用指示必須提供指向AWSMarketplace。

• 以容器為基礎的產品必須包含訂閱者使用軟體所需的所有容器映像。此外，以容器為基礎的產品不得要求使用者使用任何images從外部AWS Marketplace（例如，來自第三方存儲庫的容器映像）。

• 產品軟體和中繼資料不得包含會將使用者重新導向至其他雲端平台、其他產品或追加銷售服務的語言，但AWS Marketplace。

架構要求所有容器產品皆須符合下列架構要求：

• 來源容器映像AWS Marketplace必須從公有容器登錄或 Amazon Elastic Container Registry (AmazonECR) 提供。

95

https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security.html

https://docs.aws.amazon.com/eks/latest/userguide/security.html

AWS Marketplace 賣方指南定價容器產品

• 容器映像必須以 Linux 為基礎。• 付費容器型產品必須能夠部署在Amazon ECS、Amazon EKS, 或AWS Fargate。

定價容器產品本節概述容器產品的可用定價模型。您可以列出免費產品，攜帶自己的許可證（BYOL）產品，以及亞馬遜ECS，亞馬遜 EKS 和 Fargate 特的付費產品。您只能針對每個產品設定一個價格。

Note

您使用AWS Marketplace計量服務，以強制執行付費產品的權利和計量使用量。對於每項任務或每個網繭定價，AWS 會自動計量使用量。

您為容器產品設定的價格適用於所有 AWS 區域。每當您降低容器產品的價格時，新價格會立即為您的買家實施。對於價格上漲，現有買家會在帳單影響前 90 天收到有關變更的通知。新買家將以新金額計費。

容器產品的定價模式付費容器產品支援下列定價模式：

• 根據您定義的維度 (例如使用者、節點、儲存庫、GB 等) 的自訂計量價格，每個產品最多 24 個維度。• 一個長期合同，以較低的價格，預付或定期分期付款。長期合約可新增至具有自訂計量付費定價的現有產

品，或每個工作/每個網繭定價。如果買家消費超過他們在長期合約中購買的金額，則會支付計量價格。• 固定的月費，可讓使用者在下一個月內無限次使用產品。• 根據 Amazon ECS 任務或 Amazon EKS 網繭定價，我們以每小時設定的價格為第二個。• BYOL 定價，這是管理外AWS Marketplace透過您與買方維護的外部帳單關係。

Example 固定每月費用

您將產品的價格設定為每月 99 美元。您的產品包含三個使用 Amazon ECS 任務定義部署的不同容器映像。

買方訂閱您的產品後，系統會立即向他們收取 $99 的費用，每個月都會重複收費，直到他們取消訂閱為止。買方也獲得產品的無限使用。買方也支付任務執行的任何基礎設施的費用。訂閱時，他們可以訪問您的容器圖像。他們可以在任何組態中從 Amazon ECS 或 Amazon EKS 上的這些映像啟動和執行任意數量的容器。

如果買方在一個月中取消訂閱，他們將無法存取 Amazon ECR 存放庫，AWS Marketplace會儲存容器影像。買方可能已經提取並存儲了原始圖像，但他們不能再提取您通過AWS Marketplace。買家會根據最後一個月未使用的部分退款，而且我們會根據買家的使用量減去同意的AWS Marketplace費用

Example 自訂量度定價維度

您的產品會依使用者收費。您有管理員使用者和一般使用者，並將定價定義為管理員使用者為 $2，一般使用者為 $1。您可以在列出產品時將它們設定為不同的尺寸。您按每天登入的使用者收費，並按每天計量該使用量。

Example 每個任務或每個網繭每小時價格

您的產品包含三個不同的容器映像：控制器節點、背景工作節點和分析節點。因為如果沒有控制器節點，您的產品就無法正常運作或有用，所以您決定要為其充電使用量的影像。您設定的價格為每小時 6 美元。

您可以修改控制器節點的容器映像中的軟體，以與AWS Marketplace計量服務的RegisterUsageoperation.這可確保只有具有有效訂閱的購買者才能啟動和執行該容器映像，並根據其執行時間來計量其使用量。

96

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html

https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html

https://docs.aws.amazon.com/AmazonECS/latest/userguide/what-is-fargate.html



AWS Marketplace 賣方指南AWS Marketplace計量服務整合

針對每個執行的 Amazon EKS 控制器網繭，買方需支付每小時使用費 6 美元。如果買方啟動了五個包含控制器節點容器的 Amazon EKS 控制器網繭，則需支付每小時 30 美元 (每個網繭 6 美元)。買方也支付網繭運行的任何基礎設施的費用。

對於每小時定價，每秒計費，最少需要 1 分鐘。如果客戶執行此控制器容器 20 分鐘又 30 秒，則會向客戶收費20 x ($6/60) + 30 x ($6/60/60) = $2 + $0.05 = $2.05。我們會根據買家的使用量減去同意的AWS Marketplace費用

Example 長期合約

對於計量付費定價模型，您可以為買方新增長期合約價格，以獲得預付款的折扣。假設您通常每消耗一些單位收取 $1。買家每小時使用一個單位，將支付每年 8760 美元（365 days x 24 hours x $1 perhour) 您可以啟用合約，讓買家在 365 天內每小時使用 1 個單位，以該價格的一半 ($4380)。在這種情況下，買方承諾預付一年合約，價格從每單位 1 美元下降到每單位 0.5 美元。你也可以讓買家購買多份合約。如果計量的數量顯示買方在一小時內消耗了 10 個單位，而他們有兩個合約，則 2 個單位將包含 2 個單位，而 8 個額外的單位將以每小時 1 美元計費，該小時總計為 8 美元。

針對每項工作或每個網繭範例，您也可以新增長期合約價格，讓買方獲得預付款折扣。如果您通常每個網繭收取 6 美元，您可以將長期合約期設定為 365 天，價格為 13,140 美元 (365 days x 24 hours x $3per pod per hour。之後，一份合約將授權客戶在 365 天內每小時使用 1 個網繭。客戶可選擇購買多份合約。例如，客戶可以購買兩份合約，每小時有權使用 2 個網繭。如果客戶每小時執行的網繭數量超過有權合約，則超額網繭將以您正常的小時價格計費。

在這兩種情況下，購買長期合約的買家都會預付款，無論是單次付款或定期預付款。我們也會向買家收取超出合約的額外使用量，以計量付費費率計費。

AWS Marketplace計量服務整合您可以使用AWS Marketplace計量服務，以檢查使用產品的權利，以及計量計費使用量。如果您想要定義自己的定價單位和計量，以供我們計費使用，請與MeterUsage。如果您想要根據使用的任務或網繭數量為產品定價，並讓我們自動使用量計量器，請與RegisterUsage動作。對於這兩種類型的定價，您可以新增長期合約價格，而不需要變更與AWS Marketplace計量服務。

當您建立新的容器產品時，請在AWS Marketplace管理入口網站，我們提供一組產品識別碼 (產品代碼和公開金鑰)，用來整合您的產品與AWS Marketplace計量服務。

Entitlement與整合AWS Marketplace計量服務可讓您驗證執行付費軟體的客戶已訂閱AWS Marketplace，以防止您在容器啟動時未經授權的使用。您可以呼叫MeterUsage或RegisterUsage動作，視您的定價模式而定，以驗證權益。對於每小時和固定每月定價模式，請使用RegisterUsage動作。對於自訂計量定價模型，請使用MeterUsage動作。

如果買方無權使用您的產品，其中一個 API 動作都會傳回CustomerNotEntitledException例外狀況。

Note

如果買方在執行您的產品時取消訂閱，他們有權繼續執行該產品。但是，它們無法為您的產品啟動其他容器。

整合指導方針建立及發佈容器產品，並計劃使用AWS Marketplace計量服務MeterUsage或RegisterUsage動作的權利和計量。

97


https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html

https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html


https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html

AWS Marketplace 賣方指南支援的 AWS 區域

• 請勿在您的軟體或 Docker 容器映像中設定 AWS 登入資料。當您的容器映像在 Amazon ECS 任務或Amazon EKS 網繭中執行時，會在執行階段自動取得買方的 AWS 登入資料。

• 若要呼叫MeterUsage或RegisterUsage，您必須使用支援的AWSSDK。若要測試MeterUsage或RegisterUsage整合後，您必須執行執行 Kubernetes 1.13.x 或更高版本的 AmazonEKS 叢集。網繭支援的 IAM 角色需要 Kubernetes 1.13，這是執行中網繭的相依性，以取得AWS登入資料，才能在 Amazon EKS 上呼叫這些動作。

• 你可以做本地開發，但你會得到一個PlatformNotSupportedException例外狀況。當您在 AWS 容器服務 (Amazon ECS、Amazon EKS 和 Fargate 特) 上啟動容器時，不會發生此例外狀況

支援的 AWS 區域如需所有的清單AWS Marketplace支援的 AWS 區域，請參閱區域表格在全球基礎設施(憑證已建立！) 頁面上的名稱有些許差異。

取得用於計量的 AWS 區域將您的容器與MeterUsage或RegisterUsage進行計量，請勿將 AWS 開發套件設定為使用特定 AWS區域。AWS 區域必須在執行時間動態取得。例如，如果客戶啟動了 Amazon ECS 任務或 Amazon EKS網繭，並RegisterUsage在與亞馬遜 ECS 任務或亞馬遜 EKS 網繭啟動位置不同的 AWS 區域中呼叫，RegisterUsage將拋出InvalidRegionException。

AWS 開發套件語言不會決定AWS_REGION以一致的方式。例如，AWS SDK for Java自動使用Amazon EC2執行個體中繼資料（具體來說，ec2InstanceMetadata) 以在環境變數或其他組態不存在時取得 AWS 區域。在這種情況下，只調用ec2InstanceMetadata如果AWS_REGION環境變量不存在。

如需有關如何在執行階段動態取得 AWS 區域的詳細資訊，請參閱AWS 開發套件人員指南為您的程式設計語言。

防止計量修改為買家介紹如何修改或覆寫RegisterUsage或MeterUsage可能會導致不良的帳單和付款問題。強烈建議您整合計量和權利邏輯。

在設計產品以防範計量修改時，請謹記下列事項：

• 如果買家可以插入包含 CMD 或 ENTRYPOINT 指令的新影像圖層，請直接整合RegisterUsage或MeterUsage添加到買方正在通過您的容器圖像運行的軟件中。否則即為RegisterUsage或MeterUsage通過 CMD 或入口點執行的基本映像可能會被買方覆蓋。

• 建議您管理AWS Marketplace您的軟體使用的產品代碼RegisterUsage或MeterUsage以買家無法修改的方式。不過，如果您的產品以客戶可以覆寫的方式管理產品代碼，例如AWS CloudFormation、頭盔圖表或 Kubernetes 資訊清單，您必須維護信任 AWS Marketplace產品代碼，以確保您的軟體作為輸入RegisterUsage或MeterUsage是有效的。

• 如果您信任的任何產品代碼是免費產品，請確定這些代碼無法用來取代付費產品代碼。

自訂計量AWS Marketplace容器產品可以在每個產品最多 24 個不同的定價尺寸上進行自訂計量。每個維度都可以有一個與之相關的長期合約價格。將您的容器產品與 AWS Marketplace 計量服務整合，即可啟用自訂計量。如果您想為我們的帳單定義自己的定價單位和自訂計量，請與meterUsage。

價格維度在兩個位置定義，一次是在產品載入表單中，一次是透過MeterUsageoperation. 這種雙因素方法可確保後續優惠在向公眾提供之前按預期運作。

98

https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts-minimum-sdk.html

http://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/



http://aws.amazon.com/tools


AWS Marketplace 賣方指南自訂計量

若要設定自訂計量，您必須選擇使用量類別、單位類型和定價維度：

• 使用率類別— 使用量類別可協助買家了解您的產品是什麼，以及如何使用它。• 單位類型— 單位類型定義計費的度量單位。例如，以 GBP 或 MBP 計量的頻寬、主機數目或以 MB、GB

或 TB 計量的資料。• 定價維度— 定價維度代表您已設定每單位價格的功能或服務 (例如，使用者、掃描、vCPUs 或已部署的代

理程式)。定價維度是公開的；不過，您仍然可以為公開產品定義私人和自帶授權 (BYOL) 優惠。請勿在計量記錄中傳送定價。您計量單位的數量，我們會使用該數量以及您在創建產品時定義的價格來計算買方的帳單。

如果您的產品定價不符合任何預先定義的類別或單位類型，您可以選擇一般的單位類別，並使用維度說明來描述單位是什麼。

或者，您可以根據您追蹤的屬性將使用分配到配置中。配置會以標籤形式表示給買方。這些標籤可讓買方檢視其按標籤值分割成使用量的成本。例如，如果您依使用者收費，且使用者擁有「部門」屬性，則可以使用索引鍵為「部門」的標記和每個值一個配置來建立流量配置。這不會變更您報告的價格、維度或總使用量，但可讓您的客戶依適合您產品的類別來檢視其成本。

我們建議您每小時傳送計量記錄；不過，您也可以彙總每日或每月期間的使用量。如果您遇到服務中斷，您可以彙整購買者軟體的使用情況，並在接下來的小時計量內傳送。您每小時無法傳送一筆以上的記錄。

Important

免費試用和預付權益會按小時等級進行追蹤。因此，單獨傳送這些記錄可能會導致買家被超額收費。

自訂計量必要條件在發行產品前，您必須執行以下作業：

1. 在 [建立新的容器產品]AWS Marketplace管理入口網站，並記下其產品代碼。2. 填寫產品負載表格中必要的尺寸資訊，並將其退回給我們進行處理。3. 使用AWS Identity and Access Management(IAM) 角色執行應用程式的工作或網繭 (具有呼

叫MeterUsage。IAM 受管政策AWSMarketplaceMeteringRegisterUsage具有這些權限。4. (選擇性) 如果您想要查看記錄，建議在工作或網繭定義中啟用 CloudTrail 記錄。5. 進行測試呼叫MeterUsage作業，並記錄您定義的所有定價維度。

用於自訂計量的產品負載表當填寫產品負載表以進行定制計量時，每個產品最多可有 24 個尺寸。維度定義於下列欄位：

• 維度名稱— 當您的容器應用程式將計量記錄傳送至AWS Marketplace計量服務。此名稱表示買家會使用哪個維度。此名稱會顯示在帳單報告中。設定名稱後，您即無法變更它。

• 維度說明— 維度的對方購買者說明。說明不能超過 70 個字元。產品公開發佈給買家之後，就無法變更此欄位。

• 維度比率— 當購買者隨用付款時，此產品的每單位軟體價格。這個費爾德支持三位小數。• 尺寸標註長期費率— 購買者預付款時，長期合約的軟體價格總計。• 長期持續時間 (天)— 長期合約的持續時間，以天為單位。

測試 MeterUsage 整合與預覽模式使用MeterUsage作業來測試您的整合，然後再將您的影像提交至AWS Marketplace以發佈。

99


預覽模式的運作方式與生產模式相同，但預覽模式無法驗證產品的使用權。若要呼叫MeterUsage在預覽模式中，呼叫MeterUsage通過在亞馬遜彈性容器服務（亞馬遜 ECS）或亞馬遜彈性 Kubernetes 服務（亞馬遜 EKS）上運行您的產品與AWS帳戶，您用來列出產品AWS Marketplace。您的計量整合必須動態設定AWS地區，而不是硬編碼它，但w母雞測試，在美國東部 (維吉尼亞北部) 啟動至少一個含有付費容器的Amazon ECS 任務或 Amazon EKS 網繭AWS區域，以便AWS Marketplace營運團隊可以使用該區域的記錄來驗證您的工作。

Note

如果您的產品同時支援 Amazon ECS 和 Amazon EKS，您只需要在 Amazon EKS 中啟動，我們就能驗證您的整合。

在產品發佈包含所有必要的中繼資料和定價資訊之前，您無法完整測試整合。如果要求，AWS Marketplace目錄作業團隊可以在預覽模式中確認收到計量記錄。

MeterUsage 時的錯誤處理如果您的容器映像與MeterUsage操作並接收ThrottlingException在容器啟動時，您應該終止容器以防止未經授權的使用。

以外的例外狀況ThrottlingException只會在初始調用MeterUsage。來自同一個亞馬遜 ECS 任務或亞馬遜 EKS 網繭的後續呼叫不會擲回CustomerNotSubscribedException即使客戶在工作或網繭仍在執行期間取消訂閱也一樣。這些客戶在取消訂閱並追蹤其使用情況後，仍需支付執行容器的費用。

下表說明MeterUsage可能會拋出。每個AWSSDK 程式設計語言有一組錯誤處理準則，您可以參考以取得其他資訊。

錯誤描述

DuplicateRequestException 計量記錄已經發出給定的 {使用維度，時間戳記} 具有不同 usageQuantity。

InvalidUsageDimensionException UsageDimensions 與產品相關聯的其中一個使用方式維度不相符。

TimestampOutOfBoundsException 在 MeterUsage Use 中傳遞的時間戳記值超出允許的範圍。

InternalServiceErrorException MeterUsage無法使用。

CustomerNotEntitledException 客戶沒有產品的有效訂閱。

InvalidProductCodeException 所以此ProductCode值作為請求的一部分傳入不存在。

PlatformNotSupportedException AWS Marketplace不支持基礎平台的計量使用情況。只有亞馬遜 ECS，亞馬遜 EKS 和AWS Fargate系統支援。

ThrottlingException 呼叫MeterUsage系統調節。

InvalidEndpointRegionException MeterUsage必須在相同的AWS亞馬遜 ECS 任務或亞馬遜 EKS 網繭啟動的區域。這樣可以防止容器選擇一個區域（例如withRegion(“us-east-1”))呼叫時MeterUsage。

InvalidTagException 中的 TagUsageAllocations對象必須在每個UsageAllocation，沒有在UsageAllocation物件，而且標籤的數目必須為UsageAllocation。

100


錯誤描述

InvalidUsageAllocationsException 所以此UsageAllocation物件配置不會加起來UsageQuantity值。

整合您的容器產品與AWS Marketplace使用 AWS SDK for Java 計量服務下列範例概述了使用AWS SDK for Java與整合AWS Marketplace計量服務 MeterUsageoperation. 如需完整詳細資訊，請參閱MeterUsage Java 範例 (p. 102)。無論語言為何，下列許多步驟都適用。

範例: AWS Marketplace 計量服務整合

1. 登入AWS Marketplace管理入口網站。2. 從資產中，選擇容器以開始建立新容器產品。建立產品會產生產品程式碼，以便產品與您的容器影像

整合。如需發佈的相關資訊，請參閱發佈容器產品 (p. 94)。如需有關設定AWS Identity and AccessManagement(IAM) 權限的詳細資訊，請參閱the section called “AWS Marketplace計量和權利 API 權限” (p. 261)。

3. 下載公開AWS Java 開發套件。

Important

若要從 Amazon 彈性 Kubernetes 服務 (Amazon EKS) 呼叫計量 API，您必須使用支援的AWSSDK，並在執行 Kubernetes 1.13 或更新版本的 Amazon EKubernetes 叢集上執行。

4. 呼叫MeterUsage作業從工作或網繭每小時一次，針對每個維度使用量。API 作業會接受一個計量記錄，用於Dimension、Resource，以及Hour。資源可以是 Amazon Elastic Container Service(Amazon ECS) 任務或 Amazon EKS 網繭。

{ "ProductCode" : "string", // (required) "UsageDimension" : "string", // (required) "UsageQuantity": int, // (optional) Default is 0. Acceptable value from [0, 2147483647 (INT_MAX)] "Timestamp": Date, // (required) Timestamp in UTC. Value can be one hour in the past. "UsageAllocations": List<UsageAllocation> // (optional) UsageAllocations across 1 or more tags.}

5. 重建 Docker 容器映像的新版本，其中包含MeterUsage呼叫、標記容器，並將其推送到任何與Amazon ECS 或 Amazon EKS 相容的 Docker 登錄，例如 Amazon Elastic Container Registry (AmazonECR) 或 Docker 中樞。如果您使用的是 Amazon ECR，請確保啟動 Amazon ECS 任務或 Amazon EKS網繭的帳戶具有 Amazon ECR 存放庫的權限。否則，操作會失敗。

Note

如果您使用私人 Docker Hub 儲存庫，請遵循任務的私有登錄檔身份驗證中的Amazon ElasticContainer Service 指南。

6. 建立IAM角色，授予您的容器調用MeterUsage，如下列程式碼範例所定義。您必須在任務角色參數或亞馬遜 EKS 網繭定義。

{ "Version": "2012-10-17", "Statement": [ { "Action": [

101






https://docs.aws.amazon.com/AmazonECS/latest/developerguide/private-auth.html

http://aws.amazon.com/iam/

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_role_arn


"aws-marketplace:MeterUsage" ], "Effect": "Allow", "Resource": "*" } ]}

7. 建立 Amazon ECS 任務或 Amazon EKS 網繭定義，該定義參考已與AWS Marketplace並參考您在步驟6 中建立的 IAM 角色。如果您要查看記錄，請啟用AWS CloudTrail登入任務定義。

8. 建立 Amazon ECS 或 Amazon EKS 叢集以執行您的任務或網繭。如需建立 Amazon ECS 叢集的詳細資訊，請參閱建立叢集中的Amazon Elastic Container Service 指南。如需有關建立 Amazon EKS 叢集 (使用 Kubernetes 1.1.3.x 或更新版本) 的詳細資訊，請參閱建立 Amazon EKS 叢集。

9. 設定 Amazon ECS 或 Amazon EKS 叢集，並在美國東部 1 中啟動您在步驟 8 中建立的 Amazon ECS任務定義或 Amazon EKS 網繭AWS區域。只有在這個測試過程中，在產品上線之前，你必須使用這個區域。

10. 當你得到一個有效的響應MeterUsage，您可以開始建立容器產品。如有任何問題，請聯絡AWSMarketplace賣方經營團隊。

MeterUsage Java 範例

下列程式碼範例使用AWS SDK for Java和 AWS Marketplace Metering Service 呼叫MeterUsageoperation.

下列程式碼範例會呼叫MeterUsage沒有任何UsageAllocations。

import com.amazonaws.services.marketplacemetering.AWSMarketplaceMetering;import com.amazonaws.services.marketplacemetering.AWSMarketplaceMeteringClientBuilder;import com.amazonaws.services.marketplacemetering.model.MeterUsageRequest;import com.amazonaws.services.marketplacemetering.model.MeterUsageResult;

import java.util.Date;

public class MeterUsage { private static final String PRODUCT_CODE = "......."; private final AWSMarketplaceMetering awsMarketplaceMetering;

public MeterUsage() { awsMarketplaceMetering = AWSMarketplaceMeteringClientBuilder.standard().build(); }

/** * Submits metering record for a FCP Dimension. The API accepts 1 metering record per dimension * for a given buyer's resource for a given timestamp hour. Ex. If a buyer is running 10 tasks, * the API will accepts 1 call to MeterUsage in an hour for a given dimension for each running task. * * @param dimension - FCP dimension name provided during the publishing of the product. * @param quantity - FCP dimension consumption value for the hour. * @param timestamp - Timestamp, in UTC, for which the usage is being reported. * Timestamp cant be more than 1 hour in the past. * Make sure the timestamp value is not before the start of the software usage. */ public void callMeterUsage(String dimension, int quantity, Date timestamp) { MeterUsageRequest meterUsageRequest = new MeterUsageRequest() .withProductCode(PRODUCT_CODE) .withUsageDimension(dimension) .withUsageQuantity(quantity) .withTimestamp(timestamp);

102

https://docs.aws.amazon.com/AmazonECS/latest/userguide/create_cluster.html

https://docs.aws.amazon.com/eks/latest/userguide/create_cluster.html




MeterUsageResult meterUsageResult = awsMarketplaceMetering.meterUsage(meterUsageRequest); }}

下列程式碼範例會呼叫MeterUsage的操作UsageAllocations。

private static String callMeterUsageWithAllocationsByTag(AWSMarketplaceMetering marketplaceMetering) { // Tag Keys for the product String tagKey1 = "Key1"; String tagKey2 = "Key2"; String tagKey3 = "Key3";

// 1st Usage Allocation bucket which has two Tags [{Key1, Key1Value1},{Key2, Key2Value1}] List<Tag> tagsForUsageAllocation1 = Arrays.asList(new Tag().withKey(tagKey1).withValue("Key1Value1"), new Tag().withKey(tagKey2).withValue("Key2Value1")); UsageAllocation usageAllocation1 = new UsageAllocation() .withTags(tagsForUsageAllocation1) .withAllocatedUsageQuantity(20);

// 2nd Usage Allocation bucket which has two Tags [{Key1, Key1Value2},{Key2, Key2Value1}] List<Tag> tagsForUsageAllocation2 = Arrays.asList(new Tag().withKey(tagKey1).withValue("Key1Value2"), new Tag().withKey(tagKey2).withValue("Key2Value1")); UsageAllocation usageAllocation2 = new UsageAllocation() .withTags(tagsForUsageAllocation2) .withAllocatedUsageQuantity(20);

// 3rd Usage Allocation bucket which has two Tags [{Key1, Key1Value2},{Key2, Key2Value2},{Key3, Key3Value1}] List<Tag> tagsForUsageAllocation3 = Arrays.asList(new Tag().withKey(tagKey1).withValue("Key1Value2"), new Tag().withKey(tagKey2).withValue("Key2Value2"), new Tag().withKey(tagKey3).withValue("Key3Value1")); UsageAllocation usageAllocation3 = new UsageAllocation() .withTags(tagsForUsageAllocation3) .withAllocatedUsageQuantity(15);

// 4th Usage Allocation bucket with no tags UsageAllocation usageAllocation4 = new UsageAllocation() .withAllocatedUsageQuantity(15);

List<UsageAllocation> usageAllocationList = Arrays.asList(usageAllocation1, usageAllocation2, usageAllocation3, usageAllocation4);

MeterUsageRequest meterUsageRequest = new MeterUsageRequest() .withProductCode("TestProductCode") .withUsageDimension("Dimension1") .withTimestamp(new Date()) //UsageQuantity value must matach with sum of all AllocatedUsageQuantity .withUsageQuantity(70) .withUsageAllocations(usageAllocationList);

MeterUsageResult meterUsageResult; try { meterUsageResult = marketplaceMetering.meterUsage(meterUsageRequest); } catch (Exception e) { // Log Error throw e;

103

AWS Marketplace 賣方指南每小時計量

}

return meterUsageResult.getMeteringRecordId(); }

每小時計量如果您的容器產品使用每小時工作/網繭定價，而非自訂計量付費定價維度，則不需要定義自訂計量維度。

RegisterUsage每個 Amazon Elastic Container Service (Amazon ECS) 任務或每個 Amazon ElasticKubernetes Service (Amazon EKS) 網繭每小時使用的公尺軟體，使用量按比例計算至第二個。最少使用 1分鐘適用於短暫的任務或豆莢。軟體使用的連續計量會自動由AWS Marketplace計量控制平面。您的軟體不需要執行任何計量特定動作，除非呼叫RegisterUsage一次，用於計量軟件使用開始。

所以此AWS Marketplace計量控制平面會繼續向客戶收取執行 Amazon ECS 任務和 Amazon EKS 網繭的費用，不論客戶的訂閱狀態為何，因此不需要在初次成功啟動任務或網繭後執行權利檢查。

每小時計量先決條件在發行產品前，您必須執行以下作業：

1. 在 [建立新的容器產品]AWS Marketplace管理入口網站，並記下其產品代碼。2. 填寫必要的每小時價格信息的產品加載表格，並將其退回給我們進行處理。3. 使用AWS Identity and Access Management(IAM) 角色執行應用程式的工作或網繭 (具有呼

叫RegisterUsage。IAM 受管政策AWSMarketplaceMeteringRegisterUsage具有這些權限。4. (選用) 我們建議您啟用AWS CloudTrail(CloudTrail) 記錄工作或網繭定義 (如果您想查看記錄)。5. 進行測試呼叫RegisterUsage動作，並記錄您定義的所有訂價維度。

每小時計量的產品負載表在填寫每小時計量的產品負載表單時，除了定義產品的其他必要和選擇性欄位之外，請為您的產品填寫下列欄位：

• 每小時價格這是您產品的價格，每小時。• 尺寸標註長期費率— 購買者預付款時，長期合約的軟體價格總計。• 長期持續時間 (天)— 長期合約的持續時間，以天為單位。

測試 RegisterUsage 的整合和預覽模式使用RegisterUsage動作，以測試您的整合，然後再將您的影像提交至AWS Marketplace以發佈。

預覽模式的運作方式與生產模式相同，但預覽模式無法驗證產品的使用權。若要呼叫RegisterUsage在預覽模式中，呼叫RegisterUsage，方法是在 Amazon ECS 或亞馬遜 EKS 上運行您的產品，並使用AWS帳戶，您用來列出產品AWS Marketplace。您的計量整合必須動態設定AWS地區，而不是硬編碼它，但w母雞測試，在美國東部 (維吉尼亞北部) 啟動至少一個含有付費容器的 Amazon ECS 任務或 Amazon EKS 網繭AWS區域，以便AWS Marketplace營運團隊可以使用該區域的記錄來驗證您的工作。

Note

如果您的產品同時支援 Amazon ECS 和 Amazon EKS，您只需要在 Amazon EKS 中啟動，我們就能驗證您的整合。

104


在產品發佈包含所有必要的中繼資料和定價資訊之前，您無法完整測試整合。如果要求，AWS Marketplace目錄作業團隊可以在預覽模式中確認收到計量記錄。

RegisterUsage 時的錯誤處理如果您的容器映像與AWS Marketplace計量服務，並接收除ThrottlingException在容器啟動時，您應該終止容器以防止未經授權的使用。

以外的例外狀況ThrottlingException只會在初始調用RegisterUsage。來自同一個亞馬遜 ECS 任務或亞馬遜 EKS 網繭的後續呼叫不會擲回CustomerNotSubscribedException即使客戶在工作或網繭仍在執行期間取消訂閱也一樣。這些客戶在取消訂閱並追蹤其使用情況後，仍需支付執行容器的費用。

下表說明RegisterUsage可能會拋出。每個AWSSDK 程式設計語言有一組錯誤處理準則，您可以參考以取得其他資訊。

錯誤描述

InternalServiceErrorException RegisterUsage無法使用。

CustomerNotEntitiledException 客戶沒有產品的有效訂閱。

InvalidProductCodeException 所以此ProductCode值作為請求的一部分傳入不存在。

InvalidPublicKeyException 所以此PublicKeyVersion值作為請求的一部分傳入不存在。

PlatformNotSupportedException AWS Marketplace不支持基礎平台的計量使用情況。只有亞馬遜 ECS，亞馬遜 EKS 和AWS Fargate系統支援。

ThrottlingException 呼叫RegisterUsage系統調節。

InvalidRegionException RegisterUsage必須在 Amazon ECS 任務或 Amazon EKS 網繭所在的相同 AWS 區域中呼叫。這樣可以防止容器選擇一個區域（例如withRegion(“us-east-1”)) 呼叫時RegisterUsage。

整合您的容器產品與AWS Marketplace使用 AWS SDK for Java 計量服務下列步驟概述了使用AWS SDK for Java與整合AWS Marketplace計量服務的RegisterUsage動作。如需完整來源碼，請參閱RegisterUsage Java 範例 (p. 107)。無論語言為何，其中許多步驟都適用。

的範例步驟AWS Marketplace計量服務整合

1. 登入AWS Marketplace管理入口網站。2. 從資產選擇容器以開始建立新容器產品。建立產品會產生產品程式碼，以便產品與您的容器影像整合。

如需發佈的相關資訊，請參閱發佈容器產品 (p. 94)。如需設定 IAM 許可的資訊，請參閱the sectioncalled “AWS Marketplace計量和權利 API 權限” (p. 261)。

3. 下載公開AWS Java 開發套件。Important

若要從 Amazon EKS 呼叫計量 API，您必須使用支援的AWSSDK，並在執行 Kubernetes 1.13或更新版本的 Amazon EKubernetes 叢集上執行。

105






4. （可選）如果您正在與RegisterUsage動作，且您想要執行數位簽章驗證，您需要設定BouncyCastle簽名驗證程式庫。

如果您想要使用 JSON Web Token (JWT)，您必須包含JWT 爪哇庫中的應用程序類路徑。使用 JWT提供了一個更簡單的簽名驗證方法，但不是必需的，您可以使用獨立的 BouncyCastle 來代替。無論您使用 JWT 還是 BouncyCastle，您都需要使用構建系統，如 Maven 在您的應用程序類路徑中包含BouncyCastle 或 JWT 的傳遞依賴關係。

// Required for signature verification using code sample<dependency> <groupId>org.bouncycastle</groupId> <artifactId>bcpkix-jdk15on</artifactId> <version>1.60</version></dependency>

// This one is only required for JWT<dependency> <groupId>com.nimbusds</groupId> <artifactId>nimbus-jose-jwt</artifactId> <version>6.0</version></dependency>

5. CallRegisterUsage從產品供應項目中的每個付費容器影像。ProductCode和PublicKeyVersion是必需的參數，所有其他輸入都是可選的。以下是承載範例RegisterUsage。

{ "ProductCode" : "string", // (required) "PublicKeyVersion": 1, // (required) "Nonce": "string", // (optional) to scope down the registration // to a specific running software // instance and guard against // replay attacks}

6. RegisterUsage會使用 SHA-256 產生 RSA-PSS 數位簽章，您可以使用此簽章來驗證要求的真實性。簽名包含下列欄位：ProductCode、PublicKeyVersion，以及Nonce。若要驗證數位簽章，您必須保留要求中的這些欄位。下列程式碼是回應範例RegisterUsage呼叫。

{"Signature": "<<JWT Token>>"}

// Where the JWT Token is composed of 3 dot-separated, // base-64 URL Encoded sections.// e.g. eyJhbGcVCJ9.eyJzdWIMzkwMjJ9.rrO9Qw0SXRWTe

// Section 1: Header/Algorithm{"alg": "PS256","typ": "JWT"}

// Section 2: Payload{"ProductCode" : "string","PublicKeyVersion": 1,"Nonce": "string","iat": date // JWT issued at claim }

// Section 3: RSA-PSS SHA256 signature

106

https://mvnrepository.com/artifact/org.bouncycastle/bcprov-jdk15on

https://jwt.io/


"rrO9Q4FEi3gweH3X4lrt2okf5zwIatUUwERlw016wTy_21Nv8S..."

7. 重建 Docker 容器映像的新版本，其中包含RegisterUsage呼叫、標記容器，並將其推送到任何與Amazon ECS 或 Amazon EKS 相容的 Docker 註冊表，例如 Amazon ECR 或 Docker 集線器。如果您使用的是 Amazon ECR，請確保啟動 Amazon ECS 任務或 Amazon EKS 網繭的帳戶具有 AmazonECR 存放庫的權限。否則，執行會失敗。

Note

如果您使用私人 Docker Hub 儲存庫，請遵循任務的私有登錄檔身份驗證中的Amazon ElasticContainer Service 指南。

8. 建立IAM角色，授予您的容器調用RegisterUsage，如下列程式碼中定義。您必須在任務角色參數或亞馬遜 EKS 網繭定義。

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "aws-marketplace:RegisterUsage" ], "Effect": "Allow", "Resource": "*" } ]}

9. 建立 Amazon ECS 任務或 Amazon EKS 網繭定義，該定義參考已與AWS Marketplace並參考您在步驟7 建立的 IAM 角色。您應該啟用AWS CloudTrail登錄任務定義中，如果您想查看日誌記錄。

10. 建立 Amazon ECS 或 Amazon EKS 叢集以執行您的任務或網繭。如需建立 Amazon ECS 叢集的詳細資訊，請參閱建立叢集中的Amazon Elastic Container Service 指南。如需有關建立 Amazon EKS 叢集 (使用 Kubernetes 1.1.3.x 或更新版本) 的詳細資訊，請參閱建立 Amazon EKS 叢集。

11. 設定 Amazon ECS 或 Amazon EKS 叢集，並在美國東部 1 的 AWS 區域啟動您建立的 Amazon ECS 任務定義或 Amazon EKS 網繭。只有在這個測試過程中，在產品上線之前，你必須使用這個區域。

12. 當你得到一個有效的響應從RegisterUsage，您就可以開始建立容器產品。如有任何問題，請聯絡AWS Marketplace賣方經營團隊。

RegisterUsage Java 範例下列範例使用AWS SDK for Java和AWS Marketplace計量服務來呼叫RegisterUsageoperation. 簽名驗證是選擇性的，但如果您要執行簽名驗證，則必須包含必要的數位簽名驗證程式庫。此範例僅供說明之用。

import com.amazonaws.auth.PEM;import com.amazonaws.services.marketplacemetering.AWSMarketplaceMetering;import com.amazonaws.services.marketplacemetering.AWSMarketplaceMeteringClientBuilder;import com.amazonaws.services.marketplacemetering.model.RegisterUsageRequest;import com.amazonaws.services.marketplacemetering.model.RegisterUsageResult;import com.amazonaws.util.json.Jackson;import com.fasterxml.jackson.databind.JsonNode;import com.nimbusds.jose.JWSObject;import com.nimbusds.jose.JWSVerifier;import com.nimbusds.jose.crypto.RSASSAVerifier;import java.io.ByteArrayInputStream;import java.nio.charset.StandardCharsets;import java.security.PublicKey;import java.security.Security;import java.security.Signature;import java.security.interfaces.RSAPublicKey;import java.util.Base64;import java.util.Optional;

107

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/private-auth.html

http://aws.amazon.com/iam/

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#task_role_arn

https://docs.aws.amazon.com/AmazonECS/latest/userguide/create_cluster.html

https://docs.aws.amazon.com/eks/latest/userguide/create_cluster.html



import java.util.UUID;import org.bouncycastle.jce.provider.BouncyCastleProvider;

/** * Class for making calls out to AWS Marketplace Metering Service. */class RegisterUsage {

private static final String PRODUCT_CODE = ".......";

private final AWSMarketplaceMetering registerUsageClient; private final SignatureVerifier signatureVerifier; private final int publicKeyVersion;

public RegisterUsage(final SignatureVerifier signatureVerifier) { this.signatureVerifier = signatureVerifier; this.publicKeyVersion = PublicKeyProvider.PUBLIC_KEY_VERSION; this.registerUsageClient = AWSMarketplaceMeteringClientBuilder.standard().build(); }

/** * Shows how to call RegisterUsage client and verify digital signature. */ public void callRegisterUsage() { RegisterUsageRequest request = new RegisterUsageRequest() .withProductCode(PRODUCT_CODE) .withPublicKeyVersion(publicKeyVersion) .withNonce(UUID.randomUUID().toString());

// Execute call to RegisterUsage (only need to call once at container startup) RegisterUsageResult result = this.registerUsageClient.registerUsage(request);

// Verify Digital Signature w/o JWT boolean isSignatureValid = this.signatureVerifier.verify(request, result); if (!isSignatureValid) { throw new RuntimeException("Revoke entitlement, digital signature invalid."); } }}

/** * Signature verification class with both a JWT-library based verification * and a non-library based implementation. */class SignatureVerifier { private static BouncyCastleProvider BC = new BouncyCastleProvider();

private static final String SIGNATURE_ALGORITHM = "SHA256withRSA/PSS";

private final PublicKey publicKey;

public SignatureVerifier(PublicKeyProvider publicKeyProvider) { this.publicKey = publicKeyProvider.getPublicKey().orElse(null); Security.addProvider(BC); }

/** * Example signature verification using the NimbusJOSEJWT library to verify the JWT Token. * * @param request RegisterUsage Request. * @param result RegisterUsage Result. * @return true if the token matches. */ public boolean verifyUsingNimbusJOSEJWT(final RegisterUsageRequest request, final RegisterUsageResult result) {

108


if (!getPublicKey().isPresent()) { return false; }

try { JWSVerifier verifier = new RSASSAVerifier((RSAPublicKey) getPublicKey().get()); JWSObject jwsObject = JWSObject.parse(result.getSignature()); return jwsObject.verify(verifier) && validatePayload(jwsObject.getPayload().toString(), request, result); } catch (Exception e) { // log error return false; } }

/** * Example signature verification without any JWT library support. * * @param request RegisterUsage Request. * @param result RegisterUsage Result. * @return true if the token matches. */ public boolean verify(final RegisterUsageRequest request, final RegisterUsageResult result) { if (!getPublicKey().isPresent()) { return false; } try { String[] jwtParts = result.getSignature().split("\\."); String header = jwtParts[0]; String payload = jwtParts[1]; String payloadSignature = jwtParts[2];

Signature signature = Signature.getInstance(SIGNATURE_ALGORITHM, BC); signature.initVerify(getPublicKey().get()); signature.update(String.format("%s.%s", header, payload).getBytes(StandardCharsets.UTF_8)); boolean verified = signature.verify(Base64.getUrlDecoder() .decode(payloadSignature.getBytes(StandardCharsets.UTF_8)));

String decodedPayload = new String(Base64.getUrlDecoder().decode(payload)); return verified && validatePayload(decodedPayload, request, result); } catch (Exception e) { // log error return false; } }

/** * Validate each value in the returned payload matches values originally * supplied in the request to RegisterUsage. TimeToLiveInMillis and * PublicKeyExpirationTimestamp will have the values in the payload compared * to values in the signature */ private boolean validatePayload(final String payload, final RegisterUsageRequest request, final RegisterUsageResult result) { try { JsonNode payloadJson = Jackson.getObjectMapper().readTree(payload); boolean matches = payloadJson.get("productCode") .asText() .equals(request.getProductCode()); matches = matches && payloadJson.get("nonce") .asText() .equals(request.getNonce()); return matches = matches && payloadJson.get("publicKeyVersion")

109


.asText() .equals(String.valueOf(request.getPublicKeyVersion()));

} catch (Exception ex) { // log error return false; } }

private Optional<PublicKey> getPublicKey() { return Optional.ofNullable(this.publicKey); }}

/** * Public key provider taking advantage of the AWS PEM Utility. */class PublicKeyProvider { // Replace with your public key. Ensure there are new-lines ("\n") in the // string after "-----BEGIN PUBLIC KEY-----\n" and before "\n-----END PUBLIC KEY-----". private static final String PUBLIC_KEY = "-----BEGIN PUBLIC KEY-----\n" + "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDdlatRjRjogo3WojgGHFHYLugd\n" + "UWAY9iR3fy4arWNA1KoS8kVw33cJibXr8bvwUAUparCwlvdbH6dvEOfou0/gCFQs\n" + "HUfQrSDv+MuSUMAe8jzKE4qW+jK+xQU9a03GUnKHkkle+Q0pX/g6jXZ7r1/xAK5D\n" + "o2kQ+X5xK9cipRgEKwIDAQAB\n" + "-----END PUBLIC KEY-----";

public static final int PUBLIC_KEY_VERSION = 1;

public Optional<PublicKey> getPublicKey() { try { return Optional.of(PEM.readPublicKey(new ByteArrayInputStream( PUBLIC_KEY.getBytes(StandardCharsets.UTF_8)))); } catch (Exception e) { // log error return Optional.empty(); } }}

110

AWS Marketplace 賣方指南開始使用機器學習產品

機器學習產品作為賣家，您可以使用AWS Marketplace，以建立機器學習 (ML) 演算法和模型，讓您的買方可以在AWS。Amazon SageMaker 產品中列出兩個類型。AWS Marketplace：

模型套件

預先訓練的模型，用於進行預測，不需要由買方進一步的培訓。演算法

需要買方在進行預測之前提供訓練資料的模型。包括訓練演算法。

這些產品可以通過亞馬遜 SagMaker 控制台或AWS Marketplace。買家可以檢閱產品說明、說明文件、客戶評論、價格和支援資訊。當他們訂閱模型包裝產品或演算法產品時，它會新增至 SageMaker 主控台上的產品清單。買方也可以使用AWS軟體開發套件，AWS Command Line Interface(AWS CLI）或 SageMaker 控制台創建一個完全受管理的 REST 推斷端點或對批次數據執行推斷。

如需使用 Amazon SageMaker 建立機器學習產品的支援，請聯絡AWS Marketplace賣方操作。

開始使用機器學習產品AWS Marketplace支持兩種機器學習產品類型，使用 Amazon SageMaker。這兩種類型，模型包裝產品和演算法產品，都會產生用於進行預測的可部署推斷模型。

模 SageMaker 套件一個Amazon SageMaker 模型套件產品包含預先訓練的模型。預先訓練的模型可以在 SageMaker 中部署，以即時或批次進行推論或預測。本產品含有訓練有素的推斷元件，且具有模型假影 (如果有的話)。作為賣家，您可以使用 SageMaker 訓練模型或自備模型。

SageMaker 演算法買方可以使用SageMaker 演算法產品來執行完整的機器學習工作負載。算法產品有兩個邏輯元件：訓練和推論。在 SageMaker 中，買方使用自己的資料集，以您的訓練元件建立訓練工作。當訓練元件中的演算法完成時，它會產生機器學習模型的模型成品。SageMaker imple Storage Service (Amazon S3) 儲存貯體中儲存貯體中。然後在 SageMaker 中，買方可以部署您的推斷組件以及那些生成的模型成品，以實時或批量執行推斷（或預測）。

部署推論模型無論是從模型套件或演算法建立推斷模型，都有兩種方法可以部署它們：

• 端點— 這個方法會使用 SageMaker 來部署模型並建立 API 端點。買方可以使用這個端點做為後端服務的一部分，為他們的應用程式提供支援。當數據被發送到端點時，SageMaker 將其傳遞給模型容器，並在API 響應中返回結果。端點和容器會繼續執行，直到買方停止為止。

Note

InAWS Marketplace，端點方法稱為即時推論，並且在 SageMaker 文檔中，它被稱為託管服務。如需詳細資訊，請參閱「」Amazon Sage Maker 中的模型。

• Batch 轉換任務-在這種方法中，買方將數據集存儲在 Amazon S3 推斷。當批次轉換工作啟動時，SSageMaker 會部署模型，將資料從 S3 儲存貯體傳遞至模型的容器，然後將結果傳回至 S3 儲存貯

111


https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-marketplace.html#sagemaker-mkt-model-package

https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-marketplace.html#sagemaker-mkt-algorithm

https://docs.aws.amazon.com/sagemaker/latest/dg/how-it-works-deployment.html

AWS Marketplace 賣方指南安全和智慧財產權

體。任務完成時 SageMaker 將停止任務。如需詳細資訊，請參閱「」使用批次轉換取得整個資料集的推論。

Note

這兩種方法對模型都是透明的，因為 SageMaker 將數據傳遞給模型並將結果傳回給買方。

安全和智慧財產權Amazon SageMaker 保護您的智慧財產權和買方資料，以取得的模型和演算法AWS Marketplace。

保護智慧財產當您建立產品時，程式碼會封裝在 Docker 容器映像中。如需詳細資訊，請參閱「」準備您 SageMaker 產品 (p. 114)，本主題後述的「」。上傳容器映像時，影像和成品在傳輸和靜止狀態下全部經過加密。在發佈之前，也會先掃描影像是否有弱點。

為了保護您的知識產權，SageMaker 只允許買家透過AWS服務端點。購買者無法直接存取或提取容器映像或模型成品，也無法存取基礎架構。

無網路存取與買方創建的 SageMaker 模型和演算法不同，當買方從AWS Marketplace，模型和演算法在沒有網絡訪問的情況下部署。SageMaker 會在無法存取網路的環境中部署影像，或AWS服務端點。例如，容器映像無法對互聯網上的服務進行輸出 API 調用，VPC 端點，或任何其他AWS服務。

客戶資料的安全性您的產品在買家的AWS帳戶。因此，當買方使用您的產品來執行數據推斷，你作為賣方不能訪問他們的數據。

對於演算法產品，每次訓練工作後，您的訓練影像會輸出模型成品。模型人工因素儲存在購買者的帳戶中。當買方使用您的推論影像部署模型時，會使用訓練工作中的模型人工因素。若要保護模型成品中可能包含的任何智慧財產，請在輸出之前加密它們。

Important

此安全性模型可防止您的程式碼在執行階段存取網際網路。因此，您的代碼不能使用互聯網上的資源或庫，因此將依賴關係打包在 Docker 容器映像中。如果您選擇從訓練工作中加密輸出的成品，這一點尤其重要。無法在運行時通過互聯網訪問加密和解密成品的密鑰。它們必須與您的影像一起封裝。

如需詳細資訊，請參閱「」Amazon SageMaker 的安全。

為 Machine Learning 產品定價您可以從幾種可用的定價模式中選擇您的 Amazon SageMaker 產品。訂閱您產品的買家在自己的SageMaker 中執行AWS帳戶。購買者的價格是基礎結構成本的組合，其AWS帳戶和您設定的產品定價。

基礎設施定價使用您的產品時，買家必須負責 SageMaker 的所有基礎設施成本。這些費用是由AWS，並可在AmazonSageMaker 定價(憑證已建立！) 頁面上的名稱有些許差異。

112

https://docs.aws.amazon.com/sagemaker/latest/dg/how-it-works-batch.html

https://docs.aws.amazon.com/sagemaker/latest/dg/how-it-works-batch.html

https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints.html

https://docs.aws.amazon.com/sagemaker/latest/dg/security.html

http://aws.amazon.com/sagemaker/pricing/

http://aws.amazon.com/sagemaker/pricing/

AWS Marketplace 賣方指南軟體定價

軟體定價您可以決定AWS Marketplace向買家收取使用您的產品的費用。您可以在將機器學習產品新增至AWSMarketplace。

每個執行個體類型的所有基礎架構和軟體價格都會在AWS Marketplace之前，買方訂閱。

免費定價您可以選擇免費提供您的產品。在這種情況下，買方只支付基礎設施成本。

每小時價格您可以為您的產品提供每小時在 SageMaker 中運行的軟件實例每小時的價格。您可以針對執行軟體的每個執行個體類型收取不同的小時價格。當買方執行您的軟體時，AWS Marketplace跟踪使用情況，然後相應地向買方收取費用。使用量按比例分鐘計算。

適用於模型套件產品，買方可以使用兩種不同的方式執行您的軟體。他們可以持續託管端點，以執行即時推斷或在資料集上執行批次轉換工作。您可以針對買方執行軟體的方式，設定不同的價格。

適用於Alm產品，除了確定執行推斷的價格之外，如前所述，您還會決定訓練工作的每小時價格。您可以針對訓練影像支援的每個執行個體類型，收取不同的小時價格。

推論定價當買方透過託管端點來執行您的軟體以持續執行即時推論時，您可以選擇設定每個推論的價格。

Note

Batch 轉換處理一律使用每小時定價。演算法產品的訓練工作也一律使用每小時定價。您可以設定這些價格獨立於推論定價，以及彼此之間。

默認情況下，推斷定價，AWS Marketplace每次調用端點時，會向買家收取費用。不過，在某些情況下，您的軟體會在單一呼叫中處理批次推論 (也稱為微批次。對於端點部署，您可以指出AWS Marketplace應該收取買方的單次調用。若要執行這項操作，請在呼叫的 HTTP 回應標頭中包含自訂計量標頭，如下列範例所示。

X-Amzn-Inference-Metering: {"Dimension": "inference.count", "ConsumedUnits": 3}

此範例顯示針對三個推論向買方收取費用的呼叫。Note

如需推斷定價，AWS Marketplace只會向買方收取 HTTP 響應代碼為2XX。

免費試用您也可以選擇為您的產品建立免費試用，並定義免費試用的天數 (免費試用可能為 5 至 120 天)。在免費試用期間，買家可以隨心所欲地執行您的軟體，而且不需要為您的軟體付費。在免費試用期間，買家需支付基礎設施費用。試用期結束後，他們會向您的正常軟體價格以及基礎結構成本收取費用。

Note

您只能為每小時收費的優惠建立免費試用版。您無法為具有推斷價格的產品建立免費試用版。

當買家透過免費試用版訂閱產品時，他們會收到歡迎使用電子郵件訊息，其中包括免費試用期限、計算到期日，以及取消訂閱的詳細資料。提醒電子郵件訊息會在過期日期的前三天傳送。

如果您提供產品的免費試用版AWS Marketplace，即表示您同意特定退款政策免費試用。

113

https://docs.aws.amazon.com/marketplace/latest/userguide/refunds.html#refund-policy

AWS Marketplace 賣方指南準備您 SageMaker 產品

私人優惠您可以為機器學習產品建立私人優惠。私人講價會為特定買家提供與你公開顯示價格不同的價格。

私人方案可以使用兩種方式的其中一種來執行

• 每小時— 私人優惠的每小時費率可能與公開顯示的每小時費率不同。• 合約— 私人優惠可以是在指定天數內收取固定預付費用的合約。買方允許在合約的整個期間內使用無限數

量的執行個體。在合約結束時，如果有執行個體繼續執行，這些執行個體將按您在私人優惠中設定的小時費率計費。例如，您可以建立固定預付費用的合約，無限制使用 365 天。您也可以設定私人方案的每小時費率。當買家接受此私人講價時，他們就會支付該筆預付費用。合約結束時，任何仍在執行中的執行個體都會以該小時費率計費。

您與買方在私人優惠中之間的條款和協議，可能與公開優惠或其他私人優惠中的條款和協議有所不同。

您可以建立多個私人優惠，並將其延伸至單一買家。您擴展私人報價的買家可以選擇私人報價和公開報價之間的選擇。買方在任何時間只能訂閱一個方案。他們不能同時訂閱私人優惠和公開優惠。

若要為特定買家建立私人優惠的 SageMaker 產品，請聯絡AWS Marketplace賣方操作。

Note

如需私人方案限制的詳細資訊，請參閱私有優惠 (p. 38)。

準備您 SageMaker 產品在發佈您的產品之前AWS Marketplace, 您必須在 Amazon SageMaker 中準備它。準備您的產品有三個步驟：

1. 將您的程式碼封裝成影像 (p. 114)— 若要準備模型套件或演算法產品，您必須為產品建立 Docker 容器映像。

2. 上傳影像 (p. 127)— 將程式碼封裝在容器映像中並在本機進行測試之後，請上傳映像並掃描它們是否有已知的弱點。在繼續之前修復任何弱點。

3. 創建您 Amazon SageMaker (p. 128)— 成功掃描影像之後，可以使用這些影像在 SageMaker 中建立模型套件或演算法資源。

將您的程式碼封裝成影像機器學習產品AWS Marketplace使用 Amazon SageMaker 建立和執行您為買家提供的機器學習邏輯。SageMaker 運行包含您的邏輯的 Docker 容器映像。SageMaker 會在安全且可擴充的基礎架構中執行這些容器。如需更多詳細資訊，請參閱安全和智慧財產權 (p. 112)。

主題• 我要建立哪種類型的容器映像？ (p. 114)• 模型套件映像 (p. 115)• 演算法影像 (p. 119)

我要建立哪種類型的容器映像？兩種類型的容器影像是推斷影像和訓練影像。

若要建立模型套件產品，您只需要一個推論影像。如需詳細說明，請參閱模型套件映像 (p. 115)。

114


AWS Marketplace 賣方指南將您的程式碼封裝成影像

要創建一個算法產品，你需要培訓和推斷圖像。如需詳細說明，請參閱演算法影像 (p. 119)。

若要將程式碼正確封裝到容器影像中，容器必須遵守 SSageMaker 檔案結構。容器必須公開正確的端點，以確保服務可以將數據傳遞到您的容器和從您的容器。以下章節說明此程序的詳細資訊。

Important

為了安全起見，當買方訂閱您的容器化產品時，Docker 容器即會在隔離環境中執行，而不需要網際網路連線。當您建立容器時，請不要倚賴透過網際網路傳出呼叫，因為傳出呼叫將失敗。呼叫AWS服務也將失敗。如需詳細資訊，請參閱安全和智慧財產權 (p. 112) 節。

或者，在創建推斷和培訓圖像時，使用可用的 Deep Learning Containers er 影像做為起點。這些圖像已經與不同的機器學習框架正確打包。

模型套件映像SSageMaker 模型包是一個預先訓練的模型，使預測，不需要由買方進一步的培訓。

模型套件包含下列元件：

• 推斷圖像存儲在Amazon Elastic Container Registry(Amazon ECR)• (選擇性) 模型人工因素，分別儲存在Amazon S3

Note

模型成品是模型用來進行預測的檔案，通常是您自己的訓練流程的結果。工件可以是您的模型所需的任何文件類型，但必須 use.tar.gz 壓縮。對於模型套件，它們可以捆綁在您的推斷映像中，也可以單獨存放在 Amazon S3 中。儲存在 Amazon S3 中的模型成品會在執行階段載入推論容器中。發佈模型套件時，這些成品會發佈並儲存在AWS Marketplace擁有的 Amazon S3 儲存貯體，買方無法直接存取。

以下是採購員如何使用模型套件及其元件的概述：

1. 購買者訂閱模型套件並部署模型。SageMaker 運行推斷圖像。任何未捆綁在推斷圖像中的賣家提供的模型成品都會在運行時動態加載。

2. SageMaker 通過容器的 HTTP 端點將買方的推斷數據傳遞給容器，並返回預測結果。

Note

您的模型可以部署為單一推論的端點或批次工作，以便一次取得整個資料集的預測。如需詳細資訊，請參閱「」部署模型推論。

為模型套件建立推論影像本節提供逐步解說，用於將您的推論代碼封裝成您的模型封裝產品的推論影像。

推斷圖像是包含您的推斷邏輯的 Docker 圖像。在運行時的容器公開 HTTP 端點，以允許 SageMaker 將數據傳遞到容器和從容器傳遞數據。

Note

以下只是推斷影像的封裝程式碼範例。如需詳細資訊，請參閱「」使用泊塢 SageMaker 容器與AWS MarketplaceSageMaker 範例(在 GitHub 上)。下列範例會使用 Web 服務Flask，為了簡單起見，並且不被認為是生產準備就緒的。

步驟 1：建立容器映像

為了使推斷圖像與 SageMaker 兼容，Docker 圖像必須公開 HTTP 端點。當您的容器運行時，SageMaker將買方輸入傳遞給容器的 HTTP 端點進行推斷。推斷結果會在 HTTP 回應的主體中傳回。

115

http://aws.amazon.com/releasenotes/available-deep-learning-containers-images/

http://aws.amazon.com/ecr/

http://aws.amazon.com/s3/

https://docs.aws.amazon.com/sagemaker/latest/dg/deploy-model.html

https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms.html

https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms.html

https://github.com/aws/amazon-sagemaker-examples/tree/master/aws_marketplace

https://pypi.org/project/Flask/


下列逐步解說會在使用 Linux Ubuntu 發行版的開發環境中使用 Docker CLI。

• 建立 Web 伺服器指令碼 (p. 116)• 建立容器執行的指令碼 (p. 117)• 建立 Dockerfile (p. 117)• 封裝或上傳模型人工因素 (p. 117)

建立 Web 伺服器指令碼

這個例子使用一個名為Flask，但您可以使用任何適用於您的框架的 Web 服務器。

Note

Flask在這裡用於簡單。它不被視為生產就緒的 Web 伺服器。

創建一個瓶 Web 服務器腳本，該腳本服務於 TCP 端口 8080 上的兩個 HTTP 端點，SageMaker 使用。以下是兩個預期的端點：

• /ping-SageMaker 向此端點發出 HTTP GET 請求，以檢查您的容器是否準備就緒。當您的容器準備就緒時，它會使用 HTTP 200 響應代碼響應此端點的 HTTP GET 請求。

• /叫-SageMaker 將 HTTP POST 請求發送到此端點進行推斷。用於推理的輸入資料在請求內文中傳送。使用者指定的內容類型會在 HTTP 標頭中傳遞。回應本文為推斷輸出。如需逾時的詳細資訊，請參閱建立機器學習產品的需求和最佳做法 (p. 135)。

。 /web_app_serve.py

# Import modulesimport jsonimport refrom flask import Flaskfrom flask import requestapp = Flask(__name__)

# Create a path for health [email protected]("/ping")def endpoint_ping(): return "" # Create a path for [email protected]("/invocations", methods=["POST"])def endpoint_invocations(): # Read the input input_str = request.get_data().decode("utf8") # Add your inference code between these comments. # # # # # # Add your inference code above this comment. # Return a response with a prediction response = {"prediction":"a","text":input_str} return json.dumps(response)

在上一個範例中，沒有實際的推理邏輯。對於您的實際推斷圖像，將推斷邏輯添加到 Web 應用程序中，以便處理輸入並返回實際的預測。

116




您的推斷圖像必須包含所有必要的依賴關係，因為它不能訪問互聯網，也不能調用任何AWS服務。。

Note

此相同的代碼被稱為即時和批次推論

建立容器執行的指令碼

建立命名為serve當它運行 Docker 容器映像時運行。下列指令碼會啟動 HTTP 網頁伺服器。

。 /服務

#!/bin/bash

# Run flask server on port 8080 for SageMakerflask run --host 0.0.0.0 --port 8080

建立 Dockerfile

建立Dockerfile在您的構建上下文中。這個例子使用 Ubuntu 18.04，但你可以從任何適用於你的框架的基本映像開始。

./Dockerfile

FROM ubuntu:18.04

# Specify encodingENV LC_ALL=C.UTF-8ENV LANG=C.UTF-8

# Install python-pipRUN apt-get update \&& apt-get install -y python3.6 python3-pip \&& ln -s /usr/bin/python3.6 /usr/bin/python \&& ln -s /usr/bin/pip3 /usr/bin/pip;

# Install flask serverRUN pip install -U Flask;

# Add a web server script to the image# Set an environment to tell flask the script to runCOPY /web_app_serve.py /web_app_serve.pyENV FLASK_APP=/web_app_serve.py

# Add a script that Amazon SageMaker will run# Set run permissions# Prepend program directory to $PATHCOPY /serve /opt/program/serveRUN chmod 755 /opt/program/serveENV PATH=/opt/program:${PATH}

所以此Dockerfile會將先前建立的兩個指令碼新增至影像。的目錄serve腳本被添加到 PATH 中，以便它可以在容器運行時運行。

封裝或上傳模型人工因素

從訓練模型到推斷影像提供模型假影的兩種方式如下：

• 以推斷影像靜態方式封裝。• 在執行階段動態載入。因為它是動態載入的，所以您可以使用相同的影像來封裝不同的機器學習模型。

117


如果您想使用推斷圖像打包模型工件，請將工件包含在Dockerfile。

如果您想要動態載入模型成品，請將這些成品分別存放在 Amazon S3 中的壓縮檔 (.tar.gz) 中。建立模型套件時，請指定壓縮檔案的位置，SageMaker 將內容擷取並複製到容器目錄/opt/ml/model/運行你的容器時。發佈模型套件時，這些成品也會發佈並儲存在AWS Marketplace擁有的 Amazon S3 儲存貯體由買方直接無法存取。

步驟 2：在本機建置和測試影像

在構建上下文中，現在存在以下文件：

• ./Dockerfile

• ./web_app_serve.py

• ./serve

• 您的推斷邏輯和（可選）依賴關係

接下來構建，運行和測試容器映像。

建立影像

在構建上下文中運行 Docker 命令來構建和標記映像。這個例子使用標籤my-inference-image。

sudo docker build --tag my-inference-image ./

運行此 Docker 命令來構建映像後，您應該看到輸出，因為 Docker 根據Dockerfile。完成後，您應該會看到類似下列的內容。

Successfully built abcdef123456Successfully tagged my-inference-image:latest

在本機執行

構建完成後，您可以在本地測試映像。

sudo docker run \ --rm \ --publish 8080:8080/tcp \ --detach \ --name my-inference-container \ my-inference-image \ serve

以下是命令的詳細資訊：

• --rm：在容器停止後自動移除容器。• --publish 8080:8080/tcp：公開連接埠 8080，以模擬 SSageMaker 傳送 HTTP 要求的連接埠。• --detach：在背景執行容器。• --name my-inference-container：給這個正在運行的容器一個名稱。• my-inference-image：執行建置的映像。• Serve：執行 SSageMaker 在執行容器時執行相同的指令碼。

運行此命令後，Docker 從您構建的推斷映像創建一個容器，並在後台運行它。容器會執行serve腳本，它會啟動您的 Web 服務器進行測試。

118


測試 ping HTTP 端點

當 SageMaker 運行您的容器時，它會定期地 ping 端點。當端點返回狀態碼 200 的 HTTP 響應時，它向SageMaker 出信號，該容器已準備好進行推斷。您可以通過運行以下命令來測試它，該命令測試端點並包含響應標頭。

curl --include http://127.0.0.1:8080/ping

範例輸出如下。

HTTP/1.0 200 OKContent-Type: text/html; charset=utf-8Content-Length: 0Server: MyServer/0.16.0 Python/3.6.8Date: Mon, 21 Oct 2019 06:58:54 GMT

測試推論 HTTP 端點

當容器通過將 200 狀態碼返回到您的 ping 來表示它已準備就緒時，SageMaker 會將推斷數據傳遞給/叫HTTP 端點POST請求。透過執行以下命令來測試推理點。

curl \ --request POST \ --data "hello world" \ http://127.0.0.1:8080/invocations

範例輸出如下。

{"prediction": "a", "text": "hello world"}

隨著這兩個 HTTP 端點的工作，推斷圖像現在與 SageMaker 兼容。Note

模型封裝產品的模型可以透過兩種方式進行部署：即時和批次處理。在這兩個部署中，SageMaker會在執行 Docker 容器時使用相同的 HTTP 端點。

若要停用容器，請執行下列命令。

sudo docker container stop my-inference-container

當您的推論影像已準備好並經過測試時，您可以繼續上傳影像 (p. 127)。

演算法影像SSageMaker 算法要求買方在進行預測之前把自己的數據進行訓練。

演算法包含下列元件：

• 訓練影像儲存在Amazon ECR• 存儲在亞馬遜 ECR 中的推斷圖像

Note

對於演算法產品，訓練容器會產生模型成品，這些成品會載入到模型部署上的推論容器中。

以下概述購買者如何使用演算法及其元件：

119



1. 買方使用相容的資料集和適當的超參數值建立訓練工作。Amazon SageMaker 會執行訓練影像，並將訓練資料和超參數載入訓練容器。訓練工作完成後，位於/選擇/毫升/型號/被壓縮並複製到買方的Amazon S3儲存貯體

2. 買方會建立模型套件，其中包含儲存在 Amazon S3 中的訓練中的模型成品，並部署該模型。SageMaker運行推斷圖像，提取壓縮的模型成品，並將文件加載到推斷容器目錄路徑/選擇/毫升/型號/，它被提供推斷的代碼消耗。

3. 無論模型部署為端點或批次轉換工作，SageMaker 都會透過容器的 HTTP 端點，代表買方將資料傳遞給容器以進行推斷，並傳回預測結果。

Note

如需詳細資訊，請參閱「」訓練模型。

建立演算法的訓練影像本節提供將訓練程式碼封裝成訓練影像的逐步解說。建立演算法產品需要訓練影像。

訓練圖像是包含您的訓練算法的 Docker 圖像。該容器遵循特定的文件結構，以允許 SageMaker 將數據複製到容器中或從容器中複製數據。

發佈演算法產品時，都需要訓練和推斷圖像。建立訓練影像後，您必須建立推論影像。這兩個影像可以合併成一個影像，也可以保持為單獨的影像。是否合併圖像或分開它們取決於你。通常，推論比訓練簡單，您可能需要單獨的影像來協助推論效能。

Note

以下只是訓練影像的封裝程式碼範例。如需詳細資訊，請參閱「」使用您自己的演算法和模型搭配AWS Marketplace與AWS MarketplaceSageMaker 範例(在 GitHub 上)。

步驟 1：建立容器映像

若要讓訓練影像與 Amazon SageMaker 相容，它必須遵守特定的檔案結構，才能讓 SagMaker 將訓練資料和組態輸入複製到容器中的特定路徑。訓練完成後，產生的模型人工因素會儲存在 SageMaker 複製來源的容器中的特定目錄路徑中。

以下使用在 Linux 的 Ubuntu 發行版上安裝在開發環境中的碼頭 CLI。

• 準備程式以讀取組態輸入 (p. 120)• 準備程式以讀取資料輸入 (p. 121)• 準備您的程式撰寫訓練成果 (p. 121)• 建立容器執行的指令碼 (p. 121)• 建立 Dockerfile (p. 121)

準備程式以讀取組態輸入

如果您的訓練計劃需要任何購買者提供的配置輸入，則以下是運行時將它們複製到容器內的位置。如果需要，您的程序必須從這些特定的文件路徑中讀取。

• /opt/ml/input/config是包含控制程序運行方式的信息的目錄。• hyperparameters.json是超參數名稱和值的 JSON 格式字典。這些值是字符串，所以你可能需要轉

換它們。• resourceConfig.json是 JSON 格式的檔案，描述用於分散式訓練。如果您的訓練影像不支援分散

式訓練，您可以忽略此檔案。

Note

如需組態輸入的詳細資訊，請參閱Amazon SageMaker 如何提供訓練資訊。

120


https://docs.aws.amazon.com/sagemaker/latest/dg/train-model.html

https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms-marketplace.html



https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms-training-algo-running-container.html#your-algorithms-training-algo-running-container-dist-training

https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms-training-algo-running-container.html


準備程式以讀取資料輸入

訓練資料可以透過下列兩種模式之一傳送至容器。您在容器中執行的訓練程式會在這兩種模式之一中摘要訓練資料。

檔案模式

• /opt/ml/input/data/<channel_name>/包含該通道的輸入資料。這些通道是根據對CreateTrainingJob操作，但通道匹配算法期望的內容通常很重要。每個頻道的檔案都會從AmazonS3新增至此目錄，以保留 Amazon S3 金鑰結構所指示的樹狀結構。

管道模式

• /opt/ml/input/data/<channel_name>_<epoch_number>是給定時代的管道。時代從零開始，每次你讀它們時都會上升一個。您可以運行的時代數量沒有限制，但在閱讀下一個時代之前，您必須關閉每個管道。

準備您的程式撰寫訓練成果

訓練的輸出會寫入下列容器目錄：

• /opt/ml/model/是您編寫模型或訓練算法生成的模型工件的目錄。您的模型可以是您想要的任何格式。它可以是單個文件或整個目錄樹。SageMaker 將此目錄中的任何檔案封裝成壓縮檔 (.tar.gz)。此檔案已可在DescribeTrainingJoboperation.

• /opt/ml/output/是一個算法可以在其中編寫failure檔案，描述任務失敗的原因。此檔案的內容會傳回FailureReason的欄位DescribeTrainingJob結果。對於成功的工作，沒有理由寫入這個文件，因為它被忽略。


建立trainshell 腳本，SageMaker 它運行 Docker 容器映像時運行。當訓練完成並將模型成品寫入各自的目錄時，請結束指令碼。

./train

#!/bin/bash

# Run your training program here####

建立 Dockerfile

建立Dockerfile在您的構建上下文中。這個例子使用 Ubuntu 18.04 作為基本圖像，但您可以從任何適用於您的框架的基本圖像開始。

./Dockerfile

FROM ubuntu:18.04

# Add training dependencies and programs###### Add a script that SageMaker will run

121




# Set run permissions# Prepend program directory to $PATHCOPY /train /opt/program/trainRUN chmod 755 /opt/program/trainENV PATH=/opt/program:${PATH}

所以此Dockerfile新增先前建立的train指令碼新增至影像。腳本的目錄被添加到 PATH，以便它可以在容器運行時運行。

在上一個範例中，沒有實際的訓練邏輯。對於您實際的訓練影像，請將訓練相依性新增至Dockerfile，並添加邏輯來讀取訓練輸入以訓練和生成模型成品。

您的訓練影像必須包含所有必要的相依性，因為它將無法存取網際網路。

如需詳細資訊，請參閱「」使用您自己的演算法和模型搭配AWS Marketplace與AWSMarketplaceSageMaker 範例(在 GitHub 上)。



• ./Dockerfile

• ./train

• 您的訓練相依性和邏輯

接下來，您可以構建，運行和測試此容器映像。

建立影像

在構建上下文中運行 Docker 命令來構建和標記映像。這個例子使用標籤my-directory 影像。

sudo docker build --tag my-training-image ./


Successfully built abcdef123456Successfully tagged my-training-image:latest

在本機執行

完成後，請在本機測試影像，如以下範例所示。

sudo docker run \ --rm \ --volume '<path_to_input>:/opt/ml/input:ro' \ --volume '<path_to_model>:/opt/ml/model' \ --volume '<path_to_output>:/opt/ml/output' \ --name my-training-container \ my-training-image \ train

以下是命令詳細信息：

• --rm：在容器停止後自動移除容器。• --volume '<path_to_input>:/opt/ml/input:ro'：使測試輸入目錄可用於容器為只讀。• --volume '<path_to_model>:/opt/ml/model'：當訓練測試完成時，繫結裝載模型成品儲存在主

機上的路徑。

122





• --volume '<path_to_output>:/opt/ml/output'：綁定掛載失敗原因的路徑failure檔案會寫入主機上的。

• --name my-training-container：給這個正在運行的容器一個名稱。• my-training-image：執行建置的映像。• train：運行容器時運行相同的腳本 SageMaker 運行。

運行此命令後，Docker 從您構建的訓練映像創建一個容器並運行它。容器會執行train腳本，它會啟動您的訓練計劃。

訓練程式完成且容器退出後，請檢查輸出模型成品是否正確。此外，請檢查記錄輸出以確認它們不會產生您不想要的記錄檔，同時確保提供足夠的訓練工作資訊。

這完成包裝演算法產品的訓練代碼。由於演算法產品也包含推斷影像，請繼續前往下一節，創建算法的推斷圖像 (p. 123)。

創建算法的推斷圖像本節提供逐步解說，可將您的推論代碼封裝成演算法產品的推論影像。

推斷圖像是包含您的推斷邏輯的 Docker 圖像。在運行時的容器公開 HTTP 端點，以允許 SageMaker 將數據傳遞到容器和從容器傳遞數據。

發佈演算法產品時，都需要訓練和推斷圖像。如果您尚未這麼做，請參閱上一節建立演算法的訓練影像 (p. 120)。這兩個影像可以合併成一個影像，也可以保持為單獨的影像。是否合併圖像或分開它們取決於你。通常，推論比訓練簡單，您可能需要單獨的影像來協助推論效能。

Note

以下只是推斷影像的封裝程式碼範例。如需詳細資訊，請參閱「」使用您自己的演算法和模型搭配AWS Marketplace與AWS MarketplaceSageMaker 範例(在 GitHub 上)。下列範例會使用 Web 服務Flask，為了簡單起見，並且不被認為是生產準備就緒的。

步驟 1：建立推論影像

為了使推斷圖像與 SageMaker 兼容，Docker 圖像必須公開 HTTP 端點。當您的容器運行時，SageMaker將輸入傳遞給買方提供的推斷到容器的 HTTP 端點。推斷的結果在 HTTP 響應的主體中返回。

以下使用在 Linux 的 Ubuntu 發行版上安裝在開發環境中的碼頭 CLI。

• 建立 Web 伺服器指令碼 (p. 123)• 建立容器執行的指令碼 (p. 124)• 建立 Dockerfile (p. 124)• 準備程式以動態載入模型成品 (p. 125)

建立 Web 伺服器指令碼

這個例子使用一個名為Flask，但您可以使用任何適用於您的框架的 Web 服務器。Note

Flask在這裡用於簡單。它不被視為生產就緒的 Web 伺服器。

創建瓶 Web 服務器腳本，該腳本為兩個 HTTP 端口 8080 上的 SageMaker 使用。以下是兩個預期的端點：

• /ping-SageMaker 向此端點發出 HTTP GET 請求，以檢查您的容器是否準備就緒。當您的容器準備就緒時，它會使用 HTTP 200 響應代碼響應此端點的 HTTP GET 請求。

• /叫-SageMaker 將 HTTP POST 請求發送到此端點進行推斷。用於推理的輸入資料在請求內文中傳送。使用者指定的內容類型會在 HTTP 標頭中傳遞。回應本文為推斷輸出。

123








。 /web_app_serve.py

# Import modulesimport jsonimport refrom flask import Flaskfrom flask import requestapp = Flask(__name__)

# Create a path for health [email protected]("/ping")def endpoint_ping(): return "" # Create a path for [email protected]("/invocations", methods=["POST"])def endpoint_invocations(): # Read the input input_str = request.get_data().decode("utf8") # Add your inference code here. # # # # # # Add your inference code here. # Return a response with a prediction response = {"prediction":"a","text":input_str} return json.dumps(response)

在上一個範例中，沒有實際的推理邏輯。對於您的實際推論圖像，將推論邏輯添加到 Web 應用程序中，以便處理輸入並返回預測。

您的推斷圖像必須包含所有必要的依賴關係，因為它將無法訪問互聯網。


建立命名為serve當它運行 Docker 容器映像時運行。在此指令碼中，啟動 HTTP 網頁伺服器。

./serve

#!/bin/bash

# Run flask server on port 8080 for SageMakerflask run --host 0.0.0.0 --port 8080

建立 Dockerfile

建立Dockerfile在您的構建上下文中。這個例子使用 Ubuntu 18.04，但你可以從任何適用於你的框架的基本映像開始。

./Dockerfile

FROM ubuntu:18.04

# Specify encodingENV LC_ALL=C.UTF-8ENV LANG=C.UTF-8

124


# Install python-pipRUN apt-get update \&& apt-get install -y python3.6 python3-pip \&& ln -s /usr/bin/python3.6 /usr/bin/python \&& ln -s /usr/bin/pip3 /usr/bin/pip;

# Install flask serverRUN pip install -U Flask;

# Add a web server script to the image# Set an environment to tell flask the script to runCOPY /web_app_serve.py /web_app_serve.pyENV FLASK_APP=/web_app_serve.py

# Add a script that Amazon SageMaker will run# Set run permissions# Prepend program directory to $PATHCOPY /serve /opt/program/serveRUN chmod 755 /opt/program/serveENV PATH=/opt/program:${PATH}

所以此Dockerfile會將先前建立的兩個指令碼新增至影像。的目錄serve腳本被添加到 PATH 中，以便它可以在容器運行時運行。

準備程式以動態載入模型成品

對於演算法產品，買方使用自己的資料集與您的訓練影像來產生唯一的模型成品。訓練程序完成後，訓練容器會將模型人工因素輸出至容器目錄 /opt/ml/model/。SageMaker 將該目錄中的內容壓縮為 .tar.gz 並將其存儲在買方的AWS帳戶。

當模型部署時，SSageMaker 會執行您的推斷影像，從儲存在 Amazon S3 中買方帳戶的 .tar.gz 中擷取模型成品，然後將它們載入/選擇/毫升/型號/目錄。在運行時，您的推斷容器代碼使用模型數據。

Note

若要保護模型人工因素檔案中可能包含的任何智慧財產，您可以選擇在輸出檔案之前加密檔案。如需更多詳細資訊，請參閱安全和智慧財產權 (p. 112)。



• ./Dockerfile

• ./web_app_serve.py

• ./serve

接下來，您可以構建，運行和測試此容器映像。

建立影像

執行 Docker 命令來建置和標記映像。這個例子使用標籤my-inference-image。

sudo docker build --tag my-inference-image ./


Successfully built abcdef123456Successfully tagged my-inference-image:latest

125


在本機執行

構建完成後，您可以在本地測試映像。

sudo docker run \ --rm \ --publish 8080:8080/tcp \ --volume '<path_to_model>:/opt/ml/model:ro' \ --detach \ --name my-inference-container \ my-inference-image \ serve

以下是命令詳細信息：

• --rm：在容器停止後自動移除容器。• --publish 8080:8080/tcp：公開連接埠 8080，以模擬連接埠 SageMaker 會傳送 HTTP 要求至。• --volume '<path_to_model>:/opt/ml/model:ro'：綁定將測試模型成品存儲在主機上的路徑掛

載為只讀，以便將它們提供給容器中的推斷代碼。• --detach：在背景執行容器。• --name my-inference-container：給這個正在運行的容器一個名稱。• my-inference-image：執行建置的映像。• Serve：運行容器時運行相同的腳本 SageMaker 運行。

運行此命令後，Docker 從推斷映像創建一個容器，並在後台運行它。容器會執行serve腳本，它啟動您的Web 服務器進行測試。

測試 ping HTTP 端點

當 SageMaker 運行您的容器時，它會定期地 ping 端點。當端點返回狀態碼 200 的 HTTP 響應時，它向SageMaker 出信號，該容器已準備好進行推斷。

執行下列命令以測試端點並包含回應標頭。

curl --include http://127.0.0.1:8080/ping

範例輸出顯示在下列範例中。

HTTP/1.0 200 OKContent-Type: text/html; charset=utf-8Content-Length: 0Server: MyServer/0.16.0 Python/3.6.8Date: Mon, 21 Oct 2019 06:58:54 GMT

測試推論 HTTP 端點

當容器通過返回 200 狀態碼表示它已準備就緒時，SageMaker 會將推斷數據傳遞給/叫HTTP 端點POST請求。

執行下列命令以測試推論端點。

curl \ --request POST \ --data "hello world" \ http://127.0.0.1:8080/invocations

範例輸出顯示在下列範例中。

126

AWS Marketplace 賣方指南上傳影像

{"prediction": "a", "text": "hello world"}

隨著這兩個 HTTP 端點的工作，推斷圖像現在與 SageMaker 兼容。Note

您的演算法產品模型可以透過兩種方式部署：即時和批次處理。對於這兩個部署，SageMaker 會在執行 Docker 容器時使用相同的 HTTP 端點。

若要停用容器，請執行下列命令。

sudo docker container stop my-inference-container

您的演算法產品的訓練和推論影像都已準備好並測試完畢後，請繼續上傳影像 (p. 127)。

上傳影像本節提供將推論和訓練影像上傳到 Amazon 彈性容器登錄的逐步解說。Amazon ECR是完全受管 Docker 登錄。這是 Amazon SageMaker 從中提取圖像以創建用於培訓工作推斷或演算法的模型包的地方。這也是AWS Marketplace會擷取影像以發佈您的模型套件和演算法產品。

我必須上傳哪些圖片？如果您要發佈模型套件，請僅上傳推論影像。如果您要發佈演算法，請同時上傳推論影像和訓練影像。如果推論和訓練影像結合，請只上傳一次合併的影像。

需要哪些 IAM 權限？下列步驟假設本機電腦已安裝正確的AWS的登入資料AWS Identity and Access Management(IAM) 賣方角色或使用者AWS帳戶。角色或使用者必須具有適用於AWS Marketplace和 Amazon ECR。例如，您可以使用下列AWS受管政策：

• AwSmartAller 產品完整存取— 若要存取AWS Marketplace• AmazonEC2ContainerRegistryFullAccess— 對於訪問亞馬遜 ECR

將您的 Docker 客戶端記錄到AWS設置一個變量AWS您想要發佈的來源區域 (請參閱支援AWS要發佈的區域 (p. 141)。在此範例中使用美國東部 (俄亥俄) 區域。

region=us-east-2

執行下列命令以使用AWS帳戶 ID。此範例假設目前的AWS Command Line Interface(AWS CLI）憑證屬於賣家的AWS帳戶。

account=$(aws sts get-caller-identity --query Account --output text)

要驗證您的 Docker CLI 客戶端與您的AWS帳戶的 Amazon ECR Docker 註冊表，請執行以下命令。

aws ecr get-login-password \--region ${region} \| sudo docker login \--username AWS \--password-stdin \${account}.dkr.ecr.${region}.amazonaws.com

127


AWS Marketplace 賣方指南創建您 Amazon SageMaker

建立儲存庫並上傳影像為上傳影像的標籤設定變數，並為上傳影像儲存庫的名稱設定另一個變數。

image=my-inference-imagerepo=my-inference-image

Note

在本指南前面的章節中，建立了推論和訓練影像，它們被標記為my-directory 影像和my-directory 影像，分別。在此範例中，請建立推論影像並上傳至同名的儲存庫。

執行下列命令以在 Amazon ECR 中建立映像儲存庫。

aws ecr --region ${region} create-repository --repository-name "${repo}"

Amazon ECR 存放庫位置的完整名稱由下列部分組成： <account-id>.dkr.ecr.<region>.amazonaws.com/<image-repository-name>

若要將影像推送至儲存庫，您必須使用儲存庫位置的完整名稱來標記該影像。

為影像儲存庫位置的完整名稱設定變數，以及最新標籤。

fullname="${account}.dkr.ecr.${region}.amazonaws.com/${repo}:latest"

以全名標記影像。

sudo docker tag ${image} ${fullname}

最後，將推斷圖像推送到 Amazon ECR 中的存儲庫。

sudo docker push ${fullname}

上傳完成後，影像會顯示在亞馬遜 ECR 主控台的存放庫清單在您發佈的來源區域中。在上一個範例中，此影像已推送至美國東部 (俄亥俄) 區域的儲存庫。

掃描您上傳的影像在中Amazon ECR 控制台下，選擇AWS您要發佈的區域，然後開啟影像上傳到的儲存庫。選取您上傳的影像，然後開始掃描以檢查是否有已知的弱點。AWS Marketplace會先檢查 Amazon SagMaker 資源中使用的容器映像的 Amazon ECR 掃描結果，然後再發佈。在建立產品之前，您必須先修正具有「嚴重」或「高」嚴重性弱點的容器映像。

成功掃描影像之後，可以使用它們來建立模型套件或演算法資源。

如果您認為您的產品在掃描中出現誤判錯誤，請連絡AWS Marketplace賣方操作，以取得關於錯誤的資訊。

後續步驟

• 請參閱建立機器學習產品的需求和最佳做法 (p. 135)• 繼續創建您 Amazon SageMaker (p. 128)

創建您 Amazon SageMaker若要發佈模型套件或演算法產品，您必須建立個別的模型套件或演算法資源Amazon SagMaker 中的。

128

https://console.aws.amazon.com/ecr/repositories?region=us-east-2


http://aws.amazon.com/marketplace/management/contact-us

https://docs.aws.amazon.com/marketplace/latest/userguide/ml-creating-your-amazon-sagemaker-resource.html#ml-creating-your-model-package-product

https://docs.aws.amazon.com/marketplace/latest/userguide/ml-creating-your-amazon-sagemaker-resource.html#ml-creating-your-algorithm-product


當您為AWS Marketplace產品，它必須通過驗證步驟進行認證。驗證步驟會要求您提供資料以測試模型套件或演算法資源，然後才能發行它。

Note

如果您尚未為產品建立映像並將其上傳到 Amazon Elastic Container Registry (Amazon ECR)，請參閱將您的程式碼封裝成影像 (p. 114)和上傳影像 (p. 127)，取得如何進行的資訊。

建立您的模型套件以下是建立模型套件的需求AWS Marketplace：

• 推斷圖像存儲在Amazon ECR• (選擇性) 模型人工因素，分別儲存在Amazon S3• 您用於推論的測試資料，儲存在 Amazon Simple Storage Service (Amazon S3) 中

Note

以下是建立模型封裝產品的相關資訊。如需 SagMaker 中模型套件的詳細資訊，請參閱建立模型套件資源。

建立模型套件resources下列程序會逐步引導您完成建立模型封裝資源。

步驟 1：建立模型套件資源

1. 開啟Amazon SageMaker 控制台。2. 請確定您位於AWS您想要透過查看頁面右上角來發佈的區域。如需發佈，請參閱支援AWS要發佈的區

域 (p. 141)部分。您在先前步驟中上傳至 Amazon ECR 的推論影像必須位於相同的區域。3. 在左側導覽選單中，選擇模型套件。4. 選擇 Create model package (建立模型套件)。

建立套件後，您需要設定推論套件的規格。

步驟 2：設定推論規格

1. 提供名稱為您的模型套件 (例如，文文文文文文。2. 適用於推論影像的位置，請輸入上傳到 Amazon ECR 的推斷圖像的 URI。您可以通過在Amazon ECR

控制台。3. 如果您的訓練模型工件與您的推斷圖像中的邏輯捆綁在一起，請將模型資料人工因素的位置空白。否

則，請指定模型成品壓縮檔 (.tar.gz) 的完整 Amazon S3 位置。4. 使用下拉式方塊，選擇推論影像支援的執行個體類型以進行即時推論 (也稱為端點) 和批次轉換工作。5. 選擇下一步。

在建立和發佈模型套件之前，必須先驗證以確保其如預期般運作。這需要您執行包含測試資料的批次轉換工作，以便您提供的推斷。驗證規格告訴 SageMaker 如何執行驗證。

步驟 3：若要設定驗證規格

1. 設定發佈此模型套件AWS Marketplace至是。如果將值設為否，您無法稍後發佈此模型套件。選擇是認證您的模型套件AWS Marketplace並且需要驗證步驟。

2. 如果這是第一次完成此程序，請選擇Create a new role (建立新角色)(針對)IAM 角色。AmazonSageMaker 在部署您的模型套件時使用此角色。這包括動作，例如從 Amazon ECR 提取

129



https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-mkt-create-model-package.html

https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-mkt-create-model-package.html

https://us-east-2.console.aws.amazon.com/sagemaker/home

https://us-east-2.console.aws.amazon.com/ecr/repositories


https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateModelPackage.html#sagemaker-CreateModelPackage-request-CertifyForMarketplace



圖像和來自 Amazon S3 的成品。檢閱設定，然後選擇建立角色。在此處建立角色會授與AmazonSageMakerFullAccessIAM 政策指定為您建立的角色。

3. 編輯JSON在驗證描述檔中。如需允許值的詳細資訊，請參閱轉換工作定義。

1. TransformInput.DataSource.S3Uri：設置為用於推斷的測試數據的存儲位置。2. TransformInput.ContentType：指定您的測試資料內容類型 (例如application/

json、text/plain、image/png ，或任何其他值）。SageMaker 不會驗證實際的輸入資料。此值會傳遞至您的容器 HTTP 端點Content-type標頭值。

3. TransformInput.CompressionType：設為None如果您在 Amazon S3 中進行推斷的測試數據沒有被壓縮。

4. TransformInput.SplitType：設為None將 Amazon S3 中每個物件作為整體傳遞以進行推斷。5. TransformOutput.S3OutputPath：設定為儲存推斷輸出的位置。6. TransformOutput.AssembleWith：設為None將每個推斷輸出為 Amazon S3 中單獨的物件。

4. 選擇 Create model package (建立模型套件)。

SSageMaker 從 Amazon ECR 提取推論影像，將任何構件複製到推論容器，並使用您的測試資料執行批次轉換任務進行推論。驗證成功後，該狀態會變更為已完成。

Note

驗證步驟不會評估模型與測試資料的準確性。驗證步驟會檢查容器是否執行，並如預期般回應。

您已完成建立模型產品資源。繼續進行發行您的產品AWS Marketplace (p. 132)。

建立您的演算法以下是創建算法的要求AWS Marketplace：

• 推斷圖像，存儲在亞馬遜 ECR• 培訓圖像，存儲在亞馬遜 ECR• 您用於訓練的測試資料，儲存在 Amazon S3 中• 您用於推斷的測試資料，儲存在 Amazon S3 中

Note

下列逐步解說會建立演算法產品。如需詳細資訊，請參閱「」建立演算法資源。

建立演算法resources下列程序會逐步引導您在演算法套件中建立資源。

步驟 1：建立演算法的步驟resources

1. 開啟Amazon SageMaker 控制台。2. 請確定您位於AWS您想要透過查看頁面右上角來發佈的區域 (請參閱支援AWS要發佈的區

域 (p. 141)。您在先前步驟中上傳到 Amazon ECR 的訓練和推論影像必須位於同一個區域。3. 在左側導覽選單中，選擇演算法。4. 選擇 Create algorithm (建立演算法)。

建立演算法套件之後，您必須設定模型訓練和調整的規格。

步驟 2：若要設定訓練和調整規格

1. 輸入名稱（例如，my-algorithm。

130

https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess

https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TransformJobDefinition.html

https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-mkt-create-algo.html

https://us-east-2.console.aws.amazon.com/sagemaker/home


2. 適用於訓練影像，請貼上上傳到 Amazon ECR 的訓練映像的完整 URI 位置。您可以通過在AmazonECR 控制台。

3. 使用下拉式方塊，選擇訓練的執行個體類型您的訓練影像支援。4. 在下方通道規格區段中，為演算法支援的每個輸入資料集新增通道，最多 20 個輸入來源通道。如需詳

細資訊，請參閱「」輸入資料組態。5. 選擇下一步。6. 如果您的演算法支援超參數和超參數調整，您必須指定調整參數。7. 選擇下一步。

Note

我們強烈建議您的演算法支援超參數調整，並讓適當的參數可調整。這可讓資料科學家調整模型以獲得最佳結果。

設定調整參數後，如果有的話，您必須設定推論影像的規格。

步驟 3：設定推論影像規格

1. 適用於推論影像的位置，請粘貼上傳到亞馬遜 ECR 的推斷圖像的 URI。您可以通過在Amazon ECR 控制台。

2. 使用下拉式方塊，為您的推論影像選擇支援的執行個體類型，以便進行即時推論 (也稱為端點) 和批次轉換工作。

3. 選擇下一步。

在您的演算法可以建立和發佈之前，必須先驗證以確保它如預期般運作。這需要您同時執行訓練工作，其中包含訓練的測試資料，以及包含您提供的推斷測試資料的批次轉換工作。驗證規格告訴 SageMaker 如何執行驗證。

步驟 4：若要設定驗證規格

1. 設定發佈此演算法AWS Marketplace至是。如果將值設為否，則不能稍後發佈此演算法。選擇是認證您的演算法AWS Marketplace並且需要驗證規格。

2. 如果這是您第一次為AWS Marketplace中，選擇Create a new role (建立新角色)(針對)IAM 角色。Amazon SageMaker 在訓練演算法和部署後續模型套件時使用此角色。這包括從 Amazon ECR 提取影像、在 Amazon S3 中儲存成品，以及從 Amazon S3 複製訓練資料等動作。檢閱設定，然後選擇建立角色。在此處建立角色會授與AmazonSageMakerFullAccessIAM 政策指定為您建立的角色。

3. 編輯JSON文件中的驗證配置文件訓練工作定義。如需允許值的詳細資訊，請參閱訓練工作定義。

1. InputDataConfig：在這個 JSON 數組中，添加頻道物件針對您在訓練規格步驟中指定的每個頻道。針對每個頻道，指定要儲存訓練的測試資料的位置。

2. OutputDataConfig：訓練完成後，訓練容器目錄路徑中的模型人工因素/opt/ml/model/被壓縮並複製到 Amazon S3。指定儲存壓縮檔 (.tar.gz) 的 Amazon S3 位置。

4. 在驗證配置文件中編輯 JSON 文件轉換任務定義。如需允許值的詳細資訊，請參閱轉換工作定義。

1. TransformInput.DataSource.S3Uri：設置為用於推斷的測試數據的存儲位置。2. TransformInput.ContentType：指定您的測試資料內容類型。例如：application/

json、text/plain、image/png，或任何其他值。Amazon SageMaker 不驗證實際的輸入數據。此值會傳遞至您的容器 HTTP 端點Content-type標頭值。

3. TransformInput.CompressionType：設為None如果您在 Amazon S3 中進行推斷的測試數據沒有被壓縮。

4. TransformInput.SplitType：選擇您希望 S3 中對象的分割方式。例如：None將 Amazon S3 儲存貯體中每個物件作為一個整體傳遞以進行推斷。如需詳細資訊，請參閱「」。SplitType在 AmazonSagMaker API 參考中。

131



https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms-training-algo-running-container.html#your-algorithms-training-algo-running-container-inputdataconfig



https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateAlgorithm.html#sagemaker-CreateAlgorithm-request-CertifyForMarketplace

https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess

https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingJobDefinition.html

https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_Channel.html

https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TransformJobDefinition.html

https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TransformInput.html#sagemaker-Type-TransformInput-SplitType

AWS Marketplace 賣方指南發行您的產品AWS Marketplace

5. TransformOutput.S3OutputPath：設定為儲存推論輸出的位置。6. TransformOutput.AssembleWith：設為None將每個推斷輸出為 Amazon S3 中單獨的物件。

5. 選擇建立演算法套件。

SSageMaker 從 Amazon ECR 提取訓練影像，使用您的資料執行測試訓練任務，並將模型成品儲存在Amazon S3 中。然後，它會從 Amazon ECR 提取推斷圖像，將 Amazon S3 中的構件複製到推斷容器中，並使用測試資料進行推斷來執行批次轉換任務。驗證成功後，該狀態會變更為已完成。

Note

驗證步驟不會評估訓練或模型與測試資料的準確性。驗證步驟會檢查容器是否執行，並如預期般回應。驗證步驟只會驗證批次處理。您可以自行驗證即時處理是否適用於您的產品。

您已完成建立演算法產品資源。繼續進行發行您的產品AWS Marketplace (p. 132)。

發行您的產品AWS Marketplace您可以發佈模型套件或演算法之前，需要下列項目：

• 一個AWS帳戶已註冊為AWS Marketplace賣方。您可以在AWS Marketplace管理入口網站。• 已完成的賣家個人資料設定的頁面AWS Marketplace管理入口網站。• 對於發佈付費產品，您必須完成稅務面試和銀行表格。這不是發佈免費產品的必要條件。如需詳細資訊，

請參閱「」賣方註冊流程。• 您必須具備許可，才能存取AWS Marketplace管理入口網站和 Amazon SageMaker。如需更多詳細資訊，

請參閱必要許可 (p. 132)。

發佈程序概觀發佈程序中有四個步驟：

1. 提交產品— 建立包含模型套件或演算法產品的描述、使用資訊和其他詳細資訊的清單。提交產品以進行發佈之後，大約需要一個小時的時間，直到狀態變更為下一個步驟。

2. 測試產品— 使用您的AWS帳戶已註冊為AWS Marketplace賣家預覽AWS Marketplace，訂閱它，並測試產品。此外，其他允許AWS帳戶可以預覽和測試產品。如果需要變更，你可以返回並編輯刊登詳細資料。

3. 登出以進行發佈— 當您的產品準備上線時，請返回AWS Marketplace管理入口網站，然後選擇簽署並發佈。

4. 產品上線— 您的產品現在在AWS Marketplace。您可以透過發佈具有更新或產品修正的新版本來維護您的產品。

必要許可要發布亞 Amazon SageMaker 產品，AWS Identity and Access Management(IAM) 使用者或角色需要下列一個或兩個 IAM 動作：

• 模型:描述模型套件— 用於列出模型套件• 繪圖器:描述演算法-用於列出算法

對於AWS Marketplace權限，或如需管理賣家帳戶，請參閱中的政策和許可AWS Marketplace賣方。

132


http://aws.amazon.com/marketplace/management/seller-settings

https://docs.aws.amazon.com/marketplace/latest/userguide/seller-registration-process.html

https://docs.aws.amazon.com/marketplace/latest/userguide/detailed-management-portal-permissions.html

AWS Marketplace 賣方指南建立您的產品清單

建立您的產品清單以下是建立產品清單的逐步解說，在AWS Marketplace用於模型包和算法產品。

Note

建立物品之前，請務必備妥建立機器學習產品的需求和最佳做法 (p. 135)。

若要建立機器學習產品

1. 登入賣家後AWS帳戶中，導覽至AWS Marketplace管理入口網站。2. 在頂端功能表中，導覽至產品然後機器學習。3. 選擇建立新的物品。

建立清單後，您必須提供一般產品資訊、設定第一版產品的啟動選項、設定產品的定價，最後送出產品。下列程序會引導您完成這些步驟。

步驟 1：提供一般產品資訊

1. 選擇Addfor產品描述。輸入詳細資料，包括標題、簡短說明、產品概述和其他詳細資料。如需產品說明，請參閱建立機器學習產品的需求和最佳做法 (p. 135)。選擇Continue(憑證已完成)。您稍後可以變更這些值。

2. 繼續進行推廣資源，並提供產品標誌和相關連結。選擇Continue(憑證已完成)。您稍後可以變更這些值。

3. 繼續進行Support 資訊，提供支援和聯絡詳細資料。選擇Continue(憑證已完成)。您稍後可以變更這些值。

4. 繼續進行區域可用性，然後選擇特定的AWS您要在其中刊登產品的地區。預設值為在目前和未來支援的所有區域提供。選擇Continue(憑證已完成)。在您送出草稿以供發佈之後，您就無法變更此選取。

接下來，您就可以提供啟動選項，也就是您要銷售的模型或演算法。

步驟 2：若要新增啟動選項

1. 適用於輸入 ARN，請貼上模型套件或演算法的 Amazon Resource Name (ARN)。您能夠在 AmazonSageMaker 主控台中找到這些模型套件或演算法頁面。

1. 模型套件的 ARN 會顯示如下：arn:aws:sagemaker:<region>:<account-id>:model-package/<model-package-name>

2. 演算法的 ARN 顯示如下：arn:aws:sagemaker:<region>:<account-id>:algorithm/<algorithm-name>

2. 選擇 Add (新增)。3. 此步驟會因您發佈模型套件或演算法產品而有所不同。除了面向購買者的版本號碼之外，您可以稍後變

更版本詳細資料。

1. 提供版本號碼、版本說明和 URL 給範例 Jupyter 筆記本和 GitHub 存放庫。2. 適用於演算法產品，在下一頁描述訓練資料，並包含範例訓練資料資源以及訓練演算法的概觀。演算

法量度、通道規格和超參數將根據您在 SageMaker 中建立演算法資源時所提供的值，自動顯示在產品詳細資料頁面上。

3. 在下一頁中，提供範例輸入檔案的模型輸入詳細資料和 URL。4. 在下一頁，以文字或 URL 提供模型輸出詳細資料和範例輸出。如需使用資訊，請參閱建立機器學習

產品的需求和最佳做法 (p. 135)。5. 在下一頁上，設定建議的執行個體。如果這是模型套件產品，請從受支援的執行個體中選擇建議的執

行個體類型，以進行批次轉換和即時部署。如果這是演算法產品，請選擇建議的執行個體類型訓練工

133


https://us-east-2.console.aws.amazon.com/sagemaker/home?region=us-east-2#/model-packages/my-resources

https://us-east-2.console.aws.amazon.com/sagemaker/home?region=us-east-2#/algorithms/my-resources

AWS Marketplace 賣方指南測試您的產品

作，以及。您無法選擇模型封裝或演算法資源不支援的執行個體類型。在 Amazon SageMaker 中建立這些資源時，已選取支援的執行個體類型。

4. 選擇Continue(憑證已完成)。

Note

清楚說明產品預期輸入和輸出的使用資訊（例如），對於支持正面的買家體驗至關重要。如需更多詳細資訊，請參閱建立機器學習產品的需求和最佳做法 (p. 135)。

發佈產品的下一個步驟是設定定價和條款。

步驟 3：若要設定定價與條款

1. 選擇新增講價。2. 設定您的定價。您可以免費提供軟體、設定付費定價或啟用免費試用期。如需更多詳細資訊，請參閱為

Machine Learning 產品定價 (p. 112)。3. 上傳純文字檔案，用作您的終端使用者授權合約 (EULA)。4. 選擇 Save and close (儲存與關閉)。

您已提供產品的所有資訊。下一個步驟是將它發佈到有限的可用性，以便您可以測試產品。

步驟 5：若要提交產品以供發佈

• 適用於產品概觀中，選擇提交以進行發行。這會開始發佈程序，方法是在AWS Marketplace，您可以訂閱並用於測試。

Note

如需測試機器學習產品的詳細資訊，請參閱測試您的產品 (p. 134)。

測試產品後，如果需要進行任何變更，您可以重做上述步驟。當您準備好讓產品可供 AWS Data Exchange中的買方使用時，您可以登出以進行發佈。

步驟 4：登出以發佈的步驟

• 測試產品並撰寫說明、定價和使用資訊後，請返回產品概觀，然後選擇簽署並發佈。

測試您的產品首次提交產品後，大約需要一個小時才能準備好預覽物品。狀態變更為測試產品、你的賣家帳戶和其他列出的允許列出AWS帳戶可以預覽AWS Marketplace、訂閱產品並進行測試。若要預覽物品，請在AWSMarketplace管理入口網站，瀏覽至產品概觀頁面，然後選擇移至暫存產品。

新增其他AWS帳戶以在發佈前測試您的產品，請聯絡AWS Marketplace賣方營運，並提供AWS帳戶 ID。允許列出的帳戶會顯示有限公司徽章旁邊的產品詳細資訊頁面上的產品版本。

如果您想要進行變更，請選擇編輯產品，然後依照建立產品的相同步驟進行。當您準備好要公開發佈產品供所有買方查看時，請返回管理入口網站，然後選擇簽署並發佈。

更新您的產品若要更新模型套件或演算法產品，請瀏覽至Machine Learning 清單的頁面AWS Marketplace管理入口網站。您可以將新的模型套件或演算法資源新增為現有產品的新版本。您也可以限制舊版或移除整個產品。

134

http://aws.amazon.com/marketplace/management/contact-us

http://aws.amazon.com/marketplace/management/ml-products

AWS Marketplace 賣方指南建立機器學習產品的需求和最佳做法

加入新版本若要新增模型套件或演算法資源的新版本，請瀏覽至產品概觀，然後使用下列程序。

新增新版本

1. 選擇編輯產品。2. UNDR啟動選項中，選擇Edit (編輯)。3. 若要新增資源的 ARN，請瀏覽至版本頁面，然後選擇新增新版本。如需新增啟動選項的詳細資訊，請參

閱建立您的產品清單 (p. 133)。

Note

使用資訊是針對每個產品版本的特定資訊。繼續遵循建立機器學習產品的需求和最佳做法 (p. 135)將使用資訊新增至新版本時。

當您的買家從AWS Marketplace列表中，他們可以選擇不同的版本。當您的買家從 Amazon SageMaker 控制台啟動您的產品時，只有最新版本是可見的。

限制版本若要限制模型套件或演算法資源的版本，請瀏覽至產品概觀頁面上，然後再利用下列程序。

若要限制版本

1. 選擇編輯產品。2. UNDR啟動選項中，選擇Edit (編輯)。3. 在版本頁面上，選擇限制版本。4. 返回產品概觀，然後選擇提交以進行發行。

Note

已訂閱您產品的購買者可以繼續使用您的模型套件或演算法的限制版本。不過，新買家將無法將這些限制版本視為選項。

移除產品若要移除產品，請在Machine Learning 清單的頁面AWS Marketplace管理入口網站。選擇您想要移除的產品，然後在動作下拉式清單，選擇取消發行清單。

請提供電子郵件地址和移除刊登物品的理由，如果AWS Marketplace代表就您的要求與您聯絡。

Note

當您從中移除產品AWS Marketplace，新買家將無法再訂閱您的產品。不過，現有買家可以繼續使用您的產品，必須支援至少 90 天之久。如果您打算讓其他產品取代未發佈的清單，請在移除請求的詳細資料中指出新的清單。

建立機器學習產品的需求和最佳做法請務必讓您的買家輕鬆測試您的模型包裝和演算法產品。下列各節說明建立機器學習 (ML) 產品清單的需求，以及機器學習產品的最佳作法。如需需求和建議的完整摘要，請參閱ML 產品清單的需求和建議摘要 (p. 138)。

135

http://aws.amazon.com/marketplace/management/ml-products

AWS Marketplace 賣方指南必要資產

Note

一個AWS Marketplace如果您發佈的產品不符合這些需求，代表可能會與您連絡以協助您符合這些需求。

主題• 必要資產 (p. 136)• ML 產品的一般最佳實務 (p. 136)• 使用資訊的要求 (p. 136)• 6. 对于输入和输出的要求 (p. 137)• Jupyter 筆記型電腦的需求 (p. 137)• ML 產品清單的需求和建議摘要 (p. 138)

必要資產建立機器學習產品清單之前，請務必備妥下列必備妥下列資產：

• Amazon Resource Name (ARN)— 提供模型套件或演算法資源的 ARNAWS您要發佈的地區 (請參閱支援AWS要發佈的區域 (p. 141)。• 模型包的 ARN 具有以下形式：arn:aws:sagemaker:<region>:<account-id>:model-package/<model-package-name>

• 算法的 ARN 具有以下形式：arn:aws:sagemaker:<region>:<account-id>:algorithm/<algorithm-name>

• the section called “使用資訊的要求” (p. 136)— 提供有關輸入、輸出和程式碼範例的詳細資訊。• the section called “6. 对于输入和输出的要求” (p. 137)— 提供檔案或文字。• the section called “Jupyter 筆記型電腦的需求” (p. 137)— 展示完整的產品使用情況。

ML 產品的一般最佳實務為您的機器學習產品提供下列資訊：

• 如需產品說明，請包括下列內容：• 你的模型做什麼• 目標客戶是誰• 什麼是最重要的用例• 模型的訓練方式或使用的資料量• 效能測量結果是什麼，以及使用的驗證資料• 如果是醫療，無論您的模型是否用於診斷

• 或者，針對付費產品，提供 14 至 30 天的免費試用，讓客戶試用您的產品。如需更多詳細資訊，請參閱為Machine Learning 產品定價 (p. 112)。

• 或者，如果您想要在產品清單頁面上啟用即時產品示範，請聯絡AWS Marketplace賣方操作。產品示範可讓潛在買家直接在清單頁面上試用你的模型，而不需要訂閱或部署模型。

使用資訊的要求清楚說明產品預期輸入和輸出的使用資訊 (例如)，對於推動正面的買家體驗至關重要。

當您新增至產品清單的資源每個新版本時，您必須提供使用資訊。

136


AWS Marketplace 賣方指南6. 对于输入和输出的要求

若要新增第一次發佈之新產品的使用資訊，請登入AWS Marketplace管理入口網站主控台。從 [產品] 下拉式清單中選擇 [機器學習]。選取您的產品。在中產品概觀下啟動選項，提供模型套件或演算法資源的 ARN，然後選擇Add。

若要編輯特定版本的現有使用資訊，請選擇Edit (編輯)下啟動選項然後編輯版本。

6. 对于输入和输出的要求清楚說明您的格式，以及輸入和輸出的範例，對於幫助您的買家了解和使用您的產品非常重要。這樣的理解有助於您的買家對輸入數據進行任何必要的轉換，以獲得最佳的推斷結果。

將 SageMaker 資源新增至產品清單時，系統會提示您輸入以下資訊。

推理輸入和輸出對於推論輸入，請提供即時端點和批次轉換工作的輸入格式。包含任何必要的預處理資料的程式碼片段。包含支援的 MIME 內容類型 (例如影像/影像、影像/PNG、影像/影像)、值的說明 (如果適用) 以及限制。包含託管在GitHub。

針對推論輸出，請提供即時端點和批次轉換工作的輸出格式。包含輸出 MIME 內容類型 (例如application/json、影像/影像) 以及值的說明 (如果適用)。包含託管於的輸出樣本GitHub。

對於範例，請提供與您的產品搭配使用的輸入檔案。如果您的模型執行多類別分類，請為每個類別至少提供一個範例輸入檔案。

訓練輸入在中若要訓練模型的資訊區段中，提供輸入資料格式和程式碼片段，以便對資料進行任何必要的預處理。包含支援的 MIME 內容類型 (例如影像/影像、影像/PNG、影像/影像)、值的說明 (如果適用) 以及限制。確保包含託管在GitHub。

說明買方可提供的選擇性和強制性功能，並指定是否支援 PIPE 輸入模式。如果分散式訓練(使用超過 1 個CPU/GPU 執行個體的訓練)，請指定此選項。若要進行調整，請列出建議的超參數。

Jupyter 筆記型電腦的需求將 SSageMaker 資源新增至產品清單時，請提供裝載於GitHub，展示完整的工作流程，而不要求買方上傳或尋找任何資料。

使用 AWS SDK for Python (Boto)。開發完善的筆記型電腦樣本，讓買家更容易嘗試使用你的刊登物品。

針對模型封裝產品，您的樣本筆記型電腦示範如何準備輸入資料、為即時推斷建立端點，以及批次轉換工作的效能。如需詳細資訊，請參閱「」型號套件清單與筆記型電腦樣本(在 GitHub 上)。如需筆記本範例，請參閱一般筆記型電腦 (_S)和汽車保險。後一個樣本筆記本可在所有區域使用，不需要輸入任何參數，也不需要買方找到樣本資料。

Note

未開發的樣本 Jupyter 筆記型電腦未顯示多個可能的輸入和資料預處理步驟，可能會使買家難以完全瞭解您產品的價值主張。

對於演算法產品，範例筆記型電腦會示範完整的訓練、調校、建立模型、建立即時推論的端點，以及批次轉換工作的效能 (請參閱演算法列表和樣本筆記本(在 GitHub 上)。如需筆記本範例，請參閱亞馬遜展示產品和自動毫升(在 GitHub 上)。這些樣本筆記本可在所有地區使用，不需要輸入任何參數，也不需要買方找到樣本資料。

Note

缺少範例訓練資料可能會導致買家無法成功執行 Jupyter 筆記型電腦。未開發的樣本筆記型電腦可能會阻止買家使用您的產品，並阻礙採用。

137

https://github.com

https://github.com

https://github.com

https://docs.aws.amazon.com/sagemaker/latest/dg/your-algorithms-training-algo-running-container.html#your-algorithms-training-algo-running-container-dist-training

https://github.com

https://github.com/awslabs/amazon-sagemaker-examples/tree/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage

https://github.com/awslabs/amazon-sagemaker-examples/tree/master/aws_marketplace/using_model_packages/generic_sample_notebook

https://github.com/awslabs/amazon-sagemaker-examples/tree/master/aws_marketplace/using_model_packages/auto_insurance

https://github.com/awslabs/amazon-sagemaker-examples/tree/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/Algorithm

https://github.com/awslabs/amazon-sagemaker-examples/tree/master/aws_marketplace/using_algorithms/amazon_demo_product

https://github.com/awslabs/amazon-sagemaker-examples/tree/master/aws_marketplace/using_algorithms/amazon_demo_product

https://github.com/awslabs/amazon-sagemaker-examples/tree/master/aws_marketplace/using_algorithms/automl

AWS Marketplace 賣方指南ML 產品清單的需求和建議摘要

ML 產品清單的需求和建議摘要下表提供機器學習產品清單頁面的需求和建議摘要。

詳細資訊若要套件清單若要演算法清單

Product descriptions

Explain in detail what the productdoes for supported contenttypes (for example, “detects X inimages").

Required Required

Provide compelling anddifferentiating information aboutthe product (avoid adjectives like"best" or unsubstantiated claims).

Recommended Recommended

List most important use case(s)for this product.

Required Required

Describe the data (source andsize) it was trained on and listany known limitations.

Required Not applicable

Describe the core framework thatthe model was built on.


Summarize model performancemetric on validation data (forexample, "XX.YY percentaccuracy benchmarked using theZ dataset").


Summarize model latencyand/or throughput metrics onrecommended instance type.


Describe the algorithm category.For example, “This decisionforest regression algorithm isbased on an ensemble of tree-structured classifiers that arebuilt using the general techniqueof bootstrap aggregation and arandom choice of features.”

Not applicable Required

Usage information

For inference, provide the inputformat for both the real-timeendpoint and batch transformjob. Include supported MIMEcontent types (for example, 影像/影像, 影像/PNG, 影像/影像),description of values if applicable,and limitations. See 6. 对于输入和输出的要求 (p. 137).

Required Required

138

AWS Marketplace 賣方指南ML 產品清單的需求和建議摘要


For inference, provide inputsamples for both the real-timeendpoint and batch transformjob. Samples must be hosted onGitHub. See 6. 对于输入和输出的要求 (p. 137).

Required Required

For inference, provide the outputformat for both the real-timeendpoint and batch transform job.Include output MIME content type(for example, application/json, 影像/影像) and description of valuesif applicable. See 6. 对于输入和输出的要求 (p. 137).

Required Required

For inference, provide outputsamples for both the real-timeendpoint and batch transformjob. Samples must be hosted onGitHub. See 6. 对于输入和输出的要求 (p. 137).

Required Required

For inference, provide anexample of using an endpointor batch transform job. Includea code example using the AWSCommand Line Interface (AWSCLI) commands or using an AWSSDK.

Required Required

For training, provide inputformat. Include supported MIMEcontent types (for example, 影像/影像, 影像/PNG, 影像/影像),description of values if applicable,and limitations (for example,minimum rows of data required).See 6. 对于输入和输出的要求 (p. 137).


For training, provide inputsamples hosted on GitHub.See 6. 对于输入和输出的要求 (p. 137).


139

AWS Marketplace 賣方指南服務限制與配額


For training, provide anexample of performing trainingjobs. Describe the supportedhyperparameters, their ranges,and their overall impact. Specifyif the algorithm supportshyperparameter tuning,distributed training, or GPUinstances. Include code examplesuch as AWS CLI commands orusing an AWS SDK, for example.


Provide a Jupyter notebookhosted on GitHub demonstratingcomplete use of your product.See Jupyter 筆記型電腦的需求 (p. 137).

Required Required

Provide technical informationrelated to the usage of theproduct, including user manualsand sample data.


服務限制與配額本節說明您機器學習產品在AWS Marketplace。

網路隔離為了安全起見，當買方訂閱您的容器化產品時，Docker 容器即會在隔離環境中執行，而不需要進行網路存取。當您建立容器時，請不要倚賴透過網際網路進行傳出呼叫，因為這些呼叫會失敗。呼叫AWS服務也將失敗。

影像大小您的 Docker 影像大小受 Amazon Elastic Container Registry (Amazon ECR) 管理服務配額。Docker 映像大小會影響訓練工作、批次轉換工作和端點建立期間的啟動時間。若要獲得更佳的效能，請維持最佳 Docker映像大小。

儲存空間大小當您建立端點 (也稱為即時推論或Amazon SageMaker 託管服務)，SSageMaker 會將 Amazon EElasticBlock Store (Amazon EBS) 儲存磁碟區連接到託管端點的每個機器學習 (ML) 運算執行個體。儲存磁碟區的大小取決於執行個體類型 (請參閱託管執行個體儲存體磁碟區)。對於批次轉換，請記住這些限制。

執行個體大小SageMaker 提供了一系列實例類型，這些實例類型經過最佳化，以適應不同的 ML 使用案例。執行個體類型由不同 CPU、GPU、記憶體及聯網容量的 CPU、聯網容量組成。執行個體類型可讓您彈性選擇適當的資源組合，以建置、訓練和部署 ML 模型。如需詳細資訊，請參閱「」Amazon SageMaker 毫升執行個體類型。

140

https://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html

https://docs.aws.amazon.com/sagemaker/latest/dg/host-instance-storage.html

http://aws.amazon.com/sagemaker/pricing/instance-types/

AWS Marketplace 賣方指南推論的承載大小

推論的承載大小對於端點，每次呼叫的輸入資料大小上限為 25 MB。無法調整此值。

對於批次轉換，每次呼叫的輸入資料大小上限為 100 MB。無法調整此值。

推斷的處理時間對於端點，每次呼叫的最大處理時間為 60 秒。您可以要求變更此值。若要將此值增加為 120 秒 (也就是最大值)，請連絡AWS支援使用您的AWS帳戶 ID 和AWS您想要增加的區域。如果您的買家要求增加這項功能才能在他們自己的帳戶中使用您的產品，他們也必須要求增加。如果需要買家提出增加要求，請在產品刊登的使用資訊中清楚說明。

對於批次轉換，每次呼叫的處理時間上限為 60 分鐘。無法調整此值。

服務配額如需訓練與推論相關配額的詳細資訊，請參閱Amazon SageMaker Service Quotas。

受管 Spot 訓練對於所有演算法來自AWS Marketplace、MaxWaitTimeInSeconds設定為 3,600 秒 (60 分鐘)，即使管理現場訓練實作。無法調整此值。

Docker 影像和AWSACCOMPT若要發佈，映像必須儲存在AWS帳戶的賣方。無法發佈儲存在另一個AWS帳戶。

從內建演算法或AWS Marketplace從訓練工作建立的模型套件Amazon SageMaker 內建演算法或演算法AWS Marketplace訂閱無法發佈。

您仍然可以使用訓練工作中的模型人工因素，但發佈模型套件時需要您自己的推斷影像。

支援AWS要發佈的區域AWS Marketplace支援以下兩個區域都成立的發佈模型套件和演算法資源：

• 區域Amazon SageMaker 支援• 一個可用區域，它默認是選擇加入的（例如，描述區域傳回"OptInStatus": "opt-in-not-required")

發佈模型套件或演算法產品所需的所有資產必須儲存在您選擇發佈的相同區域中。這包含下列項目：

• 在 Amazon SageMaker 中創建的模型包和算法資源• 上傳到 Amazon ECR 存放庫的推斷和訓練影像• 儲存在 Amazon 簡易儲存服務 (Amazon S3) 中且在模型部署期間動態載入的模型成品 (如果有的話)• 儲存在 Amazon S3 中的推斷和訓練驗證測試資料

您可以在 SageMaker 支持的任何地區開發和訓練您的產品。但是，在您可以發佈之前，您必須將所有資產複製到AWS Marketplace支援從發佈。

141

https://console.aws.amazon.com/support/home

https://docs.aws.amazon.com/general/latest/gr/sagemaker.html#limits_sagemaker

https://docs.aws.amazon.com/sagemaker/latest/dg/model-managed-spot-training.html

https://docs.aws.amazon.com/sagemaker/latest/dg/model-managed-spot-training.html

https://docs.aws.amazon.com/sagemaker/latest/dg/algos.html



https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#ec2-describe-regions

AWS Marketplace 賣方指南Troubleshooting

在刊登過程中，無論AWS您發佈的地區，您可以選擇AWS您想要發佈至其中並使您的產品可用性的區域。

Troubleshooting本節提供機器學習產品發佈程序期間可能會遇到的一些常見錯誤的說明。如果沒有列出您的問題，請聯絡AWS Marketplace賣方營運。

一般：在我的模型套件或算法中添加 Amazon Resource Name（ARN）AWS Marketplace管理入口網站

如果您使用 Amazon SageMaker 主控台建立資源，則必須選擇是在進程的最後一頁發佈此模型套件AWSMarketplace或是for將此演算法發佈於AWS Marketplace。您無法選擇否並稍後發佈它。選擇是不會發布模型包或算法。但是，它會在創建時驗證您的模型包或算法資源，這對於AWS Marketplace。

若您使用的是AWS開發套件建立模型套件或建立演算法，請確定參數CertifyForMarketplace已設定為true。

重新建立已認證且驗證的模型套件或演算法資源之後，請在AWS Marketplace管理入口網站。

一般：當我將模型包或算法的 ARN 添加到AWS Marketplace管理入口網站

這個錯誤可能有幾個原因：

• ARN 可能無效。請確定您使用的是正確的 ARN。• 對於模型套件，ARN 看起來應該類似於arn:aws:sagemaker:us-east-2:000123456789:model-package/my-model-package-name。

• 針對 Alm 演算法，ARN 應該類似arn:aws:sagemaker:us-east-2:000123456789:algorithm/my-algorithm。

• 模型套件或演算法資源不是在相同的AWS帳戶作為賣方帳戶。請確定所有要發佈的資源和資產都位於您要發佈的來源賣家帳戶中。

• 所以此AWS Identity and Access Management(IAM) 使用者或角色沒有存取模型套件或演算法資源的正確IAM 權限。確定您的 IAM 使用者或角色具有下列許可：• 對於模型套件，動作sagemaker:DescribeModelPackage必須允許在模型包資源上。• 對於算法，動作sagemaker:DescribeAlgorithm必須允許在演算法資源上。

一般：當我指定我的演算法產品的定價時，我收到 500 錯誤AWS Marketplace管理入口網站

當您嘗試發佈只有訓練影像且沒有隨附的推斷影像的演算法資源時，就會發生這個錯誤。發佈在演算法資源AWS Marketplace必須具有兩個元件。如需更多詳細資訊，請參閱準備您 SageMaker 產品 (p. 114)。

Amazon SageMaker: 我得到一個「客戶端錯誤：建立模型套件或演算法資源時拒絕存取登錄」失敗訊息

當用來建立模型套件或演算法的影像儲存在Amazon ECR儲存庫，屬於另一個AWS帳戶。模型套件或演算法驗證不支援跨帳戶映像。將映像複製到AWS帳戶，您用來發佈。然後，繼續使用新映像位置建立資源。

Amazon SageMaker: 我得到「未啟動」和「客戶端錯誤：沒有預約掃瞄...」當我創建模型包或算法資源時的失敗消息

當 SSageMaker 無法開始掃描存放在 Amazon ECR 中的 Docker 容器映像時，可能會發生此錯誤。若發生這種情況，請開啟Amazon ECR 控制台，找出上傳影像的目的地存放庫，選擇影像，然後選擇掃描。

ReportingAWS Marketplace會為您的 Amazon SageMaker 產品產生報告，其中包括有關買家、財務、使用量和稅金的資料。所有報告都可以在AWS Marketplace管理入口網站報告頁面。如需詳細資訊，請參閱「」賣方報告。

142



https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateAlgorithm.html#sagemaker-CreateAlgorithm-request-CertifyForMarketplace



http://aws.amazon.com/marketplace/management/reports


AWS Marketplace 賣方指南每日業務報告

下列小節摘要說明如何報告使用 SSageMaker 之機器學習產品的財務報告。

每日業務報告每日業務報告提供每位買方和產品的執行個體類型、使用時數、軟體費用收入，以及其他詳細資料。買家是以唯一且匿名的客戶參考 ID 來識別。如需詳細資訊，請參閱「」每日業務報告。

每月收入報告每月收入報告會提供給買家使用軟體的每月收入。如需詳細資訊，請參閱「」每月計費收入報告。

支付報告每月支付報告提供您在軟體費用的結算期間代表您收取的所有資金明細。報表中反映的總結算金額應與存入銀行帳戶的金額相符。如需詳細資訊，請參閱「」支付報告。

其他報告與分析如需其他可用的報告，請參閱賣方報告。

您也可以使用可用的資料饋送 (p. 207)fromAWS Marketplace。

143

https://docs.aws.amazon.com/marketplace/latest/userguide/daily-business-report.html

https://docs.aws.amazon.com/marketplace/latest/userguide/monthly-billed-revenue-report.html

https://docs.aws.amazon.com/marketplace/latest/userguide/monthly-disbursement-report.html


AWS Marketplace 賣方指南入門

軟體即服務 (SaaS) 型產品使用軟體即服務 (SaaS) 產品，您可以部署裝載在AWS基礎設施，並授予買方存取 AWS 環境中的軟體。您必須負責管理軟體內的客戶存取、帳號建立、資源佈建和帳號管理。

如需 SaaS 產品的協助，請請聯絡我們。

主題• 入門 (p. 144)• 規劃 SaaS 產品 (p. 149)• SaaS 產品指導方針 (p. 150)• 定價 SaaS 產品 (p. 152)• SaaS 客戶上線 (p. 155)• SaaS 產品的 Amazon SNS 通知 (p. 156)• 正在存取AWS Marketplace計量與權利服務 API (p. 157)• Reporting (p. 160)• 程式碼範例 (p. 161)• 使 AWS PrivateLink 時搭配AWS Marketplace (p. 164)

入門本章概述了 SaaS 產品如何為誰創建和維護它們的賣家工作。本節說明如何取得您的 SaaS 產品AWSMarketplace以及如何將其與適當的AWS MarketplaceAPI，以 SaaS 產品的計費模式為基礎。

Prerequisites開始之前，您必須完成下列先決條件：

1. 存取和使用AWS Marketplace管理入口網站。這是您用來註冊為賣家和管理您在AWS Marketplace。2. 註冊成為賣家，並提交稅務和銀行資料。如需更多詳細資訊，請參閱註冊 (p. 5)。3. 規劃如何建立 SaaS 產品，並將其整合至AWS Marketplace。如需更多詳細資訊，請參閱規劃 SaaS 產

品 (p. 149)。

若要開始，請選擇以下其中一項：• SaaS 訂閱 (p. 144)• SaaS 合約 (p. 146)• 含消費量的 SaaS 合約 (p. 147)

SaaS 訂閱若要列出並維護 SaaS 產品，並使用訂閱定價模型AWS Marketplace，請依照本主題中的程序進行。

開始之前，請確定您的 SaaS 產品已選擇正確的定價模式AWS Marketplace。如需更多詳細資訊，請參閱規劃 SaaS 產品 (p. 149)。

程序

144



AWS Marketplace 賣方指南SaaS 訂閱

• 列出您的 SaaS 訂閱產品AWS Marketplace (p. 145)• 進行 AWS 整合測試 (p. 145)• 檢閱 SaaSAWS Marketplace產品頁面上線前 (p. 146)

列出您的 SaaS 訂閱產品AWS Marketplace下列程序概述您必須採取的步驟 SaaS 才能在AWS Marketplace。

收集產品資訊

在建立產品之前AWS Marketplace，請收集以下資訊：

• 您可以將訂閱計費模型列為產品的 SaaS 應用程式AWS Marketplace。• 產品圖誌網址。可公開存取的 URL，其中包含您所提供產品之標誌的清晰影像。• 您產品的最終使用者授權合約 (EULA) URL。您的產品必須有 EULA，而且您必須提供該產品的連結，以

便客戶閱讀和檢閱您產品的AWS Marketplace(憑證已建立！) 頁面上的名稱有些許差異。• 您產品的註冊網址。這是客戶在訂閱您的產品後，系統會傳送給他們AWS Marketplace。• 關於產品的中繼資料，如AWS Marketplace管理入口網站• 產品的 Support 資訊。這包括您產品支援管道的電子郵件地址和 URL。

建立 SaaS 產品組合

取得您的 SaaS 應用程式資訊，並在AWS Marketplace管理入口網站

1. 登入AWS Marketplace管理入口網站。2. 適用於產品中，選擇SaaS。3. 適用於建立 SaaS 產品組合中，選擇SaaS 訂閱，然後選擇啟動。4. 閱讀並使用您收集的資訊填寫產品建立精靈。如需建立 SaaS 訂閱產品的協助，請聯絡我們。5. AWS Marketplace 營運團隊會將您的產品發佈為有限的產品階段，您和您允許檢視產品的任何 AWS 帳

戶都可以看見這些階段。

Note

您可以暫時降低價格，以便測試購買流程，而不會產生高額費用。如需詳細資訊，請參閱聯絡我們。

6. AWS Marketplace 營運團隊會將電子郵件傳送到與您 AWS 帳戶相關聯的地址，以便測試產品代碼、Amazon SNS 主題和產品頁面 URL。這是您產品在產品上線前所需的幾個測試中的第一個。

進行 AWS 整合測試建立產品後，您必須進行深入的 AWS 整合測試。

1. 透過訂閱您的產品，使用允許的帳戶來測試客戶體驗。2. 使用允許的帳戶訂閱之後，請確保帳戶重新導向至註冊 URL，並且重新導向是包含臨時權杖的 POST 請

求。然後，您的 SaaS 應用程式必須執行下列作業：

• 將權杖交換為customerID呼叫ResolveCustomer處理 AWS Marketplace Metering Service 中的動作。

• 持久性customerID在您的應用程序中以便將來的調用。3. 在上一步驗證測試帳戶後，將帳戶登錄到您的應用程序。例如，您可以讓測試客戶填寫表單來建立新的

使用者帳戶。或者，為他們提供其他後續步驟，以存取您的 SaaS 應用程式。

145





AWS Marketplace 賣方指南SaaS 合約

4. 登錄後，AWS 使用BatchMeterUsage處理 AWS Marketplace Metering Service 中的動作。建議您使用AWS CloudTrail監控活動，以確保將帳單資訊傳送至 AWS。當送出計量記錄時，請謹記下列事項：

• 計量要求會在小時上移除重複。• 每小時傳送的記錄是累計的。• 即使在過去一小時內沒有記錄，我們強烈建議您每小時傳送計量傳送記錄的最佳作法。

5. 設定 Amazon SQS 佇列並訂閱產品的 Amazon SNS 主題，以測試訂閱變更。Amazon SNS 主題提供有關客戶訂閱變更的通知。這可讓您知道何時提供及撤銷特定客戶的存取權。可能的案例包括取消訂閱、成功的訂閱和失敗的訂閱。

6. 驗證訂閱成功。在您收到含有成功訂閱訊息的測試帳戶 Amazon SNS 通知後，就可以開始計量。在收到Amazon SNS 通知之前，傳送至 AWS Marketplace 計量服務的記錄不會計量付費。

Note

為了避免計費問題，我們強烈建議您在代表客戶啟動資源之前，以程式設計方式等候此通知。7. 完成所有整合要求並測試解決方案後，請通知 AWS Marketplace 營運團隊。他們會在解決方案上執行一

系列的最終測試，方法是確認您已成功傳送計量付費記錄BatchMeterUsage動作。

如需其他資訊，請參閱使用方式的計量 (p. 157)。

檢閱 SaaSAWS Marketplace產品頁面上線前端對端測試完成後，您需要檢視產品頁面與原始價格。在您核准頁面之後，AWS Marketplace 營運團隊會將產品頁面放在AWS Marketplace。此時，客戶可以開始探索並訂閱您的產品。

SaaS 合約若要使用合約定價模型列出並維護 SaaS 產品，請參閱AWS Marketplace，請依照本主題中的程序進行。


程序• 列出您的 SaaS 合約產品AWS Marketplace (p. 146)• 進行 AWS 整合測試 (p. 147)• 檢閱 SaaSAWS Marketplace產品頁面上線前 (p. 147)

列出您的 SaaS 合約產品AWS Marketplace下列程序概述您必須採取的步驟，才能列出您的 SaaS 合約產品AWS Marketplace。

收集產品資訊


• 您可以將合約計費模型列為產品的 SaaS 應用程式AWS Marketplace。• 產品圖誌網址。可公開存取的 URL，其中包含您所提供產品之標誌的清晰影像。• 您產品的最終使用者授權合約 (EULA) URL。您的產品必須有 EULA，而且您必須提供該產品的連結，以


146

AWS Marketplace 賣方指南含消費量的 SaaS 合約

建立 SaaS 產品組合取得您的 SaaS 應用程式資訊，並在AWS Marketplace管理入口網站

1. 登入AWS Marketplace管理入口網站。2. 適用於產品中，選擇SaaS。3. 適用於建立 SaaS 產品組合中，選擇SaaS 合約，然後選擇啟動。4. 閱讀並使用您先前收集的資訊填寫產品建立精靈。如需建立 SaaS 合約產品的協助，請聯絡我們。5. AWS Marketplace 營運團隊會將您的產品發佈為有限的產品階段，讓您和您允許檢視產品的任何 AWS

帳戶。Note

您可以暫時降低價格，以便測試購買流程而不會產生高額費用，請聯絡我們以獲取更多資訊。6. AWS MP Ops 團隊將傳送電子郵件到與您 AWS 帳戶相關聯的地址，以便測試產品代碼、Amazon SNS

主題和產品頁面 URL。這是您產品在產品上線前所需的幾個測試中的第一個。

進行 AWS 整合測試一旦產品建立完成，就可以開始更深入的測試。必須完成下列測試：

1. 使用允許的帳戶，藉由取得產品的合約來測試客戶體驗。2. 一旦帳戶有合約，請確保帳戶被重定向到註冊 URL，並且重定向是包含臨時令牌的 POST 請求。然後，

您的 SaaS 應用程序必須：

• 將權杖交換為customerID呼叫ResolveCustomer處理 AWS Marketplace Metering Service 中的動作。

• 持久性customerID在您的應用程序中以便將來的調用。• 使用customerID，呼叫GetEntitlement中的AWS Marketplace Entitlement Service以驗證客戶訂

閱的維度以及數量 (如果適用)。3. 在上一步驗證測試帳戶後，將帳戶登錄到您的應用程序。例如，您可以讓測試客戶填寫表單來建立新的

使用者帳戶。或提供他們其他後續步驟，以存取您的 SaaS 應用程式。4. 如果沒有從GetEntitlement，無論是在上線期間或進行中的驗證通行證中，都會決定如何管理無權使

用者的存取權和體驗。5. 設定 Amazon SQS 佇列並訂閱產品的 Amazon SNS 主題，以測試訂閱變更。Amazon SNS 主題提供有

關客戶訂閱變更的通知。這可讓您知道何時提供及撤銷特定客戶的存取權。可能的案例包括取消訂閱、成功訂閱和失敗的訂閱。

6. 完成所有整合要求並測試解決方案後，請通知 AWS Marketplace Ops 團隊。然後，他們將通過驗證您已成功調用GetEntitlement和足夠的新客戶。他們也會驗證您已透過BatchMeterUsage。

如需其他資訊，請參閱檢查權利 (p. 158)。

檢閱 SaaSAWS Marketplace產品頁面上線前端對端測試完成後，您將有機會查看產品頁面與原始價格。獲得核准後，AWS Marketplace 作業團隊將使產品頁面在AWS Marketplace。此時，客戶可以開始探索並訂閱您的產品。

含消費量的 SaaS 合約若要列出並維護 SaaS 產品與使用量定價模型的合約AWS Marketplace遵循本主題中的程序進行。


147



AWS Marketplace 賣方指南含消費量的 SaaS 合約

程序• 列出您的 SaaS 合約產品AWS Marketplace (p. 148)• 進行 AWS 整合測試 (p. 148)• 檢閱 SaaSAWS Marketplace產品頁面上線前 (p. 149)

列出您的 SaaS 合約產品AWS Marketplace下列程序概述了您必須採取的步驟，以列出您的 SaaS 合約與消費產品AWS Marketplace：

收集產品資訊


• 您可以將其列為產品的 SaaS 應用程式，其中包含使用計費模式AWS Marketplace。• 產品圖誌網址。可公開存取的 URL，其中包含您所提供產品之標誌的清晰影像。• 您產品的最終使用者授權合約 (EULA) URL。您的產品必須有 EULA，而且您必須提供該產品的連結，以


建立 SaaS 產品組合

取得您的 SaaS 應用程式資訊，並在AWS Marketplace管理入口網站

1. 登入AWS Marketplace管理入口網站。2. 從產品下拉式功能表，選擇SaaS。3. 從建立 SaaS 產品組合中，選擇SaaS 合約，然後選擇啟動。4. 閱讀並使用您先前收集的資訊填寫產品建立精靈。如需建立 SaaS 合約產品的協助，請聯絡我們。5. AWS MP Ops 團隊會將您的產品發佈為有限的產品階段，讓您和您允許檢視產品的任何 AWS 帳戶。

Note

您可以暫時降低價格，以便測試購買流程而不會產生高額費用，請聯絡我們以獲取更多資訊。6. AWS MP Ops 團隊將傳送電子郵件到與您 AWS 帳戶相關聯的地址，以便測試產品代碼、Amazon SNS

主題和產品頁面 URL。這是您產品在產品上線前所需的幾個測試中的第一個。

進行 AWS 整合測試一旦產品建立完成，就可以開始更深入的測試。必須完成下列測試：

1. 使用允許的帳戶，藉由取得產品的合約來測試客戶體驗。2. 一旦帳戶有合約，請確保帳戶被重定向到註冊 URL，並且重定向是包含臨時令牌的 POST 請求。然後，

您的 SaaS 應用程序必須：

• 將權杖交換為customerID呼叫ResolveCustomerAWS Marketplace。• 持久性customerID在您的應用程序中以便將來的調用。• 使用customerID，呼叫GetEntitlement中的AWS Marketplace Entitlement Service以驗證客戶訂

閱的維度以及數量 (如果適用)。3. 在上一步驗證測試帳戶後，將帳戶登錄到您的應用程序。例如，您可以讓測試客戶填寫表單來建立新的

使用者帳戶。或提供他們其他後續步驟，以存取您的 SaaS 應用程式。

148



AWS Marketplace 賣方指南規劃 SaaS 產品

4. 如果沒有從GetEntitlement，無論是在上線期間或進行中的驗證通行證中，都會決定如何管理無權使用者的存取權和體驗。

5. 登錄後，將計量記錄傳送至 AWS 以供計費用，使用BatchMeterUsageAWS Marketplace。建議您使用AWS CloudTrail監控活動，以確保將帳單資訊傳送至 AWS。當送出計量記錄時，請謹記下列事項：

• 計量要求會在小時上移除重複。• 每小時傳送的記錄是累計的。• 即使在過去一小時內沒有記錄，我們強烈建議您每小時傳送計量傳送記錄的最佳作法。

6. 設定 Amazon SQS 佇列並訂閱您的產品 Amazon SNS 主題。這些主題提供有關客戶訂閱和權益狀態變更的通知。這可讓您知道何時提供及撤銷特定客戶的存取權。可能的案例包括：取消訂閱、升級、續約和失敗的訂閱。

7. 完成所有整合要求並測試解決方案後，請通知 AWS Marketplace Ops 團隊。然後，他們將通過驗證您已成功調用GetEntitlement和足夠的新客戶。他們也會驗證您已透過BatchMeterUsage。

如需其他資訊，請參閱檢查權利 (p. 158)。

檢閱 SaaSAWS Marketplace產品頁面上線前端對端測試完成後，您將有機會查看產品頁面與原始價格。獲得核准後，AWS Marketplace 作業團隊將使產品頁面在AWS Marketplace。此時，客戶可以開始探索並訂閱您的產品。

規劃 SaaS 產品在您將 SaaS 產品新增至AWS Marketplace，您必須先做一些規劃。這個步驟對您的產品成功至關重要。缺乏規劃可能會導致計費問題，或者您可能必須在AWS Marketplace。

Important

大部分產品的設定都無法在您設定之後變更。如果您需要在建立產品之後變更它們，請在AWSMarketplace，則您可能需要建立具有正確設定的新產品。

規劃定價SaaS 產品有三種定價選項AWS Marketplace。為您的產品選擇正確的定價模式是您最重要的決定。選擇錯誤的定價模型可能會讓您回復數週，因為它會決定客戶的付款選項，以及撰寫、測試和部署所需的計費整合代碼。

• SaaS 訂閱— 一種隨用隨付模式，讓買方按小時使用您的 SaaS 產品計費。• SaaS 合約— 我們會預先向買家收取使用您的軟體費用，或者您可以為他們提供靈活的付款時間表。• SaaS 合約與按用量付費— 此選項與標準合約類似，但您的客戶也可以支付超出合約的額外使用量。這是

一個混合定價選項，可為您的客戶提供最多的定價選項，而且您需要最多的整合代碼。

如需定價的詳細資訊，請參閱定價 SaaS 產品 (p. 152)。

規劃您的帳單整合具有 SaaS 產品的好處之一AWS Marketplace正在合併帳單。若要利用此權益，您必須與 AWS Marketplace計量服務或AWS Marketplace Entitlement Service，視您選擇的定價模式而定。這兩項服務可協助您確保帳單和使用量報告準確無誤。

規劃整合之後，您必須在產品上線前測試與產品的整合。如需整合與測試的詳細資訊，請參閱正在存取AWSMarketplace計量與權利服務 API (p. 157)。

149

AWS Marketplace 賣方指南規劃您的 Amazon SNS 整合

規劃您的 Amazon SNS 整合您可以為 SaaS 產品訂閱兩個 Amazon SNS 主題。這些訊息可協助您以程式設計方式處理 AWS 或客戶啟動的訂閱和合約變更。您可以使用這些 Amazon SNS 通知做為程式化觸發器，讓客戶能夠在產品註冊網站上註冊新帳戶，拒絕訂閱到期的客戶存取您的產品，具體取決於您的程式處理這些通知的方式。

規劃客戶存取您產品的方式本節說明如何讓買方存取您的產品。

規劃您的 SaaS 產品註冊網站購買 SaaS 產品的客戶需要存取它。您必須規劃和實作您希望客戶存取產品的方式。SaaS 產品支援下列存取選項：

• AWS PrivateLink• 您自己的產品網站

使用AWS PrivateLink讓客戶存取您的 SaaS 產品

您可以使用使 AWS PrivateLink 時搭配AWS Marketplace (p. 164)將您的服務設定為 Amazon VirtualPrivate Cloud (Amazon VPC) 端點服務。您的客戶可以建立 VPC 端點，並透過 AWS 雲端虛擬網路存取您的軟體。或者，您可以透過您擁有和維護的網站提供對軟體產品的存取權，讓客戶透過網際網路建立連線。

使用自有註冊網站

您的 SaaS 產品代管在您的環境中，而且必須透過您管理和維護的公用端點 (例如網站) 透過網際網路存取該產品。一般而言，您的網站可供客戶註冊您的產品、登入以使用產品，以及存取產品的支援。為了簡單起見，此端點將被稱為您的註冊網站。

如果您選擇此存取選項，且您的產品還沒有註冊網站，則您需要建立一個網站。當你有一個註冊網站後，你的網站必須被編程為驗證的客戶，每當他們訪問你的註冊頁面。

使用您的註冊網站驗證客戶

1. 接受包含臨時令牌的 POST 請求x-amzn-marketplace-token。2. 將權杖交換為customerID呼叫ResolveCustomerAWS Marketplace Metering Service 中。3. 在取得customerID，將其保存在您的應用程序中以供將來的調用。4. 使用customerID，呼叫GetEntitlement中的AWS Marketplace Entitlement Service以驗證客戶訂閱的維

度和數量。5. 確認客戶的存取權和權益後，請規劃您的應用程式，以確保客戶不會超過他們有權獲得的權益。

SaaS 產品指導方針AWS Marketplace維護所有 SaaS 產品和產品的這些準則，AWS Marketplace，為我們的客戶推廣一個安全、安全和值得信賴的平台。

所有產品及其相關中繼資料在提交時都會進行審核，以確保產品符合或超過目前AWS Marketplace指導方針。這些準則經過審查和調整，以滿足我們不斷演變的安全性需求。除此之外，AWS Marketplace持續審查產品，以確認產品符合這些準則的任何變更。如果產品不符合規定，我們可能會要求您更新產品，在某些情況下，您的產品可能會暫時無法供新訂閱者使用，直到問題解決為止。

150

https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html

https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html

AWS Marketplace 賣方指南產品設定指導方針

產品設定指導方針所有 SaaS 產品皆須遵守下列產品設定指導方針：

• 至少有一個定價維度的價格必須大於 $0.00。• 所有定價維度必須與實際軟體相關，且不得包含與軟體無關的任何其他產品或服務。• SaaS 產品獨家提供AWS GovCloud (US)區域必須包含GovCloud某處的產品標題。

客戶資訊要求所有 SaaS 產品皆須符合下列客戶資訊要求：

• SaaS 產品必須完全透過AWS Marketplace。• 您無法隨時收集 SaaS 產品的客戶付款資訊，包括信用卡和銀行帳戶資訊。

產品使用指導方針所有 SaaS 產品皆須遵守下列產品使用指導方針：

• 訂閱產品後AWS Marketplace，客戶應該能夠在 SaaS 應用程式中建立帳戶，並在兩個工作天內存取 Web主控台。如果客戶無法立即取得應用程式的存取權，您必須提供訊息，說明他們何時可取得存取權限。建立帳戶後，必須傳送通知給客戶，確認他們的帳戶已建立，以及清除後續步驟。

• 如果客戶已在 SaaS 應用程式中擁有帳戶，則必須具備從履行登陸頁面登入的能力。• 客戶必須能夠在 SaaS 應用程式中查看其訂閱狀態，包括任何相關合約或訂閱使用資訊。• 客戶必須能夠輕鬆取得如下問題的協助：使用應用程式、疑難排解以及申請退款 (如果適用)。必須在履行

登陸頁面上指定 Support 連絡人選項。

架構指導方針所有 SaaS 產品皆須遵守下列架構指導方針：

• 部分應用程式必須託管在您擁有的 AWS 帳戶中。• 所有應用程式元件都應該裝載在您管理的基礎結構中。需要客戶基礎結構中額外資源的應用程式必須遵循

下列準則：• 以安全的方式佈建資源，例如使用AWS Security Token Service(AWS STS) 或AWS Identity and Access

Management（我）。• 提供其他文件，包括所有已佈建 AWS 服務的說明、IAM 政策聲明，以及如何在客戶帳戶中部署和使用

IAM 角色或使用者。• 在產品說明中包含通知，說明如果客戶在 AWS Marketplace 交易中產生額外的 AWS 基礎設施費用，則

需負責支付額外的基礎設施費用。• 如果您的產品部署代理程式，您必須向客戶提供說明如何在其 AWS 帳戶中部署代理程式的指示。• 需要在客戶基礎結構中執行資源的應用程式，將由AWS Marketplace，這可能需要 2-4 週的時間。

• 成功地呼叫AWS Marketplace註冊為提供者並提交 SaaS 發佈請求的 AWS 帳戶中的 API。SaaS 定價模型決定應該呼叫哪些 API：• SaaS 合約 —GetEntitlements中的AWS Marketplace Entitlement Service。• SaaS 與消費合約 —GetEntitlements中的AWS Marketplace Entitlement Service和BatchMeterUsage在

AWS Marketplace Metering Service 中。• SaaS 訂閱 —BatchMeterUsage在 AWS Marketplace Metering Service 中。

151



https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html


AWS Marketplace 賣方指南定價 SaaS 產品

• SaaS 產品獨家提供AWS GovCloud (US)區域必須概述其他 AWS 區域和AWS GovCloud (US)區域、產品使用案例，以及產品不建議使用的工作負載。

定價 SaaS 產品買方在取得您的 SaaS 產品後，AWS Marketplace、AWS Marketplace會沿著他們的帳單識別器傳遞。您可以使用帳單識別碼呼叫AWS Marketplace權利服務和AWS Marketplace計量服務。然後，客戶可以在AWS環境中，或透過您建立的 VPC 端點連線。AWS Marketplace為 SaaS 產品提供下列定價模式：

• SaaS 訂閱— 一種隨用隨付模式，我們會根據買方的 SaaS 產品每小時使用量向買方收取費用。• SaaS 合約— 我們會預先向買家收取使用您的軟體費用，或者您可以為他們提供靈活的付款時間表。客戶

也可以支付超出合約的額外使用量。

若要讓您的 SaaS 產品在AWS Marketplace，請決定您是否要提供 SaaS 訂閱定價模型或 SaaS 合約定價模型。

主題• SaaS 訂閱的定價 (p. 152)• SaaS 合約的定價 (p. 153)

SaaS 訂閱的定價對於 SaaS 訂閱，AWS Marketplace根據您傳送給我們的計量記錄向您的客戶收費。您必須執行下列作業，才能發佈訂閱型 SaaS 產品：

1. 建立新的 SaaS 產品，在AWS Marketplace管理入口網站，並記下其產品代碼。2. 使用必要的資訊完成精靈。

若要設定定價，請選取最能描述產品定價的類別。定價類別會出現在AWS Marketplace網站。您可以選擇頻寬 (GBP、MBP)、資料 (GB、MB、TB)、主機、要求、階層或使用者。如果沒有任何預先定義的類別符合您的需求，您可以選擇更通用的單位類別。

接著就要定義您的定價維度。每個定價維度都代表您可以設定每單位價格的功能或服務。維度範例包括使用者、已掃描的主機以及內嵌的 GB 記錄檔。您最多可以定義 24 個維度。您必須針對您定義的每個維度新增下列資訊：

• 維度 API 名稱— 將計量記錄傳送至AWS Marketplace計量服務。此名稱指出客戶所使用的維度。此名稱會顯示在帳單報告中。因為您是唯一可以存取報表的人，所以這個名稱不一定要讓讀者更容易閱讀。設定名稱後，您即無法變更名稱。

• 維度說明— 描述產品維度的客戶面向陳述式。說明 (管理員每小時、佈建的 Mbps 頻寬等) 不得超過 70 個字元，而且應該是易於使用的。產品發佈後，您即無法變更此說明。

• 維度價格— 本產品每單位的軟體費用，以美元計算。這個費爾德支持三位小數。

SaaS 訂閱結束時客戶可以透過AWS Management Console。

1. 您的 SaaS 產品會傳送unsubscribe-pending透過 Amazon SNS 主題為該客戶提供通知。2. 您有一個小時來計量客戶的任何剩餘使用量。3. 在這個小時之後，您會收到unsubscribe-success通知。此時，您即無法再傳送此客戶的計量記錄。

152


AWS Marketplace 賣方指南SaaS 合約的定價

您可以自行決定如何處理已取消訂閱的客戶，以停用 SaaS 產品的功能。例如，您的產品可能會完成客戶現有的工作，但會阻止他們建立工作。您可能想要向客戶顯示其使用已停用的訊息。客戶可以透過AWSMarketplace。

取消訂閱

客 SaaS 透過您的 Marketplace 軟體的頁面AWS Marketplace網站。當客戶取消訂閱時，您會收到通知，而且您有 1 小時的時間可以為客戶傳送最初的計量記錄。您從您的產品通知客戶取消正在進行中。如果客戶表示他們想要透過您的產品取消，請將客戶導向AWS Marketplace。為確保未來不會收取任何費用，客戶須於AWS Marketplace。

客戶可以要求取消和退款 SaaS 合約產品，但AWS Support。客戶必須在 48 小時內透過AWS Support。全額或按比例分配的退款通常會在 3 至 5 個工作天內核准。當客戶取消合約時，您會收到通知，並且您有 1 小時的時間向客戶發送最後的計量記錄，以支付任何額外的使用費用。

SaaS 合約的定價對於 SaaS 合約，AWS Marketplace根據您與客戶之間的合約，預先向客戶收取費用，或依您定義的付款排程收取費用。在那之後，他們有權利使用這些資源。如需超出合約的額外使用量，AWS Marketplace根據我們透過AWS Marketplace計量服務。

1. 建立新的 SaaS 產品，在AWS Marketplace管理入口網站，並記下其產品代碼。2. 使用必要的資訊完成精靈。

若要設定定價，請選擇您為客戶提供的一個或多個合約期限。您可以為每個合約期間輸入不同的價格。您可以選擇每月、1 年、2 年和 3 年的持續時間，或以月為單位的自訂持續時間 (最多 60 個月)。

選擇最符合您產品定價的類別。定價類別會出現在AWS Marketplace網站。您可以選擇頻寬 (GB/s、MB/s)、資料 (GB、MB、TB)、主機、要求、階層或使用者。如果沒有任何預先定義的類別符合您的需求，您可以選擇更通用的單位類別。

適用於啟用階層式維度，請從下列選項中選擇您希望客戶能夠如何購買您的產品：

• 買家只可以選擇一種提供的等級— 客戶從包含不同功能、服務和使用量的選項中選擇一個層級。• 買家可以選擇一個或多個選項— 客戶可以為您提供的每個定價維度選取數量。

選擇類別之後，請定義您的定價範圍。每個定價維度都代表一項功能或服務，您可以為其設定每單價。維度範例包括使用者、已掃描的主機和內嵌的記錄檔。對於您定義的每個維度，您可以新增名稱、描述、價格和API 名稱。系統會向客戶顯示名稱、价格和描述。您可以使用 API 名稱來追蹤和報告AWS Marketplace如下所示：

• 呼叫AWS Marketplace權利服務以擷取客戶購買的尺寸。• 呼叫AWS Marketplace計量服務，以指出客戶使用的維度。

對於您新增至合約的每個定價維度，您可以選擇讓客戶按照他們的合約上方該維度的額外使用量付費。您也可以新增不含合約價格的額外維度，而客戶只需按使用量付費即可使用。

使用精靈為 SaaS 產品建立合約時，您必須為定價維度定義下列欄位：

• 維度 API 名稱— 呼叫權利 API 時使用的名稱。此名稱會顯示在帳單報告中，且報告並非面向外部。API 名稱的最大長度為 15 個字元，在您設定名稱之後，就無法變更。

• 維度顯示名稱：— 維度的客戶面向名稱。此名稱應該可協助客戶瞭解產品的維度。該名稱應該是用戶友好的，最大長度為 24 個字符。此值可變更。

153

https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/Welcome.html


AWS Marketplace 賣方指南SaaS 合約的定價

• 維度說明：— 維度對客戶的說明，提供有關產品維度的其他資訊。描述的長度上限為 70 個字元。• 維度-每月價格— 針對此維度的 1 個月選項，每單位的軟體費用。這個費爾德支持三位小數。• 尺寸-1 年價格— 針對此維度的 12 個月選項，每單位的軟體費用。這個費爾德支持三位小數。這不是每月

收費。價格必須以 12 個月一次性收費價格為準。• 尺寸-2 年價格— 針對此維度的 24 個月選項，每單位的軟體費用。這個費爾德支持三位小數。• 尺寸-3 年價格— 此維度 36 個月選項的每單位軟體費用。這個費爾德支持三位小數。

範例：資料儲存體

每月價格 12 個月價格 24 個月價格額外使用率的按用量付費

未加密的資料 (GB) $1.50 16.00 美元/每 GB 每 GB 300 美元每小時 0.1/GB

加密的資料 (GB) 1.5 美元 16.60 美元每秒 31.20 美元每小時 0.11/GB

範例：日誌監控產品

每月價格 12 個月價格額外使用率的按用量付費

基本 (監控 10 台主機、監控 5 個容器)

$100 1000

標準 (監控 20 台主機、監控 10 個容器)

$200 2000

專業版 (監控 40 台主機，監控 20 個容器)

400 4000

每小時監控的其他主機 0.1

每小時監控額外的容器 0.2

Note

價格可以是以下持續時間：1 個月、12 個月、24 個月或 36 個月。您可以選擇為您的產品提供一個或多個這些選項。每個維度的持續時間必須相同。例如，如果您有ReadOnlyUsers和AdminUsers維度，如果您為 ReadOnlyUsers 提供年度價格，則必須提供AdminUsers，也是如此。

Upgrades客戶可以將合約升級至較高價值之一，但持續時間較長。例如，它們可以升級為更高數量或更高價值的權利。客戶會按比例計算現有合約的信用額度。客戶無法減少其現有合約的大小。他們只能在續約時減少大小，或取消續約。

您的 SaaS 產品會驗證權利，因此會呼叫AWS Marketplace Entitlement Service。

自動續約當客戶透過AWS Marketplace使用 SaaS 合約，他們可以同意自動續約合約條款。客戶繼續支付每月或 1年、2 年或 3 年的權利費用。客戶永遠可以選擇修改續約設定。他們可以取消續訂或續訂合同不同的數量和持續時間。

154

AWS Marketplace 賣方指南SaaS 客戶上線

SaaS 合約結束時SaaS 合約產品具有合約到期。當合約結束時，會發生下列事件：

1. 您的 SaaS 產品會收到entitlement-updated通知，指出其權利已變更，且AWS Marketplace權利服務會傳回空回應。

2. 您有一個小時來計量客戶的任何剩餘使用量。3. 在此之後，您就無法再傳送此客戶的計量記錄。

SaaS 客戶上線透過 SaaS 訂閱和 SaaS 合約，您的客戶可透過AWS Marketplace，但存取AWS環境。訂閱產品後，您的客戶會被導向至您建立和管理的網站，作為 SaaS 產品的一部分，以註冊他們的帳戶並設定該產品。

建立產品時，您會提供註冊登陸頁面的 URL。在客戶訂閱後，我們會使用該 URL 將客戶重新導向至您的註冊登陸頁面。在您的軟體註冊 URL 上，您會收集為客戶建立帳戶所需的任何資訊。如果您打算透過電子郵件連絡客戶以取得使用通知，我們建議您收集客戶的電子郵件地址。

註冊登陸頁面必須能夠識別並接受x-amzn-marketplace-token標記中的表單資訊AWS Marketplace與客戶的身分識別器進行計費。然後它應該將該令牌值傳遞給AWS Marketplace計量服務及AWS Marketplace權利服務 API 來解析唯一的客戶識別器和對應的產品代碼。如需程式碼範例，請參閱「ResolveCustomer 程式碼範例 (p. 161)」。

設定您的 SaaS 產品以接受新買家您必須負責正確設定 SaaS 軟體，以接受新客戶並適當地計量。下列程序概述了識別、實作及計量新客戶對軟體的存取權的建議方式：

1. 當客戶造訪您在AWS Marketplace網站，他們會選擇訂閱您的產品。2. 客戶的AWS帳戶已訂閱您的產品。這表示從您的產品傳送的計量記錄會成為客戶AWS法案。3. 註冊令牌是為包含其客戶識別器到您的網站的客戶生成的。4. 客戶會被重新導向至您的軟體註冊 URL。此頁面必須能夠接受與客戶的身份識別器的令牌。5. 客戶的瀏覽器將 POST 請求發送到您的 SaaS 註冊 URL。該請求包含一個 POST 參數x-amzn-Limzn-

In，其中包含客戶的註冊令牌。從您的註冊網站的角度來看，客戶已經提交了一份帶有此參數的表單。註冊標記是一個不透明的字符串。

6. 若要將此 Token 兌換為客戶識別碼和產品代碼，您的網站必須呼叫ResolveCustomer在AWSMarketplace計量服務。客戶身分識別器不是客戶的AWS帳戶 ID，但它在產品之間是通用的。產品代碼是 SaaS 產品的唯一字符串，AWS提供給您。EACSAWS產品有一個唯一的產品代碼，這是在註冊時指派給您的。

Note

若要查看ResolveCustomer呼叫，請參閱ResolveCustomer 程式碼範例 (p. 161)。7. 您的網站會驗證產品代碼是否符合您的 SaaS 產品識別碼。您的網站必須在客戶的工作階段中保留此客

戶的身分識別器。它可以暫時儲存在您的伺服器上，也可以是客戶瀏覽器上已簽署的工作階段 Cookie的一部分。

8. 系統會指示客戶在您的產品中建立帳戶或登入現有帳戶。9. 客戶現在已使用該 SaaS 產品的特定憑證登入您的網站。在您的帳戶資料庫中，您可以為每個客戶建立

一列。您的帳戶資料庫必須具有AWS客戶身分識別器，您會填入您在步驟 2 中取得的客戶身分識別器。確認您系統中沒有其他帳戶共用此客戶身分識別器。否則，您可能會發送計量量測記錄。

10. 在您的賣家註冊過程中，系統會為您指派一個 Amazon SNS 主題，在客戶訂閱或取消訂閱您的產品時通知您。此通知是 JSON 格式的 Amazon SNS 通知，可通知您客戶動作。

155


AWS Marketplace 賣方指南SaaS 產品的 Amazon SNS 通知

我們建議您使用 Amazon Simple Queue Service (Amazon SQS) 來擷取這些訊息。在您收到訂閱通知後subscribe-success，則客戶帳戶已準備好進行計量。您在此通知之前傳送的記錄不會計量付費。如需如何進行該服務的詳細資訊，請參閱步驟 2：將許可提供給 Amazon SNS 主題，以將訊息傳送至Amazon SQS 佇列中的Amazon Simple Notification Service 開發人員指南。

如果您有 SaaS 合約產品，您還可以獲得entitlement-updated建立合約時的通知。您的帳戶資料庫必須有訂閱狀態的額外欄位。以下是subscribe-success訂閱通知。

{ "action": "subscribe-success", "customer-identifier": "T1EXAMPLEjM0MTIzNDEyMzQtNTY3ODU2ODc1EXAMPLENj", "product-code": "72EXAMPLE2dgb8dfEXAMPLEmn" }

Note

請勿啟用產品訂閱，除非您收到SUBSCRIPTION_SUCCESSFUL通知。11. 使用儲存在資料庫中的客戶識別器，透過AWS Marketplace計量服務，或透過AWS Marketplace權利服

務。

安全性與排序作為賣家，您有責任只信任立即從AWS或您的系統已簽署的內容。我們建議您立即解決登錄權杖，因為它會在 1 小時後過期。解析註冊權杖後，請將客戶識別器儲存為客戶瀏覽器工作階段上的已簽署屬性，直到註冊完成為止。

SaaS 產品的 Amazon SNS 通知若要接收通知，您可以訂閱AWS MarketplaceAmazon Simple Notification Service (Amazon SNS) 主題會在產品建立期間提供給您。主題提供有關客戶訂閱和合約權益狀態變更的通知。這可讓您知道何時提供及撤銷特定客戶的存取權。

下列 Amazon SNS 主題適用於軟體即服務 (SaaS) 產品：

• aws-mp-entitlement-notification— 此 Amazon SNS 主題適用於 SaaS 合約。• aws-mp-subscription-notification— 此 Amazon SNS 主題適用於 SaaS 訂閱和額外消費的合

約。

Note

如果您的產品定價為含消費的 SaaS 合約，您必須使用這兩個主題。

SaaS 產品 Amazon SNS 訊息主體SaaS 產品 Amazon SNS 通知的每個訊息格式如下。

{ "action": "action-name", "CustomerIdentifier": " X01EXAMPLEX", "ProductCode": "n0123EXAMPLEXXXXXXXXXXXX"}

156

https://docs.aws.amazon.com/sns/latest/dg/sns-sqs-as-subscriber.html#SendMessageToSQS.sqs.permissions

https://docs.aws.amazon.com/sns/latest/dg/sns-sqs-as-subscriber.html#SendMessageToSQS.sqs.permissions

AWS Marketplace 賣方指南SaaS 產品 Amazon SNS 行動

所以此文文文文會根據訊息而有所不同。下列主題會列出可能的動作。

SaaS 產品 Amazon SNS 行動身為 SaaS 合約提供者，您會收到entitlement-updated動作。當您收到其中一個訊息時，後續呼叫GetEntitlement AWS Marketplace Entitlement Service動作才能探索更新的內容。

如果您提供 SaaS 訂閱產品 (或含消費產品的 SaaS 合約)，您會收到包含下列動作的訊息：

• subscribe-success

• subscribe-fail

• unsubscribe-pending

• unsubscribe-success

訂閱 SQS 佇列至 SNS 主題我們建議您訂閱 Amazon SQS 佇列至所提供的 SNS 主題。如需建立 SQS 佇列及訂閱所提供主題之佇列的詳細指示，請參閱訂閱 Amazon SQS 佇列至 Amazon SNS 主題中的Amazon Simple Notification Service 開發人員指南。

輪詢 SQS 佇列以尋找通知最後，您需要定義一個不斷輪詢隊列的服務，查找消息，並相應地處理它們。

正在存取AWS Marketplace計量與權利服務 API本節概述與 AWS Marketplace 計量服務或AWS Marketplace Entitlement Service，用於確保您對 SaaS 產品的客戶使用量的計費和報告準確無誤。假設您已提交 SaaS 訂閱產品或已發佈至有限狀態的 SaaS 合約產品。在有限的狀態下，您可以使用測試帳戶來驗證正確的組態和功能，但您的產品無法公開使用。

主題• 使用方式的計量 (p. 157)• 檢查權利 (p. 158)• SaaS 產品整合檢查清單 (p. 159)

如需設定AWS CLI，以及認證，請參閱設定AWS CLI中的AWS Command Line Interface使用者指南。如果您是初次使用AWSPython 軟件開發套件，請參閱博托 3快速指南。

使用方式的計量對於軟體即服務 (SaaS) 訂閱，您可以計量所有使用量，然後依AWS根據您提供的計量記錄。對於 SaaS 合約，您只會計算客戶合約權利以外的使用量。當客戶的應用程式計量使用量時，您的應用程式會提供AWS，並累積使用量。您在建立產品時定義的定價維度應用程式計量，例如已傳輸的 GB 或在指定小時內掃描的主機。例如，如果您根據傳送至應用程式的資料量來收費，則可以測量資料量並每小時傳送一次對應的計量記錄。AWS會使用計量資料以及您在建立產品時提供的價格，來計算客戶的帳單。

Note

或者，您可以將使用情況分割到您追蹤的屬性。這些屬性會以標籤形式公開給買方。這些標籤允許買方查看他們的成本按標籤值分成用量。例如，如果您依使用者收費，且使用者擁有「部門」屬性，您可以使用索引鍵為「部門」的標記和每個值一個配置來建立流量配置。這不會變更您報告的價格、維度或總使用量，但可讓您的客戶依適合您產品的類別來檢視其成本。

157


https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html

https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html

https://boto3.readthedocs.io/en/latest/guide/quickstart.html

AWS Marketplace 賣方指南檢查權利

我們建議您每小時傳送一筆計量記錄，讓客戶盡可能精細地掌握其使用量和成本。如果您彙總超過一小時的時間週期 (例如，一天)，請繼續每小時傳送計量記錄，如果該小時沒有用量可報告，則記錄數量為 0。將用量報告至AWS，每小時為您的所有客戶，每次最多可分批 25 個。

AWS只能在收到您的計量記錄後，向客戶收取產品的使用量。您必須負責確保產品的計量記錄成功傳輸和接收。您可以使用AWS CloudTrail以確認您傳送的一或多筆記錄是否正確。您也可以使用隨時間而來執行稽核。如需更多詳細資訊，請參閱使用 AWS CloudTrail 記錄 AWS Marketplace API 呼叫 (p. 262)。

將您的產品配置為計量使用量您使用BatchMeterUsage作 AWS Marketplace 以將計量記錄交付給AWS。請牢記下列事項：

• 我們要求賣家使用批次處理功能，請使用BatchMeterUsageoperation.• 我們會在小時重複計量要求。

• 請求會根據產品/客戶/小時/維度刪除重複。• 您隨時可以重試任何請求，但如果您計量不同的數量，則會向原始數量計費。• 如果您針對相同的客戶/維度/小時傳送多個請求，則不會彙總記錄。

• 您的計量記錄包含不得晚於過去 1 小時的時間戳記。• BatchMeterUsage裝載不得超過 1MB。選擇要傳送的使用記錄數量BatchMeterUsage請求，以便您不

會超過有效載荷的大小。• AWS Marketplace Metering Service 在 14 中提供AWS區域。根據預設，當您申請產品時，SaaS 計量產

品會啟用美國東部 (維吉尼亞北部) 區域。如果您打算使用其他區域，請聯絡AWS Marketplace賣方操作團隊。如需詳細資訊，請參閱「」BatchMeterUsage。

如需程式碼範例，請參閱「程式碼範例 (p. 161)」。

範例：主機掃描您的產品會分析運算硬體，找出已知的安全性弱點客戶手動啟動或排程其 Amazon Elastic Compute Cloud(Amazon EC2) 執行個體的掃描。當您的產品執行這些掃描時，它會記錄每小時掃描的唯一主機數目。在此範例中，您的產品使用主機類別。您可以為掃描的主機類型宣告多個維度。例如，您可以針對小型、中型和大型主機收取不同的價格。

範例：記錄分析您的 SaaS 產品摘要客戶產品、報告趨勢和異常情況所產生的記錄。當客戶將記錄檔上傳至您的產品時，您可以測量接收到的資料數量 (MB、GB 或 TB)。在每小時的第十分鐘，cron 作業會讀取前一小時每位客戶的使用情況。工作會建立批次報告，並使用BatchMeterUsage操作將其發送到AWS。在此範例中，您的產品使用資料類別。您的產品也可以計量任何指定小時內儲存的記錄資料量。在此情況下，您的產品可以沿著兩個維度計量：在小時內接收的資料以及在小時內儲存的總資料。您可以繼續計量儲存的資料，直到客戶刪除此資料或資料到期為止。

檢查權利如果您的產品是 SaaS 合約產品，您的產品會呼叫AWS Marketplace Entitlement Service來擷取客戶的權利，使用GetEntitlements。您的產品應該根據AWS Marketplace權利服務。例如，如果客戶在帳戶上提供 10位使用者，您的產品應該檢查AWS Marketplace權利服務，以取得該容量的權利。

若要確認客戶對您產品的權利，請使用GetEntitlements中的操作AWS Marketplace權利服務。所以此AWS Marketplace權利服務僅在美國東部 (維吉尼亞北部) 區域提供，可透過entitlement.marketplace.us-east-1.amazonaws.com。

GetEntitlements接受客戶識別碼和維度作為篩選器。ProductCode是必要參數。此作業會傳回權利的分頁清單。結果有一個ExpirationDate欄位，其中顯示權利文件有效期限的最短時間。如果客戶已設定自動續約，[ExpirationDate] 欄位中的日期即為續約日期。

158




AWS Marketplace 賣方指南SaaS 產品整合檢查清單

如需程式碼範例，請參閱程式碼範例 (p. 161)。

擷取使用者動作的軟體權利文件以下範例有助於您更加了解擷取使用者動作權利的程序。

範例：使用者型產品您提供的產品允許特定客戶存在多個帳戶。客戶可以造訪儀表板以佈建新使用者 (例如，指派認證)。當客戶佈建新使用者時，您的產品會呼叫GetEntitlements以確認容量是否存在。如果沒有，您可以呼叫AWSMarketplace計量服務為其他使用者開立帳單。

範例：資料儲存體您提供的產品可讓客戶以加密或未加密的形式儲存特定數量的資料。客戶可以檢視顯示產品中現有和配置的資料量的儀表板。您的儀表板會透過GetEntitlements。

SaaS 產品整合檢查清單在 SaaS 產品上線之前，請使用此檢查清單確認您已完成必要的設定。

類別需求

存取提交賣家註冊表格，其中包含所需的AWS帳戶AWSMarketplace使用方式。

存取完成賣家註冊，包括條款與條件、銀行帳戶以及 W8或 W9 稅單。

存取已設定的跨帳戶角色AWS Marketplace帳戶。

產品填妥產品申請表格AWS Marketplace管理入口網站

產品已提供者AWS帳戶識別碼，以便在備註」標籤建立產品精靈。

產品以 .txt 格式提供最終用戶特許協議的網址產品索引標籤。

產品從中收到您的產品代碼和 Amazon SNS 主題資訊AWS Marketplace。

產品訂閱 Amazon SNS 主題並建立 Amazon SQS 佇列以訂閱 Amazon SNS 主題。

帳單解決方案已驗證，您可以將計量記錄傳送至BatchMeterUsage每小時為每位客戶進行 SaaS訂閱產品。可針對 SaaS 合約產品，傳送每位客戶額外使用量的計量記錄。

帳單解決方案已驗證，您可以從AWS MarketplaceSaaS 合約產品的權益服務。

帳單解決方案驗證成本如預期般顯示在針對測試帳戶產生的帳單上。

帳單解決方案針對無效的客戶 ID 和取消訂閱等情況進行測試。

產品將產品請求提交回AWS Marketplace以進行發佈。

159

AWS Marketplace 賣方指南Reporting

類別需求

註冊實作可接受 HTTP POST 要求的 HTTPS 註冊頁面。

註冊已驗證您可以接受新的客戶註冊。

註冊已驗證您是非將註冊令牌存儲在 cookie 中。

註冊已驗證您正在使用ResolveCustomer以取得ProductCode和CustomerIdentifier來自AWS符記。

註冊驗證後，您可以解決從AWS沒有延遲。

註冊已測試您未封鎖使用 Gmail 等電子郵件服務地址註冊。

註冊已測試您可以接受不完整的註冊和多次註冊嘗試。

訂閱測試你可以處理unsubscribe-pending和unsubscribe-success訊息。

訂閱驗證您在收到unsubscribe-pending訊息。

安全性已驗證AWS根帳戶沒有 API 金鑰、具有強式密碼，並且與硬體 Multi-Factor Authentication (MFA) 裝置相關聯。所有管理存取都是透過使用AWS Identityand Access Management（我）。沒有共用帳戶。

安全性已驗證 IAM 角色用於所有程式設計的 AmazonElastic Compute Cloud (Amazon EC2) 存取。認證不會硬式編碼成指令碼、標頭或原始程式碼。

安全性已驗證您維護全面的記錄和記錄整合。

安全性驗證您擁有完善的公共和私有子網路界限，可隔離應用程式服務以及對資料庫和電腦系統的存取。不同的資料類別設定，可劃分敏感資料並隔離公開和私人資料。

安全性透過排程的金鑰輪換，驗證您在傳輸和靜態中具有私人資料加密。

安全性經過驗證，您擁有安全性事件工具，並可存取定期排定的事件回應練習，以便及時調查和復原。

可靠性驗證系統適應需求的變化，根據需求擴展和縮減，並採用負載平衡以確保高性能。系統也會根據需要提供基於邊緣的快取。

可靠性經過驗證的復原時間和點目標是指定的，嚴重損壞復原會定期排程。元件故障是透過自動觸發器和通知功能進行自我修復。

ReportingAWS Marketplace會為您的 SaaS 產品產生報告，其中包含訂閱者、財務、使用量和稅金的資料。如需更多詳細資訊，請參閱 the section called “賣方報告” (p. 186)。下表摘要說明 SaaS 產品財務報告的方式。

160

AWS Marketplace 賣方指南程式碼範例

報告 SaaS 的內容

每日業務報告預付合約費用會顯示在費用一節中的

計量付費使用費會顯示在用途一節中的

每月收入報告預付合約費用會顯示在年度訂閱一節中的

計量付費使用費會顯示在帳單和收入資料一節中的

銷售報告預付合約費用和每月額外使用費用會顯示為個別明細項目。

客戶訂閱者報告新的 SaaS 合約會出現在年度訂閱一節中的

新的 SaaS 訂閱會出現在每小時/每月訂閱一節中的

程式碼範例下列程式碼範例可協助您將 SaaS 產品與AWS Marketplace發佈和維護產品所需的 API。

主題• ResolveCustomer 程式碼範例 (p. 161)• 輸入 GetEntitlement 程式碼範例 (p. 162)• BatchMeterUsage 程式碼範例 (p. 163)

ResolveCustomer 程式碼範例以下是適用於所有定價模式的程式碼範例。這個例子交換了一個x-amzn-marketplace-token字符customerID。此代碼將在您的註冊網站上的應用程序中運行，當它們從AWS Marketplace管理入口網站。重定向是包含令牌的 POST 請求。

如需的詳細資訊ResolveCustomer，請參閱ResolveCustomer中的AWS Marketplace計量服務 API 參考。

# Import AWS Python SDK and urllib.parse import boto3import urllib.parse as urlparse

# Resolving Customer Registration TokenformFields = urlparse.parse_qs(postBody)regToken = formFields['x-amzn-marketplace-token']

# If regToken present in POST request, exchange for customerIDif (regToken): marketplaceClient = boto3.client('meteringmarketplace') customerData = marketplaceClient.resolve_customer(regToken) productCode = customerData['ProductCode'] customerID = customerData['CustomerIdentifier'] # TODO: Store customer information # TODO: Validate no other accounts share the same customerID

回應範例{

161


AWS Marketplace 賣方指南輸入 GetEntitlement 程式碼範例

'CustomerIdentifier': 'string', 'ProductCode': 'string'}

輸入 GetEntitlement 程式碼範例下列程式碼範例適用於具有合約和 SaaS 合約與消費定價模式的 SaaS 產品。Python 示例驗證客戶具有活動權益。

如需的詳細資訊GetEntitlement，請參閱GetEntitlement 說明中的AWS MarketplaceEntitlement ServiceAPI 參考。

# Import AWS Python SDKimport boto3

marketplaceClient = boto3.client('marketplace-entitlement')

# Filter entitlements for a specific customerID## productCode is supplied after the AWS Marketplace Ops team has published # the product to limited# # customerID is obtained from the ResolveCustomer responseentitlement = marketplaceClient.get_entitlements({ 'ProductCode': 'productCode', 'Filter' : { 'CUSTOMER_IDENTIFIER': [ 'customerID', ] }, 'NextToken' : 'string', 'MaxResults': 123})

# TODO: Verify the dimension a customer is subscribed to and the quantity, # if applicable

回應範例傳回的值會對應於您在AWS Marketplace管理入口網站。

{ "Entitlements": [ { "CustomerIdentifier": "string", "Dimension": "string", "ExpirationDate": number, "ProductCode": "string", "Value": { "BooleanValue": boolean, "DoubleValue": number, "IntegerValue": number, "StringValue": "string" } } ], "NextToken": "string"}

162


AWS Marketplace 賣方指南BatchMeterUsage 程式碼範例

BatchMeterUsage 程式碼範例下列程式碼範例適用於 SaaS 訂閱和採用消費定價模式的合約，但不適用於沒有消費的 SaaS 合約產品。Python 示例發送一個計量記錄到AWS Marketplace，向客戶收費按用量付費的費用。

# NOTE: Your application will need to aggregate usage for the # customer for the hour and set the quantity as seen below. # AWS Marketplace can only accept records for up to an hour in the past. ## productCode is supplied after the AWS Marketplace Ops team has # published the product to limited## customerID is obtained from the ResolveCustomer response

# Import AWS Python SDKimport boto3

usageRecord = [ { 'Timestamp': datetime(2015, 1, 1), 'CustomerIdentifier': 'customerID', 'Dimension': 'string', 'Quantity': 123 }]

marketplaceClient = boto3.client('meteringmarketplace')

response = marketplaceClient.batch_meter_usage(usageRecord, productCode)

如需的詳細資訊BatchMeterUsage，請參閱BatchMeterUsage中的AWS Marketplace計量服務 API 參考。

回應範例

{ 'Results': [ { 'UsageRecord': { 'Timestamp': datetime(2015, 1, 1), 'CustomerIdentifier': 'string', 'Dimension': 'string', 'Quantity': 123 }, 'MeteringRecordId': 'string', 'Status': 'Success' | 'CustomerNotSubscribed' | 'DuplicateRecord' }, ], 'UnprocessedRecords': [ { 'Timestamp': datetime(2015, 1, 1), 'CustomerIdentifier': 'string', 'Dimension': 'string', 'Quantity': 123 } ]}

163


AWS Marketplace 賣方指南使 AWS PrivateLink 時搭配AWS Marketplace

使 AWS PrivateLink 時搭配AWS MarketplaceAWS Marketplace支援AWS PrivateLink，一種技術，允許您使用亞馬遜網絡為買家提供訪問您通過AWSMarketplace。本文件概述使用的 Amazon Virtual Private Cloud (VPC) 端點組態和傳遞產品的程序AWSPrivateLink技術。

在這份文件中，我們假設您有幾個工作知識AWS服務和AWS Marketplace環境。

Introduction

作為AWS Marketplace賣方，您可以透過 Amazon VPC 端點提供買方存取您的服務。這種方法可讓買方透過 Amazon 網路存取您的服務，使用AWS PrivateLink技術。如果您使用AWS Marketplace以建立並提供此服務，買家可以在AWS Marketplace。您的買方也可以在建立 VPC 端點的可用服務清單中找到您的產品。

AVPC 端點是一個虛擬裝置，可啟用AWS客戶在 VPC 和另一個之間建立私有連線AWS服務，而不需要透過網際網路、NAT 裝置、VPN 連接或AWS Direct Connect。您可以透過AWS Marketplace，讓買家可以使用這項技術連接到您的服務。這種連接方法對您的買家來說更安全，因為他們是透過 Amazon 私有網路存取您的服務，而不是透過網際網路存取您的服務。

針對您要提供服務的每個區域，您可以建立或使用現有資源來設定 VPC、設定服務執行個體、設定網路負載平衡器，以及透過建立服務端點向網路負載平衡器註冊服務。完成這些步驟並測試您的供應項目之後，您可以將組態資訊提供給AWS Marketplace賣方營運團隊。

AWS建議您提供私有 DNS 名稱，讓購買者在建立 VPC 端點時可以使用。

購方建立 VPC 端點時，他們可以選擇啟用私有 DNS 名稱。選擇此選項後，買方的 VPC 服務會設定私有託管區域。如果您提供私有 DNS 名稱，購買者可以在配置 VPC 端點以連接到您的服務時使用該名稱。在買方的私有託管區域中，私有 DNS 名稱將指向為您的端點服務建立的隨機產生的 DNS 名稱。買方的 EC2 執行個體會在不同的 VPC 上呼叫相同的統一 DNS 名稱 (api.example.com)。此外，如果公用和私人 DNS 名稱相同，則買方在從 VPC 內部或外部存取您的服務時，可以使用相同的公用名稱。

如需協助您透過AWS Marketplace，您可以聯絡AWS Marketplace賣方營運團隊。當AWS Marketplace買方訂閱您的服務並建立 VPC 端點，您的服務會顯示在AWS Marketplace 服務。MCO 團隊使用易於使用的DNS 名稱，以便在建立 VPC 端點時輕鬆探索您的服務。

您的產品建立為軟體即服務 (SaaS) 產品。計量和計費方式與其他AWS MarketplaceSaaS 產品。

設定您的產品若要將您的產品設定為可透過 Amazon VPC 端點取得：

1. 建立或使用現有的Amazon VPC。

164

https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Introduction.html#what-is-privatelink

https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-endpoints.html


https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-private.html

https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/hosted-zones-private.html


http://aws.amazon.com/documentation/vpc/

AWS Marketplace 賣方指南將您的產品提交至AWS Marketplace

2. 建立 (或使用現有的)Amazon EC2執行個體。3. 建立網路負載平衡器在您提供產品的每個地區。AWS建議您包含所有可用區域(AZ) 的區域。4. 使用 Amazon VPC 主控台、CLI 或支援的開發套件來建立 VPC 端點服務。5. 確認您可以透過網路負載平衡器存取服務。6. 請求憑證AWS Certificate Manager(ACM)以取得您方便使用的 DNS 名稱。ACM 發行憑證前，它會驗證您

是否擁有或控制憑證請求中的網域名稱。7. 將您易於使用的 DNS 名稱 (例如 api.vpce.example.com) 的子網域委派給 MCO 團隊提供給您的名稱伺

服器。在您的 DNS 系統中，您必須建立名稱伺服器 (NS) 資源記錄，將此子網域指向 MCO 團隊提供的Amazon Route 53 名稱伺服器，以便 DNS 名稱 (例如 vpce-0ac6c347a78c90f8.api..vpce.example.com)公開解析。

8. 允許買家存取AWS帳戶。

請注意：您可以使用支援的 SDK 或這個 CLI 命令來自動存取帳戶：修改-vpc-端點-服務-權限-服務-識別碼-vc-0123456789abcdef1-添加允許的主體：我：我：

將您的產品提交至AWS Marketplace在將您的服務發佈至AWS Marketplace，您可以使用AWS Marketplace賣方營運團隊。若要提交已啟用私密連結的產品：

1. 將下列資訊電子郵件傳送至AWS Marketplace賣方營運團隊：a. 端點和AWS帳戶來建立端點。端點是類似於這樣的：我們東部，一個東部，一個東部，一個東部，一

個東部，一個東部，一個東部，一個東部，一個東部，一個東部的b. 您服務的易於使用的 DNS 名稱。這是AWS Marketplace買家用來存取您的產品。c. 所以此AWS帳戶，以及用來要求憑證的私人 DNS 名稱購買者用來存取 VPC 端點的私人 DNS 名稱。

所以此AWS MarketplaceMCO 團隊會驗證貴公司的身分，以及您所註冊服務所使用的 DNS 名稱 (例如api.vpce.example.com)。驗證之後，DNS 名稱會覆寫預設的基礎端點 DNS 名稱。

購買者存取 VPC 端點AWS Marketplace建立 VPC 端點的買家可以在下列情況下探索您的服務：

• 你按照本頁前面所述的賣家程序來建立或使用現有的產品。• 買家已訂閱你的服務。• 你已新增買家的AWS帳戶新增至您允許的帳戶清單。

當購方建立 VPC 端點時，他們可以選擇將私有託管區域與其 VPC 建立關聯。託管區域包含該服務預設私有DNS 名稱的記錄組，可解析至其 VPC 中端點網路界面的私有 IP 地址。

任何購買者代管的端點，包括AWS Marketplace服務，可以為所有帳戶提供權限 (「*」權限)。不過，當您使用這種方法時，服務不會包含在描述調用或控制台，除非您按服務名稱進行搜索。若要顯示描述呼叫時，買方的AWS帳戶必須明確新增至服務的允許清單。

若要存取您的服務，買方會執行以下作業：

1. 探索並訂閱您的服務AWS Marketplace。2. 使用AWS Command Line Interface(AWS CLI)、API 或 Amazon VPC 主控台來探索您的服務，然後建立

VPC 端點，以便在其使用的子網路和可用區中連線到您的服務。端點會顯示為子網路中的彈性網路介面。本機 IP 位址以及區域 DNS 名稱會指派給端點。

165

http://aws.amazon.com/documentation/ec2/

https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-getting-started.html

https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-az.html

https://docs.aws.amazon.com/acm/latest/userguide/gs-acm-request.html



AWS Marketplace 賣方指南附錄：檢查清單

用戶端 DNS 名稱名稱

區域性副總 <0dc9a211a78c90f8> 經理實例網站

IADS (1a) us-east-1a-副 <0dc9a211a78c90f8> 本網站實例網站

IADS (1b) us-east-1b-副 <0dc9a211a78c90f8> 本網站實例網站

如果您提供了預設的私人 DNS 名稱，而買方選擇啟用私有 DNS 名稱(關聯私有託管區域) 時，買方 VPC 看到區域預設私有 DNS 名稱，以供您的服務使用。

名稱別名別名託管區域 ID (備註)

例如有關網站<0dc9a211a78c90f8> 的資訊，例如

Z00ABCCD IAD1

IAD2

附錄：檢查清單請使用下列檢查清單，確保您在將產品提交給 MCO 團隊之前，先設定並測試產品。

產品建立檢查清單• 創建（或使用現有的）VPC，然後對其進行配置。• 在 VPC 內建立並設定網路負載平衡器。• 透過建立 VPC 端點服務，向網路負載平衡器註冊服務。• 提供AWS帳戶識別碼，以便將 VPC 端點設定為 MCO。• 為 MCO 提供預設端點服務名稱 (例如，遠端點服務名稱)。• 提供易於使用的服務 DNS 名稱 (必要)，以覆寫隨機產生的服務 DNS 名稱。從 ACM 要求 SSL 憑證，用於

您易於使用的服務 DNS 名稱的子網域。提供這些憑證和AWS帳號 ID，您用來向 MCO 團隊要求他們。• 建議：提供私有 DNS 名稱。• 建立程序以通知並允許您的AWS Marketplace購方可選擇使用AWS PrivateLink技術。AddAWS購買者的帳

戶 ID，加入您允許的帳戶清單。

產品測試• 確認您的服務已設定且可搜尋。• 確認您的服務可透過網路負載平衡器探索。• 確認買方可以建立 VPC 端點並存取您的服務。使用AWS帳戶，該帳戶不是您用來設定服務的帳戶。

166

AWS Marketplace 賣方指南取得說明

專業服務產品身為賣方，您可以提供專業服務AWS Marketplace買方。專業服務包括評估、移轉、支援、管理及訓練他人如何使用AWS Marketplace。賣方會建立描述他們所提供服務的產品供應項目、與客戶協商以建立條款合約，然後透過AWS Marketplace。

AWS客戶可以找到專業服務產品，按類別、賣家搜尋，以及AWS Marketplace產品，他們已經購買。他們收取的服務AWS帳單，並可以使用工具，如AWS Cost Explorer集中支付和管理成本。

如需專業服務產品的詳細資訊，請參閱：

• 入門使用專業服務產品 (p. 167)• 提供專業服務產品的詳細資訊 (p. 171)• 專業服務產品的要求 (p. 172)

取得說明如需專業服務產品的協助，請聯絡您的業務發展夥伴AWS Marketplace或聯絡我們。

入門使用專業服務產品本主題說明如何開始使用專業服務產品，並透過建立第一個產品的步驟，以及如何將產品提供給客戶。您的產品定義會告訴您的客戶有關您所提供的服務，以及他們為什麼要為這些服務選擇您的公司。AWSMarketplace然後允許他們與您聯繫。您同意合約，然後創建一個私人優惠，允許他們以固定成本購買您的服務。

主題• Prerequisites (p. 167)• 創造專業服務產品 (p. 168)• 建立私有優惠 (p. 168)• 編輯產品資訊 (p. 169)• 編輯產品定價 (p. 170)• 編輯產品可見度 (p. 170)• 移除專業服務產品 (p. 170)

Prerequisites出售專業服務AWS Marketplace，您必須完成下列必要條件：

• 可以存取AWS Marketplace管理入口網站。這是您用來註冊為賣家和管理您在AWS Marketplace。若要進一步了解如何存取AWS Marketplace管理入口網站，請參閱的政策和許可AWS Marketplace賣方 (p. 250)。

• 註冊為AWS Marketplace賣家，如果你想向你的產品收取費用，請提交你的稅金和銀行資料。若要進一步了解如何成為賣方，請參閱開始為賣方 (p. 3)。

167


AWS Marketplace 賣方指南創造專業服務產品

• 您必須擁有與至少一項公開產品相關的專業服務產品，才能提供AWS Marketplace。您的產品必須直接支援這些產品，或提供推動該產品訂閱的服務AWS Marketplace產品。

Note

您的產品必須至少列在下列其中一個主要類別：評估、實作、管理服務、進階支援或訓練。如需專業服務產品指導方針的詳細資訊，請參閱專業服務產品的要求 (p. 172)。

創造專業服務產品下列程序說明如何在建立新的專業服務產品AWS Marketplace管理入口網站。

建立專業服務產品

1. 開啟 Web 瀏覽器並登入AWS Marketplace管理入口網站。2. 從產品功能表中，選取專業服務。此頁面會顯示您已建立的所有專業服務產品，以及您針對建立或修改

這些產品所提出的任何要求。3. 在最新的專業服務產品索引標籤上，選取創造專業服務產品。4. 在建立產品頁面上，提供您產品的資訊，然後選取SUBD。如需您必須提供的詳細資訊，請參閱提供專

業服務產品的詳細資訊 (p. 171)。5. (選用) 從產品的選單AWS Marketplace管理入口網站，選取專業服務，然後選擇請求索引標籤。確認您

看到您的產品請求，並具有正確的產品標題，並且請求狀態是审查中。您應該會在幾分鐘內以限制預覽模式建立產品。

Note

您可以返回請求的索引標籤專業服務頁面，隨時查看您的請求狀態。建立程序中的任何錯誤都會出現在此處。您可以選取要求以查看要求詳細資料或修正錯誤。

當您的產品初始建立時，只有您的AWS帳戶 (您用來建立產品的帳戶)。如果您從專業服務頁面上，您可以選取檢視AWS Marketplace以檢視產品詳細資訊，如在AWS Marketplace買家。此詳細資訊清單不適用於其他AWS Marketplace用戶，除非你擴展私人報價給他們。

若要了解如何讓產品公開提供，請參閱編輯產品可見度 (p. 170)。

建立私有優惠當潛在買家瀏覽您的產品時，AWS Marketplace，他們無法直接購買。當他們嘗試訂閱時，他們會被重定向以請求私人報價從你。AWS Marketplace會傳送電子郵件訊息給您的AWS Marketplace賣家帳戶根使用者電子郵件地址，通知您該客戶已要求私人優惠。下列程序說明如何回應此請求。

Note

您可以建立私人優惠，價格高達 250,000 美元，透過AWS Marketplace管理入口網站。若要建立超過 250,000 美元的私人優惠，則需要核准。如需詳細資訊，請聯絡您的AWS Marketplace業務發展代表，或將您的詳細資料傳送至AWS Marketplace業務營運團隊[email protected]。

創建一個專業服務產品的私人報價

1. 請聯絡客戶以解決您對要求的任何問題。在創建私人報價之前，同意要約條款AWS Marketplace。買方沒有義務購買您的產品，因此在創建報價之前達成同意是有意義的。

2. 開啟 Web 瀏覽器並登入AWS Marketplace管理入口網站。3. 選擇Offers，然後選取建立私有優惠。

168


marketplace/latest/userguide/private-offers-overview.html

mailto:[email protected]


AWS Marketplace 賣方指南編輯產品資訊

4. 在建立私有優惠頁面上，選擇您要建立私人優惠的產品。僅包括目前可用的產品。5. 輸入買方帳戶 ID你想擴展一個私人報價。單一私人優惠最多可以包含 25 個帳戶。如果買家使用要求講

價功能，你收到的電郵訊息會包含要求帳戶的買家帳戶 ID。6. 選擇是否允許買家分期付款產品。通常情況下，短期合約支付一次付款。較長的合約可以選擇分期付

款，但這是您與買家簽訂的協議的一部分。選取 Next (下一步)。7. 完成優惠詳細資訊，包括下列資訊：

• 自訂講價名稱— 提供足夠的細節，您和客戶將認識到該優惠。包括您的公司或產品名稱以及產品的描述。請勿包含任何可識別個人身分的資訊，包括姓名、電話號碼或地址。

• 協議結束日期— 同意接受服務的結束日期。例如，如果您提供 1 年的支援，請輸入自服務提供日期起1 年的日期。

• 產品尺寸— 您所提供之服務的價格和單位，如下所示：• 一次性付款優惠 — 您可以列出每個維度及其相關價格 (例如，您可以使用名為銀、金幣，以及鉑

金。買家可以根據自己的喜好選擇和付款。• 包含付款排程的優惠 — 您必須選擇單一維度，並提供每筆付款的金額和日期的付款排程。

Note

如果您想要建立零元優惠，您必須選取我想啟用零美元價格以進行確認。此預防措施可協助您避免意外建立免費優惠。

• 服務合約— 定義您與客戶之間的服務合約的文件。您上傳的文件 (文字或 PDF 格式) 會附加到單一PDF 文件中，因此請確定不需要檔案名稱才能瞭解內容。

• 講價過期日期— 優惠到期的日期。這決定了買家必須接受報價的時間，並且與何時提供專業服務無關。

8. 選擇下一頁完成編輯選項。9. 在請參閱 Review頁面上，確定優惠詳細資訊正確，然後選擇建立講價。

Note

您的講價可能需要一點時間才能發佈。發佈之後，您可以在Management (管理)(憑證已建立！)頁面上的名稱有些許差異。如果您需要編輯報價（尚未接受的報價），您可以從該頁面進行編輯。

10. 優惠發佈後，並可在管理私人優惠頁面中，從動作功能表中，選取複製講價網址，然後以電郵形式傳送給買家接受。

編輯產品資訊下列程序說明如何在編輯現有專業服務產品的產品資訊，AWS Marketplace管理入口網站。

編輯產品資訊

1. 開啟 Web 瀏覽器並登入AWS Marketplace管理入口網站。2. 從產品功能表中，選取專業服務。此頁面會顯示您已經建立的所有專業服務產品，以及任何未完成建立

或修改這些產品的請求。3. 選擇您要編輯的現有產品。然後，從請求變更功能表中，選取更新產品資訊。4. 對詳細資料進行變更。如需您可以編輯欄位的詳細資訊，請參閱提供專業服務產品的詳細資

訊 (p. 171)。5. 選擇SUBD建立請求請求。6. (選擇性) 如果您尚未在請求的索引標籤專業服務頁面，然後從產品的選單AWS Marketplace管理入口網

站，選取專業服務，然後選擇請求索引標籤。確認您看到您的要求，並使用正確的產品標題，並且請求狀態是审查中。您的產品將在幾分鐘內更新您要求的變更。如果發生錯誤，您可以在此處檢視，並在修正錯誤後重新提交編輯內容。

169


AWS Marketplace 賣方指南編輯產品定價

編輯產品定價下列程序說明如何在編輯現有專業服務產品的定價資訊。AWS Marketplace管理入口網站。

編輯產品定價

1. 開啟 Web 瀏覽器並登入AWS Marketplace管理入口網站。2. 從產品功能表中，選取專業服務。此頁面會顯示您已建立的所有專業服務產品，以及您針對建立或修改

這些產品所提出的任何要求。3. 選取您要編輯的現有產品，然後從請求變更功能表中，選取更新定價維度。

Note

您只能透過AWS Marketplace管理入口網站。若要修改或移除先前建立的尺寸，請聯絡AWSMarketplace賣方營運團隊與您的請求。在您的請求中，包含產品 ID 和您想要變更或移除哪些尺寸的詳細資料。

4. 新增您想要的任何新定價維度。如需定價欄位的相關資訊，請參閱提供專業服務產品的詳細資訊 (p. 171)。

5. 選擇SUBD建立請求請求。6. (選用) 從產品的選單AWS Marketplace管理入口網站，選取專業服務，然後選擇請求索引標籤。確認您

看到您的要求，並使用正確的產品標題，並且請求狀態是审查中。您的產品將在幾分鐘內更新您要求的變更。如果發生錯誤，您可以在此處檢視，並在修正錯誤後重新提交編輯內容。

編輯產品可見度根據預設，產品建立的可見性有限 — 只有您的帳戶才能看到新產品。您可以新增其他測試帳戶，或是讓產品在AWS Marketplace下列程序說明如何在編輯現有的專業服務產品AWS Marketplace管理入口網站。

編輯產品可見度


或修改這些產品的請求。3. 選擇您要編輯的現有產品。然後，從請求變更功能表中，選取更新產品可見度。4. 選擇聯絡我們。這會啟動「聯絡我們」頁面，其中包含AWS Marketplace賣家營運團隊審核並進行變

更。5. 新增要求的詳細資料，包括您希望產品是公開還是私人。如果私人，請提供您要存取的帳戶識別碼，然

後選取SUBD以傳送您的請求，

Note

為了使產品在公眾中可見AWS Marketplace目錄需要AWS Marketplace賣方營運團隊，以確保產品符合產品準則（請參閱專業服務產品的要求 (p. 172)。請求需要數天時間來完成。

移除專業服務產品下列程序說明如何從移除現有的專業服務產品AWS Marketplace管理入口網站。

若要移除產品


或修改這些產品的請求。

170






AWS Marketplace 賣方指南產品詳細資訊

3. 選擇您要編輯的現有產品。然後，從請求變更功能表中，選取取消發佈產品。4. 選擇聯絡我們。這將啟動聯絡我們頁面，其中包含正確的資訊AWS Marketplace賣家營運團隊審核並進

行變更。5. 完成任何要求的其他資訊，請參閱聯絡我們頁面範本，然後選取SUBD以傳送您的要求。

Note

請求需要數天時間來完成。具有有效優惠的產品將移至限制狀態，直到最後一個有效訂閱或合約完成，然後從 AWS Marketplace 移除為止。處於限制狀態的產品只有具有有效優惠的客戶可以看到，而賣家將無法延長這些產品的新優惠。

提供專業服務產品的詳細資訊當您將專業服務產品發佈到AWS Marketplace，您必須提供產品中繼資料。本主題討論準備或編輯產品詳細資料時非常有用的資訊。

Note

如需專業服務產品的指導方針和需求的相關資訊，請參閱專業服務產品的要求 (p. 172)。

主題• 產品描述 (p. 171)• 其他資源 (p. 172)• Support 資訊 (p. 172)• 定價維度 (p. 172)• 產品可見度 (p. 172)

產品描述產品說明部分產品詳細資訊是您產品的核心。它描述了你的產品，你的潛在買家，以便他們可以做出購買決定。此區段的產品詳細資訊包含以下資料：

• 產品標題— 產品名稱。這是用來識別您的產品；它會顯示在產品頁面和搜尋結果中。為您的產品提供一個有意義的名稱。它必須是唯一的AWS Marketplace。

• SKU— (選擇性) 用於追蹤AWS Marketplace。這些資料僅供您自己使用，買家看不到。• 簡短描述— 您產品的簡要描述，顯示在磚上以及產品標題下方AWS Marketplace產品目錄。• 完整描述— 較長且格式化的說明，向買家說明產品的詳細資料。列出產品功能、優點、使用情況和其他特

定於產品的資訊。使用可用的格式，讓資訊更容易理解和掃描。• 產品標誌— 此欄位是公用 S3 URL，指向代表您產品的影像檔案。檔案必須使用 .png、.jpg 或 .gif 格式，

且背景為透明或白色，不超過 5MB，且寬度介於 110-10,000 個像素和高度之間。商標會在產品提交期間上傳，並儲存在AWS Marketplace。修改 URL 的內容並不會修改AWS Marketplace提交之後。

Note

您提供的 S3 URL 必須是公開可用的。這是 S3 儲存貯體的屬性，其中檔案所在。如需詳細資訊，請參閱「」如何編輯 S3 儲存貯體的公開存取設定？(位於《Amazon Simple Storage Service主控台使用者指南》)。

• 要點— 一組有關您產品的一至三個短點，描述其主要特徵或差異因素。至少需要一個亮顯。• 產品類別— 您提供的服務類型。您至少必須選擇一個類別，且至多必須選擇三個類別。有許多類別可供選

擇，但專業服務產品必須至少包含下列其中一項：

171

https://docs.aws.amazon.com/AmazonS3/latest/user-guide/block-public-access-bucket.html

AWS Marketplace 賣方指南其他資源

評估

評估客戶目前的作業環境，以找到適合其組織的解決方案。實作

協助設定、設定和部署協力廠商軟體。付費支援

取得專為客戶需求而設計的指導與協助。受管服務

代表客戶的端對端環境管理。訓練

由專家提供量身打造的研討會、計畫和教育工具，協助客戶員工學習最佳實務。• 搜尋結果的關鍵字— 最多提供三個買家可用來搜尋您的產品的關鍵字。您可以以逗號分隔的清單列出關鍵

字，最多可以使用 250 個字元。• 相關產品— 至少包含一個AWS Marketplace您的服務可以搭配使用或支援使用。AWS Marketplace使用這

些產品作為輸入，選擇要顯示在產品詳細資料頁面或相關產品針對這些產品。

其他資源在中其他資源區段中，您可以提供您已建立的資源連結，以協助您的客戶。這是儲存在線上的一到三個可下載資源的選擇性組合。資源範例包括產品資訊表、白皮書或產品手冊。針對每個資源，提供資源的名稱和URL。

Support 資訊本節是格式化的文字欄位，可讓您描述您為服務提供的支援。

客戶期待使用服務、疑難排解以及要求退款 (如果適用) 等問題的支援。支援說明應包含客戶可預期的支援層級陳述。請考慮包含購買前問題和購買後問題的支援詳細資料。

定價維度專業服務的定價範圍是您提供的套件。例如，您可以提供銀、金幣，以及鉑金支援。或者，您可能會提供10、20 或 50 小時的諮詢服務。針對您要提供的每個維度 (至少一個維度，最多 24 個維度)，指定名稱和說明。當您直接與買方合作建立產品的私人報價時，您可以設定這些維度的實際價格。

Note

如需如何使用定價維度以及如何設定價格的相關資訊，請參閱建立私有優惠 (p. 168)。

產品可見度已發行的產品可以在AWS Marketplace新增至您自己的帳戶、一小組測試帳戶或所有 AWS 帳戶。根據預設，產品會以私人發行版本發佈。若要變更產品可見性，請參閱編輯產品可見度 (p. 170)。

專業服務產品的要求AWS Marketplace維持所有產品和產品的需求AWS Marketplace。這些要求有助於為我們的客戶推廣安全、安全且值得信賴的精選數位目錄。我們鼓勵銷售者檢閱其他控制和協議的實施情況，以滿足其特定產品的需求。

172

AWS Marketplace 賣方指南產品設定指導方針

AWS Marketplace會在提交時檢閱所有產品及其相關中繼資料，以確保產品符合或超過目前AWSMarketplace要求。我們會檢閱並調整這些需求，以符合我們的安全性需求。除此之外：AWS Marketplace持續審查產品，以確認產品符合這些需求的任何變更。如果產品不符合規定，AWS Marketplace會與您聯絡以更新您的產品。在某些情況下，您的產品可能會暫時無法供新訂閱者使用，直到問題解決為止。

產品設定指導方針所有專業服務產品皆須符合下列產品設定指導方針：

• 您的AWS帳戶必須使用AWS Marketplace作為付費賣家。• 所有定價維度必須與實際服務相關，並使用AWS Marketplace。• 您的產品必須列在以下類別之一：評估、實作、受管服務、付費支援, 或訓練。• 除了所需的專業服務類別，您的產品也應該通過選擇適合所提供服務的其他適當類別進行正確分類。• 您產品的標誌不得設計成混淆AWS標誌或任何來自不相關協力廠商的標誌。• 您的產品詳細資料不得包含冒犯性或明確的內容。他們必須遵守AWS可接受之使用政策：https://

aws.amazon.com/aup/。

客戶資訊要求所有專業服務產品皆須符合下列客戶資訊要求：

• 專業服務產品必須完全透過AWS Marketplace。• 您無法收集您的專業服務產品清單的客戶付款資訊，請參閱AWS Marketplace，包括信用卡及銀行帳戶資

料。• AWS 提供給您的任何訂閱者或潛在訂閱者資訊與您的專業服務產品一起使用，必須完全遵守 AWS

Marketplace 賣方的條款與條件。

產品使用指導方針所有專業服務產品皆須符合下列產品使用指導方針：

• 訂閱產品後AWS Marketplace，客戶應該能夠在訂閱後兩個工作天內存取服務或由您（作為賣家）聯絡。如果客戶無法立即取得服務的存取權，您必須傳送電子郵件訊息給他們，告知他們何時可取得存取權限。授與存取權之後，您必須傳送電子郵件訊息給客戶，確認已授與存取權，以及明確的後續步驟。

• 客戶必須能夠輕鬆取得相關問題的協助，例如使用服務、疑難排解以及要求退款 (如果適用)。必須在履行登陸頁面上指定 Support 連絡人選項。支援說明應包含客戶可預期的支援層級陳述。

• 您的產品概觀應包括明確的價值主張、主要功能、詳細文件的連結，以及對所提供服務的預購和購買後支援的明確定義。

• 您的產品應具備明確且直接的服務條款。

架構指導方針所有專業服務產品皆須符合下列架構指導方針：

• 專業服務產品必須與至少一個公開AWS Marketplace產品（最多四個），其中產品直接為那些相關產品提供服務，或提供驅動更多用戶的服務AWS Marketplace產品。

• 如果所提供的服務需要客戶基礎結構中的額外資源，請遵循下列準則：• 以安全的方式佈建資源，例如使用AWS Security Token Service或AWS Identity and Access

Management（我）。

173

http://aws.amazon.com/aup/

http://aws.amazon.com/aup/

AWS Marketplace 賣方指南架構指導方針

• 提供其他文件，包括所有已佈建的AWS服務、IAM 政策聲明，以及如何在客戶帳戶中部署和使用 IAM角色或使用者。

• 在產品說明中包含通知，說明如果客戶發生額外AWS基礎設施成本，從他們的AWS Marketplace交易，他們負責支付額外的基礎設施費用。

• 如果您的產品部署代理程式，請向客戶提供說明如何在AWS帳戶。

174


Data ExchangeAWS Data Exchange 服務可讓 AWS 客戶輕鬆地在 AWS 雲端中安全地交換以檔案為基礎的資料集。身為供應商，AWS Data Exchange 無需建置和維護任何資料交付、權利或帳單技術。AWS Data Exchange 中的供應商擁有安全、透明且可靠的管道，可接觸 AWS 客戶，並更有效地授予現有客戶訂閱。成為 AWS DataExchange 供應商的程序需要幾個步驟來確定資格。

Data Exchange 具有下列部分：

• 產品詳細資訊— 這項資訊可協助潛在的訂閱者瞭解產品是什麼。這包括名稱、描述 (簡短和長)、標誌影像，以及支援連絡資訊。產品詳細資料由供應商填寫。

• 產品優惠— 為了讓產品在 AWS Data Exchange 中提供，供應商必須定義公開優惠。這包括價格和持續時間、資料訂閱合約、退款政策，以及建立自訂優惠的選項。

• Data Exchange— 產品可包含一個或多個資料集。資料集是以檔案為基礎的資料內容的動態集。數據集是動態的，並使用修訂版本進行版本化。每個修訂都可以包含多個資產。

如需詳細資訊 (包含資格要求)，請參閱在 AWS Data Exchange 中提供資料產品中的AWS Data Exchange 使用者指南。

175


AWS Marketplace 賣方指南使用產品標籤

提交您的產品以供出版您可以使用產品提交程序，讓您的產品在AWS Marketplace。產品可以很簡單，例如，一個亞馬遜機器圖像（AMI）具有一個價格結構。或者，產品可能相當複雜，有多個 AMI，AWS CloudFormation範本，以及複雜的定價選項和付款排程。您可以定義產品供應項目，並透過AWS Marketplace 管理入口網站兩種方式的其中一種：

• 使用產品索引標籤 — 對於較不複雜的產品，您可以使用產品索引標籤，以完整定義並提交您的請求。• 使用資產標籤 — 對於較複雜且需要更多定義的產品，您可以下載產品載入表單 (PLF)、新增產品詳細資

料，然後使用檔案上傳選項。

Note

資料產品供應商必須使用 AWS Data Exchange 主控台來發佈產品。如需詳細資訊，請參閱「」發佈產品中的AWS Data Exchange 使用者指南。

建議您使用產品索引標籤來決定要使用哪種方法。下表列出組態和您用來提交請求的方法。第一欄是您產品的定價模型，其他三欄則是產品部署至客戶的方式。

定價方式使用單節點 AMI 推出的產品

推出的產品AWSCloudFormation

以軟體即服務 (SaaS) 方式推出的產品

使用自有授權 (BYOL) 產品TAB 資產TAB

免費產品TAB 資產TAB

每小時產品TAB 資產TAB

每小時一次，每年產品TAB 資產TAB

每月資產TAB 資產TAB

每小時一次，每月資產TAB 資產TAB

使用量 (AWSMarketplace MeteringService)

資產TAB 資產TAB

SaaS 訂閱產品TAB

SaaS 合約產品TAB

SaaS 傳統資產TAB

您可以個別提交產品，如果您使用產品載入表單，則可以同時提交多個產品或產品更新。您無法同時使用產品TAB。如果您不清楚哪些產品可以以什麼方式提交，請先使用產品TAB。如果您在提交時遇到其他問題，請聯絡AWS Marketplace受管理的類別目錄作業 (MCO)團隊。

使用產品標籤若要存取產品索引標籤上，登入AWS Marketplace 管理入口網站。從到產品標籤上選擇伺服器、SaaS, 或機器學習，視您所管理的產品類型而定。此時會出現該產品類型的儀表板，其中包含所有目前產品。如果選

176

https://docs.aws.amazon.com/data-exchange/latest/userguide/publishing-products.html

https://docs.aws.amazon.com/data-exchange/latest/userguide/publishing-products.html


AWS Marketplace 賣方指南公司和產品標誌要求

擇請求索引標籤上，儀表板會顯示您擁有的任何未完成的請求，以及您已完成的請求開始建立新的產品請求後，您可以儲存進行中的工作，並在必要時在數個不同的作業階段中建立您的請求。

當您準備好提交產品請求時，會由AWS Marketplace團隊。您可以在產品頁面上監控您要求的產品類型的請求狀態。對於新產品，在您的申請核准發佈後，您會收到一個有限的刊登 URL，供您用來預覽和核准您的提交內容。在您核准提交之前，您的產品優惠不會發佈。當您申請現有產品的更新時，系統會發佈更新，而不需要您審核和核准變更。這包括新增或移除版本以及中繼資料變更。

您會在請求TAB。狀態會是下列其中一項：

• 草稿— 您已啟動請求程序，但尚未提交您的請求。• MITTED— 您已完成並提交您的請求，且正在審核中。• 需執行的動作—AWS Marketplace團隊已審核您的要求，並需要更多資訊。• 需要核准—AWS Marketplace團隊為你的產品建立了有限的刊登網址。您必須先檢閱並核准或拒絕 URL，

然後才能AWS Marketplace將會發佈。如果您核准，狀態會變更為等待發佈而網站被發布。如果您拒絕，狀態會返回草稿以便您可以修改請求。

• 等待發佈— 您已核准請求的模型，並AWS Marketplace正在發佈您的產品。• 已過期— 您已啟動請求程序，但未在六個月內完成，因此請求已過期。

如果您的項目狀態為MITTED，您可以撤回提交。如果您的項目狀態為草稿，您可以刪除該請求。這將允許你重新開始。當您刪除草稿項目，該項目會移至要求歷史記錄TAB。

將產品新增至AWS GovCloud (US) AWS區域，您必須擁有 AWS GovCloud (US) 有效帳戶，並遵守AWSGovCloud (US)要求，包括出口控制要求。

公司和產品標誌要求貴公司的標誌和產品的標誌必須符合下列規定AWS Marketplace指導方針，以便使用者在瀏覽AWSMarketplace：

產品標誌規格— 您的產品標誌影像必須具有透明或白色背景，且尺寸必須為 120 到 640 像素，且具有 1:1或 2:1 (寬) 比例。

公司標誌規格— 您的公司標誌影像應該具有透明背景，且大小為 220 x 220 像素，允許內部每邊有 10 像素的填充。

提交付費重新封裝軟體的需求如果您提交的是重新封裝的開放原始碼軟體 (例如，開放原始碼 AMI 或具有付費支援的容器產品)，或是原本由非您廠商建立的軟體 (例如，透過 Windows 作業系統轉售 AMI) 的付費清單，則下列需求必須在提交前符合：

• 產品標題必須註明重新包裝所增加的價值。產品標題的範例包括：硬化 <Product>、<Product>新增的套件、<Product1>上 <Product2>。

• 產品標題不得包含文件不支援的任何其他語言。例如，產品標題可能不會使用認證、原始的, 或free除非您提供的產品詳細資料中已證明這些資料。

• 產品簡短描述必須包含一份清晰的陳述，概述產品費用。簡短描述必須以片語開頭此產品有與其相關的費用...。例如，如果產品包含來自賣方的支援費用，則產品描述應該說明：此產品收取與賣家支援相關的費用。

• 產品標誌必須與賣家註冊過程中使用的公司標誌相同。只有在您使用官方軟體標誌時，產品標誌才能與您的公司標誌不同，因此您必須取得原始軟體廠商的明確許可。如果取得明確的權限，則必須在變更請求的附註區段中包含該文件的連結 (或在輸入簡短描述欄位檔案上傳頁面使用產品載入表單時)。

177


AWS Marketplace 賣方指南AWS CloudFormation-推出的產品（免費或付費）或基於使用量的付費 AMI 產品

• 對於 AMI 產品，AMI 名稱不能從原始產品中重複使用。AMI 名稱必須以賣家名稱開頭，並遵循以下格式：[賣家名稱] [名稱-給予阿米]。

如果付費清單是針對非貴公司建立的獨立軟體產品，且產品中沒有新增智慧財產 (例如，搭配其他軟體程式庫或新增特殊設定)，則連同先前的需求，下列需求必須也可以滿足：

• 產品標題必須包含賣家名稱 (連同加值，如前所述)。賣家名稱是賣家註冊時使用的名稱。例如：提<Product> 供維護支援 <seller>。

• 產品詳細說明的第一行必須以短語開頭這是一個重新封裝的軟體產品，其中需要支付額外費用...（或者，如果它是開源的，這是一個重新打包的開源軟件產品，其中需要支付額外費用...。然後，詳細描述必須包含一份清晰的陳述，總結您收取的費用，以及描述這些功能的其他詳細資訊。例如，開放原始碼產品收取額外支援費用的詳細說明可能會開始為：這是一個重新封裝的開放原始碼軟體產品，支援 {SLA 詳細資料}。

AWS CloudFormation-推出的產品（免費或付費）或基於使用量的付費 AMI 產品

使用產品載入表格 (PLF) 提交AWS Marketplace客戶透過使用AWS CloudFormation範本。Template PLF可透過AWS Marketplace 管理入口網站(安培)。

提交您的產品1. 從到安培下載產品的產品載入表格 (PLF)。2. 新增您的產品定義，其中包括產品資訊 (標題、說明、重點)、技術資訊 (AMI_ID、區域、執行個體類

型、作業系統) 和定價詳細資料 (定價模型、免費試用)。3. 按照試算表「說明」表格下的指示提交 PLF。

所以此AWS Marketplace團隊會檢閱您的產品，以瞭解原則和安全性合規性、軟體弱點和產品可用性。如果要求有任何問題或問題，AWS Marketplace團隊將會透過電子郵件與您聯絡，討論您的要求。一旦核准，就會建立產品頁面的模型。檢閱頁面後，您接受或拒絕模型。一旦核准，我們會將頁面新增至AWSMarketplace。

更新您的產品對於您使用產品載入表單 (PLF) 建立的產品，您也可以使用 PLF 對這些產品進行變更。您可以對已完成的原始 PLF 進行變更，如果無法使用，則可以從新的 PLF 開始進行變更。就像使用產品索引標籤上，您可以新增新版本、移除現有版本，以及更新定價、執行個體類型、AWS區域可用性，和中繼資料。若要進行更新，您必須以準備新產品的方式準備任何更新產品。準備好產品更新之後，請依照下列步驟執行：

1. 使用您現有的 PLF，或從AWS Marketplace Management Portal，位於之下資產TAB 中選擇檔案上傳。在下方產品載入表格和賣家指南，您可以下載產品的 PLF。

2. 更新您在 PLF 中提交的產品。3. 從到AWS Marketplace Management Portal，位於之下資產索引標籤中，選擇檔案上傳。4. 在檔案上傳頁面上，上傳您更新的 PLF 和任何AWS CloudFormation範本。Template 文件上傳器提供了

一個安全的傳輸機制和提交文件的歷史記錄。上傳程式會自動通知AWS Marketplace團隊開始處理您的要求。包含提交的描述 (新增新版本、變更價格、變更中繼資料等)。

我們會審查您的產品提交的原則和安全性合規性、軟體弱點和產品可用性。如果要求有任何問題或問題，AWS Marketplace團隊將會透過電子郵件與您聯絡。現有產品頁面的更新會直接處理和發行，而不需要其他評論。

178

http://aws.amazon.com/marketplace/management/products/?


http://aws.amazon.com/marketplace/management/products/?

AWS Marketplace 賣方指南產品變更與更新

產品變更與更新賣家可以隨時提交其產品的變更，並將按照先前說明進行處理。但是，某些變更只能每 90 天或 120 天進行一次，或是待處理的變更時進行一次。例子包括價格變動和AWS區域或例證類型變更。常見變更包括：

• 新的版本— 軟體的新版本，以及修補程式或更新的推出。根據您的要求，我們可以通知已訂閱您的AWSMarketplace內容，或代表您傳送升級指示。

• 中繼資料變更— 對產品資訊（描述、URL 和使用說明）的變更。• 定價變更— 定價金額的變更。請求完成後，會傳送給目前客戶的通知。• 定價模式變更— 定價模型的變更 (例如，每小時、免費、每小時 _ 每年)。並非所有定價模型變更都受到支

援，所有變更模型的請求都必須經過AWS Marketplace團隊。從免費變更為付費模式的任何變更都會對現有客戶產生重大影響。另一種方法是建議具有額外功能的新產品，並鼓勵目前客戶遷移。

• 區域或執行個體變更— 新增或移除執行個體類型或區域。• 產品下架-移除產品頁面AWS Marketplace，以防止新客戶訂閱。請求完成後，會傳送給目前客戶的通知。

時間與期望雖然我們努力盡快處理請求，但請求可能需要多次重複執行，並由賣方和AWS Marketplace團隊。使用下列指南來完成此程序所需要的時間：

• 總要求時間通常需要 2 至 4 週的日曆時間。由於對產品中繼資料和軟體進行多次反覆和調整，因此較複雜的要求或產品可能需要較長的時間。

• 審核和處理要求通常需要 3 個工作天。如果有任何問題需要額外採取行動，我們將通知您。• 我們需要完成的產品請求，AMI 在任何計劃活動或發布前至少 45 天，因此我們可以根據要求優先順序排

列。

如果您對您的要求有其他問題，請聯絡AWS Marketplace賣方操作團隊。

將 AMI 提交至AWS Marketplace所有建立的 AMI，並提交至AWS Marketplace必須遵守所有產品政策。我們建議您在提交前對 AMI 進行一些最終檢查：

• 移除系統中的所有使用者認證；例如，所有預設密碼、授權金鑰、金鑰配對、安全性金鑰或其他認證。• 確定已停用或鎖定根登入。只允許 sudo 存取帳戶。• 如果您提交的 AMI 要部署到AWS GovCloud (US)地區，您需要擁有有效的 AWS GovCloud 帳戶並同

意AWS GovCloud 需求，包括適用的出口控制要求。

AMI 自助式掃描AMI 自助掃描可在AWS Marketplace 管理入口網站。使用此功能，您可以啟動 AMI 的掃描並快速接收掃描結果 (通常在一小時內)，並在單一位置提供清晰的回饋。

使用自助掃描開始分享和掃描 AMI

1. 導覽至。https://aws.amazon.com/marketplace/management/manage-products/。2. 選取要分享的 AMI。3. 檢視您的掃描結果。

179



http://aws.amazon.com/service-terms/

http://aws.amazon.com/marketplace/management/manage-products/

AWS Marketplace 賣方指南AMI 複製和產品代碼分配

成功掃描 AMI 後，您可以按照目前的程序將其提交到AWS Marketplace賣家營運團隊上傳您的產品載入表格(PLF)。如果您有任何問題，請連絡AWS Marketplace賣方操作團隊。

要將 AMI 納入自助掃描列表中，AMI 必須位於us-east-1(N. Virginia) 區域，並由您的AWS Marketplace賣家帳戶。如果您需要授與其他帳戶對AWS Marketplace 管理入口網站，你必須將這些帳戶註冊為賣家。如需更多詳細資訊，請參閱註冊 (p. 5)。

AMI 複製和產品代碼分配在您的 AMI 提交後，AWS Marketplace會為您指出應該可用軟體的每個區域建立複製的 AMI。在此複製和發佈程序期間，AWS Marketplace會將產品代碼附加到複製的 AMI。產品代碼用於控制存取和計量使用情況。所有提交的內容都必須經過 AMI 複製程序。

最終檢查清單為了避免產品發佈延遲，請在提交產品要求之前使用此檢查清單。

產品使用方式

• 生產就緒。• 不限制產品使用時間或其他限制。• 相容於一鍵式履行體驗。• 使用產品所需的一切都包含在軟體內，包括用戶端應用程式。• 預設使用者使用隨機化的密碼和/或初始使用者的建立需要驗證買方有權使用執行個體的唯一值 (例如執行

個體 ID) 使用執行個體。

免費或付費產品

• 不需要額外的授權即可使用產品。• 付費重新封裝的軟體符合AWS Marketplace 提交付費重新封裝軟體的需求 (p. 177)。• 買方不需要提供個人識別資訊 (例如電子郵件地址) 即可使用產品。

AMI 準備

• 使用硬體虛擬機器 (HVM) 虛擬化和 64 位元架構。• 不包含任何已知的弱點、惡意程式碼或病毒。• 買家擁有 AMI 的作業系統層級管理權限。• 透過 AMI 自助掃描執行您的 AMI。

對於 Windows AMI

• 使用最新版的Ec2ConfigService，如中所述使用 EC2Config 服務來設定 Windows 執行個體。• 所以此Ec2SetPassword、Ec2WindowsActivate，以及Ec2HandleUserData外掛程式已啟用，如使

用 EC2Config 服務來設定 Windows 執行個體。• 沒有來賓帳戶或遠端桌面使用者。

適用於 Linux AMI

• 根登入已鎖定並停用。• 不包括授權金鑰、預設密碼或其他認證。

180

http://aws.amazon.com/marketplace/management/product-load/





AWS Marketplace 賣方指南最終檢查清單

• 所有必填欄位都已完成。• 所有值都在指定的字元限制內。• 所有 URL 都載入而不會發生錯誤。• 產品圖像寬度至少為 110 像素，比例為 1:1 至 2:1。• 針對所有啟用的執行個體類型 (針對每小時、每小時和每小時定價模型) 指定定價。• 指定每月定價 (適用於每小時定價和每月定價模式)。

如果您有其他關於 AMI 自動化建築的問題或意見，請聯絡AWS Marketplace賣方運作團隊。

181


AWS Marketplace 賣方指南180 天的 GTM 學院

行銷您的產品您可以藉由提高對產品的認知AWS Marketplace，並將流量直接引導到您的產品頁面AWS Marketplace。以下提供資訊與支援，協助您行銷您在AWS Marketplace。

180 天的 GTM 學院180 天的 GTM 學院適用於所有AWS Marketplace賣家，並提供自助式進入市場 (GTM) 資源，協助您建立、啟用及追蹤AWS Marketplace。您可以：

• 快速追蹤物品的需求。• 透過整合，提高行銷投資報酬率並增強客戶訊息AWS和AWS Marketplace價值主張添加到您的消息中。• 您可以前往或在AWS Marketplace上市計畫指南。

您可以從Marketplace 資源的區段AWS Marketplace 管理入口網站。

宣佈產品的可用性我們鼓勵您廣泛宣佈您的產品在AWS Marketplace。您可以通過新聞稿，推文，博客，或任何其他首選的媒體渠道來做到這一點。我們已提供您可以包含的範例文字，以及使用我們的商標和發佈新聞稿的指導方針和指示。

我們會在公開前檢閱您的部落格、推文和其他非新聞稿公告，以確保與AWS訊息和品牌指引或語音。將您的要求提交給您的AWS客戶經理。檢閱最多需要 10 個工作天才能完成。當您張貼任何推文、部落格或新聞稿時，請通知我們，我們會盡力重新張貼以提高其可見度。

AWS Marketplace簡訊在您的客戶通訊中，您可能想要描述使用AWS Marketplace。請在參照AWS Marketplace。

什麼是 AWS Marketplace？

AWS Marketplace是線上商店，能讓客戶輕鬆尋找、比較並立即開始使用在上執行的軟體與服務。AWS。訪客AWS Marketplace可以使用單鍵部署快速啟動預先設定的軟體，並且只按小時或月份按使用量付費。AWS處理帳單和付款，軟體費用會顯示在客戶的AWS法案。

為什麼一個客戶商店AWS Marketplace?

尋找和部署軟體可能很具挑戰性。AWS Marketplace提供多種商業和免費的 IT 和商業軟體，包括來自熱門賣家的軟體基礎設施，例如資料庫和應用程式伺服器、IoT 解決方案、開發人員工具和商業應用程式。AWSMarketplace可讓客戶比較選項、閱讀評論，並快速找到他們想要的軟體。然後，他們可以使用按一下滑鼠或使用AWS Marketplace 管理入口網站。

軟體價格清楚地張貼在網站上，客戶可以立即購買大多數軟體，並且已經在 Amazon Web Services 上登記付款工具。軟體費用會顯示在與AWS基礎設施費用。

為什麼軟體或 SaaS 賣家會在AWS Marketplace?

搭配AWS Marketplace、軟體和軟體即服務 (SaaS) 銷售商，提供在AWS可以從提升客戶感知度、簡化部署和自動計費中受益。

182

https://s3.amazonaws.com/awsmp-loadforms/AWS_MP_GTM_ProgramGuide.pdf


AWS Marketplace 賣方指南上的AWS Marketplace

AWS Marketplace可協助軟體和 SaaS 銷售者取得執行於AWS找到新的客戶通過暴露他們的產品的一些幾十萬AWS客戶，從個人軟件開發人員到大型企業。

在上販售AWS Marketplace可讓獨立軟體廠商 (ISV) 為其軟體增加每小時計費，而無需進行昂貴的程式碼變更。他們只需將 Amazon Machine Image (AMI) 上傳到AWS並提供每小時成本。帳單由AWS Marketplace，讓銷售者免除計量使用量、管理客戶帳戶及處理付款的責任，讓軟體開發人員有更多時間專注於建置優質軟體。

此外，客戶也能夠輕鬆部署預先設定的軟體映像，簡化新客戶的上線作業。

上的AWS MarketplaceAWS Marketplace提供客戶在您的產品上提交評論的功能。我們也提供集團審稿的能力，例如 G2，這是一個企業對企業的市場，策劃獨立產品評論，將他們的聯合審稿整合到AWS Marketplace。

AWS Marketplace客戶評論必須符合購買者使用指南中列出的評論準則。審核提交不會在AWS Marketplace直到審核提交內容後才能確認是否符合我們的審核標準。如需檢閱指導方針的詳細資訊，請參閱產品檢閱。聯合發行審核組織會使用自己的獨特程序來驗證其評論，而且不會由AWS Marketplace發行前。如果您認為產品的聯合評論不符合產品評論準則，或您認為產品評論包含令人反感的內容，聯絡賣家營運團隊。

審核者也可以根據五星評等系統為您的產品提供星級評等。評分的平均值為您產品的整體星級評分。聯合發行評論也可以包含星級評分，但聯合發行評論的星級評分並不會與AWS客戶星級評等。

以下是關於產品審查功能的其他要點：

• 您無法將產品評論從AWS Marketplace。但是，只要評論符合管理產品評論的審核準則，您就可以在任何評論上留下評論。

• 如果您認為評論不符合評論準則或包含令人反感的內容，您可以聯絡賣家營運團隊並描述你的擔憂。• AWS客戶搜尋產品AWS Marketplace可以根據評分、已驗證的評論和外部來源的評論來搜尋和篩選結

果。AWS客戶可以看到外部來源的評級AWS搜尋結果中的客戶評分。• 您產品的聯合發行評論會自動新增至AWS Marketplace在免費給你。由於檢閱會自動新增，因此您不需要

提交要求，即可新增聯合發行檢閱。• 如果您的產品沒有任何聯合發行評論，您可以聯絡聯合發行審核者，並遵循他們的流程，讓您的產品審

核。例如，在 G2 中，您可以訪問他們的網站並聲明您的產品頁面，開始他們的審查流程。

連結至AWS Marketplace您的公司可能有網路存在，其中描述和促銷您的產品。我們鼓勵您強調產品可在AWS，並且可以使用AWSMarketplace。為了簡化客戶探索及部署軟體的程序，我們提供了將客戶連結至產品的指示。

使用AWS Marketplace標誌所以此AWS Marketplace標誌可讓您輕鬆告訴客戶您的軟體在AWS可在中使用。AWS Marketplace。如果您想要在AWS Marketplace、下載封存資料夾 (.zip 檔)，其中包含多種色彩處理和檔案格式。

直接鏈接到您的產品AWS Marketplace您可以將您的客戶直接傳送至產品資訊頁面，AWS Marketplace在您的網站或資料上加入深層連結。使用下列範例連結結構進行瀏覽器型連結。

183

https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-product-reviews.html



https://s3.amazonaws.com/awsmp-logos/AWS_Marketplace-Logos-AllFormats-171006.zip

AWS Marketplace 賣方指南新聞稿

https://aws.amazon.com/marketplace/pp/ASIN

將 URL 的 ASin 區段取代為您產品的 ASin。

Example

https://aws.amazon.com/marketplace/pp/B00635Y2IW

當您在上搜尋應用程式時，ASINN 會出現在 URL 中。Amazon Marketplace。或者，您可以諮詢您的客戶經理以尋找 ASIN。

Note

使用連結之前，請先測試連結，以確定他們會將您的客戶導向正確的頁面。

新聞稿我們鼓勵您在AWS Marketplace透過任何您偏好的管道。然而，所有的新聞稿參考AWS Marketplace必須經過 Amazon 審查並簽署任何發佈或公告。雖然我們鼓勵您發佈公告，但我們無法支持與AWS Marketplace賣方。我們會依個別情況逐例支援新聞稿，並附上AWS。報價必須符合多種條件，包括但不限於：宣佈AWSMarketplace或者它包含使用AWS Marketplace。

所有新聞稿必須由您起草。我們建議您使用以下標題：[插入產品名稱] 現在可在AWS Marketplace。請使用本文件中的訊息來取得一致性。

新聞稿應：

• 清楚準確地描述該公告與亞馬遜網站的關係• 澄清您在AWS與客戶• 以客戶為中心，強調客戶利益

新聞稿不應該：

• 使用術語合作夥伴、夥伴, 或聯盟來描述關係。我們偏好協議、成組, 或關係。• 除非事先同意，否則請包括 Amazon Web Services 主管的報價。• 包括商家的任何銷售預測或使用 .com，除非參考貴公司樣板中的網站。• 將您的組織稱為 Amazon.com 的夥伴，因為這可能會與我們的線上聯盟計劃 Amazon 夥伴混淆。• 披露有關亞馬遜網站的專有資訊或參考我們的股票代號。

將新聞稿以文字格式提交給您的客戶經理，以便審查。此外，請參閱Amazon Web Services 商標指導方針之前使用任何AWS商標。特定於AWS Marketplace請參閱以下章節。

AWS Marketplace商標使用指導方針這些準則適用於您使用AWS Marketplace標誌和商標，（每個「商標」和統稱為「商標」）已經由Amazon.com, Inc. 和/或其附屬公司（「亞馬遜」）事先批准的材料。任何時候都必須嚴格遵守這些準則，任何違反這些準則的商標使用將自動終止與您使用商標相關的任何授權。

1. 您可以僅用於 Amazon 明確授權的目的使用商標，且您的使用必須：(i) 遵守 Amazon 與所有關於您使用任何商標的協議的最新版本 (統稱為「協議」)；(ii) 遵守這些指南的最新版本；，且 (iii) 遵守 Amazon 可能不時發出的任何其他適用於商標使用的條款、條件或政策。

184

http://aws.amazon.com/marketplace/

http://aws.amazon.com/trademark-guidelines/

AWS Marketplace 賣方指南AWS Marketplace商標使用指導方針

2. 我們將提供核准的商標圖像供您使用。您不得以任何方式更改商標，包括但不限於變更商標的比例、顏色或字型，或從商標中增加或移除任何元素。

3. 您不得以任何暗示 Amazon 贊助或認可的方式使用商標，但不得使用協議中明確授權的商標。4. 您不得使用商標來貶低 Amazon 及其產品或服務，或以 Amazon 自行決定可能會減少或以其他方式損害

Amazon 在商標中的商譽或損害或損害 Amazon 的商譽的方式。5. 商標必須單獨出現，商標的兩側與其他視覺、圖形或文字元素之間有合理的間距。在任何情況下，商標均

不得放置在任何影響商標可讀性或顯示的背景上。6. 您必須在任何展示商標的資料中包含下列聲明：」AWS Marketplace與AWS Marketplace標誌是 Amazon,

Inc. 或其附屬公司的商標。7. 您承認商標的所有權利是亞馬遜的獨有財產，並且通過您使用商標產生的所有商譽都將保護亞馬遜的利

益。您不得採取任何與 Amazon 對該商標的權利或擁有衝突的行動。

Amazon 保留權利 (可自行決定) 隨時修改這些指南和/或核准的商標，並在未經許可的情況下對任何使用或不符合這些指南的任何使用採取適當行動。如果您對這些準則有任何疑問，請聯絡 [email protected]尋求協助，或寫信至下列地址：

亞馬遜網路股份有限公司請注意：商標

郵箱

西雅圖，華盛頓州

185

AWS Marketplace 賣方指南賣方報告

賣家報告和資料摘要AWS Marketplace提供下列工具，用於收集和分析產品銷售資訊：

• 報告 (p. 186)，它們是自動創建的，並可用於所有註冊的AWS Marketplace賣方。• 同時API (p. 8)，可讓您存取這些報告的區段。• 資料饋送 (p. 207)，可提供額外的客戶資訊，供您用來識別報表中所列交易的客戶資訊。

AWS Marketplace在報表和資料摘要中盡可能提供更多資料，同時遵守下列各項：

• 用於保護客戶資料的 Amazon 標準和原則。• 買家在購買產品時接受的條款和條件AWS Marketplace。作為賣家，你在合約上必須安全地管理買家資

料，並應買家要求刪除資料。

賣方報告AWS Marketplace提供的報告包括產品使用量、購買者、帳單和付款資訊的相關資訊。報告可供所有已註冊的AWS Marketplace賣方。

以下是產生報告的一些重點：

• 報告是每天、每週或每月產生一次，視報告而定。• 報告會在世界標準時間 00:00 產生，並涵蓋前一天的世界標準時間 24:00。• 報告會產生為 .csv 檔案。• 您可以設定 Amazon SNS 以在資料傳送到加密 S3 儲存貯體時通知您。設定通知後，AWS會傳送通知到與

AWS您註冊的帳戶AWS Marketplace。

如需如何設定通知的資訊，請參閱Amazon SNS 入門中的Amazon Simple Notification Service 開發人員指南。

若要取消接收通知電子郵件，請聯絡AWS Marketplace賣方營運團隊。• 若要了解每個報告，您可以下載範例報告。

存取報告AWS Marketplace提供兩種方式存取您的報告：

• 使用 API 介面。所以此AWS MarketplaceCommerce Analytics Service (p. 8)可讓您透過 API 介面自動存取報表中的資料。您可以自動擷取您的資訊，並下載報告的一部分，而不是整個報告。此服務將資料以非同步方式傳回 Amazon Simple Storage Service (Amazon S3) 中的檔案，而不是直接傳統 API。資料會以機器可讀取的格式傳遞，以便您可以將資料匯入或合併到系統中。

• 使用AWS Marketplace管理入口網站。此儀表板提供先前報告期間的報告。

您可以使用控制報告存取權AWS Identity and Access Management(IAM) 權限。

每日業務報告

186

https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html


https://s3.amazonaws.com/awsmp-loadforms/AWS+Marketplace+-+Seller+Reporting+Examples.zip

http://aws.amazon.com/marketplace/management/reports/


每日業務報告可協助您瞭解AWS客戶每天使用您的產品，以及該使用量的預估收入。只有在有相關資訊的情況下，您才會收到此報告。如果您沒有收到這份報告，而且認為您應該已收到報告，請連絡AWSMarketplace賣方營運團隊。

您可以在AWS Marketplace管理入口網站。如果您已註冊the section called “AWS MarketplaceCommerceAnalytics Service” (p. 8)，您也可以使用AWSSDK。

您可以為每個客戶使用唯一識別碼，以便隨著時間和跨報告識別客戶。識別碼可讓您追蹤客戶使用模式，以便估計客戶支出、深入了解免費試用使用情況，以及年度使用情況趨勢。

出版排程本報告每日於世界標準時間 00:00 公佈，涵蓋世界標準時間 00:00 至前一天的世界標準時間 23:59。排程的任何例外情況都會在每日業務報告區段的介紹中註明。

主題• 第 1 節：依執行個體類型的使用 (p. 187)• 2. 費用 (p. 188)• 3：免費試用轉換 (p. 189)• 4：新執行個體 (p. 190)• 第 5 節：新產品訂閱者 (p. 190)• 6：已取消產品訂閱者 (p. 191)

第 1 節：依執行個體類型的使用本節列出客戶使用之每個執行個體類型的資料列。例如，當客戶在一個執行個體類型上使用產品，而在不同的執行個體類型上使用相同產品時，報告會包含兩個執行個體類型中的每一個資料列。

資料欄名稱描述

客戶參考 ID 不是帳戶 ID 的唯一識別碼。它有助於跟踪客戶的使用情況，收入和訂閱。

使用者狀態與訂閱產品的帳戶相關聯的帳戶帳單地址狀態。

使用者的國家與訂閱產品的帳戶相關聯的兩個字元國碼。本報告採用 ISO 3166-1 alpha-2 標準。

產品標題產品的標題。

產品代碼產品的唯一識別碼。

執行個體類型與產品使用量相關聯的執行個體類型：例如t2.micro。

使用單位客戶在報告期間使用的單位數。

用量單位類型測量客戶使用量的測量單位。例如，小時或天。

方案說明產品提供的說明。例如，產品提供每小時使用、免費試用或年度使用。

預估營收產品使用量的估計營收。帳單會在月底定案。

貨幣交易的貨幣。例如，如果交易是美元，則該項目是USD。

187






講議 ID 買方簽署之優惠的識別碼。

提議可見度無論是公開、私人或企業合約優惠。

客戶AWS帳戶號碼費用收費的帳戶 ID。

客戶國家與費用計費的帳戶相關聯的雙字元國碼。

客戶狀態與費用計費的帳戶相關聯的帳單地址狀態。本報告採用 ISO 3166-1 alpha-2 標準。

客戶城市與計費的帳戶相關聯的帳單地址城市。

客戶郵遞區號碼帳單地址郵遞區號與費用收費的帳戶相關聯。

客戶電子郵件網域與費用計費的帳戶相關聯的電子郵件網域。例如，如果電子郵件地址是[email protected]，項目為example.com。

解決方案標題解決方案的名稱。

解決方案 ID 解決方案的唯一識別碼。

付款人參考編號不是帳戶 ID 的唯一識別碼。它與收取費用的帳戶相關聯。它有助於追蹤客戶在所有AWS Marketplace財務報告。

付款人地址 ID 代表客戶地址的唯一識別符。

2. 費用本節包含與產品相關聯的付費交易：例如，年度、月度、SaaS 合約產品費用，以及資料產品訂閱費用。本節中的資料涵蓋產生報告之前的 24 小時期間 72 小時。例如，如果報告是在 5 月 24 日產生，則資料涵蓋 5月 21 日的 24 小時期間。







Amount (數量) 使用費用。如果有退款，則此值為負值。如果此項目用於AWS MarketplaceSaaS 合同，金額代表維度的費用，而不是整個合同。


費用說明費用的原因：例如，月費，年費，或退款。

188



客戶AWS帳戶號碼收費的帳戶 ID。

客戶國家與費用計費的帳戶相關聯的雙字元國碼。本報告採用 ISO 3166-1 alpha-2 標準。

客戶狀態與費用計費的帳戶相關聯的帳單地址狀態。




Start Date (開始日期) 一個開始日期AWS MarketplaceSaaS 合約或資料產品訂閱。

結束日期一個結束日期AWS MarketplaceSaaS 合約或資料產品訂閱。

數量合約指定的標註單位數。

維度合約指定的維度。





3：免費試用轉換本節列出免費試用開始、轉換和取消的資料，並涵蓋過去 24 小時的期間。



產品代碼代表產品的唯一識別碼。

全新免費試用在本报告所述期间启动的新免费试用次数。

目前免費試用總計有效免費試用版訂閱的總數。

轉換的免費試用在報告期間從免費試用期轉移到付費用量的訂閱總數。

未轉換的免費試用結束免費試用但未轉換為付費用量的訂閱總數。



189


4：新執行個體本節列出新 EC2 執行個體和執行個體類型的資料，並涵蓋過去的 24 小時期間。







類型 Amazon EC2 執行個體類型。

計數 EC2 執行個體的數量。











第 5 節：新產品訂閱者此區段列出新買家的資料，並涵蓋過去 24 小時的期間。




190



使用者的國家與訂閱產品帳戶相關聯的雙字元國家/地區代碼。本報告採用 ISO 3166-1 alpha-2 標準。



講議 ID 買方簽署的提供識別碼。









付款人參考編號不是帳戶的唯一識別碼。它與收取費用的帳戶相關聯。它有助於追蹤客戶在所有AWS Marketplace財務報告。


6：已取消產品訂閱者本節列出買家取消訂單的資料，並涵蓋過去 24 小時的期間。







訂閱日期訂閱開始的日期。



191

AWS Marketplace 賣方指南每日客戶訂閱報告












每日客戶訂閱報告此報告會列出購買您產品之客戶的資料。此報告不會指定目前或過去的使用量，只有客戶訂閱您的產品。只有在有相關資訊的情況下，您才會收到此報告。如果您沒有收到這份報告，而且認為您應該收到的報告，請連絡AWS Marketplace賣方營運團隊。

您可以在AWS Marketplace管理入口網站。如果您已註冊the section called “AWS MarketplaceCommerceAnalytics Service” (p. 8)，您也可以使用AWSSDK。

該報告有兩個部分：一個用於每小時和每月訂閱，另一個用於年度訂閱。該報告包括AWS所有訂閱您產品之客戶的帳戶 ID。

出版排程本報告每日於世界標準時間 00:00 公佈，涵蓋世界標準時間 00:00 至前一天的世界標準時間 23:59。

主題• 第 1 節：每小時和每月訂閱 (p. 192)• 2. 可變長度訂閱 (p. 193)

第 1 節：每小時和每月訂閱本節列出截至前一天為 23:59:59 UTC 的所有使用量型訂閱的資料。


客戶AWS帳戶號碼訂閱產品的帳戶。

192



AWS Marketplace 賣方指南每日客戶訂閱報告



產品 ID 軟體產品的唯一識別碼。

產品代碼軟體產品的唯一識別符。

訂閱開始日期訂閱的開始日期，格式為YYYY-MM-DD。






經銷商帳戶 ID 諮詢合作夥伴經銷商的唯一識別符。

經銷商帳戶名稱諮詢合作夥伴經銷商的名稱。

2. 可變長度訂閱本節列出前一天 UTC 23:59:59 的所有付費訂閱的資料。


客戶AWS帳戶號碼訂閱產品的帳戶識別碼。


產品 ID 軟體產品的唯一識別符。

產品代碼軟體產品的唯一識別碼。此資訊也提供為 AmazonEC2 執行個體中繼資料的一部分。

訂閱 ID 訂閱的識別碼。

訂閱數量客戶購買的授權總數。

訂閱類型訂閱的類型。

訂閱意圖無論此優惠是升級或更新先前優惠。


訂閱開始日期客戶訂閱產品的日期，格式為YYYY-MM-DD。

前講價 ID 升級或續訂優惠前的優惠 ID (如果有的話)。




193

AWS Marketplace 賣方指南支付報告



經銷商帳戶 ID 諮詢合作夥伴經銷商的唯一識別符。

經銷商帳戶名稱諮詢合作夥伴經銷商的名稱。

支付報告支付報告提供我們自先前支付以來收集並支付給您的銀行帳戶的資金資訊。支付可包括客戶付款或訂閱產品的退款，以及一些已收取或退還給客戶的稅金。在客戶收取資金之前，您不會收到支付資金。不同的客戶有不同的付款條件與AWS，因此每個未收集年齡類別的部分基金可能不是來自客戶。

退款會顯示為負數金額，因為在您授權退款後，款項會退還給您的客戶。

此報告可在AWS Marketplace管理入口網站報告索引標籤。要創建您自己的報告類似於這個報告，您可以使用AWS Marketplace 資料饋送 (p. 207)，包括範例 1：依產品分類的付款 (p. 216)做為基本報告，以符合您的需求。

出版排程本報告是在開始支付將資金轉移到您的銀行後的 3-5 天內發佈。一般來說，這是針對每月收到付款的賣家的報告。如果沒有啟動支付，則不會產生支付報表。

主題• 第 1 節：按產品分類的發放金額 (p. 194)• 2. 依客戶地理區分支付金額 (p. 195)• 3：按執行處理小時支付的金額 (p. 196)• 4：未領取資金的年齡 (p. 197)• 第 5 節：已支付資金的年齡 (p. 197)• 第 6 節：逾期資金年齡 (p. 197)• 第 7 節：未收資金明細 (p. 198)

第 1 節：按產品分類的發放金額本節列出依產品支付的資料。


產品產品的標題。


SellerRev 向客戶收取產品的使用量或費用的金額。

阿斯萊夫量的AWS Marketplace費用。

SellerRevRefund 如果在數據覆蓋範圍期間處理任何退款，則退還給客戶的訂閱成本金額。

194



自由退款量的AWS Marketplace費用，如果在數據覆蓋期間處理任何退款，則會退還。

SellerRevCredit 所以此AWS該點數AWS Marketplace放置在客戶的帳戶。

自由編輯所以此AWS該點數AWS Marketplace放置在您的帳戶上。

淨額我們支付給你的總資金此資料行等於「賣家列表」資料行減去「AWsReffee」資料行。當提供退款給客戶時，此欄位是負數，等於「SellerRevRefund」欄位減去「自助退款」欄位。

交易參考 ID 交易的唯一識別碼，可協助您在AWS Marketplace報告。

SellerUSSalesTax 針對此交易計費的美國銷售與使用稅總金額。

SellerUSSalesTaxRefund 如果已處理退款，則此交易可退還的美國銷售與使用稅總金額。





客戶郵遞區號碼帳單地址郵遞區號與費用計費的帳戶相關聯。






2. 依客戶地理區分支付金額本節依客戶地理位置列出支付的資料。


結算識別碼支付的唯一識別符。

結算期間開始日期支付期間的開始日期和時間

195



結算期間結束日期支付期間的結束日期與時間。

存款日期支付發生的日期和時間

支付金額支付的總金額。

國家代碼與費用計費的帳戶相關聯的雙字元國碼。本報告採用 ISO 3166-1 alpha-2 標準。

州或地區與費用計費的帳戶相關聯的帳單地址狀態。

城市與計費的帳戶相關聯的帳單地址城市。

郵遞區碼帳單地址郵遞區號與軟體費用計費的帳戶相關聯。

依稅捐地點的淨金額總資金支付給賣方的稅收地點，少AWSMarketplace費用、退款以及美國銷售和使用稅。

按稅捐地點劃分的總金額依稅務地點支付給賣方的資金總額。

賣家美國營業稅代表賣家為此交易收取的美國銷售與使用稅金總額。（也就是說，美國銷售和稅務報表中的相關記錄顯示「稅務責任關係人」==「賣家」。）

賣家美國營業稅退款在代表賣家收取這類稅金時，如果處理退款，就此交易所退還的美國銷售與使用稅總金額。（也就是說，美國銷售和稅務報表中的相關記錄顯示「稅務責任關係人」==「賣家」。）

3：按執行處理小時支付的金額本節列出 Amazon EC2 執行個體小時支付的資料。


產品產品的標題。


用量類型描述使用情況的說明，包括優惠類型、區域和執行個體類型。

Rate (速率) 優惠類型、區域和執行個體類型的每小時費率。

使用者計數使用優惠類型、區域和執行個體類型的獨特客戶數目。

執行處理時數執行個體針對優惠類型、區域和執行個體類型所耗用的小時數。



196


4：未領取資金的年齡本節列出未收集資金的資料，依年齡組織。未收款的資金可能包含尚未到期的金額。


未收集 (等待 31 天以下) 在 31 天內已開立帳單但未收取的資金總計。

未領取 (待處理 31-60 天) 在 31-60 天之間已開立帳單但未收取的資金總計。

未領取 (等待中的 61—90 天) 在 61—90 天之間已開立帳單但未收取的資金總計。

未領取 (91—120 天等待中) 91—120 天之間已開立帳單但未收集的資金總計。

未領取 (超過 120 天待處理) 已開立帳單但未收取超過 120 天的資金總計。

未收集 (整體) 已開立帳單但未收集的所有資金總計。

第 5 節：已支付資金的年齡本節列出自上次支付以來收集資金的資料。


已收集 (未滿 31 天) 在 0—31 天範圍內收取帳單的資金總計。

已收集 (31-60 天待處理) 在 31-60 天範圍內收取的資金總計。

已收集 (61—90 天待處理) 在 61—90 天範圍內收取的資金總計。

已收集 (91—120 天待處理) 在 91—120 天範圍內收取帳單的資金總計。

已收集 (超過 120 天待處理) 在超過 120 天的範圍內收取帳單的資金總計。

已收集 (整體) 所有收集的資金總額。

第 6 節：逾期資金年齡本節列出已累積且由客戶應付的基金資料，但尚未根據客戶與AWS。


逾期（31 天以下）過去 0—31 天內累積且到期但客戶尚未支付的資金總計。

逾期未付 (31-60 天) 過去 31-60 天內累積且到期但客戶尚未支付的資金總計。

逾期未付 (61—90 天) 過去 61—90 天內累積到期但客戶尚未支付的資金總計。

逾期未付 (91 天至 120 天) 過去 91—120 天內累積且到期但客戶尚未支付的資金總計。

逾期未付 (> 120 天) 過去 121 天或更多天累積且到期但客戶尚未支付的資金總計。

197

AWS Marketplace 賣方指南每月計費收入報告


逾期 (整體) 已累積且已到期但客戶尚未支付的資金總計。

第 7 節：未收資金明細此區段列出所有未收款的資金，依付款到期日排序。


AWS 付款人帳號：計費軟體費用的帳戶。


總收入使用產品或使用產品的費用所計費的金額。

AWS 營收佔用在結算時從計費金額中扣除的 AWS 費用金額。

總退款交易的任何退款總金額。

AWS 退款份額針對交易退還的 AWS 費用部分。

淨營收此交易計費的淨金額減去 AWS 費用、退款以及美國銷售和使用稅。


AR 期間該月份和年份的交易，在格式YYYY-MM。

交易參考 ID 代表交易的唯一識別碼，您可以使用此識別碼來關聯AWS Marketplace報告。

機會名已註冊商機的唯一識別符。

商機描述已註冊商機中的任何中繼資料。





付款到期日付款到期日的格式YYYY-MM-DD。

每月計費收入報告每月計費收入報告會為您提供每月計費收入的授權資訊，以供會計和其他財務報告之用。此報表會顯示AWS向客戶收取產品每小時、每年或每月使用量的費用。報告分為四個區段：每小時使用量和每月費用的計費金額、可變長度訂閱、現場示範使用量，以及彈性付款。

Important

此報表中的金額僅反映我們向客戶開立帳單的收入，而不是我們收集的金額。

198


此報告可在AWS Marketplace管理入口網站報告索引標籤。如果您已註冊AWS Marketplace商務分析服務，您可以使用 API 呼叫來下拉此報表的區段。如需更多詳細資訊，請參閱 the section called “AWSMarketplaceCommerce Analytics Service” (p. 8)。

出版排程本報告在每月第十五天的 00:00 UTC 公佈。該報告涵蓋從 UTC 月份的第一天 00:00 到 UTC 月份的最後一天的前一個月份。例如，5 月 15 日發佈的報告涵蓋世界標準時間 4 月 1 日 00:00 至 4 月 30 日 23:59 的世界標準時間。

主題• 第 1 節：帳單和收入資料 (p. 199)• 第二節：可變長度訂閱 (p. 200)• 第 3 節：AWS欄位示範用量 (p. 202)• 第 4 節：靈活付款時間表的合約 (p. 202)

第 1 節：帳單和收入資料本節列出使用量計費、退款、費用以及所收取的美國銷售和使用稅的資料。



國家/地區與費用計費的帳戶相關聯的雙字元國碼。本報告採用 ISO 3166-1 alpha-2。

狀態與費用計費的帳戶相關聯的帳單地址狀態。


郵遞區碼帳單地址郵遞區號與費用計費的帳戶相關聯。



客戶帳單金額針對產品的使用量或每月費用向客戶計費的金額。

AWS刊登費用所以此AWS Marketplace費用金額從收費金額中扣除。

退款金額如在數據覆蓋期內處理任何退款，則退還給客戶的訂閱費用總金額。

AWS退還費用部分AWS Marketplace如在數據覆蓋期內處理任何退款，費用將退還。

費用商品給經銷商的成本：例如，經銷商在銷售您的產品時支付的費用。

合作夥伴營收金額針對交易開立帳單的總金額，淨額為AWSMarketplace費用、退款以及美國銷售和使用稅。

貨幣交易的貨幣。例如，如果交易是以美元為單位，條目是USD。

199




美國營業稅客戶帳單金額代表賣家為此交易收取的美國銷售與使用稅金總額。（也就是說，美國銷售和稅務報表中的相關記錄顯示「稅務責任關係人」==「賣家」。）

美國營業稅退款金額在代表賣家收取這類稅金時，如果處理退款，就此交易所退還的美國銷售與使用稅總金額。（也就是說，美國銷售和稅務報表中的相關記錄顯示「稅務責任關係人」==「賣家」。）



客戶AWS帳戶號碼收費的帳戶 ID。



商機描述已註冊商機的中繼資料。





第二節：可變長度訂閱本節列出以付費為基礎的費用資料。






郵遞區碼帳單地址郵遞區號與費用收費的帳戶相關聯。



200



訂閱數量指定為變動長度訂閱購買一部分的授權總數。

訂閱開始日期可變長度訂閱購買的開始日期。

訂閱結束日期可變長度訂閱購買的結束日期。

訂閱執行個體類型與變動長度訂閱購買相關聯的執行個體類型。

客戶帳單金額使用量、每月費用或兩者的計費金額。

AWS刊登費用所以此AWS Marketplace從收費金額中扣除的費用金額。

退款金額在數據保障期內，如有任何退款，將退還給客戶的總金額。

AWS退還費用部分AWS Marketplace如在數據覆蓋期內處理任何退款，費用將退還。

費用商品給經銷商的成本：例如，經銷商在銷售您的產品時支付的費用。

合作夥伴營收金額針對此交易開立帳單的總金額，淨額為AWSMarketplace費用、退款以及美國銷售和使用稅。



美國營業稅客戶帳單金額代表賣家為此交易收取的美國銷售與使用稅金總額。（也就是說，美國銷售和稅務報表中的相關記錄顯示「稅務責任關係人」==「賣家」。）

美國營業稅退款金額在代表賣家收取這類稅金時，如果處理退款，就此交易所退還的美國銷售與使用稅總金額。（也就是說，美國銷售和稅務報表中的相關記錄顯示「稅務責任關係人」==「賣家」。）


客戶電子郵件網域與費用計費的帳戶相關聯的電子郵件網域。例如，如果電子郵件地址是[email protected]，條目為example.com。



合約開始日期 Start Date (開始日期)AWS MarketplaceSaaS 合約。

合約結束日期一個結束日期AWS MarketplaceSaaS 合約。


商機描述已註冊商機的中繼資料。

201







第 3 節：AWS欄位示範用量此區段會列出AWS 欄位示範用量 (p. 18)您的產品。您可以配置您的產品，讓我們向潛在客戶展示您的產品。此處列出示範中的任何用法。




執行個體類型與現場示範相關聯的 Amazon EC2 執行個體類型。

使用單位與產品相關聯的使用單位數。

使用量單位類型與使用單位計數相關聯的使用單位：例如，小時。

第 4 節：靈活付款時間表的合約本節列出您在上一個報告期間使用彈性付款排程建立的所有合約的資料。


客戶AWS帳戶號碼收費的付款人帳戶 ID。

客戶國家與費用計費的付款人帳戶相關聯的兩個字元國碼。本報告採用 ISO 3166-1 alpha-2。

客戶狀態與費用收費的付款人帳戶相關聯的帳單地址狀態。

客戶城市與收費的付款人帳戶相關聯的帳單地址城市。

客戶郵遞區碼帳單地址郵遞區號與費用收費的付款人帳戶相關聯。

客戶電子郵件網域與收費的付款人帳戶相關聯的電子郵件網域。例如，如果電子郵件地址是[email protected]，條目為example.com。

使用者參考 ID 支付費用的付款人帳戶的帳戶。

使用者AWS帳戶號碼訂閱產品的帳戶 ID。

產品 ID 產品的唯一識別碼。

202

AWS Marketplace 賣方指南銷售報告



產品類型產品類型。

AWS Marketplace講議 ID 買方簽署之優惠的識別碼。

合約建立日期合約建立日期，即帳戶訂閱優惠的日期。

合約到期日期合約到期的日期。

合約總值 (美元) 合同的總價值，以美元表示。

付款數量為合約排定的付款數目。

發票日期建立商業發票的日期。

商業發票金額 (美元) 在發票上以美元計費的金額。


銷售報告報表會列出每月計費的收入，以及其他客戶資訊不在標準the section called “每月計費收入報告” (p. 198)。此報表會列出AWS向客戶收取產品每小時、每年或每月使用量的費用。

Important

此報表中的金額僅反映向客戶開立帳單的收入，而非從客戶收集的金額。

銷售補償報告以及作為本計劃一部分與您分享的資訊構成 Amazon 的機密資訊，根據我們與您的保密協議，如果沒有此類協議，則AWS Marketplace賣方。您只能使用此資訊來補償銷售代表，方法是將AWSMarketplace收入的代表按公司名稱，地理，AWS帳戶 ID。您可以與需要知道它的員工分享這些信息，以了解支付給他們的佣金來源。您使用和分享這些資訊必須遵守我們與您簽訂的保密協議中的義務，以及AWSMarketplace賣家，包括但不限於AWS Marketplace賣方。

要創建您自己的報告類似於這個報告，您可以使用AWS Marketplace 資料饋送 (p. 207)，包括範例 2：銷售薪酬報告 (p. 220)做為基本報告，以符合您的需求。

出版排程本報告每月發佈，在每個月的第十五天的 00:00 UTC。該報告涵蓋該月最後一個行事曆日的世界標準時間00:00 到 23:59 之間的前一個行事曆月份。例如，5 月 15 日發表的報告涵蓋世界標準時間 4 月 1 日凌晨 00時至 4 月 30 日 23:59 的世界標準時間。

開立帳單收入此報表的已計費收入區段包含上一個行事曆月份的使用量和以付費為基準的費用。以下是欄名稱和說明。

Note

在這份報告中，刊登費用是根據分級上市費用釐定的交易收益的百分比（授權經銷商轉售產品除外）。

203

AWS Marketplace 賣方指南美國銷售與使用稅務報表


客戶AWS帳戶號碼費用收費的帳戶。



城市帳單地址城市與費用計費的帳戶相關聯。

郵遞區碼帳單地址郵遞區號與費用收費的帳戶相關聯。

電子郵件網域與費用計費的帳戶相關聯的電子郵件網域。例如，如果電子郵件地址是[email protected]，條目為example.com。



總收入使用產品所計費的金額或使用產品的每月費用。

AWS營收分成所以此AWS在結算時從結算金額中扣除的費用金額。它會出現在the section called “支付報告” (p. 194)。

總退款交易的任何退款總金額。

AWS退款部分AWS費是退還的交易。

淨營收針對此交易開立帳單的淨金額，減去AWS費用、退款以及美國銷售和使用稅。


AR 期間該月份和年份的交易，在格式YYYY-MM。

交易參考 ID 代表交易的唯一識別碼，您可以使用此識別碼來關聯AWS Marketplace報告。


商機描述已註冊商機中的任何中繼資料。





美國銷售與使用稅務報表本月報告為賣家提供美國銷售和使用稅的相關資訊AWS從銷售和使用交易中收集AWS Marketplace。該報告包括銷售商註冊參加AWS Marketplace美國營業稅徵收服務和 AWS 收取和匯款所需的產品。

204


針對註冊在稅捐計算服務中的產品銷售，報表會包含已計算的美國銷售額，以及具有產品稅碼之產品的使用稅。沒有產品稅碼的任何產品都會顯示在此報表中，稅值為 $0.00 USD。對於因制定的市場促進者規則而無法使用稅捐計算服務的產品銷售，您會看到 AWS 收集和匯款的金額為AWS，根據我們的內部稅務決策。如需詳細資訊，請參閱「」AWS Marketplace 銷售商和稅收徵收上 Amazon Web Services 稅務說明。

若要對映支付報表與此報表之間的交易，請使用Transaction Reference ID。

此報告可在AWS Marketplace管理入口網站報告索引標籤。如果您已註冊AWS Marketplace商務分析服務，您可以使用 API 呼叫來下拉此報表的區段。如需更多詳細資訊，請參閱 the section called “AWSMarketplaceCommerce Analytics Service” (p. 8)。

出版排程本報告在每月第十五天的 00:00 UTC 公佈。該報告涵蓋從 UTC 月份的第一天 00:00 到 UTC 月份的最後一天的前一個月份。例如，5 月 15 日發佈的報告涵蓋世界標準時間 4 月 1 日 00:00 至 4 月 30 日 23:59 的世界標準時間。

美國銷售與使用稅務記錄本節列出由軟體費用產生的美國營業稅金額資料。


明細項目 ID 明細項目的唯一識別符。退款交易與其轉寄稅捐交易具有相同的明細項目識別碼。

客戶帳單 ID 客戶帳單的唯一識別碼。

產品名稱購買產品名稱。


產品稅務代碼識別產品之稅捐屬性的標準代碼。您可以在建立或修改產品時選擇屬性。

賣方帳號賣方的唯一識別符。

賣方姓名賣家的合法名稱。

交易日期交易的日期。

調整後價格總計交易的最終價格。

稅務總計針對交易收取的稅捐總額。

基本貨幣代碼所有的基本貨幣代碼AWS Marketplace交易。此項目一律為美元。

寄出城市與我們向其收取軟體費用的付款人帳戶相關聯的帳單地址城市。

寄送州與軟體費用計費的付款人帳戶相關聯的帳單地址郵遞區號。

寄送郵遞區號的帳單帳單地址郵遞區號與軟體費用計費的付款人帳戶相關聯。

付款國家與軟體費用計費的付款人帳戶相關聯的兩個字元國碼。本報告採用 ISO 3166-1 alpha-2。

205

http://aws.amazon.com/tax-help/marketplace



交易型態代碼交易的類型代碼。有效值：

• AWS：向前稅捐交易• REFUND: 全額或部分退款• TAXONLYREFUND: 僅限稅項退款

退款交易會與其原始向前交易共用明細行項目識別碼。

顯示價格可稅性型態對客戶而言，價格的應稅性型態。All (全部)AWSMarketplace產品是獨家的。

稅捐地點代碼稅捐管轄區與徵稅位置相關聯的頂點地理代碼。

稅務型態代碼套用到交易的稅金型態。可能的值為None、Sales和 SellerUse。

管轄區級別用於稅捐地點之地址的管轄區層次。可能的值為State、County、City，以及District。

稅務管轄區稅務管轄區的名稱。

應稅銷售金額依管轄區層次的應稅交易金額。

不應稅銷售金額依管轄區層次分類的不應稅交易金額。

稅務金額在管轄區層次收取的稅捐。

稅捐管轄區稅率在管轄區層次套用的稅率。

稅捐計算原因代碼交易是否為應稅、不應稅、免稅或零分級，依管轄區層次組織。

用於計算稅捐的日期用於計算交易稅捐的日期。

客戶免除憑證 ID 免除憑證的憑證 ID。

客戶豁免憑證識別碼網域證書被存儲在亞馬遜系統中的地方。

客戶免除憑證等級提供豁免的管轄區層次。

客戶免除代碼指定豁免的程式碼：例如 RESALE。

客戶免除網域用於捕獲客戶豁免信息的亞馬遜系統，如果信息可用。




206

AWS Marketplace 賣方指南資料饋送


稅務責任關係人此欄位會填入Seller或AWS。如果賣方是稅務責任方，他們有責任根據他們的稅務決定自己的收款和匯款義務。如果 AWS 是稅務責任關係人銷售稅，AWS 將收取並匯出。如需詳細資訊，請參閱「」AWS Marketplace 銷售商和稅收徵收上Amazon Web Services 稅務說明。

資料饋送AWS Marketplace提供多種資料摘要，協助銷售者收集及分析您產品銷售的相關資訊。資料摘要可供所有已註冊AWS Marketplace賣方。由於資料摘要是在一天內產生，因此它們包含最新的可用資料。

此頁面提供資料摘要的概觀，並說明如何存取和使用這些摘要。後續頁面會說明每個資料摘要。

資料饋送的儲存與結構資料摘要會收集逗號分隔值 (CSV) 檔案，並將其傳遞至您提供的加密 Amazon S3 儲存貯體。CSV 檔案具有下列特性：

• 他們跟隨4180 個標準。• 字符編碼是沒有 BOM 的 UTF-8。• 逗號用作值之間的分隔符。• 欄位會以雙引號逸出。• \n是換行字元。• 日期以 UTC 時區報告，採用 ISO 8601 日期和時間格式，並且在 1 秒內準確無誤。• All (全部)*_period_start_date和*_period_end_date值是包含的，這意味著23:59:59是任何一天

的最後可能的時間戳。• 所有貨幣欄位前面都有貨幣欄位。• 貨幣字段使用句點（.）字符作為小數分隔符，並且不要使用逗號（，）作為千位分隔符。

資料摘要會產生並儲存如下：

• 資料摘要會在一天內產生，並包含前一天的 24 小時資料。• 在 Amazon S3 儲存貯體中，資料饋送會使用下列格式按月組織：

bucket-name/data-feed-name_version/year=YYYY/month=MM/data.csv

• 產生每個每日資料摘要時，它會附加到該月的現有 CSV 檔案中。當新的月份開始時，會為每個資料摘要產生新的 CSV 檔案。

• 資料摘要中的資訊在二 ○ 一 ○ 年一月一日至二 ○ 一 ○ 年四月三十日（含）回填，並可在CSV 檔案 (p. 207)中的year=2010/month=01子資料夾。

您可能會注意到指定資料摘要的目前月份檔案僅包含欄標頭，且沒有資料的情況。這表示該月份的摘要沒有新的項目。這可能會發生在較不頻繁更新的資料摘要 (例如產品摘要)。在這些情況下，資料可以在回填資料夾中使用。

• 在 Amazon S3 中，您可以創建一個Amazon S3 生命週期政策來管理文件在存儲桶中保留多長時間。• 您可以設定 Amazon SNS 以在資料交付到加密的 S3 儲存貯體時通知您。如需如何設定通知的相關資訊，

請參閱Amazon SNS 入門中的Amazon Simple Notification Service 開發人員指南。

207


https://tools.ietf.org/html/rfc4180

https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-lifecycle.html

https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html

AWS Marketplace 賣方指南存取資料饋送

數據的歷史化每個資料摘要都包含記錄資料歷程記錄的資料行。除非valid_to，這些資料行對所有資料饋送都是通用的。它們被包含為一個常見的歷史記錄模式，並且在查詢數據時非常有用。


驗證第一個日期，該主鍵的值是有效的相對於其他字段的值。

驗證至此資料行只會顯示在Address (p. 228)資料摘要，且永遠為空白。

插入日期 (_D) 記錄插入資料摘要的日期。

更新日期 (_D) 上次更新記錄的日期。

刪除日期 (_D) 此欄永遠為空白。

以下顯示這些資料行的範例。

驗證驗證至插入日期 (_D) 更新日期 (_D) 刪除日期 (_D)

2018-12-12 分鐘02:00:00 Z

2018-12-12 分鐘02:00:00 Z

2018-12-12 分鐘02:00:00 Z

2019 年 3 月 29 日 2019 年 3 月 29 日 2019 年 3 月 29 日

2019 年 3 月 29 日 2019 年 3 月 29 日 2019-04-28 分鐘04-28 分鐘

所以此valid_from和update_date字段組成一個雙時間資料模型。所以此valid_from欄位會告訴您項目何時有效來源。如果項目已編輯，它可以在摘要中有多個記錄，每個記錄都有不同的update_date，但相同的valid_from日期。例如，若要尋找項目的目前值，您會發現具有最新update_date，從具有最新的記錄列表valid_from日期。

在上面的例子中，記錄最初創建 2018-12-12。然後在 2019-03-29 更改了它（例如，如果記錄中的地址發生了變化）。後來，在 2019-04-28 年，地址變化得到了糾正（所以valid_from沒有改變，但update_date做了）。更正地址（罕見事件）追溯地更改記錄從原始valid_from日期，所以該字段不會改變。查詢以查找最新valid_from將返回兩條記錄，其中包含最新的update_date為您提供實際的當前記錄。

存取資料饋送若要存取資料饋送，您需要將環境設定為接收到加密的 Amazon S3 儲存貯體的資料饋送。AWSMarketplace提供AWS CloudFormation範本，您可以使用它來簡化設定。

Note

若要存取資料摘要，您需要授予AWS Marketplace。當您完成AWS CloudFormation範本。如果您尚未擁有 IAM 角色，請參閱IAM 角色中的IAM 使用者指南。

使用AWS CloudFormation範本，以設定您的環境以接收資料饋送

1. 移至設定客戶資料儲存。

208

https://s3.amazonaws.com/aws-marketplace-reports-resources/DataFeedsResources.yaml

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html

http://aws.amazon.com/marketplace/management/reports/data-feed-configuration

AWS Marketplace 賣方指南使用資料饋送

2. 選擇透過建立資源AWS CloudFormation範本以開啟範本AWS CloudFormation主控台。3. 在範本中，指定下列項目，然後選擇下一頁：

• 堆疊名稱 — 您正在建立用來存取資料摘要的資源集合。• Amazon S3 儲存貯體名稱 — 用於儲存資料饋送的儲存貯體。• (選擇性) Amazon SNS 主題名稱 — 在AWS會將新資料交付到 Amazon S3 儲存貯體。

4. 在檢閱頁面上，確認您的輸入並選擇建立堆疊。5. 在下一個畫面上，選擇您建立的 IAM 角色以搭配AWS Marketplace(請參閱注意 (p. 208))，然後選擇下

一頁。6. 從資源索引標籤上，將下列資源的 Amazon Resource Name (ARN) 複製到AWS Marketplace 設定客戶

資料儲存(U) 頁面：

• 用於儲存資料饋送的 Amazon S3 儲存貯體• AWS KMS加密 Amazon S3 儲存貯體的金鑰• (選擇性) Amazon SNS 主題，用於在AWS將新資料交付到 Amazon S3 儲存貯體

7. 在設定客戶資料儲存頁面，選擇送出。

您現在已訂閱資料摘要。下次產生資料摘要時，您可以存取資料。

如需有關的詳細資訊AWS CloudFormation範本，請參閱使用AWS CloudFormation範本中的AWSCloudFormation使用者指南。

使用資料饋送當您的 Amazon S3 儲存貯體中有資料可用時，您可以透過下列方式使用資料饋送：

• 從您在中建立的 Amazon S3 儲存貯體下載 .CSV 檔案存取資料饋送 (p. 208)，讓您可以在試算表中檢視資料。

• 使用 ETL (擷取、轉換、載入)、SQL 查詢、商務分析工具收集和分析資料。

您可以使用AWS服務來收集和分析資料，或任何可以執行 .csv 資料集分析的協力廠商工具。

範例：使用AWS收集和分析資料的服務下列程序假設您已將環境設定為接收到 Amazon S3 儲存貯體的資料饋送，且儲存貯體包含資料饋送。

收集和分析資料摘要中的資料

1. 從AWS Glue主控台、建立編目程式連接到存放資料饋送的 Amazon S3 儲存貯體、擷取所需資料，以及在AWS Glue Data Catalog。

如需 AWS Glue 的詳細資訊，請參閱 AWS Glue 開發人員指南。2. 從Athena 控制台、在資料上執行 SQL 查詢AWS Glue Data Catalog。

如需 Athena 的詳細資訊，請參閱Amazon Athena 使用者指南。3. 從Amazon QuickSight 主控台、建立分析然後建立視覺化效果資料。

如需 Amazon QuickSight 的詳細資訊，請參閱Amazon QuickSight 使用者指南。

如需使用的一種方法的詳細示例AWS服務來收集和分析資料摘要中的資料，請參閱使用賣家數據饋送服務，Amazon Athena 和 Amazon QuickSight 創建賣家報告在AWS Marketplace部落格。

209



https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html

https://console.aws.amazon.com/glue

https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html

https://docs.aws.amazon.com/glue/latest/dg/what-is-glue.html

https://console.aws.amazon.com/athena

https://docs.aws.amazon.com/athena/latest/ug/querying-athena-tables.html

https://docs.aws.amazon.com/athena/latest/ug/what-is.html

http://quicksight.aws.amazon.com

https://docs.aws.amazon.com/quicksight/latest/user/creating-an-analysis.html

https://docs.aws.amazon.com/quicksight/latest/user/creating-a-visual.html

https://docs.aws.amazon.com/quicksight/latest/user/welcome.html

http://aws.amazon.com/blogs/awsmarketplace/using-seller-data-feed-delivery-service-amazon-athena-and-amazon-quicksight-to-create-seller-reports/

http://aws.amazon.com/blogs/awsmarketplace/using-seller-data-feed-delivery-service-amazon-athena-and-amazon-quicksight-to-create-seller-reports/

AWS Marketplace 賣方指南資料摘要表格概觀

資料摘要表格概觀所以此AWS Marketplace提供的資料摘要是一組表格，您可以連接在一起，以便為您的查詢提供更多上下文。

您的資料摘要中有三個一般網域或感興趣的類別：

• 目錄— 包含您帳戶中產品和優惠的相關資訊。• 帳戶— 包括提供或購買產品之帳戶的相關資訊AWS Marketplace(您自己的帳戶或合作夥伴帳戶，例如通路

合作夥伴或買方)。• Revenue (營收)— 包括帳單、支付和稅金的相關資訊。

下圖顯示每個網域中的資料表，以及如何相互關聯的資料表。此圖表顯示「目錄」、「帳戶」和「收入」網域，包括其中的表格。

下列各節將詳細說明實體關係(ER) 每個網域的圖表。每個 ER 圖顯示的表和每個表中的字段，以及您可以用來連接表的字段。

Note

本節中的 ER 圖不包含所有資料饋送的一般欄位。如需常見欄位的詳細資訊，請參閱資料饋送的儲存與結構 (p. 207)。

下表描述 ER 圖中使用的符號。

符號描述

Primary key (主索引鍵)— 資料表的主索引鍵。當與valid_from和update_date字段中，它是唯一的。如需搭配使用這些欄位的詳細資訊，請參閱數據的歷史化 (p. 208)。如果多個字段被標記為主鍵，那麼這些字段一起形成主鍵。

210


符號描述

外部索引鍵— 代表不同表格中主索引鍵的欄位。表格中不一定是唯一的。

Note

在某些情況下，如果目前資料表中的記錄沒有外部資料表中的對應記錄，外部索引鍵可以是空白的。

替代索引鍵— 可做為表格中索引鍵使用的索引鍵。遵循與主鍵相同的唯一性規則。

連接器— 欄位之間的行代表連線，這是兩個可用來結合表格的欄位。線的端點表示連接的類型。此範例代表一對多連線。

連接器類型

下表顯示每個連接器可能具有的端點類型。

連接器類型描述

1 到 n— 具有此端點的連接器代表在接合的這一端只有一個值的接合。

零或一到 n— 具有此端點的連接器代表聯結這一端有零或一個值的聯結。

零個或多個到 n— 具有此端點的連接器代表聯結這一端有零、一或多個值的聯結。

一個或多個對 n— 具有此端點的連接器代表在此端有一個或多個值的連接。

與目錄相關的表格下圖顯示目錄網域中資料表之間的關係，以及資料表中的欄位。

211


所以此Product、Offer_Product、Offer、Offer_Target，以及Legacy_id_mapping_table 位於目錄網域中。

所以此Offer_Target資料表的值欄位包含account_id的目標，但只有當target_type值為account。

所以此Legacy_id_mapping資料表不會用於目前的資料。

Note

如需有關這些表格的詳細資訊，包括表格中每個欄位的說明以及可以創建的連接的詳細說明，請參閱下列主題：

• 產品資料饋送 (p. 241)• 提供產品資料饋送 (p. 239)

212


• 優惠資料饋送 (p. 238)• 提供目標資料饋送 (p. 240)• 舊式對映資料饋送 (p. 237)

與帳戶相關的表格下圖顯示的關係Account和Address表格，以及表格中的欄位。

Note


• 帳戶資料饋送 (p. 226)

213


• 位址資料饋送 (p. 228)

与收入有关的表格下圖顯示的關係Billing_Event和Tax_Item表格，以及表格中的欄位。所以此Billing_Event資料表包含付款的相關資訊，以及帳單事件。

214


215

AWS Marketplace 賣方指南資料摘要查詢範例

Note


• 帳單事件資料饋送 (p. 229)• 稅務項目資料饋送 (p. 242)

資料摘要查詢範例本節提供了使用提供的數據饋送複雜查詢的例子AWS Marketplace。這些範例類似於賣方報告 (p. 186)，您可以從AWS Marketplace管理入口網站。您可以自訂這些查詢，以建立您需要的其他報告。

範例 1：依產品分類的付款若要找出已由產品支付的金額，您可以執行如下所示的查詢。這個例子可以媲美支付報告 (p. 194)你可以得到作為賣家報告。不過，您可以使用此範例來建置您自己的查詢，並自訂它，以取得您所需的完全報告。

這組範例查詢建立在彼此之間，以建立含支付的產品詳細資料的最終清單。它也展示如何在特定時間點取得產品資訊。查詢中的註釋解釋查詢正在做什麼，以及如何修改它們以獲取數據的不同視圖。

Note

執行此查詢時，我們假設擷取的資料使用兩個時間軸 (valid_from 資料行和更新資料行)。如需詳細資訊，請參閱資料饋送的儲存與結構 (p. 207)。

-- Get all the products and keep the latest product_id, valid_from tuple with products_with_uni_temporal_data as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY product_id, valid_from ORDER BY from_iso8601_timestamp(update_date) desc) as row_num from productfeed_v1 ) where -- A product_id can appear multiple times with the same -- valid_from date but with a different update_date column, -- making it effectively bi-temporal. By only taking the most -- recent tuple, we are converting to a uni-temporal model. row_num = 1 ),

-- Gets the latest revision of a product -- A product can have multiple revisions where some of the -- columns, like the title, can change. -- For the purpose of the disbursement report, we want -- to get the latest revision of a product products_with_latest_version as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY product_id ORDER BY from_iso8601_timestamp(valid_from) desc)

216


as row_num_latest_version from products_with_uni_temporal_data ) where row_num_latest_version = 1 ),

-- Get all the accounts and keep the latest account_id, valid_from tuple accounts_with_uni_temporal_data as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY account_id, valid_from ORDER BY from_iso8601_timestamp(update_date) desc) as row_num from accountfeed_v1 ) where -- An account_id can appear multiple times with the same -- valid_from date but with a different update_date column, -- making it effectively bi-temporal. By only taking the most -- recent tuple, we are converting to a uni-temporal model. row_num = 1 ),

-- Gets the latest revision of an account -- An account can have multiple revisions where some of the -- columns, like the mailing_address_id, can change. -- For the purpose of the disbursement report, we want -- to get the latest revision of a product accounts_with_latest_version as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY account_id ORDER BY from_iso8601_timestamp(valid_from) desc) as row_num_latest_version from accounts_with_uni_temporal_data ) where row_num_latest_version = 1 ),

-- Get all the billing events and keep the -- latest billing_event_id, valid_from tuple: billing_events_with_uni_temporal_data as ( select * from ( select billing_event_id, from_iso8601_timestamp(valid_from) as valid_from, from_iso8601_timestamp(update_date) as update_date, from_iso8601_timestamp(invoice_date) as invoice_date, transaction_type, transaction_reference_id, product_id, disbursement_billing_event_id,

217


action, from_account_id, to_account_id, end_user_account_id, CAST(amount as decimal(20, 10)) invoice_amount, bank_trace_id, ROW_NUMBER() OVER (PARTITION BY billing_event_id, valid_from ORDER BY from_iso8601_timestamp(update_date) desc) as row_num from billingeventfeed_v1 ) where row_num = 1 ),

-- Get all the disbursements -- The billing events data is immutable. -- It is not required to use time windows based on the -- valid_from column to get the most recent billing event disbursement_events as ( select billing_events_raw.billing_event_id as disbursement_id, billing_events_raw.invoice_date as disbursement_date, billing_events_raw.bank_trace_id from billing_events_with_uni_temporal_data billing_events_raw where -- Only interested in disbursements, so filter out -- non-disbursements by selecting transaction type -- to be DISBURSEMENT: billing_events_raw.transaction_type = 'DISBURSEMENT' -- Select a time period, you can adjust the dates -- below if need be. For billing events use the -- invoice date as the point in time of the -- disbursement being initiated: and billing_events_raw.invoice_date >= from_iso8601_timestamp('2020-10-01T00:00:00Z') and billing_events_raw.invoice_date < from_iso8601_timestamp('2020-11-01T00:00:00Z') ),

-- Get the invoices along with the line items that -- are part of the above filtered disbursements disbursed_line_items as ( select line_items.transaction_reference_id, line_items.product_id, line_items.transaction_type, (case -- Get the payer of the invoice from any -- transaction type that is not AWS and -- not BALANCE_ADJUSTMENT. -- For AWS and BALANCE_ADJUSTMENT, the billing -- event feed will show the "AWS Marketplace" -- account as the receiver of the funds and the -- seller as the payer. Filter those out. when line_items.transaction_type not like '%AWS%' and transaction_type not like 'BALANCE_ADJUSTMENT' then line_items.from_account_id end) as payer_account_id, line_items.end_user_account_id, invoice_amount, disbursements.disbursement_date, disbursements.disbursement_id, disbursements.bank_trace_id

218


from billing_events_with_uni_temporal_data line_items -- Each disbursed line item is linked to the parent -- disbursement via the disbursement_billing_event_id join disbursement_events disbursements on disbursements.disbursement_id = line_items.disbursement_billing_event_id where -- we are interested only in the invoice line -- items that are DISBURSED line_items.action = 'DISBURSED' ),

-- An invoice can contain multiple line items -- Create a pivot table to calculate the different -- amounts that are part of an invoice. -- The new row is aggregated at -- transaction_reference_id - end_user_account_id level invoice_amounts_aggregated as ( select transaction_reference_id, product_id, -- a given disbursement id should have the -- same disbursement_date max(disbursement_date) as disbursement_date, -- Build a pivot table in order to provide all the -- data related to a transaction in a single row. -- Note that the amounts are negated. This is because -- when an invoice is generated, we give you the -- positive amounts and the disbursement event -- negates the amounts sum(case when transaction_type = 'SELLER_REV_SHARE' then -invoice_amount else 0 end) as seller_rev_share, sum(case when transaction_type = 'AWS_REV_SHARE' then -invoice_amount else 0 end) as aws_rev_share, sum(case when transaction_type = 'SELLER_REV_SHARE_REFUND' then -invoice_amount else 0 end) as seller_rev_refund, sum(case when transaction_type = 'AWS_REV_SHARE_REFUND' then -invoice_amount else 0 end) as aws_rev_refund, sum(case when transaction_type = 'SELLER_REV_SHARE_CREDIT' then -invoice_amount else 0 end) as seller_rev_credit, sum(case when transaction_type = 'AWS_REV_SHARE_CREDIT' then -invoice_amount else 0 end) as aws_rev_credit, sum(case when transaction_type = 'SELLER_TAX_SHARE' then -invoice_amount else 0 end) as seller_tax_share, sum(case when transaction_type = 'SELLER_TAX_SHARE_REFUND' then -invoice_amount else 0 end) as seller_tax_refund, -- This is the account that pays the invoice: max(payer_account_id) as payer_account_id, -- This is the account that subscribed to the product: end_user_account_id as customer_account_id, bank_trace_id from disbursed_line_items group by transaction_reference_id, product_id, disbursement_id, -- There might be a different end-user for the same -- transaction reference id. Distributed licenses -- is an example end_user_account_id, bank_trace_id),

disbursed_amount_by_product as (

219


select products.title as ProductTitle, products.product_code as ProductCode, -- We are rounding the sums using 2 decimal precision -- Note that the rounding method might differ -- between SQL implementations. -- The disbursement seller report is using -- RoundingMode.HALF_UP. This might create -- discrepancies between this SQL output -- and the disbursement seller report round(invoice_amounts.seller_rev_share, 2) as SellerRev, round(invoice_amounts.aws_rev_share, 2) as AWSRefFee, round(invoice_amounts.seller_rev_refund, 2) as SellerRevRefund, round(invoice_amounts.aws_rev_refund, 2) as AWSRefFeeRefund, round(invoice_amounts.seller_rev_credit, 2) as SellerRevCredit, round(invoice_amounts.aws_rev_credit, 2) as AWSRefFeeCredit, ( round(invoice_amounts.seller_rev_share, 2) + round(invoice_amounts.aws_rev_share, 2) + round(invoice_amounts.seller_rev_refund, 2) + round(invoice_amounts.aws_rev_refund, 2) + round(invoice_amounts.seller_rev_credit, 2) + round(invoice_amounts.aws_rev_credit, 2) ) as NetAmount, invoice_amounts.transaction_reference_id as TransactionReferenceID, round(invoice_amounts.seller_tax_share, 2) as SellerSalesTax, round(invoice_amounts.seller_tax_refund, 2) as SellerSalesTaxRefund, payer_info.aws_account_id as PayerAwsAccountId, customer_info.aws_account_id as EndCustomerAwsAccountId, invoice_amounts.disbursement_date as DisbursementDate, invoice_amounts.bank_trace_id as BankTraceId from invoice_amounts_aggregated invoice_amounts join products_with_latest_version products on products.product_id = invoice_amounts.product_id left join accounts_with_latest_version payer_info on payer_info.account_id = invoice_amounts.payer_account_id left join accounts_with_latest_version customer_info on customer_info.account_id = invoice_amounts.customer_account_id)

select * from disbursed_amount_by_product;

範例 2：銷售薪酬報告若要依客戶尋找已計費的收入，您可以執行如下所示的查詢。這個例子可以媲美銷售報告 (p. 203)你可以得到作為賣家報告。不過，您可以使用此範例來建置您自己的查詢，並自訂它，以取得您所需的完全報告。

這是一組相互建立的範例查詢，以建立客戶詳細資料的最終清單，其中包含計費給每位客戶使用您的軟體的總金額。查詢中的註釋解釋查詢正在做什麼，以及如何修改它們以獲取數據的不同視圖。

Note

執行此查詢時，我們假設擷取的資料使用兩個時間軸 (valid_from 資料行和更新資料行)。如需詳細資訊，請參閱資料饋送的儲存與結構 (p. 207)。

-- Gets all the products and keeps the latest product_id,

220


-- valid_from tuple. with products_with_uni_temporal_data as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY product_id, valid_from ORDER BY from_iso8601_timestamp(update_date) desc) as row_num from productfeed_v1 ) where -- A product_id can appear multiple times with the same -- valid_from date but with a different update_date column, -- making it effectively bi-temporal. By only taking the most -- recent tuple, we are converting to a uni-temporal model. row_num = 1 ),

-- Gets the latest revision of a product -- A product can have multiple revisions where some of the -- columns, like the title, can change. -- For the purpose of the sales compensation report, we want -- to get the latest revision of a product products_with_latest_revision as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY product_id ORDER BY from_iso8601_timestamp(valid_from) desc) as row_num_latest_revision from products_with_uni_temporal_data ) where row_num_latest_revision = 1 ),

-- Gets all the addresses and keeps the latest address_id, -- aws_account_id, and valid_from combination. -- We're transitioning from a bi-temporal data model to an -- uni-temporal data_model piifeed_with_uni_temporal_data as ( select * from ( select *, ROW_NUMBER() OVER ( PARTITION BY address_id, aws_account_id, valid_from ORDER BY from_iso8601_timestamp(update_date) desc) as row_num from piifeed ) where -- An address_id can appear multiple times with the same -- valid_from date but with a different update_date column. -- We are only interested in the most recent. row_num = 1

221


),

-- Gets the latest revision of an address. -- An address_id can have multiple revisions where some of -- the columns can change. -- For the purpose of the sales compensation report, we want to -- get the latest revision of an address + account_id pair. pii_with_latest_revision as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY address_id, aws_account_id ORDER BY from_iso8601_timestamp(valid_from) desc) as row_num_latest_revision from piifeed_with_uni_temporal_data ) where row_num_latest_revision = 1 ),

-- Gets all the accounts and keeps the latest -- account_id, valid_from tuple. -- We're transitioning from a bi-temporal data -- model to an uni-temporal data_model. accounts_with_uni_temporal_data as ( select * from ( select *, ROW_NUMBER() OVER (PARTITION BY account_id, valid_from ORDER BY from_iso8601_timestamp(update_date) desc) as row_num from accountfeed_v1 ) where -- An account_id can appear multiple times with the same -- valid_from date but with a different update_date column. -- We are only interested in the most recent tuple. row_num = 1 ),

-- Gets all the historical dates for an account -- An account can have multiple revisions where some of the -- columns like the mailing_address_id can change. accounts_with_history as ( select *, -- This interval's begin_date case when -- First record for a given account_id lag(valid_from, 1) over (partition by account_id order by from_iso8601_timestamp(valid_from) asc) is null then -- 'force' begin_date a bit earlier because of different -- data propagation times. We'll subtract one day as one -- hour is not sufficient from_iso8601_timestamp(valid_from) - INTERVAL '1' DAY else

222


-- not the first line -> return the real date from_iso8601_timestamp(valid_from) end as begin_date, -- This interval's end date. COALESCE( LEAD(from_iso8601_timestamp(valid_from), 1) OVER (partition by account_id ORDER BY from_iso8601_timestamp(valid_from)), from_iso8601_timestamp('9999-01-01T00:00:00Z') ) as end_date from accounts_with_uni_temporal_data ),

-- Gets all the billing events and keeps the latest -- billing_event_id, valid_from tuple. -- We're transitioning from a bi-temporal data -- model to an uni-temporal data_model. billing_events_with_uni_temporal_data as ( select * from ( select billing_event_id, from_iso8601_timestamp(valid_from) as valid_from, from_iso8601_timestamp(update_date) as update_date, from_iso8601_timestamp(invoice_date) as invoice_date, transaction_type, transaction_reference_id, product_id, disbursement_billing_event_id, action, currency, from_account_id, to_account_id, end_user_account_id, -- convert an empty billing address to null. This will -- later be used in a COALESCE call case when billing_address_id <> '' then billing_address_id else null end as billing_address_id, CAST(amount as decimal(20, 10)) invoice_amount, ROW_NUMBER() OVER (PARTITION BY billing_event_id, valid_from ORDER BY from_iso8601_timestamp(update_date) desc) as row_num from billingeventfeed_v1 where -- The Sales Compensation Report does not contain BALANCE -- ADJUSTMENTS, so we filter them out here transaction_type <> 'BALANCE_ADJUSTMENT' -- Keep only the transactions that will affect any -- future disbursed amounts. and balance_impacting = '1' ) where row_num = 1 ),

-- Gets the billing address for all DISBURSED invoices. This -- will be the address of the payer when the invoice was paid. -- NOTE: For legal reasons, for CPPO transactions, the -- manufacturer will not see the payer's billing address id billing_addresses_for_disbursed_invoices as ( select billing_events_raw.transaction_reference_id, billing_events_raw.billing_address_id,

223


billing_events_raw.from_account_id from billing_events_with_uni_temporal_data billing_events_raw where -- the disbursed items will contain the billing address id billing_events_raw.action = 'DISBURSED' -- we only want to get the billing address id for the -- transaction line items where the seller is the receiver -- of the amount and billing_events_raw.transaction_type like 'SELLER_%' group by billing_events_raw.transaction_reference_id, billing_events_raw.billing_address_id, billing_events_raw.from_account_id ),

-- An invoice can contain multiple line items. -- We create a pivot table to calculate the different amounts -- that are part of an invoice. -- The new row is aggregated at -- transaction_reference_id - end_user_account_id level invoiced_and_forgiven_transactions as ( select transaction_reference_id, product_id, -- A transaction will have the same invoice date for all -- of its line items (transaction types) max(invoice_date) as invoice_date, -- A transaction will have the same billing_address_id -- for all of its line items. Remember that the billing event -- is uni temporal and we retrieved only the latest valid_from item max(billing_address_id) as billing_address_id, -- A transaction will have the same currency for all -- of its line items max(currency) as currency, -- We're building a pivot table in order to provide all the -- data related to a transaction in a single row sum(case when transaction_type = 'SELLER_REV_SHARE' then invoice_amount else 0 end) as seller_rev_share, sum(case when transaction_type = 'AWS_REV_SHARE' then invoice_amount else 0 end) as aws_rev_share, sum(case when transaction_type = 'SELLER_REV_SHARE_REFUND' then invoice_amount else 0 end) as seller_rev_refund, sum(case when transaction_type = 'AWS_REV_SHARE_REFUND' then invoice_amount else 0 end) as aws_rev_refund, sum(case when transaction_type = 'SELLER_REV_SHARE_CREDIT' then invoice_amount else 0 end) as seller_rev_credit, sum(case when transaction_type = 'AWS_REV_SHARE_CREDIT' then invoice_amount else 0 end) as aws_rev_credit, sum(case when transaction_type = 'SELLER_TAX_SHARE' then invoice_amount else 0 end) as seller_tax_share, sum(case when transaction_type = 'SELLER_TAX_SHARE_REFUND' then invoice_amount else 0 end) as seller_tax_refund, -- this is the account that pays the invoice. max(case -- Get the payer of the invoice from any transaction type -- that is not AWS and not BALANCE_ADJUSTMENT. -- For AWS and BALANCE_ADJUSTMENT, the billing event feed -- will show the "AWS Marketplace" account as the -- receiver of the funds and the seller as the payer. We -- are not interested in this information here. when transaction_type not like '%AWS%' and transaction_type not like 'BALANCE_ADJUSTMENT' then from_account_id end) as payer_account_id,

224


-- this is the account that subscribed to your product end_user_account_id as customer_account_id from billing_events_with_uni_temporal_data where -- Get invoiced or forgiven items. Disbursements are -- not part of the sales compensation report action in ('INVOICED', 'FORGIVEN') group by transaction_reference_id, product_id, -- There might be a different end-user for the same -- transaction reference id. Distributed licenses -- is an example. end_user_account_id),

invoiced_items_with_product_and_billing_address as ( select invoice_amounts.*, products.product_code, products.title, payer_info.aws_account_id as payer_aws_account_id, payer_info.account_id as payer_reference_id, customer_info.aws_account_id as end_user_aws_account_id, ( invoice_amounts.seller_rev_share + invoice_amounts.aws_rev_share + invoice_amounts.seller_rev_refund + invoice_amounts.aws_rev_refund + invoice_amounts.seller_rev_credit + invoice_amounts.aws_rev_credit + invoice_amounts.seller_tax_share + invoice_amounts.seller_tax_refund ) as seller_net_revenue, -- Try to get the billing address from the DISBURSED event -- (if any). If there is no DISBURSEMENT, get the billing -- address from the INVOICED item. If still no billing address, -- then default to getting the mailing address of the payer. coalesce(billing_add.billing_address_id, invoice_amounts.billing_address_id, payer_info.mailing_address_id) as final_billing_address_id from invoiced_and_forgiven_transactions invoice_amounts join products_with_latest_revision products on products.product_id = invoice_amounts.product_id left join accounts_with_history payer_info on payer_info.account_id = invoice_amounts.payer_account_id -- Get the Payer Information at the time of invoice creation and payer_info.begin_date <= invoice_amounts.invoice_date and invoice_amounts.invoice_date < payer_info.end_date left join accounts_with_history customer_info on customer_info.account_id = invoice_amounts.customer_account_id -- Get the End User Information at the time of invoice creation and customer_info.begin_date <= invoice_amounts.invoice_date and invoice_amounts.invoice_date < customer_info.end_date left join billing_addresses_for_disbursed_invoices billing_add on billing_add.transaction_reference_id = invoice_amounts.transaction_reference_id and billing_add.from_account_id = invoice_amounts.payer_account_id),

invoices_with_full_address as ( select

225

AWS Marketplace 賣方指南帳戶資料饋送

payer_aws_account_id as "Customer AWS Account Number", pii_data.country as "Country", pii_data.state_or_region as "State", pii_data.city as "City", pii_data.postal_code as "Zip Code", pii_data.email_domain as "Email Domain", product_code as "Product Code", title as "Product Title", seller_rev_share as "Gross Revenue", aws_rev_share as "AWS Revenue Share", seller_rev_refund as "Gross Refunds", aws_rev_refund as "AWS Refunds Share", seller_net_revenue as "Net Revenue", currency as "Currency", date_format(invoice_date, '%Y-%m')as "AR Period", transaction_reference_id as "Transaction Reference ID", payer_reference_id as "Payer Reference ID", end_user_aws_account_id as "End Customer AWS Account ID" from invoiced_items_with_product_and_billing_address invoice_amounts left join pii_with_latest_revision pii_data on pii_data.aws_account_id = invoice_amounts.payer_aws_account_id and pii_data.address_id = invoice_amounts.final_billing_address_id -- Filter out FORGIVEN and Field Demonstration Pricing transactions where seller_net_revenue <> 0)

select * from invoices_with_full_address;

帳戶資料饋送此資料摘要提供與您互動的所有帳戶相關的資訊：您自己的帳戶、合作的任何通路合作夥伴、買家、付款人，以及所有稅務帳戶。

帳戶資料是不可變的，而且不會與版本號碼相關聯。會附加對欄位的變更，因此此資料饋送可能有多個具有相同account_id和不同valid_from值。如需資料歷程記錄欄位的資訊，請參閱數據的歷史化 (p. 208)。

帳戶資料摘要每 24 小時重新整理一次，因此每天都有新的資料可供使用。

下表說明資料饋送欄的名稱和說明。


account_id 帳戶的全域唯一識別碼 (GUID)。

可用於聯結到欄位中的Product、Offer_Target、Billing_Event，以及Tax_Item資料饋送。請參閱這些資料摘要，以取得有關可用來關連之欄位的資訊。

aws_account_id 所以此AWS賣家的帳號AWS帳戶，這是AWS磁碟分割。

加密帳號代碼您應用程式中個別買家的唯一加密 ID。的值encrypted_account_id是由AWS Marketplace計量服務，例如，作為CustomerIdentifier會傳回ResolveCustomer動作。

郵件地址代碼此帳戶的郵寄地址參考。

226


AWS Marketplace 賣方指南帳戶資料饋送


代碼此帳戶的稅捐地址參考。

稅務註冊號碼若為非美國帳戶，則為此帳戶的統一編號。

法律名稱若為非美國帳戶，則為合法公司名稱。這是稅捐發票上使用的名稱。

帳戶資料摘要範例以下顯示帳戶資料摘要的範例。為了可讀性，不會顯示資料歷程記錄欄。如需資料歷程記錄欄位的資訊，請參閱數據的歷史化 (p. 208)。

account_id aws_account_id加密帳號代碼

郵件地址代碼

代碼稅務註冊號碼

法律名稱

XK0CSMiam6PQ4QEEG9IIAO酒店

444456660000ZF7 歐茲格溫

25O3K46 伊芙菲菲菲菲菲菲菲菲菲菲菲菲菲菲菲菲菲菲菲菲

7 年代 5 年代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代

555567679999373 瓦格目錄第八季

5AJ6 對應快速輸出 2 對應快速輸出9 對應快速輸出 8 對應

5AJ6 對應快速輸出 2 對應快速輸出9 對應快速輸出 8 對應

你可以選擇

維加 2T9J3米克歐 9C8米克歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐

73739998888 8 斯派克米爾8 毫米瓦特

不可思議的5GL5GL5QM8DB7

V5NH 比比約格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格

D469558025

227

AWS Marketplace 賣方指南位址資料饋送

位址資料饋送此資料摘要提供您與之互動的所有帳戶的聯絡資訊：您自己的帳戶、合作的任何通路合作夥伴、買家、付款人，以及所有納稅帳戶。每次發生新交易時，系統都會掃描交易的客戶地址，如果該交易不在您的資料摘要中，則會新增一個項目至您的資料摘要檔案。

位址資料不可變。

地址資料摘要每 24 小時重新整理一次，因此每天都有新的資料可供使用。



位址 ID 地址的唯一密鑰。

可用於聯結Billing_Event資料饋送billing_address_id欄位，或從Account資料饋送mailing_address_id或tax_address_id欄位。

aws_account_id 所以此AWS此地址的帳戶號碼。

可用於聯結至Account資料饋送aws_account_id欄位。

電子郵件網域此帳戶登錄電子郵件地址的網域。

company_name 此帳戶登記的公司名稱。

country 此地址的 ISO 3166 阿爾法-2 國家代碼。

狀態或區域此地址登記的州或地區。

city 這個地址登記的城市

postal_code 這個地址登記的郵遞區號

地址:線 _1 這個地址的檔案位址的第一行。

地址行 _2 這個地址的檔案位址的第二行。

地址行 _3 此地址登記的第三行位址。

地址資料饋送範例以下顯示位址資料摘要的範例。在資料摘要中，此資訊會以單一表格呈現。為了可讀性，數據顯示在這裡的兩個表中，並且不顯示數據歷史記錄列。如需資料歷程記錄欄位的資訊，請參閱數據的歷史化 (p. 208)。

位址 ID aws_account_id電子郵件網域

company_namecountry 狀態或區域 city postal_code

V5NH 比比約格格格格格格格格格格格格格格

444456660000a.com 馬特奧傑克遜公司

DE 漢堡 67568

228

AWS Marketplace 賣方指南帳單事件資料饋送

位址 ID aws_account_id電子郵件網域

company_namecountry 狀態或區域 city postal_code

格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格格

G68xDbkzqvhzfffffffffffffffffffffffffffffffffffffffffffffffffffffffr555567679999b.com 瑪麗大學的公司

美國哦代頓 57684

不可思議的5GL5GL5QM8DB7

555567679999c.com 賣方美國 NY 紐約 89475

地址:線 _1 地址行 _2 地址行 _3

19 樓

帳單事件資料饋送此資料摘要提供帳單事件的相關資訊，包括開立商業發票和支付。

例如，您可以使用此資料摘要來瞭解買家何時開立發票的內容。您也可以使用範例 SQL 查詢 (p. 234)來分析這個資料摘要中的資料。

此資料摘要包含您為記錄賣方的帳單事件相關資訊。針對透過通路合作夥伴簽訂的合約，此資料摘要包含記錄製造商與銷售商之間帳單事件的相關資訊。

計費事件資料摘要每 24 小時重新整理一次，因此每天都有新的資料可供使用。

帳單事件資料不可變。



清單事件識別碼帳單事件的識別碼。此 ID 在賣家環境中是唯一的。

從帳號 ID (_A) 啟動帳單事件的帳戶。如果transction_type是SELLER_REV_SHARE，這是買方的付款人帳戶。這是一個外鍵account (p. 226)資料饋送。

可用於聯結至Account資料饋送account_id欄位。

229



到帳號代碼 (_A) 接收產品交易金額的帳戶。這是帳戶資料摘要的外部索引鍵。


結束使用者帳號 ID 使用產品的帳戶。此帳戶可能與不同。


產品代碼產品的識別碼。這是一個外鍵產品 (p. 241)資料饋送。

可用於聯結至Product資料饋送product_id欄位。

動作此事件的動作類型。可能的值如下：

• INVOICED— 買方已開立金額的發票。• FORGIVEN— 買方已開立金額的發票，AWS恢復

充電。• DISBURSED— 賣家已支付此金額。這可能包括一

個月的發票，也可以是隨選支付。

交易類型交易的型態。如需範例，請參閱「稅務案例 (p. 231)」。可能的值如下：

• SELLER_REV_SHARE— 一個正數，這是賣方在與買方協議中設置的價格。

• SELLER_TAX_SHARE— 正數，這是添加到SELLER_REV_SHARE支付稅款的賣方欠。

• AWS_REV_SHARE— 負數，這是刊登費。• AWS_TAX_SHARE— 一個積極的金額，這是稅收

的金額AWS收集除了SELLER_REV_SHARE。這筆金額不會影響賣家的餘額。這筆金額不支付，是為了讓賣家了解開立發票給買家的稅金，並代表賣家匯款給當局。

• transaction_type_REFUND— 買家要求的退款金額。

• transaction_type_CREDIT— 數量AWS學分買方。

• BALANCE_ADJUSTMENT— 由AWS以解決開立發票的問題。

• DISBURSEMENT— 如果action=DISBURSEMENT和balancing_impacting=1，這是支付給賣家的金額。如果值action是 =INVOICED，此記錄會否定parent_billing_event_id記錄無論是全部或部分。在這種情況下，相關支付disbursement_billing_event_id(一個或多個資源balancing_impacting=0。

• DISBURSEMENT_FAILURE— 否定交易。

230



父系清單事件識別碼 (_O) 如果action是DISBURSEMENT或FORGIVEN與transaction_type是DISBURSEMENT，這是billing_event_id發起此計費事件。如果action具有另一個值，則此欄位為 null。

支付清單事件識別碼相關支付時action是DISBURSED並且以下其中一項為 true：

• transaction_type like ('SELLER%')

• transaction_type like ('AWS%')

在所有其他案例中，此值為空。

amount 帳單事件金額。

貨幣 ISO 639 貨幣代碼。

平衡影響金額是否考慮在計算賣方支付。值為0表示顯示的金額僅供參考，並且對餘額沒有影響。值為1表明，這一數額考慮在確定賣方支付。

商業發票日期 (_D) 商業發票的建立日期。

付款日期 (_D) 當action是INVOICED，即發票的到期日。

使用期間 (__ 開始日期) 記錄中期間的開始日期。

使用期間結束日期記錄中期間的結束日期。

商業發票所以此AWS發票 ID。

帳單地址代碼付款人在地址資料摘要中的帳單地址參考。

可用於聯結至Address資料饋送address_id欄位。

交易參照可讓您從下列報表交互參照資料的識別碼：

• 支付報告 (p. 194)• 每月計費收入報告 (p. 198)• 銷售報告 (p. 203)• 美國銷售與使用稅務報表 (p. 204)

銀行追蹤代碼對於支付交易 (transaction_type = '支付'，作業 = '支付')，由銀行指定的追蹤識別碼。追蹤 ID 可用於與賣方銀行提供的報告相關聯。

稅務案例對於買方和賣方的國家和國家的稅收模式決定了如何收取和匯款的稅收模式。以下是可能的情況：

• 稅收收集和匯款AWS。在這些情況下，transaction_type是AWS_TAX_SHARE。• 稅收由AWS，支付給賣方，並由賣方匯款給稅務機關。在這些情況

下，transaction_type是SELLER_TAX_SHARE。

231


• 稅收不收取AWS。賣方必須計算稅收，並匯出給稅務機關。在這些情況下，AWS Marketplace不會執行稅捐計算或接收稅捐資訊。賣方支付的稅收從收入份額。

計費事件資料摘要的範例本節顯示開立發票時和一個月後計費事件資料期間的範例。請注意本節中所有表格的下列事項：

• 在資料摘要中，billing_event_id值是 40 個字元的英數字串。它們在這裡顯示為可讀性的雙字符串。• 在資料摘要中，此資訊會以單一表格呈現。為了可讀性，數據顯示在這裡的多個表中，並且不顯示所有

列。

本節中的範例，假設如下：

• 阿納夫是買家• 他的帳戶 ID 是737399998888。• 他的位置在法國，受市場協調者法律的約束。如需詳細資訊，請參閱「」亞馬遜 Web 服務稅幫助。• 他購買prod-o4grxfafcxxxx，並且為他每月使用該產品而開立了 120.60 美元的發票。• 他在一個月內支付了發票

• 簡是製造商。• 她的帳戶 ID 是111122223333。

• 保羅是銷售紀錄。• 他的帳戶 ID 是777788889999。• 他住在堪薩斯州，這是不受市場促進法律約束。

記錄賣方的帳單事件資料摘要作為賣方的記錄，保羅發票買方，Arnav。

下表顯示保羅的資料摘要中的相關資訊，當他發票 Arnav。

清單事件識別碼

從帳號 ID(_A)

到帳號代碼(_A)

結束使用者帳號 ID

產品代碼動作交易類型

I0 7373999988887777889999 737399998888產品-產品-產品

發票賣家共用

I1 737399998888AWS 737399998888產品-產品-產品

發票 AW_TAX 共用

I2 7777889999 1111222333 737399998888產品-產品-產品

發票賣家共用

I3 7777889999 AWS 737399998888產品-產品-產品

發票 AW_TAX 共用

父系清單事件識別碼 (_O)

支付清單事件識別碼

amount 貨幣商業發票日期(_D)

商業發票

100 USD 2018-12-31 T00:00:00 Z

781216640

232






商業發票

20.6 USD 2018-12-31 T00:00:00 Z

781216640

-80 USD 2018-12-31 T00:07

788576665

-0.2 USD 2018-12-31 T00:07

788576665

下表顯示當 Arnav 支付發票後，保羅資料摘要中的相關資訊。


從帳號 ID(_A)

到帳號代碼(_A)



I10 7373999988887777889999 737399998888 發票賣家共用

I12 7777889999 1111222333 737399998888 發票賣家共用

I13 7777889999 AWS 737399998888產品-產品-產品

發票自動分享

I14 AWS 7777889999 支付支付




商業發票

I0 I14 -100 USD 2018-12-31 T00:00:00 Z

781216640

I2 I14 80 USD 2018-12-31 T00:07

788576665

I3 I14 0.2 USD 2018-12-31 T00:07

788576665

19.8 USD

製造商的帳單事件資料摘要

下表顯示保羅發票 Arnav 時，珍的資料摘要中的相關資訊。


從帳號 ID(_A)

到帳號代碼(_A)



I5 7777889999 1111222333 產品-產品-產品

已開發票賣家共用

I6 7777889999 1111222333 產品-產品-產品

已開發票賣家共用

233



從帳號 ID(_A)

到帳號代碼(_A)



I7 7777889999 AWS 產品-產品-產品

已開發票自動分享




商業發票

73.5 2018-12-31 T00:07

788576665

6.5 2018-12-31 T00:07

788576665

-7.35 2018-12-31 T00:07

788576665

下表顯示 Jane 在支付發票後月底的資料摘要中的相關資訊。


從帳號 ID(_A)

到帳號代碼(_A)



I30 7777889999 1111222333 產品-產品-產品

支付賣家共用

I31 7777889999 1111222333 產品-產品-產品

支付賣家共用

I32 7777889999 AWS 產品-產品-產品

支付自動分享

I33 AWS 1111222333 支付支付




商業發票

I5 I33 -73.5 USD

I6 I33 -6.5 USD

I7 I33 7.35 USD

72.65 USD

查詢範例如使用資料饋送 (p. 209)，您可以使用Athena，對受管理的 Amazon S3 儲存貯體中以資料饋送形式收集並儲存的資料執行查詢。本節提供一些常見的方法範例，您可能會執行這項操作。所有範例都假設使用單一貨幣。

234

https://docs.aws.amazon.com/athena/latest/ug/what-is.html


範例 1：已開立商業發票的金額，包括稅捐若要瞭解已開立商業發票的買家數量 (包括稅捐)，您可以執行類似下列的查詢：

SELECT sum(amount) FROM billing_event WHERE action = 'INVOICED' AND ( (transaction_type in ('SELLER_REV_SHARE', 'SELLER_TAX_SHARE') -- to discard SELLER_REV_SHARE from Manufacturer to Channel Partner, aka cost of goods AND to_account_id='seller-account-id' ) OR transaction_type= 'AWS_TAX_SHARE' );

範例 2：代賣家向買家開立的發票金額若要了解買家代表賣家開立發票的數量，你可以執行類似下列的查詢：

SELECT sum(amount) FROM billing_event WHERE action = 'INVOICED' AND transaction_type in ('SELLER_REV_SHARE', 'SELLER_TAX_SHARE') AND to_account_id='seller-account-id';

範例 3：Amount (數量)AWS可以代賣家領取要找出多少AWS可以代表賣家收取，減去任何退款，貸方和寬恕的帳戶，你可以運行如下查詢：

SELECT sum(amount) FROM billing_event WHERE -- what is invoiced on behalf of SELLER, incl. refunds/ credits and cost of goods transaction_type like 'SELLER_%' -- FORGIVEN action records will "negate" related INVOICED and action in ('INVOICED','FORGIVEN') ;

範例 4：賣家可以收取的金額要了解賣家可以收集多少錢，你可以執行類似下列的查詢。此範例會移除刊登費用和AWS收集，並添加任何特殊的餘額調整。

SELECT sum(amount) FROM billing_eventWHERE (transaction_type like 'SELLER_%' -- what is invoiced on behalf of SELLER or transaction_type like 'AWS_REV_%' -- what is owed to AWS or transaction_type = 'BALANCE_ADJUSTMENT' -- exceptionnal case ) and action in ('INVOICED','FORGIVEN');

您也可以使用下列查詢收集相同的資訊：

SELECT sum(amount) FROM billing_event

235


WHERE balance_impacting = 1 and action in ('INVOICED','FORGIVEN');

下列範例顯示相同的資訊，但僅限於 2018 年交易，並假設所有買方都已支付帳單：

SELECT sum(amount) FROM billing_eventWHERE invoice_date between '2018-01-01' and '2018-12-31' and balance_impacting = 1 and action in ('INVOICED','FORGIVEN');

範例 5：支付金額若要找出已支付的金額，您可以執行如下所示的查詢：

select sum(amount) FROM billing_eventWHERE action ='DISBURSED' and transaction_type like 'DISBURSEMENT%';

範例 6：等待支付的金額若要找出擱置支付的金額，您可以執行如下所示的查詢。此查詢會移除已支付的金額。

SELECT sum(amount) FROM billing_event targeted WHERE (transaction_type like 'SELLER_%' -- what is invoiced on behalf of SELLER or transaction_type like 'AWS_REV_%' -- what is owed to AWS or transaction_type = 'BALANCE_ADJUSTMENT' -- exceptionnal case ) -- DISBURSEMENT action records will "negate" 'INVOICED' -- but do not take into account failed disbursements AND (not exists (select 1 from billing_event disbursement join billing_event failed_disbursement on disbursement.billing_event_id=failed_disbursement.parent_billing_event_id where disbursement.transaction_type='DISBURSEMENT' and failed_disbursement.transaction_type='DISBURSEMENT_FAILURE' and targeted.disbursement_billing_event_id=disbursement.billing_event_id ) ) ;

另一種獲取相同信息的方法是運行如下查詢以獲取賣家的餘額：

SELECT sum(amount) FROM billing_eventWHERE balance_impacting = 1;

下面的查詢擴展了我們的例子。它將結果限制為 2018 交易，並返回有關交易的更多細節。

236

AWS Marketplace 賣方指南舊式對映資料饋送

select sum(residual_amount_per_transaction)from (SELECT max(billed_invoices.amount) invoiced_amount, sum(nvl(disbursed_invoices.amount,0)) disbursed_amount, -- Exercise left to the reader: -- use transaction_type to distinguish listing fee vs seller-owed money -- still pending collection max(transaction_type) transaction_type, max(billed_invoices.amount) + sum(nvl(disbursed_invoices.amount,0)) residual_amount_per_transaction FROM billing_event billed_invoices -- find related disbursements left join billing_event disbursed_invoices on disbursed_invoices.action='DISBURSED' and disbursed_invoices.parent_billing_event_id=billed_invoices.billing_event_id WHERE billed_invoices.invoice_date between '2018-01-01' and '2018-12-31' and billed_invoices.transaction_type like 'SELLER_%' -- invoiced on behalf of SELLER and billed_invoices.action in ('INVOICED','FORGIVEN') -- do not take into account failed disbursements AND not exists (select 1 from billing_event failed_disbursement where disbursed_invoices.disbursement_billing_event_id = failed_disbursement.parent_billing_event_id ) GROUP BY billed_invoices.billing_event_id);

範例 7：發票集餘額若要瞭解一組發票的總和，您可以執行類似下列的查詢：

SELECT invoice_id, sum(amount) FROM billing_event targetedWHERE -- invoice_id is only not null for invoiced records AND disbursed records -- linking them to related disbursement -> no need to filter more precisely invoice_id in ('XXX','YYY') -- filter out failed disbursements AND not exists (select 1 from billing_event disbursement join billing_event failed_disbursement on disbursement.billing_event_id=failed_disbursement.parent_billing_event_id where disbursement.transaction_type='DISBURSEMENT' and failed_disbursement.transaction_type='DISBURSEMENT_FAILURE' and targeted.disbursement_billing_event_id=disbursement.billing_event_id ) group by invoice_id;

舊式對映資料饋送此資料摘要會列出產品識別碼和提供識別碼如何對應至舊版全域唯一識別碼 (GUID)。舊版 GUID 用於舊版報表中，而新的 ID 用於資料摘要和AWS MarketplaceAPI。

此資料摘要提供您建立為記錄賣方的所有產品，以及您獲授權轉售的所有產品的相關資訊。

舊版對應資料摘要每 24 小時重新整理一次，因此每天都可以使用新的資料。


237

AWS Marketplace 賣方指南優惠資料饋送


對映類型無論是產品識別碼或優惠識別碼。

字母此產品或優惠的舊版 ID。

新 (_id) 此產品或優惠的易記 ID。此 ID 用作主索引鍵和所有目前的 API 動作。

舊式對映資料摘要的範例以下展示舊式對映資料摘要的範例。為了可讀性，不會顯示資料歷程記錄欄。如需資料歷程記錄欄位的資訊，請參閱數據的歷史化 (p. 208)。

對映類型字母新 (_id)

講價八成鐘七分鐘七分鐘七分鐘優惠-Dacpxnflfwin

產品你可以在這裡找到一個產品-產品-產品

講價一個人可以選擇優惠-解決方案

優惠資料饋送此資料摘要提供您作為記錄賣家建立的所有優惠資訊。如果單一提案有多個修訂版本，則所有修訂都會包含在資料摘要中。

當您進行提供修訂，且公開欄位中的資料變更時，會在相同主索引鍵的資料摘要中建立新的記錄(offer_id加號offer_revision），但對valid_from欄位。如需資料摘要歷程記錄欄位的詳細資訊，請參閱數據的歷史化 (p. 208)。

優惠資料摘要每 24 小時重新整理一次，因此每天都有新的資料可供使用。



提供 ID 優惠的易記識別碼。

可以用來加入offer_id欄位Offer_Product資料饋送。

提供修訂優惠修訂。此欄位和offer_id字段組合以形成主索引鍵。

搭配offer_id，可以用來連接到offer_id和offer_revision欄位Target_Offer資料饋送。

name 賣方定義的優惠名稱。

到期日期 (_D) 優惠到期的日期和時間。

機會名稱任何與此優惠相關的商機資料。如果優惠綁定到AWS機會，則會填入此欄位。

238

AWS Marketplace 賣方指南提供產品資料饋送


機會描述任何與此優惠連結的描述性資訊。如果優惠綁定到AWS機會，則會填入此欄位。

優惠資料摘要範例以下顯示優惠資訊摘要的範例。為了可讀性，不會顯示資料歷程記錄欄。如需資料歷程記錄欄位的資訊，請參閱數據的歷史化 (p. 208)。

提供 ID 提供修訂 name 到期日期 (_D) 機會名稱機會描述

優惠-Dacpxnflfwin

1 企業合約計劃優惠

：009-01-01T01T 00:00:00 Z

優惠-解決方案 1 由賣家建立的私人講價

020-10-31 T00:00:00 Z

提供-低氧乙烯八十五毫米

1 企業合約計劃優惠

：009-01-01T01T 00:00:00 Z

提供產品資料饋送一個報價可以有多個產品，一個產品可以包含在不同的報價中。此資料摘要會列出優惠與產品之間關係的相關資訊。

此資料摘要提供您作為記錄賣方建立之所有產品優惠的相關資訊。

當您從提案中新增或移除產品時，您會建立提案修訂。

優惠產品資料摘要每 24 小時重新整理一次，因此每天都有新的資料可供使用。

下表說明資料饋送欄的名稱和說明。如需資料摘要歷程記錄欄位的相關資訊，請參閱數據的歷史化 (p. 208)。


提供 ID 此優惠的易記識別碼。

可以用來加入offer_id欄位Offer資料饋送。

提供修訂結合與offer_id欄位，以形成提供修訂的外部索引鍵。

產品代碼產品的友好標識符，這是該優惠公開的產品的外鍵。

可以用來加入product_id欄位Product資料饋送。

239

AWS Marketplace 賣方指南提供目標資料饋送

優惠產品資料摘要範例以下顯示「優惠」產品資料摘要的範例。

提供 ID 提供修訂產品代碼

優惠-Dacpxnflfwin 10 產品-產品-產品

優惠-解決方案 24 產品-產品-產品

提供目標資料饋送此資料摘要會列出您作為記錄賣家建立的所有講價修訂目標。如果單一提案有多個修訂版本，則所有修訂都會包含在資料摘要中。

當您進行提供修訂，且公開欄位中的資料變更時，會在相同主索引鍵的資料摘要中建立新的記錄(offer_id加號offer_revision），但對valid_from欄位。

優惠目標資料饋送每 24 小時重新整理一次，因此每天都有新的資料可供使用。



提供目標代碼饋送的主索引鍵。

報價 + 報價修訂要約的識別碼和修訂。這兩欄參考此目標所涉及的優惠。

可以用來加入offer_id和offer_revision欄位Target資料饋送。

目標類型指出優惠收件者是否BuyerAccounts，表示私人報價，或ParticipatingPrograms。

極性指出優惠是否旨在向target_type。可接受的值如下：

• PositiveTargeting— 此優惠適用於此target_type。

• NegativeTargeting— 此優惠不適用於此target_type。

值代表目標的字串：AWS帳戶 ID 或可與優惠搭配使用的程式。例如：的標準合約AWSMarketplace(SCMP) (p. 46)、的企業合約AWSMarketplace(ECMP) (p. 47), 或AWS Marketplace現場示範計劃 (FDP) (p. 18)。

優惠目標資料饋送範例以下顯示優惠目標資料摘要的範例。為了可讀性，不會顯示資料歷程記錄欄。如需資料歷程記錄欄位的資訊，請參閱數據的歷史化 (p. 208)。

240

AWS Marketplace 賣方指南產品資料饋送

提供目標代碼提供 ID 提供修訂目標類型極性值

您可以選擇自己的方式

優惠-Dacpxnflfwin

1 ParticipatingProgramsPositiveTargeting EnterpriseContract

客人可以選擇自己的方式

優惠-解決方案 1 ParticipatingProgramsPositiveTargeting FieldDemonstration

您可以選擇自己的方式

優惠-解決方案 1 ParticipatingProgramsPositiveTargeting EnterpriseContract

產品資料饋送此資料摘要提供您建立為記錄賣方的所有產品，以及您獲授權轉售的所有產品的相關資訊。

產品數據是可變的。這表示當您變更下列其中一個欄位的值時，會在資料饋送中建立新記錄，其中包含valid_from欄位。如需資料摘要歷程記錄欄位的詳細資訊，請參閱數據的歷史化 (p. 208)。

產品資料摘要每 24 小時重新整理一次，因此每天都有新的資料可供使用。



產品代碼產品的易記識別符。

可以用來加入product_id欄位Account、Billing_Event，以及Offer_Product資料饋送。

制造商帳號產品擁有者的識別碼。這是一個外鍵帳戶 (p. 226)資料饋送。

可以用來加入account_id欄位Account資料饋送。

產品代碼用於計量產品的現有權益產品代碼。此值也可用來將資料與報表結合，或參考 AWS Marketplace 計量服務中提供的內容。

title 產品的標題。

產品資料摘要範例以下顯示優惠目標資料摘要的範例。為了可讀性，不會顯示資料歷程記錄欄。如需資料歷程記錄欄位的資訊，請參閱數據的歷史化 (p. 208)。

產品代碼制造商帳號產品代碼 title

產品-產品-產品 555568000000 產品代碼 _1 產品 1

產品-特殊版本-特殊版本 444457000000 產品代碼 _2 產品 2

生產者可以使用 666678000000 產品代碼產品 3

241

AWS Marketplace 賣方指南稅務項目資料饋送

稅務項目資料饋送此資料饋送提供客戶發票稅捐計算的相關資訊。

可以有多個行項目（line_item_id) 用於給定產品 (product_id）的給定客戶發票（invoice_id），每個稅務管轄區的一個或多個。發生這種情況，例如，使用基於使用不同AWS不同的地區規則AWS實體（例如，美國和愛爾蘭）。進一步了解AWS對您的銷售收取銷售稅、增值稅或商品及服務稅，並以 AWS, Inc. 的名義將此類稅捐匯給當地稅務機關，請參閱亞馬遜 Web 服務稅幫助。

稅務項目資料摘要每 24 小時重新整理一次，因此每天都有新的資料可供使用。

稅項資料不可變。

下表說明資料饋送欄的名稱和說明。如需資料歷程記錄欄的相關資訊，請參閱數據的歷史化 (p. 208)。


稅務項目代碼稅金項目記錄的唯一識別碼。

商業發票所以此AWS發票 ID。您可以將此值與product_id以尋找相關的稅務帳單事件。

行 _item_id 客戶帳單明細項目的唯一識別碼。退款交易與其轉寄稅捐交易具有相同的明細項目識別碼。

客戶客戶帳單的唯一識別符。買家可以與賣家分享此識別碼，以協助識別和解決稅務計算問題。

稅務對象 AWS 或 Seller。如果賣方是稅務責任方，則會收取稅金。如果AWS是稅務責任方，銷售稅收收集和匯款AWS。如需詳細資訊，請參閱「」AWSMarketplace 銷售商和稅收徵收。

如果沒有收取稅金，則此處沒有顯示任何值。賣方需要確定是否為每張發票收取一些稅款，因為賣方須負責徵收稅款。

交易類型代碼交易的型態。可能的值如下：

• AWS— 遠期稅捐交易• REFUND— 全額或部分退款• TAXONLYREFUND— 僅限稅項退款

退款交易會與其原始向前交易共用明細行項目識別碼。

產品代碼產品的外鍵。

可用於聯結至Product資料饋送product_id欄位。

產品代碼識別產品之稅捐屬性的標準代碼。賣方在創建或修改產品時選擇屬性。

商業發票日期 (_D) 商業發票的建立日期。

稅務客戶帳號代碼被徵稅的帳戶實體的外部索引鍵。

242





資料欄名稱描述可用於聯結至Account資料饋送account_id欄位。

稅務客戶國家用於計算稅金的地址的 ISO 3166 阿爾法 2 國家/地區代碼。

客戶狀態或區域用於計算稅捐的州、地區或省。

稅務客戶城市稅務計算所使用的城市。

客戶郵件代碼用於計算稅捐的郵遞區號。

稅務位置代碼管轄區與徵稅位置相關聯的頂點地理碼。

分類型代碼套用到交易的稅金型態。可能的值為None、Sales和 SellerUse。

管轄區層級用於稅捐地點之地址的管轄區層次。可能的值為State、County、City，以及District。

稅務管轄區稅捐管轄區的名稱。

顯示價格類型買家看到的價格是否含稅或不含稅。All (全部)AWSMarketplace產品是不含稅。

應稅金額在此管轄區層次應稅的交易金額。

不應稅金額 (_A) 在此管轄區層次不應稅的交易金額。

稅率管轄區在此管轄區層次套用的稅率。

稅金額在此管轄區層次收取的稅捐金額。

TAX 貨幣上述金額的 ISO 4217 阿爾法 3 貨幣代碼。

計算合理代碼交易是否為應稅、不應稅、免稅或零分級，依管轄區層次組織。

使用的日期 (_A) 用於計算交易稅捐的日期。

客戶免責憑證識別碼免除憑證的憑證 ID。

客戶免除憑證 ID 網域證書存儲在亞馬遜系統上的位置。

客戶免責憑證層級提供豁免的管轄區層次。

客戶免責代碼指定豁免的程式碼；例如，RESALE。

客戶免責網域用於擷取客戶豁免資訊的 Amazon 系統 (如果有的話)。

交易參照可讓您從下列報表交互參照資料的識別碼：

• 支付報告 (p. 194)• 每月計費收入報告 (p. 198)• 銷售報告 (p. 203)• 美國銷售與使用稅務報表 (p. 204)

243


稅捐項目資料饋送範例以下顯示稅金項目資料摘要的範例。在資料摘要中，此資訊會以單一表格呈現。為了可讀性，數據顯示在這裡的多個表中，並且不顯示所有列。

稅務項目代碼商業發票行 _item_id 客戶

您可以參考我們的參考我們的參考

781216640 七十億零百萬 2210000000000

您可以參考我們的參考我們的參考

781216640 五億零百萬 2210000000000

你可以選擇自己的名字，然後選擇自己的名字

250816266 七六四億零零百萬 57200 億美元

可以使用這個功能，可以使用這個功能，並且可以使用這個功能。

280336288 七六四億零零百萬 5724390000000

我們提供了一個地方，一個地方，一個地方，一個地方

451431024 99300 億美元 12300 億美元

我們提供了一個完整的一個完整的一個完整的一個

451431024 99300 億美元 3120000 億萬

我們的電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦電腦

229987654 9210000000000 639000000億萬

稅務對象交易類型代碼產品代碼產品代碼商業發票日期 (_D)

賣方 AWS 產品-產品-產品軟體 2018-12-31 T00:00:00 Z

賣方 AWS 產品-產品-產品軟體 2018-12-31 T00:00:00 Z

賣方 AWS 產品-特殊版本-特殊版本

遠端存取軟體 2018-08-31

賣方退款產品-特殊版本-特殊版本

遠端存取軟體 2018-08-31

賣方 AWS 生產者可以使用遠端存取軟體 2018-08-31

賣方退稅生產者可以使用遠端存取軟體 2018-05-31

244


稅務對象交易類型代碼產品代碼產品代碼商業發票日期 (_D)

AWS AWS 產品配件配件配件配件配件

遠端存取軟體 2019-07-31

稅務客戶帳號代碼稅務客戶國家客戶狀態或區域稅務客戶城市客戶郵件代碼

維加 2T9J3 米克歐9C8 米克歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐

美國 GA 米爾頓 48573-4839

維加 2T9J3 米克歐9C8 米克歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐克斯歐

美國 GA 米爾頓 48573-4839


美國 NC 達勒姆 27517-4834


美國 NC 達勒姆 27517-4834


美國 TX 不適用 75844-1235

7 年代 5 年代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代代

美國 TX 休斯敦 75844-1235

245


稅務客戶帳號代碼稅務客戶國家客戶狀態或區域稅務客戶城市客戶郵件代碼代代代代代代代代代代代代代代代

他們的身份有限公司

美國 CT 新的避風港 06002-2948

稅務位置代碼管轄區

分類型代碼管轄區層級稅務管轄區顯示價格類型

應稅金額不應稅金額(_A)

460473664 銷售狀態 GA EXCLUSI 100 0

66301164 銷售縣富爾頓 EXCLUSI 0 100

692938178 SellerUse 狀態 NC EXCLUSI 58.1 523.8

692938178 SellerUse 狀態 NC EXCLUSI -58.1 523.8

356794387 銷售狀態 TX EXCLUSI 1105.14 0

528887443 銷售城市休斯敦 EXCLUSI -36 0

171248162 銷售狀態 CT EXCLUSI 0 114.55

稅率管轄區稅金額 TAX 貨幣計算合理代碼使用的日期 (_A)

0.206 20.6 USD 應課稅 2018-10-31

0 0 USD NonTaxable 2018-10-31

0.1 5.8 USD 應課稅 2018-07-31

0.1 -5.8 USD 應課稅 2018-07-31

0.06 66.3 USD 應課稅 2018-07-31

0.01 -0.36 USD NonTaxable 2018-07-31

0 0 USD 豁免 2019-06-30

246

AWS Marketplace 賣方指南IAMAWS Marketplace

AWS Marketplace 安全性雲端安全是 AWS 最重視的一環。身為 AWS 客戶的您，將能從資料中心和網路架構的建置中獲益，以滿足組織最為敏感的安全要求。

安全是 AWS 與您共同肩負的責任。共同的責任模型將此描述為雲端本身的安全和雲端內部的安全：

• 雲端本身的安全 – AWS 負責保護在 AWS Cloud 中執行 AWS 服務的基礎設施。AWS 也提供您可安全使用的服務。第三方稽核人員定期檢測及驗證安全的效率也是我們 AWS 合規計劃的一部分。若要進一步了解適用於 AWS Marketplace 的合規計劃，請參閱合規計劃範圍內的 AWS 服務。

• 雲端內部的安全 – 您的責任取決於所使用的 AWS 服務。您也必須對資料敏感度、組織要求，以及適用法律和法規等其他因素負責。

本文件有助於您了解如何在使用 AWS Marketplace 時套用共同責任模型。下列主題說明如何設定AWSIdentity and Access Management管理對的存取AWS Marketplace，使其符合您的安全和合規目標。您也可以了解如何使用其他AWS服務，幫助您監控並保護AWS Marketplace的費用。

若要深入了解有關您所提供產品的安全性和其他原則，請參閱AWS Marketplace的詳細說明，請參閱下列主題：

• AMI 安全政策 (p. 85)• 以貨櫃為基礎的產品需求 (p. 94)• SaaS 產品指導方針 (p. 150)• 專業服務產品的要求 (p. 172)

Note

若要了解資料產品的 AWS Data Exchange 安全性，請參閱安全性中的AWS Data Exchange 使用指南。要了解安全的買家AWS Marketplace，請參閱的安全AWS Marketplace中的AWS Marketplace買方指南。

主題• 控制 AWS Marketplace 管理入口網站存取 (p. 247)• 的政策和許可AWS Marketplace賣方 (p. 250)• AWS的受管政策AWS Marketplace賣方 (p. 252)• AWS MarketplaceCommerce Analytics Service 帳戶權限 (p. 259)• AWS Marketplace產品 Support 連線帳戶權限 (p. 260)• Amazon SQS 權限 (p. 260)• AWS Marketplace計量和權利 API 權限 (p. 261)• 使用 AWS CloudTrail 記錄 AWS Marketplace API 呼叫 (p. 262)

控制 AWS Marketplace 管理入口網站存取AWS Identity and Access Management(IAM) 是一個AWS服務，可協助您控制AWS的費用。如果您是 IAM管理員，您可以控制哪些人可以已驗證(已登入) 和已授權（有權限）來使用AWS Marketplace的費用。IAM是一種您可以免費使用的 AWS 服務。

247

http://aws.amazon.com/compliance/shared-responsibility-model/

http://aws.amazon.com/compliance/programs/

http://aws.amazon.com/compliance/services-in-scope/

https://docs.aws.amazon.com/data-exchange/latest/userguide/security.html

https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-security.html

AWS Marketplace 賣方指南建立使用者

推薦的方法來控制誰可以在AWS Marketplace 管理入口網站的目的是使用 IAM 建立使用者和群組。然後將使用者新增至群組，並管理群組。例如，如果應允許 John 檢視您的產品，請為他建立 IAM 使用者，並將其IAM 使用者新增至您為唯讀存取建立的群組。您可以將原則或權限指派給提供唯讀權限的群組。如果您有其他使用者需要唯讀存取權，您可以將他們新增至您建立的群組，而不是將權限新增至其使用者帳戶。如果John 的角色變更，而且他不再需要唯讀存取權，您可以從群組中移除 John 的使用者帳戶。

A政策是定義套用至使用者、群組或角色之許可的文件。接著，許可會決定哪些使用者可以在AWS。政策通常允許特定動作，而且可以選擇性地允許特定資源 (例如 Amazon EC2 執行個體、Amazon S3 儲存貯體等)的動作。政策也可以明確拒絕存取。A許可是政策中的陳述式，可允許或拒絕對特定資源的存取。您可以陳述像這樣的任何許可：「A 有許可對 C 執行 B」例如，Jane (A) 擁有從 John 的 Amazon 簡易佇列服務佇列(C) 讀取訊息 (B) 的許可。每當 Jane 將請求傳送到 Amazon SQS 使用 John 的佇列時，該服務就會檢查她是否擁有許可，並進一步確認請求是否符合 John 在許可中指定的條件。

Important

您使用其認證建立驗證的所有 IAM 使用者。但是，它們使用相同的AWS帳戶。使用者所做的任何變更都會影響整個帳戶。

AWS Marketplace具有定義的權限，可控制具有這些權限的使用者可以在AWS Marketplace 管理入口網站。還有一些政策AWS Marketplace創建和管理結合了多個權限。例如，aws-marketplace-management:ViewMarketing權限可讓使用者存取行銷部門標籤AWS Marketplace 管理入口網站。所以此AWSMarketplaceSellerProductsFullAccess政策可讓使用者完整存取AWS Marketplace 管理入口網站。

以下資源提供入門和使用 IAM 的詳細資訊。

• 建立您的第一個 IAM 管理員使用者和群組• IAM 最佳實務• 管理 IAM 政策• 將政策連接至 IAM 群組• 身分 (使用者、群組和角色)• 使用政策控制存取

以下提供建立使用者和群組以及以 IAM 使用者身分登入的一些高階指引。

建立使用者若要允許貴公司的人員登入AWS Marketplace 管理入口網站，請為每位需要存取的人建立 IAM 使用者。

若要建立 IAM 使用者

1. 登入 AWS Management Console，並開啟位於 https://console.aws.amazon.com/iam/ 的 IAM 主控台。2. 在導覽窗格中，選擇使用者，然後選擇建立新的使用者。3. 在編號的文字方塊中，輸入您要建立的每個使用者的名稱。4. 清除為每位使用者建立存取金鑰核取方塊，然後選擇建立。

若要指派密碼給您建立的每位使用者

1. 在使用者清單中選擇新使用者的名稱。2. 選擇安全登入資料索引標籤，然後選擇管理密碼。3. 選擇自動產生的密碼或自訂密碼的選項。或者，若要求使用者在下一次登入時選擇新密碼，請選取要求

使用者在下次登入時建立新密碼。選擇 Apply (套用)。4. 選擇下載身分證明，將使用者名稱、密碼和帳戶特定的登入 URL 儲存至以逗號分隔值 (CSV) 檔案。然

後，選擇 Close (關閉)。

248

https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-using.html#create-managed-policy-console

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage_attach-policy.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_permissions.html


AWS Marketplace 賣方指南建立或使用群組

Note

若要使用您剛才建立的 IAM 使用者名稱和密碼登入，使用者必須導覽至您帳戶特定的登入 URL。此URL 位於您剛下載的認證檔案中，也可在 IAM 主控台上使用。如需詳細資訊，請參閱「」IAM 使用者如何登入您的AWS帳戶中的IAM User Guide。

Tip

為您自己建立使用者名稱和密碼，即使您是AWS帳戶擁有者。這是一個建議的最佳做法，讓每個人都可以在AWS Marketplace 管理入口網站身分識別為 IAM 使用者，即使是帳戶擁有者亦然。若要了解如何為自己建立具有管理權限的 IAM 使用者，請移至建立管理員群組中的IAM User Guide。

建立或使用群組建立使用者之後，請建立群組、建立存取AWS Marketplace 管理入口網站，將這些權限新增至群組，然後將使用者新增至群組。

當您指派權限給群組時，您可以允許該群組的任何成員執行特定動作。當您將新使用者新增到群組時，該使用者就自動獲得指派至該群組的許可。群組可以擁有多個動作的許可。我們建議您使用受管理的原則，而不是建立自己的原則。

若要將受管理原則指派給AWS Marketplace至群組

1. 在 https://console.aws.amazon.com/iam/ 中開啟 IAM 主控台。2. 在導覽窗格中，選擇Groups (群組)，然後選擇要連接政策的群組。3. 在 Group (摘要) 頁面的Permissions (許可)索引標籤中，選擇連接政策。4. 在連接政策頁面，旁邊篩選：ENTERawsmarketplace。5. 選擇您要附加的政策，然後選擇連接政策。

若要建立政策AWS Marketplace 管理入口網站permissions

1. 在 https://console.aws.amazon.com/iam/ 中開啟 IAM 主控台。2. 在導覽窗格中，選擇 Policies (政策)，然後選擇 Create Policy (建立政策)。3. 在 Policy Generator (政策產生器) 旁選擇 Select (選取)。4. 在 Edit Permissions (編輯許可) 頁面上，執行下列動作：

a. 針對 Effect (效果)，選擇 Allow (允許)。b. 適用於AWSService (服務)中，選擇AWS Marketplace 管理入口網站。c. 適用於動作下，選取要允許的權限。d. 選擇新增陳述式。e. 選擇 Next Step (後續步驟)。

5. 在Review Policy頁面上，執行下列動作：

a. 適用於政策名稱下，輸入此政策的名稱。請記下政策名稱，因為您在稍後步驟中會用到。b. (選用) 對於描述下，輸入此政策的描述。c. 選擇 Create Policy (建立政策)。

若要建立具有適當權限的 IAM 群組，並將使用者新增至群組

1. 在以下網址開啟 IAM 主控台：https://console.aws.amazon.com/iam/。2. 在導覽窗格中選擇 Groups (群組)，然後選擇 Create New Group (建立新群組)。

249

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_sign-in.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_sign-in.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html




AWS Marketplace 賣方指南以 IAM 使用者身分登入

3. 適用於群組名稱：下，輸入群組的名稱。然後選擇 Next Step (下一步)。4. 在連接政策頁面上，執行下列動作：

a. 適用於篩選：中，選擇客戶受管政策。b. 選取要連接至此群組的政策名稱旁的核取方塊。這通常是您剛才建立的政策。c. 選擇 Next Step (後續步驟)。

5. 選擇 Create Group (建立群組)。6. 在Groups (群組)清單，然後選取旁的核取方塊。選擇群組動作然後新增使用者至群組。7. 選取要新增至群組的每位使用者旁的核取方塊，然後選擇新增使用者。

以 IAM 使用者身分登入在 IAM 中建立使用者之後，使用者可以使用自己的使用者名稱和密碼登入。若要這麼做，他們需要使用與AWS帳戶。您可以取得登入 URL，並將其散佈給您的使用者。

取得帳戶的唯一登入網址

1. 在 https://console.aws.amazon.com/iam/ 中開啟 IAM 主控台。2. 在導覽窗格中，選擇 Dashboard (儀表板)。3. 在目前窗格的頂端附近，找到IAM 使用者登入連結：並注意登錄鏈接，該鏈接具有這樣的格式：

https://AWS_account_ID.signin.aws.amazon.com/console/

Note

若希望您的登入頁面的 URL 含有您的公司名稱 (或其他好記的識別符)，而非您的AWS帳戶ID，您可以透過選擇自訂。如需詳細資訊，請參閱「」您的AWS帳戶 ID 及其別名中的IAMUser Guide。

4. 將此 URL 發佈給您公司的人員，他們可以使用AWS Marketplace 管理入口網站，以及您為每個使用者名稱和密碼建立的密碼。指示他們在存取AWS Marketplace 管理入口網站。

的政策和許可AWS Marketplace賣方AWS Marketplace有三個受管理的原則，您可以搭配AWS Marketplace 管理入口網站。此外，您可以使用個別權限來建立您自己的AWS Identity and Access Management(IAM) 政策。

Note

若要了解資料產品的 AWS Data Exchange 政策和權限，請參閱AWS Data Exchange 中的 Identityand Access Management中的AWS Data Exchange 使用指南。若要了解AWS Marketplace買家，請參閱控制存取AWS Marketplace訂閱中的AWS Marketplace買方指南。

適用於的政策AWS Marketplace賣方您可以使用下列受管理政策，為 IAM 使用者提供AWS Marketplace 管理入口網站：

AWSMarketplaceSellerFullAccess

允許完整存取所有頁面AWS Marketplace 管理入口網站和其他AWS服務，例如 Amazon Machine Image(AMI) 管理。

250


https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html

https://docs.aws.amazon.com/data-exchange/latest/userguide/auth-access.html

https://docs.aws.amazon.com/data-exchange/latest/userguide/auth-access.html

https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-iam-users-groups-policies.html

AWS Marketplace 賣方指南許可

AWSMarketplaceSellerProductsFullAccess

允許完整存取產品的頁面AWS Marketplace 管理入口網站。AWSMarketplaceSellerProductsReadOnly

允許對的唯讀存取產品的頁面AWS Marketplace 管理入口網站。

Important

AWS Marketplace買方可以使用受管理的政策來管理他們所購買的訂閱。您搭配使用的受管理原則AWS Marketplace 管理入口網站開頭為AWSMarketplaceSeller。當您在 IAM 中搜尋政策時，請務必搜尋以AWSMarketplaceSeller。

AWS Marketplace也會針對特定案例提供專門化受管理政策。如需 AWS 受管政策的完整清單，AWSMarketplace賣家，以及說明他們提供的權限，請參閱AWS的受管政策AWS Marketplace賣方 (p. 252)。

的許可AWS Marketplace賣方您可以在 IAM 政策中使用以下許可，以建立AWS Marketplace 管理入口網站：

aws-marketplace-management:viewMarketing

允許存取行銷部門的頁面AWS Marketplace 管理入口網站。aws-marketplace-management:viewSupport

允許存取客戶 Support 資格的頁面AWS Marketplace 管理入口網站。aws-marketplace-management:viewReports

允許存取報告的頁面AWS Marketplace 管理入口網站。aws-marketplace-management:uploadFiles

允許存取檔案上傳的頁面AWS Marketplace 管理入口網站。aws-marketplace-management:viewSettings

允許存取設定的頁面AWS Marketplace 管理入口網站。aws-marketplace:SearchAgreements

允許檢視協議 (p. 45)頁面，以及 ISV 與諮詢合作夥伴之間的機會，合作夥伴 (p. 41)(憑證已建立！) 頁面上的名稱有些許差異。

aws-marketplace:DescribeAgreement

允許檢視協議頁面，以及 ISV 與諮詢合作夥伴之間的機會，合作夥伴(憑證已建立！) 頁面上的名稱有些許差異。

aws-marketplace:GetAgreementTerms

允許檢視協議頁面，以及 ISV 與諮詢合作夥伴之間的機會，合作夥伴(憑證已建立！) 頁面上的名稱有些許差異。

Note

若要讓使用者存取管理產品頁面上，您必須使用AWSMarketplaceSellerProductsFullAccess或AWSMarketplaceSellerProductsReadOnly受管理許可。

您可以將先前的權限合併為單一 IAM 政策，以授與您想要的權限。請參閱以下範例。

251

http://aws.amazon.com/marketplace/management/products/


http://aws.amazon.com/marketplace/management/marketing/

http://aws.amazon.com/marketplace/management/support/


http://aws.amazon.com/marketplace/management/product-load/

http://aws.amazon.com/marketplace/management/seller-settings/account


AWS Marketplace 賣方指南AWS 受管政策

範例 1：存取「行銷」和「檔案上傳」頁面的權限。若要將權限授與行銷部門頁面檔案上傳頁面上，使用類似以下範例的政策。

{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "aws-marketplace-management:viewMarketing", "aws-marketplace-management:uploadFiles" ], "Resource": ["*"] }]}

範例 2：為私人優惠建立升級和續約的權限若要授與檢視和使用協議頁面建立私人優惠的升級和續訂，請使用與以下範例類似的政策。

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "aws-marketplace:SearchAgreements", "aws-marketplace:DescribeAgreement", "aws-marketplace:GetAgreementTerms" ], "Effect": "Allow", "Resource": "*", "Condition": { "StringEquals": { "aws-marketplace:PartyType": "Proposer" }, "ForAllValues:StringEquals": { "aws-marketplace:AgreementType": [ "PurchaseAgreement" ] } } } ]}

使用 IAM 群組或者，您也可以建立個別的 IAM 群組，以授與AWS Marketplace 管理入口網站。使用者可以隸屬於多個群組。因此，如果使用者需要存取多個頁面，您可以將使用者新增至所有適當的群組。例如，建立一個 IAM 群組，並授與該群組存取行銷部門頁面上，建立另一個群組，並授與該群組存取檔案上傳頁面上的名稱有些許差異。如果使用者需要存取行銷部門頁面檔案上傳頁面上，將使用者新增至這兩個群組。

如需 IAM 使用者和群組的詳細資訊，請參閱身分 (使用者、群組和角色)中的IAM User Guide。

AWS的受管政策AWS Marketplace賣方若要新增許可給使用者、群組和角色，使用 AWS 受管政策比自己撰寫政策更容易。建立 IAM 客戶受管政策需要時間和專業知識，而受管政策可為您的團隊提供其所需的許可。若要快速開始使用，您可以使用 AWS

252

https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html

AWS Marketplace 賣方指南安全地方治療

受管政策。這些政策涵蓋常見的使用案例，並可在您的 AWS 帳戶中使用。如需 AWS 受管政策的詳細資訊，請參閱《IAM 使用者指南》中的 AWS 受管政策。

AWS 服務維護和更新 AWS 受管政策。您無法更改 AWS 受管政策中的許可。服務偶爾會在 AWS 受管政策中新增其他許可以支援新功能。此類型的更新會影響已連接政策的所有身分識別 (使用者、群組和角色)。當新功能啟動或新操作可用時，服務很可能會更新 AWS 受管政策。服務不會從 AWS 受管政策中移除許可，因此政策更新不會破壞您現有的許可。

此外，AWS 支援跨越多項服務之任務職能的受管政策。例如，ViewOnlyAccess 這項 AWS 受管政策提供針對許多 AWS 服務和資源的唯讀存取權限。當服務啟動新功能時，AWS 會為新的操作和資源新增唯讀許可。如需任務職能政策的清單和說明，請參閱《IAM 使用者指南》中有關任務職能的 AWS 受管政策。

此部分列出了各項用來管理賣家存取權的政策。AWS Marketplace。如需買方政策的詳細資訊，請參閱AWS的受管政策AWS Marketplace買方中的AWS Marketplace買方指南。

主題• AWS受管政策：安全地方治療 (p. 253)• AWS受管政策：智慧安裝完整存取 (p. 254)• AWS受管政策：可能的智慧放置位置 (p. 255)• AWS受管政策：安裝計量完整存取 (p. 256)• AWS受管政策：安全放置計量註冊使用 (p. 256)• AWS受管政策：智慧位置設定員完整存取 (p. 256)• AWS受管政策：AwSmartAller 產品完整存取 (p. 258)• AWS受管政策：AwSmartAller 產品僅供讀取 (p. 258)• AWS Marketplace更新AWS受管政策 (p. 259)

AWS受管政策：安全地方治療您可以使用此政策建立服務角色，然後可供AWS Marketplace代表您執行動作。如需使用 AwAwAccess 的詳細資訊，請參閱給予AWS Marketplace存取 AMI (p. 61)。

此政策是用來授與參與者權限，允許AWS Marketplace複製 Amazon Machine Machine Limages (AMI)，以便在AWS Marketplace。

許可詳細資訊

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "ec2:ModifySnapshotAttribute" ], "Effect": "Allow", "Resource": "arn:aws:ec2:us-east-1::snapshot/snap-*" }, { "Action": [ "ec2:DescribeImageAttribute", "ec2:DescribeImages", "ec2:DescribeSnapshotAttribute", "ec2:ModifyImageAttribute" ], "Effect": "Allow", "Resource": "*"

253

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html

https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-security-iam-awsmanpol.html

https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-security-iam-awsmanpol.html

AWS Marketplace 賣方指南智慧安裝完整存取

} ]}

AWS受管政策：智慧安裝完整存取您可以將 AWSMarketplaceFullAccess 政策連接到 IAM 身分。

此政策授與允許完全存取AWS Marketplace及相關服務，無論是作為賣方和買方。這些權限包括訂閱和取消訂閱AWS Marketplace軟體, 管理AWS Marketplace軟體執行個體AWS Marketplace、在帳戶中建立和管理私有市集，以及 Amazon EC2 的存取權限，AWS CloudFormation和 Amazon EC2 Systems Manager。

許可詳細資訊

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:*", "cloudformation:CreateStack", "cloudformation:DescribeStackResource", "cloudformation:DescribeStackResources", "cloudformation:DescribeStacks", "cloudformation:List*", "ec2:AuthorizeSecurityGroupEgress", "ec2:AuthorizeSecurityGroupIngress", "ec2:CreateSecurityGroup", "ec2:CreateTags", "ec2:DescribeAccountAttributes", "ec2:DescribeAddresses", "ec2:DeleteSecurityGroup", "ec2:DescribeImages", "ec2:DescribeInstances", "ec2:DescribeKeyPairs", "ec2:DescribeSecurityGroups", "ec2:DescribeSubnets", "ec2:DescribeTags", "ec2:DescribeVpcs", "ec2:RunInstances", "ec2:StartInstances", "ec2:StopInstances", "ec2:TerminateInstances" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ec2:CopyImage", "ec2:DeregisterImage", "ec2:DescribeSnapshots", "ec2:DeleteSnapshot", "ec2:CreateImage", "ec2:DescribeInstanceStatus", "ssm:GetAutomationExecution", "ssm:UpdateDocumentDefaultVersion", "ssm:CreateDocument", "ssm:StartAutomationExecution", "ssm:ListDocuments", "ssm:UpdateDocument",

254

AWS Marketplace 賣方指南可能的智慧放置位置

"ssm:DescribeDocument", "sns:ListTopics", "sns:GetTopicAttributes", "sns:CreateTopic", "iam:GetRole", "iam:GetInstanceProfile", "iam:ListRoles", "iam:ListInstanceProfiles" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "s3:ListBucket", "s3:GetObject" ], "Resource": [ "arn:aws:s3:::*image-build*" ] }, { "Effect": "Allow", "Action": [ "sns:Publish", "sns:setTopicAttributes" ], "Resource": "arn:aws:sns:*:*:*image-build*" }, { "Effect": "Allow", "Action": [ "iam:PassRole" ], "Resource": [ "*" ], "Condition": { "StringLike": { "iam:PassedToService": [ "ec2.amazonaws.com", "ssm.amazonaws.com" ] } } } ]}

AWS受管政策：可能的智慧放置位置您可以將 AWSMarketplaceGetEntitlements 政策連接到 IAM 身分。

此政策授與唯讀權限，允許軟體即服務 (SaaS) 產品銷售商檢查客戶是否已訂閱AWS MarketplaceSaaS 產品。

許可詳細資訊

{ "Version": "2012-10-17", "Statement": [ { "Action": [

255

AWS Marketplace 賣方指南安裝計量完整存取

"aws-marketplace:GetEntitlements" ], "Effect": "Allow", "Resource": "*" } ]}

AWS受管政策：安裝計量完整存取您可以將 AWSMarketplaceMeteringFullAccess 政策連接到 IAM 身分。

此政策授與參與者權限，允許報告與 AMI 和容器產品相對應的計量付費使用量，並在AWS Marketplace。

許可詳細資訊

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "aws-marketplace:MeterUsage" ], "Effect": "Allow", "Resource": "*" } ]}

AWS受管政策：安全放置計量註冊使用您可以將 AWSMarketplaceMeteringRegisterUsage 政策連接到 IAM 身分。

此原則會授與參與者權限，允許報告計量付費使用量，這些使用量對應於容器產品的每小時定價AWSMarketplace。

許可詳細資訊

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "aws-marketplace:RegisterUsage" ], "Effect": "Allow", "Resource": "*" } ]}

AWS受管政策：智慧位置設定員完整存取您可以將 AWSMarketplaceSellerFullAccess 政策連接到 IAM 身分。

此政策授與的管理許可，允許AWS Marketplace，包括AWS Marketplace 管理入口網站，以及管理基於 AMI的產品中使用的 Amazon EC2 亞馬遜機器圖像（AMI）。

256

AWS Marketplace 賣方指南智慧位置設定員完整存取

許可詳細資訊

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace-management:uploadFiles", "aws-marketplace-management:viewMarketing", "aws-marketplace-management:viewReports", "aws-marketplace-management:viewSupport", "aws-marketplace-management:viewSettings", "aws-marketplace:ListChangeSets", "aws-marketplace:DescribeChangeSet", "aws-marketplace:StartChangeSet", "aws-marketplace:CancelChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity", "aws-marketplace:ListTasks", "aws-marketplace:DescribeTask", "aws-marketplace:UpdateTask", "aws-marketplace:CompleteTask", "ec2:DescribeImages", "ec2:DescribeSnapshots", "ec2:ModifyImageAttribute", "ec2:ModifySnapshotAttribute" ], "Resource": "*" }, { "Action": [ "aws-marketplace:SearchAgreements", "aws-marketplace:DescribeAgreement", "aws-marketplace:GetAgreementTerms" ], "Effect": "Allow", "Resource": "*", "Condition": { "StringEquals": { "aws-marketplace:PartyType": "Proposer" }, "ForAllValues:StringEquals": { "aws-marketplace:AgreementType": [ "PurchaseAgreement" ] } } }, { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:PassRole" ], "Resource": "arn:aws:iam::*:role/*", "Condition": { "StringEquals": { "iam:PassedToService": "assets.marketplace.amazonaws.com" } } } ]}

257

AWS Marketplace 賣方指南AwSmartAller 產品完整存取

AWS受管政策：AwSmartAller 產品完整存取您可以將 AWSMarketplaceSellerProductsFullAccess 政策連接到 IAM 身分。

此政策授與參與者許可，允許完整權限來管理產品和AWS Marketplace 管理入口網站，以及管理基於 AMI 的產品中使用的 Amazon EC2 亞馬遜機器圖像（AMI）。

許可詳細資訊

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:ListChangeSets", "aws-marketplace:DescribeChangeSet", "aws-marketplace:StartChangeSet", "aws-marketplace:CancelChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity", "aws-marketplace:ListTasks", "aws-marketplace:DescribeTask", "aws-marketplace:UpdateTask", "aws-marketplace:CompleteTask", "ec2:DescribeImages", "ec2:DescribeSnapshots", "ec2:ModifyImageAttribute", "ec2:ModifySnapshotAttribute" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:PassRole" ], "Resource": "arn:aws:iam::*:role/*", "Condition": { "StringEquals": { "iam:PassedToService": "assets.marketplace.amazonaws.com" } } } ]}

AWS受管政策：AwSmartAller 產品僅供讀取您可以將 AWSMarketplaceSellerProductsReadOnly 政策連接到 IAM 身分。

此政策授與允許存取AWS Marketplace 管理入口網站，以及查看基於 AMI 的產品中使用的 Amazon EC2 亞馬遜機器圖像（AMI）。

許可詳細資訊

{ "Version": "2012-10-17",

258

AWS Marketplace 賣方指南政策更新

"Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:ListChangeSets", "aws-marketplace:DescribeChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity", "aws-marketplace:ListTasks", "aws-marketplace:DescribeTask", "ec2:DescribeImages", "ec2:DescribeSnapshots" ], "Resource": "*" } ]}

AWS Marketplace更新AWS受管政策檢視更新的詳細資訊AWS的受管政策AWS Marketplace因為這項服務開始追蹤這些變更。如需有關此頁面變更的自動提醒，請訂閱AWS Marketplace 文件歷史記錄 (p. 264)(憑證已建立！) 頁面上的名稱有些許差異。

變更描述日期

AWSMarketplaceFullAccess (p. 254)—更新現有政策

AWS Marketplace已移除重複的ec2:DescribeAccountAttributes權限AWSMarketplaceFullAccess政策。

2021 年 7 月 20 日

AWS Marketplace開始追蹤變更 AWS Marketplace開始追蹤其AWS受管政策。

2021 年四月二十日

AWS MarketplaceCommerce Analytics Service 帳戶權限

您可以使用下列 IAM 權限政策允許 IAM 使用者存取AWS MarketplaceCommerce Analytics Service

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ]}

如需本功能的詳細資訊，請參閱AWS MarketplaceCommerce Analytics Service (p. 8)。

259

AWS Marketplace 賣方指南AWS Marketplace產品 Support 連線帳戶權限

AWS Marketplace產品 Support 連線帳戶權限所以此AWS Marketplace產品支援連線功能讓客戶能夠在AWS Marketplace網站，以便您可以為您的產品提供支援。AWS Marketplace共用客戶透過 API 提供給您的資料。客戶可以在購買您註冊的產品期間或之後，選擇新增聯絡資料AWS Marketplace產品支援連線。您可以使用 API 擷取客戶的連絡人資料，以及相關的產品訂閱詳細資料。

如果尚未註冊the section called “AWS MarketplaceCommerce Analytics Service” (p. 8)，您必須設定您的帳戶和AWS服務來使用它。執行以下操作：

1. (選用) 建立IAM 使用者。2. 建立目的地Amazon Simple Storage Service (Amazon S3) 儲存貯體。3. 建立Amazon Simple Notification Service (Amazon SNS) 主題以取得回應通知。4. 註冊AWS MarketplaceCommerce Analytics Service。5. (建議使用) 對服務進行測試呼叫AWS Command Line Interface(AWS CLI)。

如需說明，請參閱入門指南 (p. 9)。

Note

產品支援連線所需的 IAM 權限與商務分析服務所需的 IAM 權限不同。產品支援連線需要 IAM 使用者可以呼叫marketplacecommerceanalytics:StartSupportDataExport動作。

您可以允許 IAM 使用者呼叫StartSupportDataExport動作，藉由使用 IAM 許可政策。

Example

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:StartSupportDataExport", "Resource": "*" } ]}

如需此功能的詳細資訊，請參閱產品 Support 連線 (p. 18)。

Amazon SQS 權限作為 SaaS 產品發佈程序的一部分，AWS Marketplace提供 Amazon SNS 主題，您可以在客戶的訂閱或權益狀態變更時用來接收通知。您可以為主題設定一或多個 Amazon SQS 佇列，以便佇列可以對通知採取動作。例如，如果客戶在 SaaS 產品的訂閱中新增更多儲存體，則 Amazon SNS 主題可以將訊息傳送至 AmazonSQS 佇列，該佇列會啟動程序自動增加該客戶可用的儲存容量。

當您訂閱 Amazon Simple Queue Service (Amazon SQS) 佇列到提供的 Amazon SNS 主題時，會自動新增權限，以允許該主題將訊息發佈到佇列。不過，您仍然需要 IAM 政策，以授與AWS Marketplace計量和權利服務 API 使用者對佇列的存取權。如果服務以相同的認證執行，這可以套用至相同的使用者。建立包含下列內容的政策，並與 IAM 使用者或角色連接。

{ "Version": "2012-10-17",

260

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html

https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#create-bucket-intro

https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html


AWS Marketplace 賣方指南AWS Marketplace計量和權利 API 權限

"Statement": [ { "Action": [ "sqs:ReceiveMessage", "sqs:DeleteMessage", "sqs:GetQueueAttributes", "sqs:GetQueueUrl" ], "Effect": "Allow", "Resource": "arn:aws:sqs:REGION_HERE:XXXXXXXXXXXX:NAME_HERE" } ]}

Note

所以此Resource檔案是 Amazon SQS 佇列的 Amazon Resource Name (ARN)。

如需 SaaS 產品的訊息通知和佇列的詳細資訊，請參閱the section called “訂閱 SQS 佇列至 SNS 主題” (p. 157)和the section called “正在存取AWS Marketplace計量與權利服務 API” (p. 157)。

AWS Marketplace計量和權利 API 權限軟體即服務 (SaaS) 產品、AMI 產品和容器產品均可使用AWS Marketplace計量與權利服務 API。每種類型都需要不同的 IAM 權限。對於您的產品或產品，您可以計量所有使用量，而客戶則按AWS根據您提供的計量記錄。若要啟用提供AWS Marketplace計量記錄時，整合正在執行的服務帳戶需要受限制的 IAM 政策才能啟用存取。附加您要傳送計量資訊的產品類型政策給您用於整合的 IAM 使用者或角色。

SaaS 產品的 IAM 政策{ "Version": "2012-10-17", "Statement": [ { "Action": [ "aws-marketplace:ResolveCustomer", "aws-marketplace:BatchMeterUsage", "aws-marketplace:GetEntitlements" ], "Effect": "Allow", "Resource": "*" } ]}

Note

所有 SaaS 整合都需要第一個權限。第二個和第三個權限需要AWS Marketplace計量服務 API 和AWS Marketplace權利服務 API。

AMI 產品的 IAM 政策{ "Version": "2012-10-17", "Statement": [ { "Action": [ aws-marketplace:MeterUsage ],

261

AWS Marketplace 賣方指南容器產品的 IAM 政策

"Effect": "Allow", "Resource": "*" } ]}

容器產品的 IAM 政策{ "Version": "2012-10-17", "Statement": [ { "Action": [ "aws-marketplace:RegisterUsage" ], "Effect": "Allow", "Resource": "*" } ]}

如需建立 IAM 使用者的詳細資訊，請參閱建立 IAM 使用者AWS帳戶中的IAM 使用者指南。如需建立與指派政策的詳細資訊，請參閱變更 IAM 使用者的許可。

此政策授與您附加政策之 IAM 角色或使用者 API 的存取權。如需如何為這些 API 呼叫啟用另一個帳戶的詳細資訊，請參閱如何最好的建築師你AWS Marketplace跨多個 SaaS 訂閱AWS帳戶在AWS合作夥伴網路(APN) 部落格。

使用 AWS CloudTrail 記錄 AWS Marketplace API 呼叫

AWS Marketplace與 CloudTrail 整合，這是一種服務，該服務提供由使用者、角色或AWS服務AWSMarketplace。CloudTrail 會擷取AWS Marketplace當作事件。擷取的呼叫包括從 AWS Marketplace 主控台進行的呼叫，以及針對 AWS Marketplace API 操作的程式碼呼叫。

當您建立帳戶時，系統即會在您的 AWS 帳戶中啟用 CloudTrail。當支援的事件活動發生在AWSMarketplace，該外，系統便會將該活動記錄至 CloudTrail 事件，並將其他AWS服務事件事件歷史記錄。您可以檢視、搜尋和下載帳戶的最新事件。

每一筆事件或日誌項目都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：

• 該請求是否透過根或 AWS Identity and Access Management (IAM) 使用者登入資料來提出。• 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全登入資料.• 該請求是否由另一項 AWS 服務提出。

AWS Marketplace支援記錄BatchMeterUsage作為 CloudTrail 日誌文件中的事件進行操作。

範例: AWS Marketplace 日誌檔案項目以下範例顯示的是展示BatchMeterUsage動作AWS Marketplace Metering Service。

{"Records": [

262

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html

http://aws.amazon.com/blogs/apn/how-to-best-architect-your-aws-marketplace-saas-subscription-across-multiple-aws-accounts/

AWS Marketplace 賣方指南相關主題

{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "EX_PRINCIPAL_ID", "arn": "arn:aws:iam::123456789012:user/Alice", "accountId": "123456789012", "accessKeyId": "EXAMPLE_KEY_ID", "userName": "Alice" }, "eventTime": "2018-04-19T16:32:51Z", "eventSource": "metering-marketplace.amazonaws.com", "eventName": "BatchMeterUsage", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.0.2/24", "userAgent": "Coral/Netty14", "requestParameters": { "usageRecords": [ { "dimension": "Dimension1", "timestamp": "Apr 19, 2018 4:32:50 PM", "customerIdentifier": "customer1", "quantity": 1 } ], "productCode": "EXAMPLE_proCode" }, "responseElements": { "results": [ { "usageRecord": { "dimension": "Dimension1", "timestamp": "Apr 19, 2018 4:32:50 PM", "customerIdentifier": "customer1", "quantity": 1 }, "meteringRecordId": "bEXAMPLE-98f0-4e90-8bd2-bf0EXAMPLE1e", "status": "Success" } ], "unprocessedRecords": [ ] }, "requestID": "dEXAMPLE-251d-11e7-8d11-1f3EXAMPLE8b", "eventID": "cEXAMPLE-e6c2-465d-b47f-150EXAMPLE97", "readOnly": false, "eventType": "AwsApiCall", "recipientAccountId": "123456789012" } ] }

相關主題如需詳細資訊，請參閱 AWS CloudTrail 使用者指南中的以下主題：

• 建立追蹤的概觀• AWS 與 CloudTrail 日誌的服務整合• 針對 CloudTrail 設定 Amazon SNS 通知• 從多個區域接收 CloudTrail 日誌檔案，以及從多個帳戶接收 CloudTrail 日誌檔案• CloudTrail userIdentity 元素。

263

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html


文件歷史記錄下表說明此版本的說明文件。AWS Marketplace賣方指南。

update-history-change update-history-description update-history-date

退款政策及審批僅限文件更新，以釐清退款政策，並將所有退款資訊移至AWSMarketplace賣方指南。

2021 年 8 月 20 日

選擇或上傳 EULA 以諮詢合作夥伴私人優惠

獨立軟體廠商現在可以在為諮詢合作夥伴建立轉售商機時，選取或上傳使用者授權合約 (EULA)。

2021 年 8 月 17 日

SaaS 合約產品的自訂產品尺寸獨立軟體廠商 (ISV) 現在可以在為諮詢合作夥伴建立轉售機會時，自訂 SaaS 合約產品維度。

2021 年 8 月 17 日

AWS Marketplace 現場示範節目僅限文件更新，以釐清 AWS DataExchange 資料集產品的需求AWSMarketplace現場示範計畫。

2021 年 8 月 3 日

SaaS 產品指南更新 SaaS 產品的產品指南已更新。 2021 年 7 月 29 日

以容器為基礎的產品需求更新以容器為基礎的產品需求已更新。 2021 年 7 月 29 日

AMI 安全政策更新 AMI 產品的安全政策已更新。 2021 年 7 月 29 日

更符合資格的司法管轄下列物品現在符合AWSMarketplace：香港特別行政區和卡塔爾。

2021 年 6 月 23 日

資料饋送概觀僅限文件更新，提供銷售者可用的資料摘要結構概觀。

2021 年 6 月 23 日

更新了機器學習章節僅限文件更新有關建立和維護機器學習產品的資訊。

2021 年 5 月 27 日

容器產品的自助更新賣方現在可以更簡單快速的方式，透過AWS Marketplace 管理入口網站。

2020 年 12 月 17 日

專業服務賣家現在可以提供專業的服務AWS Marketplace買方。將專業服務部分新增至文件中。

2020 年 12 月 3 日

AMI 產品的自助更新賣方現在有一個更簡單快捷的方式來更新他們的基於亞馬遜機器圖像（AMI）的產品，通過AWSMarketplace 管理入口網站。

2020 年 11 月 23 日

更符合資格的司法管轄下列物品現在符合AWSMarketplace：巴林、挪威、瑞士和阿拉伯聯合酋長國 (阿聯酋)。

2020 年 6 月 17 日

您可以針對已接受的私人優惠提供升級和續約

對於 SaaS 合約和使用消費產品的SaaS 合約，您可以使用先前接受

2020 年 5 月 28 日

264

https://docs.aws.amazon.com/marketplace/latest/userguide/refunds.html

https://docs.aws.amazon.com/marketplace/latest/userguide/consulting-partner-isv-info.html



https://docs.aws.amazon.com/marketplace/latest/userguide/field-demonstration-program.html

https://docs.aws.amazon.com/marketplace/latest/userguide/saas-guidelines.html

https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-policies.html

https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html

https://docs.aws.amazon.com/marketplace/latest/userguide/user-guide-for-sellers.html#eligible-jurisdictions

https://docs.aws.amazon.com/marketplace/latest/userguide/data-feed-joining.html

https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-products.html

https://docs.aws.amazon.com/marketplace/latest/userguide/create-container-product.html

https://docs.aws.amazon.com/marketplace/latest/userguide/proserv-products.html

https://docs.aws.amazon.com/marketplace/latest/userguide/ami-products.html

https://docs.aws.amazon.com/marketplace/latest/userguide/user-guide-for-sellers.html#eligible-jurisdictions

https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html

https://docs.aws.amazon.com/marketplace/latest/userguide/private-offers-upgrades-and-renewals.html


的私人優惠的私人優惠來提供升級和續約。

詳細資訊將另由資料饋送提供。報告中的更多資訊會細分為較小的資料饋送，以簡化資料的尋找和分析作業。

2020 年 5 月 21 日

標準化授權條款現已提供您可以提供標準化的授權條款取代自訂 EULA，以簡化合約程序。

2020 年 4 月 28 日

澳洲和紐西蘭是符合資格的司法管轄區

下列物品現在符合AWSMarketplace：(i) 澳洲 (澳洲) 新西蘭 (新西蘭) 的永久居民和公民，或 (ii) 在其中一個地區組織或成立的商業實體。

2020 年 4 月 2 日

容器產品現在支援自訂計量和定價增強功能

如果您想要定義自己的定價單位和計量，以供我們計費使用，請與AWS Marketplace計量服務meterUsage動作。

2019 年 11 月 14 日

AWS Marketplace 透過 AWSData Exchange 支援資料產品

您現在可以在AWS Marketplace。 2019 年 11 月 13 日

簡介。AWS Marketplace目錄 APIService Catalog (p. 264)

所以此AWS Marketplace目錄 API服務提供 API 介面，讓經核准的銷售者以程式設計方式管理其產品。

2019 年 11 月 12 日

AWS Marketplace 支援每小時付費容器

AWS Marketplace現在支援Amazon Elastic KubernetesService (Amazon ElasticKubernetes Service) 上執行的每小時付費容器。

2019 年 9 月 25 日

AMI 產品功能更新您現在可以一起部署 AMI 和Lambda 函數，使用AWSCloudFormation。

2019 年 9 月 11 日

新增了安全區段在新的「安全性」區段下整合的安全性內容。

2019 年 5 月 7 日

AMI 安全政策更新更新 AMI 產品的安全政策 2019 年 4 月 11 日

已將版本設定資訊新增至Machine Learning 產品區段 (p. 264)

已新增說明機器學習產品版本功能的內容。

2019 年 3 月 21 日

新增 Machine Learning 產品區段新增發佈機器學習產品的內容 2018 年 11 月 28 日

新增以容器為基礎的產品區段新增發佈容器型產品的內容。 2018 年 11 月 27 日

已更新提交賣家協助要求的連結將電子郵件地址變更為網頁表單地址。

2018 年 10 月 22 日

新增含消費內容的 SaaS 合約重新架構 SaaS 內容和新增的內容，以支援發行具有消費功能的SaaS 合約。

2018 年 10 月 18 日

新增有關私人優惠彈性付款時間表的內容

新增內容，以支援針對私人優惠內容彈性付款排程器發行。

2018 年 10 月 15 日

265

https://docs.aws.amazon.com/marketplace/latest/userguide/data-feed.html

https://docs.aws.amazon.com/marketplace/latest/userguide/standardized-license-terms.html

https://docs.aws.amazon.com/marketplace/latest/userguide/user-guide-for-sellers.html#additional-seller-requirements-for-paid-products


https://docs.aws.amazon.com/marketplace/latest/userguide/entitlement-and-metering-for-paid-products.html

https://docs.aws.amazon.com/marketplace/latest/userguide/entitlement-and-metering-for-paid-products.html

https://docs.aws.amazon.com/marketplace/latest/userguide/data-products.html

https://docs.aws.amazon.com/marketplace/latest/userguide/data-products.html

https://docs.aws.amazon.com/marketplace/latest/userguide/container-based-products.html


https://docs.aws.amazon.com/marketplace/latest/userguide/cloudformation-serverless-application.html

https://docs.aws.amazon.com/marketplace/latest/userguide/seller-security.html

https://docs.aws.amazon.com/marketplace/latest/userguide/product-and-ami-policies.html

https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-products.html



https://docs.aws.amazon.com/marketplace/latest/userguide/saas-contracts.html

https://docs.aws.amazon.com/marketplace/latest/userguide/flexible-payment-scheduler.html

https://docs.aws.amazon.com/marketplace/latest/userguide/flexible-payment-scheduler.html


已更新 IAM 許可內容新增內容以支援 AMMP 唯讀存取的新 IAM 權限。

2018 年 10 月 9 日

已新增諮詢合作夥伴私人優惠的內容

新增支援諮詢合作夥伴私人優惠功能版本的內容。

2018 年 10 月 9 日

已新增關於私人影像建置的內容已新增內容以支援針對 AMI 功能發行的私人映像建置。

2018 年 8 月 13 日

新增賣家搜尋引擎最佳化指引。為想要最佳化產品以進行搜尋的賣家新增指引。

2018 年 7 月 3 日

已更新 AWS Marketplace 標誌的連結

已更新指向新 AWS Marketplace標誌的連結。

2018 年 6 月 12 日

已新增賣家指南將所有 PDF 賣家指南轉換為線上內容。

2018 年 5 月 9 日

266

https://docs.aws.amazon.com/marketplace/latest/userguide/marketplace-management-portal-user-access.html#detailed-management-portal-permissions

https://docs.aws.amazon.com/marketplace/latest/userguide/consulting-partner-offers.html

https://docs.aws.amazon.com/marketplace/latest/userguide/consulting-partner-offers.html

https://docs.aws.amazon.com/marketplace/latest/userguide/private-images.html

https://docs.aws.amazon.com/marketplace/latest/userguide/search-engine-optimization.html

https://docs.aws.amazon.com/marketplace/latest/userguide/product-marketing.html#using-the-aws-marketplace-logo

https://docs.aws.amazon.com/marketplace/latest/userguide/product-marketing.html#using-the-aws-marketplace-logo

https://docs.aws.amazon.com/marketplace/latest/userguide/what-is-marketplace.html


AWS 詞彙表如需最新 AWS 術語，請參閱 AWS 一般參考中的 AWS 詞彙表。

267

https://docs.aws.amazon.com/general/latest/gr/glos-chap.html


本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

cclxviii

Date post:	29-Jan-2023
Category:	Documents
Upload:	khangminh22
View:	0 times
Download:	0 times