Generieren eines Datensatzes mithilfe des AWS Marketplace Commerce Analytics Service - AWS Marketplace
GenerateDataSet-ParameterAntwortenOutputs

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Generieren eines Datensatzes mithilfe des AWS Marketplace Commerce Analytics Service

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 Analytics Service. 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 Dokument im JSON-Format 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 einer asynchronen Antwort im JSON-Format 


 {    
   "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 Metadatendatei im JSON-Format wird im selben Verzeichnis wie die Datenset-Datei 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 and end date/time für den Datenabdeckungsbereich. 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.

Es folgt ein Beispiel für in JSON formatierte Metadateninhalte. 


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