Terms and conditions Guía de incorporación Guía de implementación técnica Documentación técnica Solución de problemas

Servicio de análisis de comercio de AWS Marketplace

El servicio de análisis de comercio de AWS Marketplace le permite acceder mediante programación a datos del producto y del cliente a través de AWS Marketplace. Una vez que se inscriba en el servicio, puede acceder a su uso, suscripción e informes de facturación a través del SDK de AWS.

Commerce Analytics Service Overview.

Los datos que solicite con las herramientas de SDK se entregan a su Cuenta de AWS como conjuntos de datos. La mayoría de los conjuntos de datos corresponden a los mismos datos que los informes basados en texto disponibles en el AWS Marketplace Management Portal. Puede solicitar conjuntos de datos para una fecha específica y los datos se entregan al bucket de Amazon S3 proporcionado. Amazon Simple Notification Service (Amazon SNS) se encarga de proporcionar la notificación de entrega de datos.

Terms and conditions

Estos términos y condiciones de los servicios de análisis de comercio de AWS Marketplace (estos "Términos de CAS") contienen los términos y condiciones específicos de su uso del servicio de análisis de comercio de AWS Marketplace ("Servicio de CA") y son efectivos a partir de la fecha en la que haga clic en el botón o la casilla "Acepto" que se presenta con estos Términos de CAS o anteriormente, al utilizar cualquier oferta del servicio de CA. Estos Términos de CAS son una adición a los Términos y condiciones para vendedores de AWS Marketplace ("Términos para vendedores de AWS Marketplace") existentes entre usted y Amazon Web Services, Inc. ("AWS", "nosotros", "nos" o "nuestro”), cuyos términos quedan incorporados al presente documento. En el caso de que se produzca un conflicto entre estos Términos de CAS y los Términos del vendedor de AWS Marketplace, se aplicarán los Términos de CAS, aunque solo en la medida de este tipo de conflicto y únicamente con respecto a su uso del Servicio de CA. Los términos en mayúsculas utilizados en el presente documento pero que no se hayan definido específicamente en el presente documento tendrán el significado que se indique en los Términos del vendedor de AWS Marketplace.

Servicios de CA y Datos de CAS. Para poder optar a obtener acceso al Servicio de CA debe ser un Vendedor de AWS Marketplace vinculado por unos Términos del vendedor de AWS Marketplace en vigor. La información y los datos que reciba o a los que tenga acceso en relación con el Servicio de CA ("Datos de CAS") constituyen la información del suscriptor y están sujetos a las restricciones y las obligaciones establecidas en los Términos del vendedor de AWS Marketplace. Puede utilizar los Datos de CAS de forma confidencial para mejorar y establecer actividades de marketing o promocionales relacionadas con su Contenido de AWS Marketplace, siempre y cuando no (a) revele los Datos de CAS a ningún tercero; (b) utilice cualquier Dato de CAS de cualquier forma que no cumpla con las políticas o la ley de privacidad aplicables; (c) se ponga en contacto con un suscriptor para influir en él para realizar una compra alternativa fuera de AWS Marketplace; (d) nos desacredite a nosotros ni a nuestras filiales ni a cualquiera de nuestros respectivos productos o (e) dirija comunicaciones de ningún tipo basándose en que el destinatario es suscriptor de AWS Marketplace.
Limitaciones del Servicio y seguridad de CA. Solo obtendrá acceso (o intentará obtener acceso) al Servicio de CA por los medios descritos en la documentación del Servicio de CA. No distorsionará ni enmascarará su identidad o la de sus clientes al usar el Servicio de CA. Nos reservamos el derecho, bajo nuestra única discreción, a establecer y aplicar límites a su uso del Servicio de CA, incluido a título meramente enunciativo, con respecto al número de conexiones, las llamadas y servidores que tienen permiso de acceso al servicio de CA durante cualquier periodo de tiempo. Usted manifiesta su acuerdo y que no intentará eludir dichas limitaciones. Nos reservamos el derecho a restringir, suspender o terminar su derecho de acceso al Servicio de CA si creemos que es posible que haya violado estos Términos de CAS o que está usando de un modo indebido el Servicio de CA.
Confidencialidad y seguridad de las credenciales del Servicio de CA. Las credenciales del Servicio de CA (como contraseñas, claves e ID de cliente) están pensadas para que usted las utilice para identificar el cliente de API. Usted es el único responsable de mantener la confidencialidad de sus credenciales y se compromete a tomar todas las medidas razonables necesarias para evitar la divulgación, difusión o uso no autorizado de dichas credenciales, tales como, a título no exhaustivo, las medidas que adopte para proteger su propia información confidencial de una naturaleza similar. Es posible que las credenciales del Servicio de CA no estén integradas en proyectos de código abierto. Usted es el único responsable de todos los accesos al Servicio de CA que se produzcan con sus credenciales.
Modificación. Podemos modificar estos Términos de CAS en cualquier momento publicando una versión revisada en el Sitio de AWS dándole aviso tal y como se indica en los Términos del vendedor de AWS Marketplace. Los términos modificados entrarán en vigor al realizar la publicación o si se lo notificamos por correo electrónico, tal y como se indica en el mensaje de correo electrónico. Si continúa usando el Servicio de CA u obteniendo acceso a este a partir de la fecha en que entre en vigor cualquier modificación de los Términos de CAS, usted manifiesta que acepta regirse por los términos modificados.
Resolución. Estos Términos de CAS y los derechos a usar los Datos de CAS concedidos en el presente documento terminarán con o sin aviso previo al concluir por cualquier motivo sus Términos de vendedor de AWS Marketplace. Además, tenemos la potestad para detener el suministro de los Servicios de CA o terminar su acceso a dichos Servicios en cualquier momento, con o sin motivo.

Guía de incorporación

Debe configurar la cuenta de Cuenta de AWS y Servicios de AWS para utilizar el servicio de análisis de comercio de AWS Marketplace.

Inscripción en el servicio de análisis de comercio de AWS Marketplace

Configuración del Cuenta de AWS con permisos.
Creación del bucket de Amazon S3 de destino.
Configuración de un tema de Amazon SNS para las notificaciones de respuesta.
Inscripción en el programa del servicio de análisis de comercio.
Verificación de la configuración.

Configuración del Cuenta de AWS con permisos

AWS Marketplace recomienda encarecidamente usar roles (de IAM) de AWS Identity and Access Management para iniciar sesión en AWS Marketplace Management Portal en vez de usar las credenciales de su cuenta raíz. Consulte Políticas y permisos para vendedores de AWS Marketplace para ver los permisos específicos de AIM para el servicio de análisis de comercio de AWS Marketplace. Si crea un usuario de para cada persona que tiene acceso a la cuenta, puede asignar a cada usuario de un conjunto único de credenciales de seguridad. También puede conceder permisos distintos a cada usuario de . Si fuera necesario, puede cambiar o revocar permisos de usuario de en cualquier momento

Creación del bucket de Amazon S3 de destino

El servicio de análisis de comercio envía los datos solicitados al bucket de Amazon S3 que especifique. Si ya tiene un bucket de Amazon S3 que utilizar, vaya al siguiente paso.

Si no tiene un bucket de Amazon S3 o si desea crear un bucket de Amazon S3 específicamente para estos datos, puede encontrar instrucciones en ¿Cómo puedo crear un bucket de S3?

El servicio de análisis de comercio entrega notificaciones de respuesta mediante Amazon SNS. El servicio publica los mensajes en este tema para notificarle cuando haya conjuntos de datos disponibles o si se ha producido un error. Si ya tiene un tema de Amazon SNS para este fin, vaya al siguiente paso.

Si no ha configurado un tema de Amazon SNS para este servicio, hágalo ahora. Para obtener instrucciones, consulte Creación de un tema.

Anote el tema Amazon Resource Name (ARN) correspondiente al tema que ha creado, porque ARN lo necesitará para llamar al servicio.

Inscripción en el programa del servicio de análisis de comercio

El servicio de análisis de comercio accede al bucket de Amazon S3 y al tema de Amazon SNS después de configurar el servicio con el ARN del tema y el nombre del bucket.

Para habilitar el acceso

Inicie sesión en AWS Marketplace Management Portal con la Cuenta de AWS que utiliza para administrar los productos del servicio de análisis de comercio de AWS Marketplace.
Asegúrese de tener los permisos de IAM necesarios para inscribirse en el servicio de análisis de comercio de AWS Marketplace.
Vaya a la página de inscripción del servicio de análisis de comercio.
Escriba el nombre de bucket de Amazon S3 y el ARN del tema de Amazon SNS y, a continuación, elija Inscribirse.
En la página de permisos, elija Allow (Permitir).
En el AWS Marketplace Management Portal, registre el Role Name ARN (ARN de nombre de función) en el mensaje de confirmación. Necesitará el ARN para llamar al archivo.

nota

Al incorporarse al servicio de análisis de comercio, se crea un rol de IAM en su Cuenta de AWS. El rol de IAM permite a AWS Marketplace escribir en el bucket de Amazon S3 y publicar notificaciones en el tema de Amazon SNS. AWS Marketplace utiliza la cuenta 452565589796 para realizar estas acciones asociadas a este rol de IAM.

Verificación de la configuración

El último paso consiste en comprobar que la configuración funciona según lo previsto.

Para probar la configuración

Descargue, instale y configure la interfaz de línea de comandos de AWS (AWS CLI).

Con la AWS CLI, ejecute este comando.



aws marketplacecommerceanalytics generate-data-set \
--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \
--data-set-publication-date "{TODAY'S-DATE}" \
--role-name-arn "{YOUR-ROLE-NAME-ARN}" \
--destination-s3-bucket-name "{YOUR-S3-BUCKET}" \
--destination-s3-prefix "test-prefix" \
--sns-topic-arn "{YOUR-SNS-TOPIC-ARN}"

Para --data-set-publication-date, sustituya {TODAY'S DATE} por la fecha actual utilizando el formato ISO-8601 YYYY-MM-DDT00:00:00Z, donde YYYY es el año en cuatro dígitos, MM es el mes en dos dígitos y DD es el día en dos dígitos.
En --role-name-arn, reemplace {YOUR-ROLE-NAME-ARN} por el ARN del rol que recibió del proceso de inscripción en Inscripción en el programa del servicio de análisis de comercio.
En --destination-s3-bucket-name, reemplace {YOUR-S3-BUCKET} por el bucket de Amazon S3 que creó en Creación del bucket de Amazon S3 de destino.
En --sns-topic-arn, reemplace {YOUR-SNS-TOPIC-ARN} por el tema de Amazon SNS que creó en Configuración de un tema de Amazon SNS para las notificaciones de respuesta.

Si recibe una respuesta que incluye la respuesta dataSetRequestId del servicio, ha completado correctamente el proceso de incorporación. Una respuesta correcta tiene un aspecto similar al siguiente:



{
   "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}

Guía de implementación técnica

El servicio de análisis de comercio de AWS Marketplace se proporciona a través del SDK de AWS. Esta guía le muestra cómo interactuar con el servicio mediante la AWS CLI y la AWS SDK for Java.

Políticas de IAM para el servicio de análisis de comercio

Para permitir que sus usuarios utilicen el servicio de análisis de comercio, se requieren los siguientes permisos.

Utilice la siguiente política de permisos de IAM para inscribirse en el servicio de análisis de comercio de AWS Marketplace.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:ListRoles",
                "iam:CreateRole",
                "iam:CreatePolicy",
                "iam:AttachRolePolicy",
                "aws-marketplace-management:viewReports"
            ],
            "Resource": "*"
        }
    ]
}

Utilice la siguiente política de permisos de IAM para permitir que un usuario realice solicitudes al servicio de análisis de comercio de AWS Marketplace.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "marketplacecommerceanalytics:GenerateDataSet",
            "Resource": "*"
        }
    ]
}

Para obtener más información, consulte Creación de políticas en la consola de IAM en la Guía del usuario de IAM.

Realización de solicitudes con el AWS CLI

Para empezar, descargue AWS CLI. El siguiente ejemplo de AWS CLI realiza una solicitud para el conjunto de datos Suscripciones por hora/mensuales para el 1 de octubre de 2017. Este conjunto de datos se publica en el bucket de Amazon S3 demo-bucket con el prefijo demo-prefix y el mensaje de notificación se entrega en el tema de Amazon SNS demo-topic.



aws marketplacecommerceanalytics generate-data-set \
--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \
--data-set-publication-date "2017-10-01T00:00:00Z" \
--role-name-arn "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole" \
--destination-s3-bucket-name "demo-bucket" \
--destination-s3-prefix "demo-prefix" \
--sns-topic-arn "arn:aws:sns:us-west-2:123412341234:demo-topic"

Esta solicitud devuelve un identificador único para cada solicitud. Puede utilizar este identificador para correlacionar las solicitudes con las notificaciones publicadas en el tema de Amazon SNS. El ejemplo siguiente es un ejemplo de este identificador.



{
   "dataSetRequestId": "646dd4ed-6806-11e5-a6d8-fd5dbcaa74ab"
}

Realización de solicitudes con el AWS SDK for Java

Para empezar, descargue el AWS SDK para Java. El siguiente ejemplo de AWS SDK for Java realiza una solicitud para el conjunto de datos Suscripciones por hora/mensuales para el 1 de octubre de 2015. Este conjunto de datos se publica en el bucket de Amazon S3 demo-bucket con el prefijo demo-prefix y el mensaje de notificación se entrega en el tema de Amazon SNS demo-topic.



/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.TimeZone;
import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.regions.Region;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.marketplacecommerceanalytics.AWSMarketplaceCommerceAnalyticsClient;
import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetRequest;
import com.amazonaws.services.marketplacecommerceanalytics.model.GenerateDataSetResult;
/**
* This sample demonstrates how to make basic requests to the AWS Marketplace Commerce 
* Analytics service using the AWS SDK for Java.
* <p>
* <b>Prerequisites:</b> Follow the on-boarding guide: {URL OR SOMETHING}
* <p>
* Fill in your AWS access credentials in the provided credentials file
* template, and be sure to move the file to the default location
* (~/.aws/credentials) where the sample code will load the credentials from.
* <p>
* <b>WARNING:</b> To avoid accidental leakage of your credentials, DO NOT keep
* the credentials file in your source directory.
* <p>
* http://aws.amazon.com/security-credentials
*/
public class MarketplaceCommerceAnalyticsSample {
public static void main(String[] args) throws ParseException {
/*
* The ProfileCredentialsProvider will return your [default]
* credential profile by reading from the credentials file located at
* (~/.aws/credentials).
*/
AWSCredentials credentials = null;
try {
credentials = new ProfileCredentialsProvider().getCredentials();
} catch (Exception e) {
throw new AmazonClientException("Cannot load the credentials from the credential profiles "
+ "file. Make sure that your credentials file is at the correct "
+ "location (~/.aws/credentials), and is in valid
format.", e);
}
AWSMarketplaceCommerceAnalyticsClient client = new AWSMarketplaceCommerceAnalyticsClient(credentials);
Region usEast1 = Region.getRegion(Regions.US_EAST_1);
client.setRegion(usEast1);
System.out.println("===============================================================");
System.out.println("Getting Started with AWS Marketplace Commerce Analytics Service"); 
System.out.println("===============================================================\n");
// Create a data set request with the desired parameters
GenerateDataSetRequest request = new GenerateDataSetRequest();
request.setDataSetType("customer_subscriber_hourly_monthly_subscriptions");
request.setDataSetPublicationDate(convertIso8601StringToDateUtc("2014-06-09T00:00:00Z"));
request.setRoleNameArn("arn:aws:iam::864545609859:role/MarketplaceCommerceAnalyticsRole");
request.setDestinationS3BucketName("awsmp-goldmine-seller");
request.setDestinationS3Prefix("java-sdk-test");
request.setSnsTopicArn("arn:aws:sns:us-west-2:864545609859:awsmp-goldmine-seller-topic");
System.out.println(
String.format("Creating a request for data set %s for publication date %s.",
request.getDataSetType(), request.getDataSetPublicationDate()));
try {
// Make the request to the service
GenerateDataSetResult result = client.generateDataSet(request);
// The Data Set Request ID is a unique identifier that you can use to correlate the
// request with responses on your Amazon SNS topic 
System.out.println("Request successful, unique ID: " + result.getDataSetRequestId());
} catch (AmazonServiceException ase) {
System.out.println("Caught an AmazonServiceException, which means your request made it "
+ "to the AWS Marketplace Commerce Analytics service, but was rejected with an " 
+ "error response for some reason.");
System.out.println("Error Message: " + ase.getMessage());
System.out.println("HTTP Status Code: " + ase.getStatusCode());
System.out.println("AWS Error Code: " + ase.getErrorCode());
System.out.println("Error Type: " + ase.getErrorType());
System.out.println("Request ID: " + ase.getRequestId());
} catch (AmazonClientException ace) {
System.out.println("Caught an AmazonClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with the AWS Marketplace"
+ "Commerce Analytics service, such as not being able to access the "
+ "network.");
System.out.println("Error Message: " + ace.getMessage());
}
}
private static Date convertIso8601StringToDateUtc(String dateIso8601) throws ParseException {
TimeZone utcTimeZone = TimeZone.getTimeZone("UTC");
DateFormat utcDateFormat = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ssX");
utcDateFormat.setTimeZone(utcTimeZone);
return utcDateFormat.parse(dateIso8601);
}
}

Cabe esperar resultados similares a este ejemplo.



===============================================================
Getting Started with AWS Marketplace Commerce Analytics Service 
===============================================================
Creating a request for data set customer_subscriber_hourly_monthly_subscriptions for publication
date Sun Jun 08 17:00:00 PDT 2014.
Request successful, unique ID: c59aff81-6875-11e5-a6d8-fd5dbcaa74ab

Documentación técnica

El servicio expone un método, GenerateDataSet, que permite solicitar la publicación de conjuntos de datos en un bucket de Amazon S3. En la tabla siguiente se enumeran los parámetros de GenerateDataSet.

Parámetros del conjunto de datos
Campo	Descripción
Tipo de conjunto de datos	Este conjunto de datos se devolverá como resultado de la solicitud.
Fecha de publicación del conjunto de datos	La fecha en que se publicó un conjunto de datos. Para los conjuntos de datos diarios, proporcione una fecha con el grado de detalle de nivel de día para el día que desee. Para los conjuntos de datos mensuales, proporcione una fecha con el grado de detalle de nivel de mes para el mes que desee. El valor de día no se tiene en cuenta.
ARN del nombre de rol	El ARN del rol que tiene asociada una política de permisos que proporciona al servicio acceso a los recursos.
Nombre del bucket de Amazon S3 de destino	El nombre (el nombre fácil de recordar, no el ARN) del bucket de Amazon S3 de destino. Los conjuntos de datos se publican en esta ubicación.
Prefijo de Amazon S3 del destino	(Opcional) El prefijo de Amazon S3 para el conjunto de datos publicado, similar a una ruta del directorio en los sistemas de archivos estándar. Por ejemplo, si el nombre del bucket es `mybucket` y el prefijo `myprefix/mydatasets`, el archivo de salida se publica en `s3://DOC-EXAMPLE-BUCKET/myprefix/mydatasets/outputfile`. Si la estructura de directorios del prefijo no existe, se crea. Si no se proporciona ningún prefijo, el conjunto de datos se publica en la raíz del bucket de Amazon S3.
SNS Topic ARN	El ARN del tema de Amazon SNS al que se envía una notificación cuando se publique el conjunto de datos o si se produce un error.

Respuestas

El servicio de análisis de comercio de AWS Marketplace devuelve dos respuestas. La primera es síncrona y se devuelve inmediatamente, y la segunda es asíncrona y se devuelve usando el Amazon SNS. La respuesta síncrona será similar a este ejemplo.

Parámetros del conjunto de datos
Campo	Descripción
ID de solicitud del conjunto de datos	Identificador único que representa una solicitud específica al servicio. Este identificador se puede utilizar para correlacionar una solicitud con las notificaciones del tema de Amazon SNS.

La respuesta asíncrona se publica como un documento con formato JSON en su tema Amazon SNS y será similar a este ejemplo.

Parámetros del conjunto de datos
Campo	Descripción
Ubicación del conjunto de datos en S3	La clave y el nombre del bucket del conjunto de datos entregado.
Ubicación de los metadatos del conjunto de datos en S3	La clave y el nombre del bucket del archivo de metadatos del conjunto de datos entregado.
ID de solicitud del conjunto de datos	Identificador único que representa una solicitud específica al servicio. Este identificador se puede utilizar para correlacionar una solicitud con las notificaciones del tema de Amazon SNS.
Correcto	"True" si la operación se realiza correctamente, de lo contrario, "false".
Mensaje	(Opcional) Si se produce un error (por ejemplo, "Correcto" es "false"), este mensaje contiene información sobre el error.

Ejemplo de respuesta asíncrona con 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
 }

Salidas

Cuando una solicitud finaliza correctamente, el conjunto de datos solicitado se entrega en el bucket de Amazon S3 como un archivo .csv. El archivo de metadatos con formato JSON se publica en la misma ubicación que el archivo de conjunto de datos. El archivo de metadatos proporciona información útil sobre el conjunto de datos y los parámetros de la solicitud original. El archivo de metadatos tiene el mismo nombre que el archivo del conjunto de datos, pero con la extensión .meta.json. En la tabla siguiente se muestra el conjunto de campos de metadatos en el archivo .csv.

Campos de metadatos
Campo	Descripción
ID de solicitud del conjunto de datos	Identificador único que representa una solicitud específica al servicio. Este identificador se puede utilizar para correlacionar una solicitud con las notificaciones del tema de Amazon SNS.
Rango de cobertura del conjunto de datos	Define la fecha y hora de inicio y de finalización del rango que cubren los datos. Estas fechas están en formato ISO 8601.
Parámetros de la solicitud del conjunto de datos	Los parámetros de solicitud originales para el método `GenerateDataSet`.
Ubicación del conjunto de datos en S3	La clave y el nombre del bucket del conjunto de datos entregado.
Ubicación de los metadatos del conjunto de datos en S3	La clave y el nombre del bucket del archivo de metadatos del conjunto de datos entregado.

A continuación se ofrece un ejemplo de contenido metadatos con 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 obtener una lista completa de los conjuntos de datos disponibles, incluidas las fechas de disponibilidad, consulte la documentación del SDK de AWS.

Solución de problemas

En esta sección se describen las soluciones a los problemas que pueden surgir al utilizar el servicio de análisis de comercio de AWS Marketplace.

No puedo obtener acceso al servicio debido a un problema con la lista de permitidos.

Si aún no se ha registrado como vendedor en AWS Marketplace, visite AWS Marketplace Management Portal para registrarse. Si ya se ha registrado como vendedor en AWS Marketplace, póngase en contacto con el equipo de Operaciones de vendedores de AWS Marketplace.

No puedo solicitar conjuntos de datos de una fecha pasada, aunque la documentación del SDK dice que deben estar disponibles para esta fecha.

Aunque se indica que los conjuntos de datos están disponibles para determinadas fechas en el pasado, solo disponemos de datos desde la hora en que se inscribió en AWS Marketplace. Si cree que esto es un error, póngase en contacto con el equipo de Operaciones de vendedores de AWS Marketplace.

Al llamar al servicio, recibo el mensaje de error "No se pudo conectar con la dirección URL del punto de enlace: https://marketplacecommerceanalytics.eu-central-1.amazonaws.com/"

El servicio de análisis de comercio de AWS Marketplace solo está disponible en la región Este de EE. UU. (Norte de Virginia). Debe realizar todas las llamadas al servicio de análisis de comercio al punto de enlace us-east-1.

Si está utilizando la AWS CLI, agregue la marca --region a cada llamada y especifique la Región de AWS como us-east-1, tal y como se muestra en el siguiente ejemplo.



aws marketplacecommerceanalytics generate-data-set \
--data-set-type "customer_subscriber_hourly_monthly_subscriptions" \
--data-set-publication-date "2016-04-21T00:00:00Z" \
--role-name-arn "arn:aws:iam::138136086619:role/MarketplaceCommerceAnalyticsRole" \
--destination-s3-bucket-name "marketplace-analytics-service" \
--destination-s3-prefix "test-prefix" \
--sns-topic-arn "arn:aws:sns:eu-central-1:138136086619:Marketplace_Analytics_Service_Notice" \
 --region us-east-1

Quiero utilizar un bucket de Amazon S3 o un tema de Amazon SNS distinto de los que seleccioné durante el proceso de incorporación.

Al inscribirse en el servicio de análisis de comercio de AWS Marketplace, especificó un bucket de Amazon S3 y un tema de Amazon SNS. El proceso de incorporación configura sus permisos de IAM para permitir que el servicio acceda únicamente a estos recursos específicos. Para utilizar diferentes recursos, debe modificar su política de IAM:

Inicie sesión en la AWS Management Console y abra la consola de IAM en https://console.aws.amazon.com/iam/.
Elija Roles en el lado izquierdo de la consola de IAM.
Elija MarketplaceCommerceAnalyticsRole.
Expanda la sección Inline Roles (Roles insertados) si fuera necesario.
Busque la política con un nombre que comience por oneClick_MarketplaceCommerceAnalyticsRole y elija Editar política.
En el documento de política, busque la sección que especifica las acciones relacionadas con el servicio que quiere modificar. Por ejemplo, para cambiar el bucket de Amazon S3, busque la sección que incluye las acciones que comienzan por s3: y cambie los valores de Recurso respectivos por el bucket de Amazon S3 nuevo.

Para obtener más información sobre las políticas de IAM, consulte la siguiente guía: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html

Aparece un error AccessDeniedException al llamar a la acción GenerateDataSet

Esto puede ocurrir si el usuario de no tiene los permisos necesarios para llamar a GenerateDataSet. El siguiente procedimiento describe los pasos necesarios para crear una política de IAM con esos permisos mediante la consola de IAM y agregar los permisos a los usuarios, grupos o funciones.

Para utilizar el editor de política de JSON para crear una política

Inicie sesión en la AWS Management Console y abra la consola de IAM en https://console.aws.amazon.com/iam/.
En el panel de navegación de la izquierda, elija Policies (Políticas).

Si es la primera vez que elige Policies (Políticas), aparecerá la página Welcome to Managed Policies (Bienvenido a políticas administradas). Elija Get Started (Comenzar).
En la parte superior de la página, seleccione Crear política.
En la sección Editor de políticas, seleccione la opción JSON.

Ingrese el siguiente documento de política JSON:


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "marketplacecommerceanalytics:GenerateDataSet",
      "Resource": "*"
    }
  ]
}

Elija Siguiente.

nota
Puede alternar entre las opciones Visual y JSON del editor en todo momento. No obstante, si realiza cambios o selecciona Siguiente en la opción Visual del editor, es posible que IAM reestructure la política, con el fin de optimizarla para el editor visual. Para obtener más información, consulte Reestructuración de política en la Guía del usuario de IAM.
En la página Revisar y crear, escriba el Nombre de la política y la Descripción (opcional) para la política que está creando. Revise los Permisos definidos en esta política para ver los permisos que concede la política.
Elija Create Policy (Crear política) para guardar la nueva política.

Para proporcionar acceso, agregue permisos a sus usuarios, grupos o roles:

Usuarios y grupos de AWS IAM Identity Center:

Cree un conjunto de permisos. Siga las instrucciones de Create a permission set (Creación de un conjunto de permisos) en la Guía del usuario de AWS IAM Identity Center.
Usuarios administrados en IAM a través de un proveedor de identidades:

Cree un rol para la federación de identidades. Siga las instrucciones de Creación de un rol para un proveedor de identidad de terceros (federación) en la Guía del usuario de IAM.
Usuarios de IAM:
- Cree un rol que el usuario pueda asumir. Siga las instrucciones de Creación de un rol para un usuario de IAM en la Guía del usuario de IAM.
- (No recomendado) Adjunte una política directamente a un usuario o agregue un usuario a un grupo de usuarios. Siga las instrucciones de Adición de permisos a un usuario (consola) de la Guía del usuario de IAM.

Mi problema no se incluye en esta lista.

Póngase en contacto con el equipo de Operaciones de vendedores de AWS Marketplace.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Conjunto de herramientas del vendedor

Programa de demostración práctica de AWS Marketplace

Servicio de análisis de comercio de AWS Marketplace

Terms and conditions

Guía de incorporación

Inscripción en el servicio de análisis de comercio de AWS Marketplace

Configuración del Cuenta de AWS con permisos

Creación del bucket de Amazon S3 de destino

Configuración de un tema de Amazon SNS para las notificaciones de respuesta

Inscripción en el programa del servicio de análisis de comercio

Para habilitar el acceso

nota

Verificación de la configuración

Para probar la configuración

Guía de implementación técnica

Políticas de IAM para el servicio de análisis de comercio

Realización de solicitudes con el AWS CLI

Realización de solicitudes con el AWS SDK for Java

Documentación técnica

Respuestas

Salidas

Solución de problemas

Para utilizar el editor de política de JSON para crear una política

nota