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

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 for Java Die Daten, die Sie mithilfe der SDK Tools anfordern, werden Ihnen AWS-Konto als Datensätze zugestellt. 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 Ergebnissen im Zusammenhang mit Datensätzen, die vom Commerce Analytics Service generiert wurden.

GenerateDataSet parameters

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.

Name der Rolle ARN Die ARN Rolle mit einer angehängten Berechtigungsrichtlinie, die dem Dienst Zugriff auf Ihre Ressourcen gewährt.
Name des Amazon S3 S3-Ziel-Buckets Der Name (der benutzerfreundliche Name, nicht derARN) 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.

SNSThema ARN

Das ARN für das SNS Amazon-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, die sofort zurückgegeben wird, und die zweite ist asynchron, die über Amazon zurückgegeben wird. SNS 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 verwendet werden, um eine Anfrage mit Benachrichtigungen zum SNS Thema Amazon zu korrelieren.

Die asynchrone Antwort wird als JSON -formatiertes Dokument zu Ihrem SNS Amazon-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 verwendet werden, um eine Anfrage mit Benachrichtigungen zum SNS Thema Amazon 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 eine asynchrone 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 JSON im -Format 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 verwendet werden, um eine Anfrage mit Benachrichtigungen zum SNS Thema Amazon zu korrelieren.
Dataset-Gültigkeitsbereich Definiert den Beginn date/time and end date/time des Datenabdeckungsbereichs. Diese Daten haben das Format ISO 8601.
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 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 Dokumentation. AWS SDK