利用規約オンボーディングガイド技術的な実装ガイド技術ドキュメントトラブルシューティング

AWS Marketplace コマース分析サービス

AWS Marketplace Commerce Analytics Service を使用すると、を通じて製品と顧客データにプログラムでアクセスできます AWS Marketplace。サービスに登録すると、 AWS SDK から使用状況、サブスクリプション、請求レポートにアクセスできます。

Commerce Analytics Service Overview.

SDK ツールを使用してリクエストしたデータは、データセット AWS アカウントとしてに配信されます。ほとんどのデータセットは、AWS Marketplace 管理ポータルで利用可能なテキストベースのレポートと同じデータに対応します。特定の日付のデータセットをリクエストできます。データは指定先の Amazon S3 バケットに配信されます。データ配信の通知は、Amazon Simple Notiﬁcation Service (Amazon SNS) によって提供されます。

利用規約

これらの AWS Marketplace Commerce Analytics Service 利用規約 (以下「CAS 条件」) には、 AWS Marketplace Commerce Analytics Service (「CA Service」) の使用とアクセスに固有の条件が含まれており、これらの CAS 条件に表示された「I Accept」ボタンまたはチェックボックスをクリックした日付、または以前に CA サービスサービスサービスを使用する日付に有効になります。本 CAS 条件は、お客様と Amazon Web Services, Inc の間の AWS Marketplace 販売者向け利用規約 (AWS Marketplace 「販売者条件」) の補足です。（「AWS」、「we」、「us」、または「our」）、その条件はここに組み込まれます。これらの CAS 規約と AWS Marketplace 販売者規約の間に競合が発生した場合は、当該の競合の範囲内で、およびお客様の CA サービスの使用に関してのみ、これらの CAS 規約が適用されます。大文字で表記された用語は、本書で使用されているが、本書で定義されていない用語は、 AWS Marketplace 販売者条件に規定された意味を持つものとします。

CA サービスおよび CAS データ。CA サービスへのアクセス資格を得るには、既存の AWS Marketplace 販売者条件に拘束されている AWS Marketplace 販売者である必要があります。CA サービス (「CAS Data」) に関連して受け取った、またはアクセスできる情報およびデータは、サブスクライバー情報であり、 AWS Marketplace 販売者条件に規定された制限および義務の対象となります。(a) CAS データを第三者に開示しないことを条件として、CAS データを機密ベースで使用して、お客様の AWS Marketplace コンテンツに関連するマーケティングやその他のプロモーション活動を改善およびターゲットにすることができます。 (b) CAS データを、適用されるプライバシーポリシーまたは法律と矛盾する形で使用すること。 (c) サブスクライバーに連絡して、の外部で代替購入を行うよう影響を与える AWS Marketplace。 (d) わたしたちを誹謗中傷する関連会社またはそれらもしくは当社のそれぞれの製品。または (e) 目的の受信者が AWS Marketplace サブスクライバーであることに基づいて、あらゆる種類のターゲット通信。
CA サービスの制限とセキュリティ。CA サービスドキュメントに記載されている方法によってのみ、CA サービスにアクセスします (またはアクセスを試みます)。CA サービスを使用中に自身のアイデンティティまたは顧客のアイデンティティを偽ったり、隠したりしてはなりません。いずれかの期間において CA サービスへのアクセスを許可された接続、通話、またはサーバーの数に関して、これを含みますが限定されず、CA サービスに使用を設定または制限する権利を単独裁量にて保有します。当該の制限に同意し、迂回することを回避しようとしません。これらの CAS 規約に違反している、または CA サービスを悪用していると確信した場合、CA サービスにアクセスする権利を制限、停止または終了する権利を保有します。
CA サービス認証情報の機密性とセキュリティ。CA サービス認証情報 (パスワード、キー、およびクライアント ID など) は、お客様が API クライアントを識別するために使用されることが目的です。認証情報を秘匿する全責任はお客様が負い、少なくとも同様の性質の機密情報を保護するために取る措置を含め、当該認証情報の開示、流布、または不正使用を避けるための合理的な措置を取ります。CA サービス認証情報をオープンソースプロジェクトに埋め込むことはできません。お客様の認証情報での CA サービスへのあらゆるアクセスの全責任はお客様が負います。
変更。AWS は、AWS サイトに改訂されたバージョンを投稿するか、 AWS Marketplace 販売者規約に従ってお客様に通知することで、いつでも本 CAS 規約を変更できます。変更された規約は、掲載時に、または、E メールによって通知した場合、E メールメッセージに記載されているとおりに、発行します。これらの CAS 規約への変更の発行日後に CA サービスの使用またはアクセスを継続することで、変更された規約に縛られることに同意したものと見なされます。
ターミネーション。これらの CAS 規約およびここに付与される CAS データを使用する権限は、あらゆる理由による AWS Marketplace 販売者規約の終了により、通知の有無に関わらず、終了します。さらに、あらゆるときにあらゆる理由で CA サービスの提供を停止するか、CA サービスへのアクセスを終了する場合があります。

オンボーディングガイド

AWS Marketplace Commerce Analytics Service AWS のサービスを使用するには、 AWS アカウントとを設定する必要があります。

AWS Marketplace Commerce Analytics Service を使用するには

アクセス許可 AWS アカウントを使用してをセットアップする.
送信先の Amazon S3 バケットを作成する.
レスポンス通知用の Amazon SNS トピックを設定する.
Commerce Analytics Service プログラムに登録する.
設定を確認する.

アクセス許可 AWS アカウントを使用してをセットアップする

では、ルートアカウントの認証情報を使用するの AWS Marketplace 管理ポータルではなく、 AWS Identity and Access Management (IAM) ロールを使用してにサインインすることをAWS Marketplace 強くお勧めします。 AWS Marketplace Commerce Analytics Service のアクセス許可の、特定の IAM のアクセス許可については、「AWS Marketplace 販売者のポリシーとアクセス許可」を参照してください。お客様のアカウントにアクセスする人に対して個別ユーザーを作成することにより、ユーザーそれぞれに一意の認証情報を設定することができます。さらに、各ユーザーにそれぞれ異なるアクセス権限を付与することもできます。必要な場合には、いつでもユーザーのアクセス許可を変更、または無効にすることができます。

送信先の Amazon S3 バケットを作成する

Commerce Analytics Service により、リクエストしたデータが、指定した Amazon S3 バケットに配信されます。既に Amazon S3 バケットをお持ちで使用できる場合は、次のステップに進みます。

Amazon S3 バケットがない場合、このデータ専用の Amazon S3 バケットを作成する場合は、「S3 バケットを作成する方法」を参照してください。

Commerce Analytics Service は、Amazon SNS を使用してレスポンス通知を配信します。このサービスでは、データセットが利用可能になったり、エラーが発生したりしたときに、このトピックにメッセージを発行して通知します。既にこの目的で Amazon SNS トピックをお持ちの場合は、次のステップに進みます。

このサービスに対して Amazon SNS トピックを設定していない場合は、この時点で設定します。手順については、「トピックの作成」を参照してください。

作成したトピックの Amazon リソースネーム (ARN) をメモしておきます。サービスを呼び出すときに ARN が必要になります。

Commerce Analytics Service プログラムに登録する

トピックの ARN およびバケットの名前を使用してサービスを設定すると、Commerce Analytics Service は Amazon S3 バケットと Amazon SNS トピックにアクセスします。

そのアクセスを有効にするには

AWS Marketplace 製品の管理 AWS アカウントに使用する AWS Marketplace 管理ポータルを使用してにログインします。
AWS Marketplace Commerce Analytics Service に登録するために必要な IAM 権限があることを確認してください。
Commerce Analytics Service 登録ページに移動します。
Amazon S3 バケット名および Amazon SNS トピック ARN を入力し、[登録] を選択します。
[permissions (権限)] ページの [Allow (許可)] を選択します。
で AWS Marketplace 管理ポータル、成功メッセージにロール名 ARN を記録します。サービスを呼び出すには ARN が必要です。

注記

Commerce Analytics Service へのオンボーディングにより、に IAM ロールが作成されます AWS アカウント。IAM ロールは、 AWS Marketplace が Amazon S3 バケットに書き込み、Amazon SNS トピックに通知を発行できるようにします。 AWS Marketplace はアカウント 452565589796 を使用して、この IAM ロールでこれらの関連アクションを実行します。

設定を確認する

最後のステップは、設定が正常に動作しているかどうかを確認することです。

設定をテストするには

AWS Command Line Interface (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 "{YOUR-S3-BUCKET}" \
--destination-s3-prefix "test-prefix" \
--sns-topic-arn "{YOUR-SNS-TOPIC-ARN}"

--data-set-publication-date で、{TODAY'S DATE} を ISO-8601 形式を使用して現在の日付 YYYY-MM-DDT00:00:00Z に置き換えます。YYYY は 4 桁の年、MM は 2 桁の月、DD は 2 桁の日を表します。
--role-name-arn で、{YOUR-ROLE-NAME-ARN} を Commerce Analytics Service プログラムに登録するの登録プロセスで取得したロールの ARN に置き換えます。
--destination-s3-bucket-name では、{YOUR-S3-BUCKET} を、送信先の Amazon S3 バケットを作成するで作成した Amazon S3 バケットに置き換えてください。
--sns-topic-arn では、{YOUR-SNS-TOPIC-ARN} を、レスポンス通知用の Amazon SNS トピックを設定するで作成した Amazon SNS トピックに置き換えます。

サービスからデータ SetRequestID レスポンスを含むレスポンスを受け取った場合は、オンボーディングプロセスが完了しました。正常な応答は次のようになります。



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

技術的な実装ガイド

AWS Marketplace Commerce Analytics Service は AWS SDK を通じて提供されます。このガイドでは、AWS CLI および AWS SDK for Java を使用してサービスを操作する方法を説明します。

Commerce Analytics Service の IAM ポリシー

ユーザーが Commerce Analytics Service を使用できるようにするには、以下の権限が必要です。

AWS Marketplace Commerce Analytics Service に登録するには、次の IAM アクセス許可ポリシーを使用します。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:ListRoles",
                "iam:CreateRole",
                "iam:CreatePolicy",
                "iam:AttachRolePolicy",
                "aws-marketplace-management:viewReports"
            ],
            "Resource": "*"
        }
    ]
}

以下の IAM アクセス許可ポリシーを使用して、ユーザーが AWS Marketplace Commerce Analytics Service にリクエストを送信できるようにします。


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

詳細については、「IAM ユーザーガイド」の「IAM コンソールでのポリシーの作成」を参照してください。

を使用したリクエストの実行 AWS CLI

開始するには、AWS CLIをダウンロードします。次の AWS CLI 例では、2017 年 10 月 1 日の時間単位/月単位のサブスクリプションデータセットをリクエストします。このデータセットはプレフィックス demo-prefix を使用して Amazon S3 バケット demo-bucket に発行され、通知メッセージは Amazon SNS トピック demo-topic に配信されます。



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によるリクエストの作成

開始するには、AWS Java SDK をダウンロードします。次の AWS SDK for Java 例では、2015 年 10 月 1 日の時間単位/月単位のサブスクリプションデータセットをリクエストします。このデータセットはプレフィックス demo-prefix を使用して Amazon S3 バケット demo-bucket に発行され、通知メッセージは Amazon SNS トピック demo-topic に配信されます。



/*
* 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

技術ドキュメント

このサービスでは、1 つのメソッド GenerateDataSet が公開されます。このメソッドを使用すると、Amazon S3 バケットに発行するデータセットをリクエストできます。次の表に GenerateDataSet のパラメータの一覧を示します。

データセットのパラメータ
フィールド	説明
Data Set Type	このデータセットはリクエストの結果として返されます。
Data Set Publication Date	データセットの発行日。日別データセットでは、該当日の日付が日単位の粒度で提供されます。月別データセットでは、該当月の日付が月単位の粒度で提供されます。日付の値は無視されます。
Role Name ARN	ロールの ARN の後に、リソースへのアクセス権を持つサービスを提供するアクセス権限ポリシーが続いています。
Destination Amazon S3 Bucket Name	送信先 Amazon S3 バケットの名前 (ARN ではなくフレンドリ名)。データセットはこの場所に発行されます。
Destination Amazon S3 Prefix	(オプション) データセットの発行先である Amazon S3 のプレフィックス。標準ファイルシステムのディレクトリパスに似ています。たとえば、バケットの名前が `mybucket` であり、プレフィックスが `myprefix/mydatasets` の場合、出力ファイルは `s3://DOC-EXAMPLE-BUCKET/myprefix/mydatasets/outputfile` に発行されます。プレフィックスのディレクトリ構造が存在しない場合は作成されます。プレフィックスを指定しないと、データセットの発行先は Amazon S3 バケットのルートになります。
SNS トピックの ARN	データセットの発行時またはエラーの発生時に通知先となる Amazon SNS トピックの ARN。

レスポンス

AWS Marketplace Commerce Analytics Service は 2 つのレスポンスを返します。1 つ目は同期で即座に返され、2 つ目は非同期でこれは Amazon SNS を使用して返されます。同期のレスポンスは次の例のようになります。

データセットパラメータ
フィールド	説明
Data Set Request ID	サービスに対する特定のリクエストを表す一意の識別子。この識別子を使用して、リクエストを Amazon SNS トピックへの通知と関連付けることができます。

非同期レスポンスが JSON 形式のドキュメントとして Amazon SNS トピックに書き込まれ、次の例のようになります。

データセットのパラメータ
フィールド	説明
Data Set S3 Location	配信されたデータセットのバケット名とキー。
Data Set Meta Data S3 Location	配信されたデータセットのメタデータファイルのバケット名とキー。
Data Set Request ID	サービスに対する特定のリクエストを表す一意の識別子。この識別子を使用して、リクエストを Amazon SNS トピックへの通知と関連付けることができます。
成功	オペレーションが成功した場合は「true」、それ以外の場合は「false」。
メッセージ	(オプション) エラーが発生した場合 (「Success」が「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 ファイルのメタデータフィールドの一覧です。

メタデータフィールド
フィールド	説明
Data Set Request ID	サービスに対する特定のリクエストを表す一意の識別子。この識別子を使用して、リクエストを Amazon SNS トピックへの通知と関連付けることができます。
Data Set Coverage Range	データ範囲の開始日時と終了日時を定義します。これらの日時は ISO 8601 形式です。
Data Set Request Parameters	`GenerateDataSet` メソッドへの元のリクエストパラメータ。
Data Set S3 Location	配信されたデータセットのバケット名とキー。
Data Set Meta Data S3 Location	配信されたデータセットのメタデータファイルのバケット名とキー。

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 SDK ドキュメントを参照してください。

トラブルシューティング

このセクションでは、 AWS Marketplace Commerce Analytics Service の使用に伴って発生する可能性のある問題の解決策について説明します。

許可リストの問題のため、サービスにアクセスできません。

で販売者としてまだ登録されていない場合は AWS Marketplace、 AWS Marketplace 管理ポータルにアクセスして登録してください。で販売者として登録済みの場合は AWS Marketplace、AWS Marketplace 販売者オペレーションチームにお問い合わせください。

過去の日付のデータセットをリクエストできません。ただし、SDK ドキュメントでは、この日付のデータが利用可能となっています。

過去の特定の日付に関するデータセットが利用可能であると記載されていても、利用できるのは AWS Marketplaceに参加した時点以降のデータのみです。エラーが発生したと思われる場合は、AWS Marketplace Seller Operations チームまでお問い合わせください。

このサービスを呼び出すと、「Could not connect to the endpoint URL: https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/」というエラーメッセージが表示されます。

AWS Marketplace Commerce Analytics Service は、米国東部 (バージニア北部) リージョンでのみ利用できます。Commerce Analytics Service へのすべての呼び出しは us-east-1 エンドポイントに対して行う必要があります。

を使用している場合は AWS CLI、次の例に示すように、「」フラグを各呼び出しに追加--regionしus-east-1、を AWS リージョンとして指定します。



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 Commerce Analytics Service に登録するときに、Amazon S3 バケットと Amazon SNS トピックを指定しました。オンボーディングプロセスでは、サービスがこれらの特定のリソースにのみアクセスできるように IAM 権限を設定します。別のリソースを使用するには、IAM ポリシーを変更する必要があります。

にサインイン AWS Management Console し、https://console.aws.amazon.com/iam/ で IAM コンソールを開きます。
IAM コンソールの左側にある [ロール] を選択します。
を選択しますMarketplaceCommerceAnalyticsRole。
[Inline Roles (インラインロール)] セクションが展開されていない場合は展開します。
oneClick_MarketplaceCommerceAnalyticsRole で始まる名前のポリシーを探し、[Edit Policy] を選択します。
そのポリシードキュメントで、変更するサービスに関連するアクションが指定されているセクションを見つけます。例えば、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 し、https://console.aws.amazon.com/iam/ で IAM コンソールを開きます。
左側のナビゲーションペインで、[ポリシー] を選択します。

初めて [ポリシー] を選択する場合には、[管理ポリシーにようこそ] ページが表示されます。[今すぐ始める] を選択します。
ページの上部で、[ポリシーを作成] を選択します。
[ポリシーエディタ] セクションで、[JSON] オプションを選択します。

次の JSON ポリシードキュメントを入力します。


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

[次へ] をクリックします。

注記
いつでも [Visual] と [JSON] エディタオプションを切り替えることができます。ただし、[Visual] エディタで [次] に変更または選択した場合、IAM はポリシーを再構成して visual エディタに合わせて最適化することがあります。詳細については、「IAM ユーザーガイド」の「ポリシーの再構成」を参照してください。
[確認と作成] ページで、作成するポリシーの [ポリシー名] と [説明] (オプション) を入力します。[このポリシーで定義されているアクセス許可] を確認して、ポリシーによって付与されたアクセス許可を確認します。
[ポリシーの作成] をクリックして、新しいポリシーを保存します。

アクセス権限を付与するには、ユーザー、グループ、またはロールにアクセス許可を追加します。

のユーザーとグループ AWS IAM Identity Center：

アクセス許可セットを作成します。「AWS IAM Identity Center ユーザーガイド」の「権限設定を作成する」の手順に従ってください。
IAM 内で、ID プロバイダーによって管理されているユーザー:

ID フェデレーションのロールを作成します。詳細については、「IAM ユーザーガイド」の「サードパーティー ID プロバイダー (フェデレーション) 用のロールの作成」を参照してください。
IAM ユーザー:
- ユーザーが担当できるロールを作成します。手順については、「IAM ユーザーガイド」の「IAM ユーザー用ロールの作成」を参照してください。
- (お奨めできない方法) ポリシーをユーザーに直接アタッチするか、ユーザーをユーザーグループに追加する。詳細については、「IAM ユーザーガイド」の「ユーザー (コンソール) へのアクセス権限の追加」を参照してください。

ここに記載されていない問題。

AWS Marketplace Seller Operations チームまでお問い合わせください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

販売者ツールキット

AWS Marketplace フィールドデモンストレーションプログラム