As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Gerando um conjunto de dados usando o AWS Marketplace Commerce Analytics Service
Depois de se inscrever no AWS Marketplace Commerce Analytics Service, você pode acessar seus relatórios de uso, assinatura e cobrança por meio do e. AWS CLI AWS SDK para Java Os dados que você solicita usando as ferramentas do SDK são entregues a você Conta da AWS como conjuntos de dados. A maioria dos conjuntos de dados corresponde aos mesmos dados dos relatórios baseados em texto disponíveis no Portal de gerenciamento do AWS Marketplace
Parâmetros GenerateDataSet
O AWS Marketplace Commerce Analytics Service expõe um método,GenerateDataSet, que você pode usar para solicitar que conjuntos de dados sejam publicados em seu bucket Amazon S3. A tabela a seguir relaciona os parâmetros de GenerateDataSet.
| Campo | Descrição |
|---|---|
| Tipo do conjunto de dados | Esse conjunto de dados será retornado como resultado da solicitação. |
| Data da publicação do conjunto de dados |
A data em que um conjunto de dados foi publicado. Para conjuntos de dados diários, forneça uma data com granularidade em nível de dia para o dia desejado. Para conjuntos de dados mensais, forneça uma data com granularidade em nível de mês para o mês desejado. O valor day é ignorado. |
| ARN do nome da função | O ARN da função com uma política de permissões anexada que fornece ao serviço acesso a seus recursos. |
| Nome do bucket do Amazon S3 de destino | O nome (o nome amigável, não o ARN) do bucket do Amazon S3 de destino. Seus conjuntos de dados serão publicados nesse local. |
| Prefixo do Amazon S3 de destino |
(Opcional) O prefixo do Amazon S3 para o conjunto de dados publicado, semelhante a um caminho de diretório em sistemas de arquivos padrão. Por exemplo, se o nome do bucket Se a estrutura do diretório do prefixo não existir, ela será criada. Se nenhum prefixo for fornecido, o conjunto de dados será publicado na raiz do bucket do Amazon S3. |
| ARN do tópico do SNS |
O ARN do tópico do Amazon SNS que será notificado quando o conjunto de dados tiver sido publicado ou se ocorrer um erro. |
Respostas
O AWS Marketplace Commerce Analytics Service retorna duas respostas. A primeira é síncrona, que é gerada imediatamente, e a segunda é assíncrona, que é gerada usando o Amazon SNS. A resposta síncrona é semelhante a este exemplo.
| Campo | Descrição |
|---|---|
| Data Set Request ID (ID da solicitação do conjunto de dados) | Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações no tópico do Amazon SNS. |
A resposta assíncrona é publicada como um documento em formato JSON no tópico do Amazon SNS e é semelhante a este exemplo.
| Campo | Descrição |
|---|---|
| Data Set S3 Location (Local do S3 do conjunto de dados) | O nome do bucket e a chave do conjunto de dados entregue. |
| Data Set Meta Data S3 Location (Local do S3 dos metadados do conjunto de dados) | O nome do bucket e a chave do arquivo de metadados do conjunto de dados entregue. |
| Data Set Request ID (ID da solicitação do conjunto de dados) | Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações no tópico do Amazon SNS. |
| Bem-sucedida | "Verdadeiro" se a operação tiver sido bem-sucedida, caso contrário, "falso". |
| Mensagem | (Opcional) Se ocorrer um erro (por exemplo, "Sucesso" for "falso"), essa mensagem conterá informações sobre a falha. |
Exemplo de resposta assíncrona em 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 }
Saídas
Após uma solicitação bem-sucedida, o conjunto de dados solicitado será entregue para seu bucket do Amazon S3 como um arquivo .csv. Um arquivo de metadados em formato JSON será publicado no mesmo local do arquivo de conjunto de dados. O arquivo de metadados fornece informações úteis sobre o conjunto de dados e os parâmetros da solicitação original. O arquivo de metadados tem o mesmo nome que o conjunto de dados no arquivo, mas termina com a extensão .meta.json. A tabela a seguir relaciona os campos de metadados no arquivo .csv.
| Campo | Descrição |
|---|---|
| Data Set Request ID (ID da solicitação do conjunto de dados) | Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações no tópico do Amazon SNS. |
| Intervalo de cobertura do conjunto de dados | Define o início date/time and end date/time da faixa de cobertura de dados. Essas datas estão no formato ISO 8601. |
| Parâmetros da solicitação do conjunto de dados | Os parâmetros de solicitação originais do método GenerateDataSet. |
| Data Set S3 Location (Local do S3 do conjunto de dados) | O nome do bucket e a chave do conjunto de dados entregue. |
| Data Set Meta Data S3 Location (Local do S3 dos metadados do conjunto de dados) | O nome do bucket e a chave do arquivo de metadados do conjunto de dados entregue. |
Veja a seguir um exemplo de conteúdo de metadados em 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" } }
Para obter uma lista completa dos conjuntos de dados disponíveis, incluindo as datas de disponibilidade, consulte a documentação do AWS SDK.
