Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Génération d'un ensemble de données à l'aide du service AWS Marketplace Commerce Analytics
Une fois inscrit au service AWS Marketplace Commerce Analytics, vous pouvez accéder à vos rapports d'utilisation, d'abonnement et de facturation via le AWS CLI et AWS SDK for Java. Les données que vous demandez à l'aide SDK des outils vous sont fournies sous Compte AWS forme de jeux de données. La plupart des ensembles de données correspondent aux mêmes données que les rapports à base de texte disponibles sur Portail de gestion AWS Marketplace
GenerateDataSet paramètres
Le service AWS Marketplace Commerce Analytics propose une méthode que vous pouvez utiliser pour demander que des ensembles de données soient publiés dans votre compartiment Amazon S3. GenerateDataSet Le tableau suivant répertorie les paramètres pour GenerateDataSet.
| Champ | Description |
|---|---|
| Type d'ensemble de données | Cet ensemble de données est renvoyé comme résultat de la demande. |
| Date de publication de l'ensemble de données |
Date à laquelle un ensemble de données a été publié. Pour les ensembles de données quotidiens, indiquez une date avec un niveau de granularité jour pour le jour voulu. Pour les ensembles de données mensuels, indiquez une date avec un niveau de granularité mensuel pour le mois voulu. La valeur jour est ignorée. |
| Nom du rôle ARN | Le ARN rôle auquel est attachée une politique d'autorisation qui permet au service d'accéder à vos ressources. |
| Nom du compartiment Amazon S3 de destination | Le nom (le nom convivial, pas leARN) du compartiment Amazon S3 de destination. Vos ensembles de données sont publiés dans cet emplacement. |
| Préfixe Amazon S3 de destination |
(Facultatif) Le préfixe Amazon S3 pour le jeu de données publié, similaire à un chemin de répertoire dans les systèmes de fichiers standard. Par exemple, avec le nom de compartiment Si le préfixe de la structure de répertoires n'existe pas, il est créé automatiquement. Si aucun préfixe n'est fourni, l'ensemble de données est publié sur la racine du compartiment Amazon S3. |
| SNSRubrique ARN |
Le ARN SNS sujet correspondant à Amazon qui est notifié lorsque le jeu de données a été publié ou en cas d'erreur. |
Réponses
Le service AWS Marketplace Commerce Analytics renvoie deux réponses. Le premier est synchrone, qui est renvoyé immédiatement, et le second est asynchrone, qui est renvoyé via Amazon. SNS La réponse synchrone est similaire à cet exemple.
| Champ | Description |
|---|---|
| ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour corréler une demande avec des notifications sur le SNS sujet Amazon. |
La réponse asynchrone est publiée sous forme de document JSON formaté dans votre SNS rubrique Amazon et est similaire à cet exemple.
| Champ | Description |
|---|---|
| Emplacement S3 d'ensemble de données | Nom de compartiment et de clé pour l'ensemble de données diffusé. |
| Data Set Meta Data Emplacement S3 | Nom de compartiment et de clé pour le fichier de métadonnées de l'ensemble de données diffusé. |
| ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour corréler une demande avec des notifications sur le SNS sujet Amazon. |
| Réussite | « True » si l'opération a abouti, « false » dans le cas contraire. |
| Message | (Facultatif) Si une erreur s'est produite (par exemple, si « Success » a la valeur « false »), ce message contient des informations sur la défaillance. |
Exemple de JSON réponse asynchrone formatée
{ "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
Une fois la demande réussie, l'ensemble de données demandé est envoyé dans votre compartiment Amazon S3 sous forme de fichier .csv. Un fichier de métadonnées JSON au format -formaté est publié au même emplacement que le fichier du jeu de données. Le fichier de métadonnées fournit des informations utiles sur l'ensemble de données et les paramètres de la demande d'origine. Le fichier de métadonnées porte le même nom que le fichier de l'ensemble de données, mais se termine par l'extension . meta.json. Le tableau suivant répertorie les champs de métadonnées dans le fichier .csv.
| Champ | Description |
|---|---|
| ID de demande d'ensemble de données | Identifiant unique qui représente une demande spécifique au service. Cet identifiant peut être utilisé pour corréler une demande avec des notifications sur le SNS sujet Amazon. |
| Data Set Coverage Range | Définit le début date/time and end date/time de la plage de couverture des données. Ces dates sont au format ISO 8601. |
| Paramètres de demande d'ensemble de données | Paramètres de la demande d'origine à la méthode GenerateDataSet. |
| Emplacement S3 d'ensemble de données | Nom de compartiment et de clé pour l'ensemble de données diffusé. |
| Data Set Meta Data Emplacement S3 | Nom de compartiment et de clé pour le fichier de métadonnées de l'ensemble de données diffusé. |
Voici un exemple de contenu de métadonnées JSON formaté.
{ "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" } }
Pour obtenir la liste complète des ensembles de données disponibles, y compris les dates de disponibilité, consultez la AWSSDKdocumentation.
