GenerateDataSet-Parameter Antworten Outputs

Generieren eines Datensatzes mit dem AWS Marketplace Commerce-Analysedienst

Nachdem Sie sich für den AWS Marketplace Commerce Analytics Service registriert haben, können Sie über und auf Ihre Nutzungs-, Abonnement- und Abrechnungsberichte zugreifen. AWS CLI AWS SDK für Java Die Daten, die Sie mit den SDK-Tools anfordern, werden AWS-Konto als Datensätze an Ihre Daten übermittelt. Die meisten Datensets entsprechen den gleichen Daten, wie die textbasierten Berichte, die auf dem AWS Marketplace Management Portal verfügbar sind. Weitere Informationen finden Sie unter Zugriff auf Produkt- und Kundendaten mit dem AWS Marketplace Commerce-Analyseservice. Diese Abschnitte enthalten Informationen zu Parametern, Antworten und Ausgaben im Zusammenhang mit Datensätzen, die vom Commerce Analytics Service generiert wurden.

`GenerateDataSet`-Parameter

Der AWS Marketplace Commerce Analytics Service bietet eine MethodeGenerateDataSet, mit der Sie die Veröffentlichung von Datensätzen in Ihrem Amazon S3 S3-Bucket anfordern können. In der folgenden Tabelle sind die Parameter für GenerateDataSet aufgelistet.

Dataset-Parameter
Feld	Beschreibung
Dataset-Typ	Dieser Dataset wird als Ergebnis der Anforderung zurückgegeben.
Dataset-Veröffentlichungsdatum	Das Datum, an dem ein Dataset veröffentlicht wurde. Für tägliche Datasets geben Sie ein Datum mit Granularität auf Tagesebene für den gewünschten Tag an. Für monatliche Datensets geben Sie ein Datum mit Granularität auf Monatsebene für den gewünschten Monat an. Der Wert für den Tag wird ignoriert.
Rollennamen-ARN	Der ARN der Rolle mit einer angefügten Berechtigungsrichtlinie, die dem Service Zugriff auf Ihre Ressourcen gewährt.
Name des Amazon S3 S3-Ziel-Buckets	Der Name (der benutzerfreundliche Name, nicht der ARN) des Amazon S3-Ziel-Buckets. Ihre Datensets werden an diesem Speicherort veröffentlicht.
Amazon S3 S3-Zielpräfix	(Optional) Das Amazon S3 S3-Präfix für den veröffentlichten Datensatz, ähnlich einem Verzeichnispfad in Standarddateisystemen. Beispiel: Bei Wahl des Bucket-Namens `mybucket` und des Präfixes `myprefix/mydatasets` wird die Ausgabedatei in `s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile` veröffentlicht. Wenn die Präfix-Verzeichnisstruktur nicht vorhanden ist, wird sie erstellt. Wenn kein Präfix angegeben wird, wird der Datensatz im Amazon S3 S3-Bucket-Root veröffentlicht.
SNS-Thema-ARN	Der ARN für das Amazon SNS SNS-Thema, das benachrichtigt wird, wenn der Datensatz veröffentlicht wurde oder wenn ein Fehler auftritt.

Antworten

Der AWS Marketplace Commerce Analytics Service gibt zwei Antworten zurück. Die erste ist synchron, was sofort zurückgegeben wird, und die zweite ist asynchron, die über Amazon SNS zurückgegeben wird. Die synchrone Antwort ähnelt diesem Beispiel.

Dataset-Parameter
Feld	Beschreibung
Dataset-Anforderungs-ID	Eine eindeutige Kennung für eine bestimmte Anforderung des Services. Diese Kennung kann dazu dienen, eine Anforderung mit Benachrichtigungen über das Amazon SNS-Thema zu korrelieren.

Die asynchrone Antwort wird als JSON-formatted Dokument zu Ihrem Amazon SNS SNS-Thema veröffentlicht und ähnelt diesem Beispiel.

Dataset-Parameter
Feld	Beschreibung
S3-Speicherort des Dataset	Der Bucket-Name und Schlüssel für den gelieferten Dataset.
S3-Speicherort der Dataset-Metadaten	Der Bucket-Name und Schlüssel für den gelieferte Dataset-Metadatendatei.
Dataset-Anforderungs-ID	Eine eindeutige Kennung für eine bestimmte Anforderung des Services. Diese Kennung kann dazu dienen, eine Anforderung mit Benachrichtigungen über das Amazon SNS-Thema zu korrelieren.
Herzlichen Glückwunsch	True, wenn die Operation erfolgreich war, „false“, wenn dies nicht der Fall ist.
Fehlermeldung	(Optional) Wenn ein Fehler aufgetreten ist (d. h. „Success“ ist „false“), enthält diese Meldung Informationen über den Fehler.

Beispiel für JSON-formatted eine asynchrone Antwort



 {    
   "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

Nach einer erfolgreichen Anfrage wird der angeforderte Datensatz als CSV-Datei an Ihren Amazon S3 S3-Bucket übermittelt. Eine JSON-formatted Metadatendatei wird am selben Speicherort wie die Datensatzdatei veröffentlicht. Die Metadatendatei bietet nützliche Informationen über das Dataset und die ursprünglichen Anforderungsparameter. Die Metadatendatei hat den gleichen Namen wie das Dataset, aber mit der Erweiterung .meta.json. Die folgende Tabelle listet die Metadatenfelder in der CSV-Datei auf.

Metadaten-Felder
Feld	Beschreibung
Dataset-Anforderungs-ID	Eine eindeutige Kennung für eine bestimmte Anforderung des Services. Diese Kennung kann dazu dienen, eine Anforderung mit Benachrichtigungen über das Amazon SNS-Thema zu korrelieren.
Dataset-Gültigkeitsbereich	Definiert den Start date/time und das Ende date/time des Datenabdeckungsbereichs. Diese Daten befinden sich im ISO 8601-Format.
Dataset-Anforderungsparameter	Die ursprünglichen Anforderungsparameter für die `GenerateDataSet`-Methode.
S3-Speicherort des Dataset	Der Bucket-Name und Schlüssel für den gelieferten Dataset.
S3-Speicherort der Dataset-Metadaten	Der Bucket-Name und Schlüssel für den gelieferte Dataset-Metadatendatei.

Im Folgenden finden Sie ein Beispiel für den Inhalt von JSON-formatted Metadaten.



{
"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"
}
}

Eine vollständige Liste der verfügbaren Datensätze, einschließlich Verfügbarkeitsdaten, finden Sie in der AWS SDK-Dokumentation.

Dokumentkonventionen

AWS CLI und SDK for Java Java-Implementierung

Fehlerbehebung