Gerar um conjunto de dados usando o Serviço de análise de comércio do AWS Marketplace - AWS Marketplace

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á.

Gerar um conjunto de dados usando o Serviço de análise de comércio do AWS Marketplace

Depois de se cadastrar o Serviço de análise de comércio do AWS Marketplace, você poderá acessar seu uso, assinatura e relatórios de faturamento por meio do AWS CLI e AWS SDK for Java. Os dados que você solicita usando as ferramentas do SDK são entregues para sua 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. Para ter mais informações, consulte Acesse os dados de produtos e de cliente com o Serviço de análise de comércio do AWS Marketplace. Essas seções fornecem informações sobre parâmetros, respostas e saídas relacionadas aos conjuntos de dados gerados pelo Serviço de análise de comércio.

Parâmetros GenerateDataSet

O Serviço de análise de comércio do AWS Marketplace expõe um método, GenerateDataSet, que permite solicitar conjuntos de dados que serão publicados em seu bucket do Amazon S3. A tabela a seguir relaciona os parâmetros de GenerateDataSet.

Parâmetros do conjunto de dados
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 mybucket e o prefixo myprefix/mydatasets forem fornecidos, o arquivo de saída será publicado em s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile.

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 Serviço de análise de comércio do AWS Marketplace gera 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.

Parâmetros do conjunto de dados
Campo Descrição
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.

Parâmetros do conjunto de dados
Campo Descrição
Local do S3 do conjunto de dados O nome do bucket e a chave do conjunto de dados entregue.
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.
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 }

Outputs

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.

Campos de metadados
Campo Descrição
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 a data/hora de início e a data/hora de término do intervalo de cobertura dos 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.
Local do S3 do conjunto de dados O nome do bucket e a chave do conjunto de dados entregue.
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 ver uma lista completa dos conjuntos de dados disponíveis, incluindo datas de disponibilidade, consulte a Documentação do SDK da AWS.