기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS Marketplace Commerce Analytics Service를 사용하여 데이터 세트 생성
AWS Marketplace Commerce Analytics Service에 등록한 후 AWS CLI 및 를 통해 사용량, 구독 및 결제 보고서에 액세스할 수 있습니다 AWS SDK for Java. SDK 도구를 사용하여 요청하는 데이터는 데이터 세트 AWS 계정 로 에 전달됩니다. 대부분의 데이터 세트는 AWS Marketplace Management Portal
GenerateDataSet 파라미터
AWS Marketplace Commerce Analytics Service는 Amazon S3 버킷에 데이터 세트를 게시하도록 요청하는 데 사용할 수 있는 한 가지 메서드GenerateDataSet인 를 노출합니다. 다음 표는 GenerateDataSet에 대한 파라미터를 나열합니다.
| 필드 | 설명 |
|---|---|
| Data Set Type | 이 데이터 세트는 요청의 결과로 반환됩니다. |
| Data Set Publication Date |
데이터 세트가 게시된 날짜입니다. 일별 데이터 세트의 경우 원하는 날의 일 수준으로 세분화된 날짜를 입력합니다. 월별 데이터 세트의 경우 원하는 달의 월 수준으로 세분화된 날짜를 입력합니다. 일 값은 무시됩니다. |
| 역할 이름 ARN | 서비스에 리소스에 대한 액세스 권한을 제공하는 권한 정책이 연결된 역할ARN의 입니다. |
| Destination Amazon S3 Bucket Name | 대상 Amazon S3 버킷의 이름(가 아닌 표시 이름ARN)입니다. 데이터 세트가 이 위치에 게시됩니다. |
| Destination Amazon S3 Prefix |
(선택 사항) 게시된 데이터 세트의 Amazon S3 접두사이며 표준 파일 시스템의 디렉터리 경로와 유사합니다. 예를 들어 해당 버킷 이름이 접두사 구조 디렉터리가 존재하지 않으면 새로 생성됩니다. 접두사가 제공되지 않으면 데이터 세트가 Amazon S3 버킷 루트에 게시됩니다. |
| SNS 주제 ARN |
데이터 세트가 게시되거나 오류가 발생할 때 알림을 받는 ARN Amazon SNS 주제의 입니다. |
응답
AWS Marketplace Commerce Analytics Service는 두 개의 응답을 반환합니다. 첫 번째는 즉시 반환되는 동기식이고, 두 번째는 Amazon 를 사용하여 반환되는 비동기식입니다SNS. 동기식 응답은 다음 예제와 유사합니다.
| 필드 | 설명 |
|---|---|
| Data Set Request ID | 서비스에 대한 특정 요청을 나타내는 고유 식별자입니다. 이 식별자를 사용하여 Amazon SNS 주제에 대한 알림과 요청을 상호 연관시킬 수 있습니다. |
비동기 응답은 Amazon SNS 주제에 JSON형식이 지정된 문서로 게시되며 이 예제와 유사합니다.
| 필드 | 설명 |
|---|---|
| Data Set S3 Location | 전달된 데이터 세트의 버킷 이름 및 키입니다. |
| Data Set Meta Data S3 Location | 전달된 데이터 세트 메타데이터 파일의 버킷 이름 및 키입니다. |
| Data Set Request ID | 서비스에 대한 특정 요청을 나타내는 고유 식별자입니다. 이 식별자를 사용하여 Amazon SNS 주제에 대한 알림과 요청을 상호 연관시킬 수 있습니다. |
| Success | 작업이 성공하면 "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 | 데이터 적용 범위의 시작date/time and end date/time을 정의합니다. 이 날짜는 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 설명서를 참조하세요.
