Generazione di un set di dati utilizzando il servizio Marketplace AWS Commerce Analytics - Marketplace AWS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Generazione di un set di dati utilizzando il servizio Marketplace AWS Commerce Analytics

Dopo esserti registrato al servizio Marketplace AWS Commerce Analytics, puoi accedere ai report di utilizzo, abbonamento e fatturazione tramite e. AWS CLI AWS SDK per Java I dati richiesti utilizzando gli strumenti SDK vengono forniti ai set di dati Account AWS As. La maggior parte dei set di dati corrisponde agli stessi dati dei report testuali disponibili su. Portale di gestione Marketplace AWS Per ulteriori informazioni, consulta Accesso ai dati dei prodotti e dei clienti con il servizio Marketplace AWS Commerce Analytics. Queste sezioni forniscono informazioni su parametri, risposte e output relativi ai set di dati generati dal Commerce Analytics Service.

Parametri GenerateDataSet

Il servizio Marketplace AWS Commerce Analytics offre un metodo che puoi utilizzare per richiedere la pubblicazione di set di dati nel tuo bucket Amazon S3. GenerateDataSet La tabella seguente elenca i parametri per. GenerateDataSet

Parametri del set di dati
Campo Descrizione
Tipo di set di dati Questo set di dati verrà restituito come risultato della richiesta.
Data di pubblicazione del set di dati

Data di pubblicazione di un set di dati.

Per i set di dati giornalieri, fornisci una data con granularità a livello di giorno per il giorno desiderato.

Per i set di dati mensili, fornisci una data con granularità a livello di mese per il mese desiderato. Il valore del giorno viene ignorato.

Nome del ruolo ARN L'ARN del ruolo con una politica di autorizzazioni allegata che fornisce al servizio l'accesso alle tue risorse.
Nome del bucket Amazon S3 di destinazione Il nome (il nome descrittivo, non l'ARN) del bucket Amazon S3 di destinazione. I tuoi set di dati vengono pubblicati in questa posizione.
Prefisso Amazon S3 di destinazione

(Facoltativo) Il prefisso Amazon S3 per il set di dati pubblicato, simile a un percorso di directory nei file system standard.

Ad esempio, se vengono forniti il nome del bucket mybucket e il prefissomyprefix/mydatasets, il file di output viene pubblicato su. s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile

Se la struttura della directory del prefisso non esiste, viene creata.

Se non viene fornito alcun prefisso, il set di dati viene pubblicato nella radice del bucket Amazon S3.

SNS Topic ARN (ARN argomento SNS)

L'ARN per l'argomento Amazon SNS che viene notificato quando il set di dati è stato pubblicato o se si verifica un errore.

Risposte

Il servizio Marketplace AWS Commerce Analytics restituisce due risposte. Il primo è sincrono, che viene restituito immediatamente, mentre il secondo è asincrono, che viene restituito utilizzando Amazon SNS. La risposta sincrona è simile a questo esempio.

Parametri del set di dati
Campo Descrizione
ID della richiesta del set di dati Un identificatore univoco che rappresenta una richiesta specifica al servizio. Questo identificatore può essere utilizzato per correlare una richiesta con le notifiche sull'argomento Amazon SNS.

La risposta asincrona viene pubblicata come documento in formato JSON nell'argomento Amazon SNS ed è simile a questo esempio.

Parametri del set di dati
Campo Descrizione
Posizione del set di dati S3 Il nome e la chiave del bucket per il set di dati fornito.
Posizione del set di dati Meta Data S3 Il nome e la chiave del bucket per il file di metadati del set di dati fornito.
ID della richiesta del set di dati Un identificatore univoco che rappresenta una richiesta specifica al servizio. Questo identificatore può essere utilizzato per correlare una richiesta con le notifiche sull'argomento Amazon SNS.
Riuscito «Vero» se l'operazione è riuscita; «falso» in caso contrario.
Messaggio (Facoltativo) Se si è verificato un errore (ad esempio, «Success» è «falso»), questo messaggio contiene informazioni sull'errore.

Esempio di risposta asincrona in formato 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 }

Output

Dopo una richiesta riuscita, il set di dati richiesto viene inviato al tuo bucket Amazon S3 come file.csv. Un file di metadati in formato JSON viene pubblicato nella stessa posizione del file del set di dati. Il file di metadati fornisce informazioni utili sul set di dati e sui parametri della richiesta originale. Il file di metadati ha lo stesso nome del file del set di dati, ma termina con l'estensione .meta.json. La tabella seguente elenca i campi di metadati nel file.csv.

Campi di metadati
Campo Descrizione
ID della richiesta del set di dati Un identificatore univoco che rappresenta una richiesta specifica al servizio. Questo identificatore può essere utilizzato per correlare una richiesta con le notifiche sull'argomento Amazon SNS.
Intervallo di copertura del set di dati Definisce l'inizio date/time and end date/time dell'intervallo di copertura dei dati. Queste date sono in formato ISO 8601.
Parametri di richiesta del set di dati I parametri di richiesta originali del GenerateDataSet metodo.
Posizione del set di dati S3 Il nome e la chiave del bucket per il set di dati fornito.
Posizione del set di dati Meta Data S3 Il nome e la chiave del bucket per il file di metadati del set di dati fornito.

Di seguito è riportato un esempio di contenuto di metadati in formato 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" } }

Per un elenco completo dei set di dati disponibili, comprese le date di disponibilità, consulta la documentazione SDK.AWS