本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS Marketplace 商務分析服務
AWS Marketplace 商務分析服務可讓您透過程式設計方式存取產品和客戶資料 AWS Marketplace。註冊服務後,您可以透過存取使用量、訂閱和帳單報告 AWS SDK。
您使用這些SDK工具請求的資料會以資料集的形式傳送 AWS 帳戶 至您的。大部分的資料集對應於相同的資料,以文字為基礎的報表。AWS Marketplace 管理入口網站
條款及細則
這些 AWS Marketplace 商務分析服務條CAS款與條件 (以下簡稱「條款」) 包含您使用和存取 AWS Marketplace 商務分析服務 (「CA 服務」) 的特定條CAS款與條件,且自您按一下「我接受」按鈕或核取方塊當您使用任何 CA 服務方案時起生效。這些CAS條款是您與 Amazon Web Services, Inc.(」,「我們」或「我們的」)之間的AWS Marketplace 賣 AWS Marketplace 家條款和條件(以下簡稱「賣方條款」)的附錄,這些條款已在此納入。AWS如果這些條款與 AWS Marketplace 賣方條CAS款之間存在衝突,則本條款的條CAS款和條件僅適用於此類衝突的程度,僅適用於您對 CA 服務的使用。本文中使用但未在此處定義的術語應具有 AWS Marketplace 賣方條款中規定的含義。
-
CA 服務與CAS資料。要符合使用加州服務的資格,你必須是受現有 AWS Marketplace 賣家條款約束的 AWS Marketplace 賣家。您所收到或可存取的與 CA 服務相關的資訊和資料 (以下稱「資CAS料」) 構成訂閱者資訊,並受 AWS Marketplace 賣家條款中規定的限制和義務所約束。閣下可以保密的方式使用CAS資料來改善與閣下 AWS Marketplace 內容相關的市場推廣及其他促銷活動,前提是閣下不得 (a) 向任何第三方披露CASCAS資料;(d) 以任何不符適用的私隱政策或法律的方式使用任何資料;(c) 聯絡訂戶以影響他們在本公司以外進行另類購買 AWS Marketplace;(d) 貶低我們、我們各自的關聯公司或我們的任何產品;的基礎上,任何形式的目標通信預期的收件者是 AWS Marketplace 訂閱者。
-
CA 服務限制和安全性。您只能透過 CA 服務說明文件中所述的方式存取 (或嘗試存取) CA 服務。使用 CA 服務時,您不會歪曲或掩蓋您的身份或客戶的身份。我們保留權利,全權酌情決定設定和強制執行您使用 CA 服務的限制,包括但不限於在任何時間段內允許存取 CA 服務的連線數量、通話和伺服器數量。您同意且不會嘗試規避此類限制。如果我們認為您可能違反本CAS條款或濫用 CA 服務,我們保留限制、暫停或終止您存取 CA 服務的權利。
-
CA 服務憑證機密性和安全性。CA 服務憑證(例如密碼、金鑰和用戶端IDs)旨在供您用來識別您的用API戶端。您應全權負責將您的憑據保密,並將採取一切合理措施以避免披露、傳播或未經授權使用此類憑證,包括您為保護自己具有類似性質的機密資訊而採取的措施至少包括這些措施。CA 服務認證可能不會內嵌在開放原始碼專案中。您必須全權負責使用您的憑證存取 CA 服務的任何及所有權限。
-
修改。我們可以隨時修改這些CAS條款,方法是在AWS網站上發布修訂版本或根據 AWS Marketplace 賣家條款向您提供通知。修改後的條款將在發布時生效,或者如果我們通過電子郵件通知您,如電子郵件中所述。在本CAS條款的任何修改生效日期後繼續使用或存取 CA 服務,即表示您同意受修改後條款的約束。
-
終止。這些CAS條款和使用此處授予的CAS數據的權利將在出於任何原因終止您的 AWS Marketplace 賣家條款時終止,無論是否通知您。此外,我們可能隨時以任何理由或無理由停止提供 CA 服務或終止您對 CA 服務的存取權。
入職指南
您必須配置 AWS 帳戶 和 AWS 服務 才能使用 AWS Marketplace 商務分析服務。
使用 AWS Marketplace 商務分析服務
設定您的 AWS 帳戶 使用權限
AWS Marketplace 強烈建議使用 AWS Identity and Access Management (IAM) 角色登入, AWS Marketplace 管理入口網站 而不是使用您的根帳戶認證。AWS Marketplace 賣家政策和權限如需 AWS Marketplace 商務分析服務IAM權限的特定權限,請參閱。為存取您帳戶的人建立個別 使用者,即可將一組唯一的安全登入資料授予每個 使用者。您也可以將不同的許可授予每個 使用者。如有需要,您隨時可以變更或撤銷 使用者的許可。
建立目的地 Amazon S3 儲存貯體
商務分析服務會將您請求的資料交付到您指定的 Amazon S3 儲存貯體。如果您已經有要使用的 Amazon S3 儲存貯體,請繼續執行下一個步驟。
如果您沒有 Amazon S3 儲存貯體,或想要專門為此資料建立 Amazon S3 儲存貯體,請參閱如何建立 S3 儲存貯體。
針對回應通知設定 Amazon SNS 主題
商務分析服務使用 Amazon 提供回應通知SNS。服務會將訊息發佈到此主題,以便在您的資料集可用或發生錯誤時通知您。如果您已經有一個 Amazon SNS 主題用於此目的,請繼續執行下一步。
如果您沒有為此服務設定 Amazon SNS 主題,請立即設定一個主題。如需指示,請參閱建立主題。
記錄您建立的主題的主題 Amazon 資源名稱 (ARN),因為呼叫服務時需要。ARN
註冊商務分析服務計劃
在您使用儲存貯體的SNS主題和名稱設定服務之後,商務分析服務會存ARN取 Amazon S3 儲存貯體和 Amazon 主題。
啟用存取
-
使用 AWS 帳戶 您AWS Marketplace 管理入口網站
用來管理 AWS Marketplace 產品的使用者登入。 -
確保您具有註冊商務分析服 AWS Marketplace 務的必要IAM權限。
-
導覽至商務分析服務註冊頁面
。 -
輸入 Amazon S3 儲存貯體名稱和 Amazon SNS 主題ARN,然後選擇註冊。
-
在 [權限] 頁面上,選擇 [允許]。
-
在上 AWS Marketplace 管理入口網站,在成功訊息ARN中記錄「角色名稱」。您需ARN要呼叫服務。
注意
加入商務分析服務會IAM在您 AWS 帳戶的. 該IAM角色 AWS Marketplace 允許寫入 Amazon S3 儲存貯體,並將通知發佈到 Amazon SNS 主題。 AWS Marketplace 使用帳號 452565589796 來執行這些與此角色相關聯的動作。IAM
驗證您的組態
最後一個步驟是驗證您的組態是否如預期般運作。
若要測試組態
-
下載、安裝和設定AWS命令列介面 (AWS CLI)。
-
使用 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 "{DOC-EXAMPLE-BUCKET}" \ --destination-s3-prefix "TEST_PREFIX" \ --sns-topic-arn "{YOUR-SNS-TOPIC-ARN}"
-
對於
--data-set-publication-date
,使用 ISO -8601 格式替換{TODAY'S DATE}
為當前日期YYYY-MM-DDT00:00:00Z
,其中YYYY
是四位數年份,是兩位數月份,並且MM
DD
是兩位數的日期。 -
對於
--role-name-arn
,取代{YOUR-ROLE-NAME-ARN}
為您從中ARN的註冊程序收到的角色註冊商務分析服務計劃。 -
對於 --S3-儲存貯體名稱,請將 {DOC-EXAMPLE-BUCKET} 取代為您在其中建立的 Amazon S3 儲存貯體的名稱。建立目的地 Amazon S3 儲存貯體
-
對於 — sns-topic-arn,將 {YOUR---SNS TOPIC-ARN} 替換為您在中創建的 Amazon SNS 主題針對回應通知設定 Amazon SNS 主題。
如果您收到包含來自服務的 dataSetRequestID 回應的回應,表示您已完成加入程序。一個成功的回應看起來像這樣:
{ "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" }
技術實施指南
AWS Marketplace 商務分析服務是透過 AWSSDK
IAM商務分析服務政策
為了允許您的用戶使用商務分析服務,需要以下權限。
使用下列IAM權限原則註冊 AWS Marketplace 商務分析服務。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:ListRoles", "iam:CreateRole", "iam:CreatePolicy", "iam:AttachRolePolicy", "aws-marketplace-management:viewReports" ], "Resource": "*" } ] }
使用下列IAM權限原則可允許使用者向 AWS Marketplace 商務分析服務提出要求。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] }
如需詳細資訊,請參閱《IAM使用指南》中的〈在IAM主控台中建立策略〉。
提出要求 AWS CLI
若要開始使用,請下載 AWS CLI
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" \ --sns-topic-arn "arn:aws:sns:us-west-2:123412341234:demo-topic"
此要求會傳回每個要求唯一的識別碼。您可以使用此識別碼將請求與發佈到 Amazon SNS 主題的通知建立關聯。下列範例是此識別碼的範例。
{ "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab" }
提出要求 AWS SDK for Java
若要開始,請下載 AWSJava SDK
/* * 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. * <p> * <b>Prerequisites:</b> Follow the on-boarding guide: {URL OR SOMETHING} * <p> * 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. * <p> * <b>WARNING:</b> To avoid accidental leakage of your credentials, DO NOT keep * the credentials file in your source directory. * <p> * http://aws.amazon.com/security-credentials */ 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 valid format.", 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 parameters GenerateDataSetRequest 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 service GenerateDataSetResult 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); } }
您應該期待與此範例類似的結果。
=============================================================== Getting Started with AWS Marketplace Commerce Analytics Service =============================================================== Creating a request for data set customer_subscriber_hourly_monthly_subscriptions for publication date Sun Jun 08 17:00:00 PDT 2014. Request successful, unique ID: c59aff81-6875-11e5-a6d8-fd5dbcaa74ab
技術文件
該服務公開了一種方法GenerateDataSet
,可讓您請求將資料集發佈到 Amazon S3 儲存貯體。下表列示的參數GenerateDataSet
。
資料集參數 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
欄位 | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集類型 | 該數據集將作為請求的結果返回。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集發佈日期 |
發佈資料集的日期。 對於每日資料集,請為所需日期提供具有日級粒度的日期。 針對每月資料集,請提供所需月份之月份層級精細度的日期。忽略日值。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
角色名稱 ARN | 具有附加權限原則ARN的角色,可讓服務存取您的資源。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
目的地 Amazon S3 存儲桶名 | 目的地 Amazon S3 儲存貯體的名稱 (易記名稱,而不是ARN)。您的資料集會發佈到這個位置。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon S3 目的地前綴 |
(選擇性) 已發佈資料集的 Amazon S3 前置詞,類似於標準檔案系統中的目錄路徑。 例如,如果指定值區名稱 如果前綴目錄結構不存在,則會創建它。 如果未提供前置詞,資料集會發佈到 Amazon S3 儲存貯體根目錄。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SNS主题 ARN |
在ARN資料集發佈或發生錯誤時通知的 Amazon SNS 主題。 |
回應
AWS Marketplace 商務分析服務會傳回兩個回應。第一個是同步的,立即返回,第二個是異步的,這是使用 Amazon 返回的SNS。同步回應類似於此範例。
資料集參數 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
欄位 | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集請求識別碼 | 代表服務特定要求的唯一識別碼。此識別碼可用於將請求與 Amazon SNS 主題的通知建立關聯。 |
非同步回應會以JSON格式化的文件發佈到您的 Amazon SNS 主題,與此範例類似。
資料集參數 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
欄位 | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集 S3 位置 | 已傳送資料集的值區名稱和金鑰。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集中繼資料 S3 位置 | 已傳送資料集中繼資料檔案的值區名稱和金鑰。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集請求識別碼 | 代表服務特定要求的唯一識別碼。此識別碼可用於將請求與 Amazon SNS 主題的通知建立關聯。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Success (成功) | 如果作業成功,則為「True」;如果不是,則為「false」。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
訊息 | (選擇性) 如果發生錯誤 (例如,「成功」為「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 }
輸出
成功請求後,請求的資料集會以 .csv 檔案形式傳送到您的 Amazon S3 儲存貯體。JSON格式化的中繼資料檔案會發佈至與資料集檔案相同的位置。中繼資料檔案提供有關資料集和原始要求參數的實用資訊。中繼資料檔案的名稱與資料集檔案相同,但是以 .meta.json 副檔名結尾。下表列出 .csv 檔案中的中繼資料欄位。
元數據字段 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
欄位 | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集請求識別碼 | 代表服務特定要求的唯一識別碼。此識別碼可用於將請求與 Amazon SNS 主題的通知建立關聯。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集涵蓋範圍 | 定義資料涵蓋範圍的開始日期/時間和結束日期/時間。這些日期是 ISO 8601 格式。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集請求參數 | 原始請求參數的GenerateDataSet 方法。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集 S3 位置 | 已傳送資料集的值區名稱和金鑰。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
資料集中繼資料 S3 位置 | 已傳送資料集中繼資料檔案的值區名稱和金鑰。 |
以下是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" } }
如需可用資料集的完整清單 (包括可用性日期),請參閱AWSSDK文件。
故障診斷
本節說明使用 AWS Marketplace 商務分析服務時可能遇到問題的解決方案。
由於允許列表問題,我無法訪問該服務。
如果你尚未註冊為賣家 AWS Marketplace,請前AWS Marketplace 管理入口網站
我不能請求過去的日期的數據集,即使SDK文檔說它應該在這個日期可用。
雖然資料集列為過去某些日期可供使用,但我們只有自您加入之後才有資料 AWS Marketplace。如果你認為這是錯誤的,請聯絡AWS Marketplace 賣家營運
當我調用服務時,我收到錯誤消息「無法連接到端點URL:https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/」
AWS 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政策:
-
登入 AWS Management Console 並開啟IAM主控台,位於https://console.aws.amazon.com/iam/
。 -
選擇IAM主控台左側的 [角色]。
-
選擇MarketplaceCommerceAnalyticsRole。
-
展開「內嵌角色」區段 (如果尚未展開)。
-
找出名稱開頭為的策略,oneClick_MarketplaceCommerceAnalyticsRole然後選擇編輯策略。
-
在政策文件中,找出指定與您要修改之服務相關動作的區段。例如,若要變更 Amazon S3 儲存貯體,請找到包含以 s3 開頭之動作的區段,然後變更各自的資源選項以指定新的 Amazon S3 儲存貯體。
如需有關IAM原則的其他資訊,請參閱下列指南:https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
當我調用GenerateDataSet
動作時AccessDeniedException
出現錯誤
如果您的用戶沒有呼叫所需的權限,則可能會發生這種情況GenerateDataSet
。下列程序概述使用IAM主控台建立具有這些權限的IAM原則,並將權限新增至您的使用者、群組或角色所需的步驟。
使用JSON策略編輯器建立策略
登入 AWS Management Console 並開啟IAM主控台,位於https://console.aws.amazon.com/iam/
。 -
在左側的導覽窗格中,選擇 Policies (政策)。
如果這是您第一次選擇 Policies (政策),將會顯示 Welcome to Managed Policies (歡迎使用受管政策) 頁面。選擇 Get Started (開始使用)。
-
在頁面頂端,選擇 Create policy (建立政策)。
-
在 [原則編輯器] 區段中,選擇JSON選項。
-
輸入以下JSON政策文件:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "marketplacecommerceanalytics:GenerateDataSet", "Resource": "*" } ] }
-
選擇下一步。
注意
您可以隨時在視覺和JSON編輯器選項之間切換。不過,如果您在視覺化編輯器中進行變更或選擇 [下一步],IAM可能會重新架構您的原則,以針對視覺化編輯器最佳化它。如需詳細資訊,請參閱《IAM使用指南》中的「策略重新架構」。
-
在檢視與建立頁面上,為您在建立的政策輸入政策名稱與描述 (選用)。檢視此政策中定義的許可,來查看您的政策所授予的許可。
-
選擇 Create policy (建立政策) 儲存您的新政策。
若要提供存取權,請新增權限至您的使用者、群組或角色:
-
使用者和群組位於 AWS IAM Identity Center:
建立權限合集。請按照 AWS IAM Identity Center 使用者指南 中的 建立權限合集 說明進行操作。
-
IAM透過身分識別提供者管理的使用者:
建立聯合身分的角色。請遵循《使用指南》中的〈為第三方身分識別提供IAM者 (同盟) 建立角色〉中的指示進行。
-
IAM使用者:
-
建立您的使用者可擔任的角色。請按照《用戶指南》中的「為IAM用戶創建角色」中的IAM說明進行操作。
-
(不建議) 將政策直接附加至使用者,或將使用者新增至使用者群組。請遵循《使用指南》中的「向使用者 (主控台) 新增權限」IAM 中的指示進行。
-
我的問題沒有在這裡列出。
聯絡AWS Marketplace 賣家營運