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 Serviço de análise de comércio
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 do 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 JSON-formatted documento no seu 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 JSON-formatted assíncrona
{ "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 JSON-formatted metadados é publicado no mesmo local do arquivo do 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 e o fim 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 JSON-formatted metadados.
{ "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 de conjuntos de dados disponíveis, inclusive datas de disponibilidade, consulte a Documentação do SDK da AWS.