Publicar un producto nuevo - AWS Data Exchange Guía del usuario

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Publicar un producto nuevo

En los temas siguientes veremos el proceso de publicación de un producto nuevo en AWS Data Exchange mediante la consola AWS Data Exchange.

En el vídeo siguiente se explica más sobre cómo publicar un nuevo producto de datos en AWS Data Exchange.

Publicar un producto que contiene datos basados en archivos

En los temas siguientes veremos el proceso de crear un conjunto de datos y publicar un producto nuevo que contenga datos basados en archivos en AWS Data Exchange mediante la consola AWS Data Exchange. El proceso consta de los pasos siguientes:

Paso 1: Crear activos

Los activos son los datos en AWS Data Exchange. Para obtener más información, consulte Activos.

Antes de crear y publicar un nuevo producto de datos basado en archivos, debe hacer lo siguiente:

  1. Crear los archivos.

    AWS Data Exchange admite todo tipo de archivos.

  2. Almacene los archivos como objetos en Amazon Simple Storage Service (Amazon S3) o en su ordenador local.

    Para obtener más información acerca del almacenamiento de archivos de Amazon S3, consulte la Guía del usuario de Amazon S3.

Paso 2: Crear un conjunto de datos

Los conjuntos de datos de AWS Data Exchange son dinámicos y están sometidos a control de versiones, de modo que cada revisión contiene al menos un activo. Para obtener más información, consulte Datos en AWS Data Exchange.

Para crear un conjunto de datos
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación de la izquierda, en Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija Crear conjunto de datos para abrir el asistente Pasos para crear un conjunto de datos.

  4. En Seleccionar tipo de conjunto de datos, elija Archivos.

  5. En Definir conjunto de datos, introduzca un Nombre y una Descripción para el conjunto de datos. Para obtener más información, consulte Prácticas recomendadas con conjuntos de datos.

  6. (Opcional) En Agregar etiquetas - opcional, agregue etiquetas.

  7. Elija Crear conjunto de datos.

Paso 3: Crear una revisión

En el procedimiento siguiente, se crea una revisión después de haber creado un conjunto de datos en la consola de AWS Data Exchange. Para obtener más información, consulte Revisiones.

Para crear una revisión
  1. En la sección Información general sobre el conjunto de datos de la página de detalles del conjunto de datos:

    1. (Opcional) Elija Editar nombre para editar la información sobre su conjunto de datos.

    2. (Opcional) Elija Eliminar para eliminar el conjunto de datos.

  2. En la sección Revisiones, elija Crear revisión.

  3. En Definir revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

  4. (Opcional) En Agregar etiquetas: opcional, agregue las etiquetas asociadas al recurso.

  5. Elija Crear revisión.

  6. Revise, edite o elimine los cambios del paso anterior.

Paso 4: Importar activos en una revisión

En el procedimiento siguiente, se importan los activos de datos y, a continuación, se finaliza la revisión en la consola de AWS Data Exchange. Para obtener más información, consulte Activos.

Para importar activos a la revisión
  1. En la sección Trabajos de la página de detalles del conjunto de datos, elija Importar desde Amazon S3 o Cargar (para cargar desde su ordenador), según dónde estén almacenados actualmente los activos de datos del conjunto de datos.

  2. Siga las indicaciones en función de la selección. Se inicia un trabajo para importar el activo en el conjunto de datos.

  3. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

  4. Si tiene más datos que agregar, repita el paso 1.

  5. En Información general sobre la revisión, revise la revisión y sus activos.

  6. Seleccione Finalizar revisión.

Ha finalizado correctamente una revisión de un conjunto de datos.

Puede editar o eliminar una revisión antes de agregarla a un producto.

Editar una revisión

Para editar la revisión después de finalizarla
  1. En Información general sobre la revisión, elija Revertir finalización.

    Se muestra un mensaje que indica que la revisión ya no está en estado finalizado.

  2. Para editar la revisión, en Información general sobre la revisión, elija Acciones, Editar.

  3. Realice los cambios y elija Actualizar.

  4. Revise las opciones seleccionadas y, a continuación, elija Finalizar.

Eliminar una revisión

Para eliminar la revisión después de finalizarla
  1. En Información general sobre la revisión, elija Eliminar.

  2. En el cuadro de diálogo Eliminar, escriba Delete y, a continuación, elija Eliminar.

aviso

Esto elimina la revisión y todos sus activos. Esta acción no se puede deshacer.

Paso 5: Publicar un producto nuevo

Una vez que haya creado al menos un conjunto de datos y finalizado una revisión con activos, ya se podrá publicar ese conjunto de datos como parte de un producto. Para obtener más información, consulte Detalles del producto. Asegúrese de disponer de todos los detalles necesarios sobre su producto y su oferta.

Para publicar un producto nuevo
  1. En el panel de navegación izquierdo de la consola de AWS Data Exchange, en Publicar datos, elija Productos.

  2. En Productos, elija Publicar producto nuevo para abrir el asistente Publicar producto nuevo.

  3. En la sección Visibilidad del producto, elija las Opciones de visibilidad del producto y la configuración de Información confidencial y, a continuación, seleccione Siguiente. Para más información, consulte Visibilidad del producto y Categorías de información confidenciales.

  4. En la sección Agregar datos, en Conjuntos de datos propios, seleccione las casillas de verificación situadas junto a los conjuntos de datos que quiera agregar y, a continuación, elija Agregar selección.

    nota

    Los conjuntos de datos que elija deben tener una revisión finalizada. No se pueden agregar conjuntos de datos sin versiones finalizadas.

    1. Vaya a Conjuntos de datos seleccionados para revisar sus selecciones.

      Puede revisar el Nombre del conjunto de datos, el Tipo de conjunto de datos y la fecha y hora de la Última actualización del conjunto de datos.

    2. Vaya a Seleccionar reglas de acceso a revisiones, elija las reglas de acceso a las revisiones que desee establecer para los conjuntos de datos incluidos en este producto y, a continuación, elija Siguiente. Para obtener más información, consulte Reglas de acceso a las revisiones.

  5. En la sección Definir producto, en Descripción general del producto, introduzca la información sobre el producto, incluidos el Nombre del producto, el Logotipo del producto, la información de Contacto de soporte y Categorías de productos.

    Para obtener más información, consulte Detalles del producto.

  6. (Opcional) En la sección Definir producto, en Diccionarios de datos y muestras (opcional), seleccione un conjunto de datos pulsando el botón de opción situado junto al nombre del conjunto de datos y, a continuación, seleccione Editar.

    1. En el cuadro de diálogo Editar, en Cargar diccionario de datos, elija Agregar archivo para cargar un diccionario de datos nuevo.

      Puede elegir un diccionario de datos, en formato .csv, con un tamaño máximo de 1 MB.

    2. Elija un diccionario de datos guardado en su ordenador y, a continuación, elija Abrir.

      El archivo .csv del diccionario de datos aparece en el cuadro de diálogo Editar.

      nota

      El diccionario de datos debe estar ajustado a la plantilla de diccionarios de datos de AWS Data Exchange. Si no tiene ningún diccionario de datos guardado para cargar, puede elegir el enlace de plantilla de diccionario de datos vacía o el enlace de diccionario de datos de ejemplo en la consola de AWS Data Exchange.

    3. Elija Vista previa del diccionario de datos para previsualizarlo.

    4. En Muestras (opcional), elija Cargar muestras, seleccione una muestra de su ordenador y, a continuación, seleccione Abrir.

      Las muestras aparecen en el cuadro de diálogo Editar.

      nota

      Puede cargar hasta 10 muestras con un tamaño máximo de 50 MB. Es posible previsualizar las muestras en formato .csv.

    5. Introduzca una descripción en cada muestra que vaya a estar visible en la página de detalles del producto.

    6. Seleccione Guardar.

  7. En Definición del producto, introduzca una Descripción breve y una Descripción larga del producto.

    Si desea usar una plantilla para la descripción larga, seleccione Aplicar plantilla, elija el tipo de plantilla y, a continuación, rellena la plantilla con los detalles específicos del producto.

  8. Elija Siguiente.

  9. Configura su oferta.

    • Si va a crear una oferta pública, en la sección Agregar oferta pública, configure la oferta. Todos los productos de AWS Data Exchange cuya visibilidad esté configurada como Pública requieren una oferta pública.

      1. Elija las opciones de Precios y duración del acceso de la suscripción.

      2. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      3. (Opcional) Configure la Verificación de las suscripciones, que permite controlar quién puede suscribirse el producto. Para obtener más información, consulte Verificación de suscripciones para proveedores.

      4. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      5. Elija Siguiente.

    • Si va a crear una oferta privada, configure los detalles de la oferta en la sección Agregar oferta personalizada.

      1. En la sección Información de la cuenta del suscriptor, agregue al menos una cuenta de suscriptor a la que quiera extender la oferta.

      2. Elija las opciones de Precios y duración del acceso de la suscripción.

      3. Elija la Fecha de vencimiento de la oferta en la que el suscriptor debe aceptarla.

      4. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      5. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      6. Elija Siguiente.

  10. En la sección Revisar y publicar, revise la información del producto y, a continuación, expanda la Vista previa de la página del producto para ver cómo quedará después de publicarla.

  11. Si está seguro de que desea que el producto y la oferta pública sean visibles y estén disponibles para todos, seleccione Publicar.

Ya ha completado la parte manual de la publicación de un producto de datos con una oferta pública. AWS Data Exchange prepara y publica el producto. En la página Información general del producto, el estado del producto es Pendiente de aprobación y cambia a Publicado después de la publicación.

Paso 6: (Opcional) Copiar un producto

Después de crear su primer producto, puede copiar sus detalles y las ofertas públicas para crear un producto nuevo.

nota

Es posible copiar un producto público, privado, publicado o no publicado. No se copia las ofertas personalizadas asociadas al producto, pero sí las públicas.

Para copiar un producto
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación izquierdo, en Publicar datos, elija Productos.

  3. En Productos, elija el botón situado al lado del producto cuyo contenido desee copiar.

  4. Seleccione el menú desplegable Acciones y, a continuación, seleccione Crear copia.

  5. Continúe con el flujo de trabajo Publicar un producto nuevo, con los detalles ya rellenados, en función del producto que haya elegido en el paso 3. Para obtener más información, consulte Paso 5: Publicar un producto nuevo.

Publicar un producto que contenga API

Información general

En los temas siguientes se describe el proceso de crear un conjunto de datos de API de REST y de publicación de un producto nuevo que contenga API en AWS Data Exchange. Puede completar el proceso mediante la consola AWS Data Exchange o la AWS Command Line Interface.

Tras configurar la API de REST de Amazon API Gateway, puede crear un nuevo conjunto de datos de API en AWS Data Exchange. A continuación, puede crear una revisión y agregar los activos de la API.

La creación y publicación de un activo de API permite transferir las solicitudes de los suscriptores a un punto de conexión de AWS Data Exchange a un proxy mediante su API de API Gateway. A continuación, puede agregar este conjunto de datos a un producto y añadir los precios. Luego, los suscriptores pueden ver su producto y suscribirse a él en el catálogo de AWS Marketplace y el catálogo de AWS Data Exchange.

Las funciones de AWS Data Exchange disponibles incluyen las reglas de acceso a las versiones, los productos privados, las ofertas privadas y la verificación de suscripciones.

Puede elegir solo precios basados en contratos, precios de coste medido (donde el precio del contrato es de 0 USD) o una combinación de precios medidos y por contrato.

Puede elegir los costes medidos estándar o especificar un coste medido personalizado. Existen tres tipos de costes medidos estándar disponibles:

  • Por solicitud de API

  • Por solicitud de API satisfactoria

  • Por unidad de datos transferida en bytes

nota

Los costes medidos se aplican a todos los conjuntos de datos de la API de un producto. Por lo tanto, si desea cobrar precios distintos por la misma dimensión y distintos conjuntos de datos de API, le recomendamos que cree estos conjuntos de datos en productos distintos.

El proceso consta de los pasos siguientes:

Requisitos previos

Para poder publicar un producto que contenga API, debe cumplir los requisitos previos siguientes:

  • Antes de poder utilizar cualquier Servicio de AWS, incluido AWS Data Exchange, debe registrarse en AWS y crear un usuario administrativo. Para obtener más información, consulte la Introducción de la Guía del usuario de AWS IAM Identity Center.

  • Para crear productos en AWS Data Exchange, es necesario registrar su Cuenta de AWS como vendedor de AWS Marketplace. Utilice esta cuenta para crear sus conjuntos de datos. La cuenta con el recurso de API Gateway no necesita estar en la misma cuenta que crea los conjuntos de datos.

  • Su API de REST debe estar en Amazon API Gateway con una integración que utilice un modelo de solicitud y respuesta adecuado para acceder a sus datos, como Amazon DynamoDB o AWS Lambda. Para obtener más información, consulte Desarrollar una API de REST en API Gateway y Trabajar con las API de REST en la Guía para desarrolladores de Amazon API Gateway.

    nota

    Solo se admiten las API de API Gateway públicas.

  • La API de REST de API Gateway debe poder autenticar y autorizar llamadas del entidad principal del servicio AWS Data Exchange. Cada solicitud desde AWS Data Exchange hacia su API utiliza el protocolo Signature Version 4 (SigV4) firmado con credenciales de AWS Data Exchange. AWS Data Exchange funciona con dominios personalizados y asignaciones de claves de dominio.

    nota

    AWS Data Exchange no es compatible con Amazon Cognito, No-Auth ni autorizadores de AWS Lambda.

  • Si la API de REST de API Gateway utiliza un sistema de identidad personalizado para la autenticación y la autorización, configúrelo para que utilice la autenticación de IAM e importe un esquema de OpenAPI que describa su API. AWS Data Exchange invocará la API de REST de API Gateway con sus propias credenciales de servicio e incluirá información del suscriptor, como el ID de la cuenta.

  • Su API de REST de API Gateway es responsable de la integración con su backend. Para ello, siga uno de estos pasos:

    • Adjunte un token de autenticación de larga duración a cada solicitud que llegue a través de la API de REST de API Gateway que el backend pueda verificar.

    • Utilice API Gateway para invocar una función de Lambda que pueda generar credenciales e invocar su API.

Su API se invoca según la especificación de solicitud de integración de API.

Para obtener más información, consulte los temas siguientes:

Seguridad de conjuntos de datos de API

AWS Data Exchange cifra el tráfico de extremo a extremo mediante seguridad de la capa de transporte (TLS) 1.2. Todos los metadatos están cifrados en reposo. AWS Data Exchange no almacenará las solicitudes de los suscriptores ni las respuestas de su backend. Solo se extraen los metadatos de medición necesarios para la facturación.

Especificación de solicitud de integración de API

Una API en AWS Data Exchange pasa por todos los encabezados (excepto los que se enumeran en Reenvío de encabezados), el cuerpo, el método http, la ruta y las cadenas de consulta tal como están de la solicitud del cliente y agrega los encabezados siguientes.

// These headers help prevent Confused Deputy attacks. They enable the SourceAccount // and SourceArn variables in IAM policies. 'x-amz-source-account': ACCOUNT_ID, 'x-amz-source-arn': `arn:aws:dataexchange:${REGION}:${OWNER_ACCOUNT_ID}:data-sets/${DATA_SET_ID}/revisions/${REVISION_ID}/assets/${ASSET_ID}`, // These headers identify the API Asset in Data Exchange. 'x-amzn-dataexchange-asset-id': ASSET_ID, 'x-amzn-dataexchange-data-set-id': DATA_SET_ID, 'x-amzn-dataexchange-revision-id': REVISION_ID, // This header identifies the Data Exchange Product. 'x-amzn-dataexchange-product-id': PRODUCT_ID, // This header identifies the caller of Data Exchange. It will contain subscriber // information. 'x-amzn-dataexchange-requester-account-id': REQUESTER_ACCOUNT_ID, // Providers can attach custom metadata in the form of key/value pairs // to a particular subscription. We will send these key/value pairs as stringified // JSON. 'x-amz-dataexchange-subscription-metadata': STRINGIFIED_METADATA,
Reenvío de encabezados

AWS Data Exchange elimina cualquier encabezado relacionado con la autenticación o el espacio de nombres asignado a Amazon antes de reenviarlo al backend de un proveedor. En concreto, AWS Data Exchange elimina:

  • Encabezado Authentication

  • Encabezados que comiencen por x-amz

El encabezado host se sobrescribirá como consecuencia del uso del proxy.

Paso 1: Actualizar la política de recursos de la API

Si tiene una API de REST de Amazon API Gateway que cumpla los requisitos previos, debe actualizar la política de recursos de la API para conceder a AWS Data Exchange la habilidad de invocar su API cuando un suscriptor solicite obtener el esquema de la API.

Para actualizar la política de recursos de la API
  1. Agregue la política siguiente a la política de recursos de la API:

    { "Effect": "Allow", "Principal": {"Service": "dataexchange.amazonaws.com"}, "Action": "execute-api:Invoke", "Resource": "*", "Condition": {"StringEquals": {"aws:SourceAccount": "<account-id>"}} }
  2. Sustituya account-id por la cuenta que vaya a crear el conjunto de datos de la API.

    No es necesario que la cuenta con el recurso de API Gateway esté en la misma cuenta que crea los conjuntos de datos.

Esta política restringe estos permisos a las llamadas realizadas por la entidad principal del servicio de AWS Data Exchange y exige que solo su cuenta pueda autorizar la integración de AWS Data Exchange con su API.

nota

Si tiene una política de recursos que deniegue explícitamente esta invocación por parte de AWS Data Exchange, es necesario eliminar o limitar esta denegación.

Ya está listo para crear un conjunto de datos de la API.

Paso 2: Crear un conjunto de datos de API

Los conjuntos de datos de AWS Data Exchange son dinámicos y están sometidos a control de versiones, de modo que cada revisión contiene al menos un activo. Para obtener más información, consulte Datos en AWS Data Exchange.

Se utiliza la consola de AWS Data Exchange o la AWS Command Line Interface para crear un conjunto de datos de la API:

Creación de un conjunto de datos de API (consola)
Para crear un conjunto de datos de API (consola)
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación de la izquierda, en Mis datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija Crear conjunto de datos para abrir el asistente Pasos para crear un conjunto de datos.

  4. En Seleccionar tipo de conjunto de datos, elija API de Amazon API Gateway.

  5. En Definir conjunto de datos, introduzca un Nombre y una Descripción para el conjunto de datos. Para obtener más información, consulte Prácticas recomendadas con conjuntos de datos.

  6. (Opcional) En Agregar etiquetas - opcional, agregue etiquetas.

  7. Seleccione Crear.

Ya está listo para crear una revisión.

Creación de un conjunto de datos de API (AWS CLI)
Para crear un conjunto de datos de API (CLI)
  1. Utilice el comando create-data-set para crear un conjunto de datos de API:

    $ aws dataexchange create-data-set \ --asset-type API_GATEWAY_API \ --description 'Data Set Description' \ --name 'Data Set Name' { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID", "AssetType": "API_GATEWAY_API", "CreatedAt": "2021-09-11T00:16:46.349000+00:00", "Description": "Data Set Description", "Id": "$DATA_SET_ID", "Name": "Data Set Name", "Origin": "OWNED", "UpdatedAt": "2021-09-11T00:16:46.349000+00:00" }
  2. Anote el nuevo tipo de activo de API_GATEWAY_API.

Ya está listo para crear una revisión.

Paso 3: Crear una revisión

En el procedimiento siguiente, se crea una revisión después de haber creado un conjunto de datos. Para obtener más información, consulte Revisiones.

Puede utilizar la consola de AWS Data Exchange o la AWS Command Line Interface para crear una revisión nueva:

Creación de una revisión (consola)
Para crear una revisión (consola)
  1. En la sección Información general sobre el conjunto de datos de la página de detalles del conjunto de datos:

    1. (Opcional) Elija Editar nombre para editar la información sobre su conjunto de datos.

    2. (Opcional) Elija Eliminar para eliminar el conjunto de datos.

  2. En la sección Revisiones, elija Crear revisión.

  3. En Definir revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

  4. (Opcional) En Agregar etiquetas: opcional, agregue las etiquetas asociadas al recurso.

  5. Elija Crear revisión.

  6. Revise, edite o elimine los cambios del paso anterior.

Ahora está listo para agregar activos de la API a la revisión.

Creación de una revisión (AWS CLI)
Para crear una revisión (AWS CLI)
  1. Utilice el comando create-revision para crear una revisión:

    $ aws dataexchange create-revision \ --data-set-id $DATA_SET_ID \ --comment 'First Atlas Revision' { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID", "Comment": "First Atlas Revision", "CreatedAt": "2021-09-11T00:18:49.160000+00:00", "DataSetId": "$DATA_SET_ID", "Finalized": false, "Id": "$REVISION_ID", "UpdatedAt": "2021-09-11T00:18:49.160000+00:00" }
  2. Añada los activos de la API a la revisión.

    nota

    Necesitará saber el ID de la API de REST de API Gateway que desea importar, así como la fase.

Paso 4: Agregar activos de API a una revisión

Los activos de API contienen la información que los suscriptores necesitan para realizar llamadas a su API. Para obtener más información, consulte Activos.

En el procedimiento siguiente, se importan los activos de datos y, a continuación, se finaliza la revisión.

Puede utilizar la consola de AWS Data Exchange o la AWS CLI para agregar activos a una revisión:

Añadir activos de API a una revisión (consola)
Para añadir activos de API a una revisión (consola)
  1. En la sección de Activos de API de la página de detalles del conjunto de datos, elija Agregar etapa de API.

  2. En Seleccionar etapa de API, para la API de Amazon API Gateway, introduzca una API en el cuadro de entrada o elija una de las opciones siguientes en la lista desplegable:

    • API en otra Cuenta de AWS: se trata de una API multicuenta a la que se le ha dado permiso para acceder.

    • En esta Cuenta de AWS: esta es una API en su Cuenta de AWS.

    1. Si ha elegido una API en otra Cuenta de AWS, introduzca el ID de la API y el Nombre de la etapa de la API en los cuadros de entrada.

    2. Si ha seleccionado En esta Cuenta de AWS, elija el Nombre de la etapa de API en la lista desplegable

    nota

    Para crear una nueva etapa de API, elija Crear nueva y siga los pasos del modal Crear nueva API en Amazon API Gateway. Después de crear la etapa nueva, repita el paso 2.

  3. En Configuración avanzada (opcional), puede optar por Conectar el plan de uso existente de Amazon API Gateway para utilizar los límites de limitación y cuota definidos en el plan de uso existente e introducir la Clave de API.

  4. En API de documentos para suscriptores, proporcione detalles sobre la API que verán los suscriptores después de suscribirse a su producto.

    1. En Nombre de API, introduzca un nombre que los suscriptores puedan usar para identificar el activo de la API.

      nota

      Si se ha seleccionado En esta Cuenta de AWS, el Nombre de API se rellena automáticamente y es posible modificarlo si es necesario.

      Si se ha seleccionado API en otra Cuenta de AWS, el Nombre de la API se rellena con un nombre predeterminado, que es necesario modificar para que el suscriptor pueda entender fácilmente de qué se trata.

    2. Para la Especificación OpenAPI 3.0, puede:

      1. Introducir o copiar y pegar el archivo de especificaciones de OpenAPI 3.0.

      2. Seleccione Importar desde un archivo JSON y, a continuación, seleccione el archivo .json de su ordenador local para importarlo.

        La especificación importada aparece en el cuadro.

      3. Elija Importar desde Amazon API Gateway y, a continuación, elija una especificación para importar.

        La especificación importada aparece en el cuadro.

    3. En Documentación adicional (opcional), introduzca cualquier información adicional que sea útil para que el suscriptor conozca su API. Se admite Markdown.

    nota

    No es posible editar la especificación de OpenAPI ni la documentación adicional después de agregar este activo a una revisión.

    Si desea actualizar esta información y la revisión no está finalizada, puede sustituir el activo.

    Si desea actualizar esta información y la revisión está finalizada, puede crear una revisión nueva con el activo actualizado.

  5. Elija Agregar etapa de API.

    Se inicia un trabajo para importar el activo (en este caso, la API) en el conjunto de datos.

    nota

    Si no dispone de una API en Amazon API Gateway, se le pedirá que cree una.

  6. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

  7. Si tiene más API que agregar, repita el paso 2.

  8. En Información general sobre la revisión, revise la revisión y sus activos.

  9. Elija Finalizar.

Ha finalizado correctamente una revisión de un conjunto de datos.

Puede editar una revisión o eliminar una revisión antes de agregarla a un producto.

Ya está todo preparado para publicar un nuevo producto de datos de API.

Agregar activos de API a una revisión (AWS CLI)

Es posible agregar activos de API ejecutando un trabajo de IMPORT_ASSET_FROM_API_GATEWAY_API.

Para agregar activos de API a una revisión (AWS CLI):
  1. Utilice el comando create-job para agregar activos de API a la revisión:

    $ aws dataexchange create-job \ --type IMPORT_ASSET_FROM_API_GATEWAY_API \ --details '{"ImportAssetFromApiGatewayApi":{"DataSetId":"$DATA_SET_ID","RevisionId":"$REVISION_ID","ApiId":"$API_ID","Stage":"$API_STAGE","ProtocolType":"REST"}}' { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/$JOB_ID", "CreatedAt": "2021-09-11T00:38:19.875000+00:00", "Details": { "ImportAssetFromApiGatewayApi": { "ApiId": "$API_ID", "DataSetId": "$DATA_SET_ID", "ProtocolType": "REST", "RevisionId": "$REVISION_ID", "Stage": "$API_STAGE" } }, "Id": "$JOB_ID", "State": "WAITING", "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API", "UpdatedAt": "2021-09-11T00:38:19.875000+00:00" } $ aws dataexchange start-job --job-id $JOB_ID $ aws dataexchange get-job --job-id $JOB_ID { "Arn": "arn:aws:dataexchange:us-east-1:0123456789012:jobs/$JOB_ID", "CreatedAt": "2021-09-11T00:38:19.875000+00:00", "Details": { "ImportAssetFromApiGatewayApi": { "ApiId": "$API_ID", "DataSetId": "$DATA_SET_ID", "ProtocolType": "REST", "RevisionId": "$REVISION_ID", "Stage": "$API_STAGE" "ApiEndpoint": "string", "ApiKey": "string", "ApiName": "string", "ApiDescription": "string", "ApiSpecificationDownloadUrl": "string", "ApiSpecificationDownloadUrlExpiresAt": "string" } }, "Id": "$JOB_ID", "State": "COMPLETED", "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API", "UpdatedAt": "2021-09-11T00:38:52.538000+00:00" }
  2. Utilice el comando list-revision-assets para confirmar que se ha creado el nuevo activo correctamente:

    $ aws dataexchange list-revision-assets \ --data-set-id $DATA_SET_ID \ --revision-id $REVISION_ID { "Assets": [ { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID/assets/$ASSET_ID", "AssetDetails": { "ApiGatewayApiAsset": { "ApiEndpoint": "https://$API_ID.execute-api.us-east-1.amazonaws.com/$API_STAGE", "ApiId": "$API_ID", "ProtocolType": "REST", "Stage": "$API_STAGE" } }, "AssetType": "API_GATEWAY_API", "CreatedAt": "2021-09-11T00:38:52.457000+00:00", "DataSetId": "$DATA_SET_ID", "Id": "$ASSET_ID", "Name": "$ASSET_ID/$API_STAGE", "RevisionId": "$REVISION_ID", "UpdatedAt": "2021-09-11T00:38:52.457000+00:00" } ] }

Ya está todo preparado para publicar el producto de datos de API.

Editar una revisión
Para editar la revisión después de finalizarla
  1. En Información general sobre la revisión, elija Revertir finalización.

    Se muestra un mensaje que indica que la revisión ya no está en estado finalizador.

  2. Para editar la revisión, en Información general sobre la revisión, elija Acciones, Editar.

  3. Realice los cambios y elija Actualizar.

  4. Revise los cambios y, a continuación, elija Finalizar.

Eliminar una revisión
Para eliminar la revisión después de finalizarla
  1. En Información general sobre la revisión, elija Eliminar.

  2. En el cuadro de diálogo Eliminar, escriba Delete y, a continuación, elija Eliminar.

aviso

Esto elimina la revisión y todos sus activos. Esta acción no se puede deshacer.

Paso 5: Publicar un producto nuevo que contenga API

Una vez que haya creado al menos un conjunto de datos y finalizado una revisión con activos, ya se podrá publicar ese conjunto de datos como parte de un producto. Para obtener más información, consulte Detalles del producto. Asegúrese de disponer de todos los detalles necesarios sobre su producto y su oferta.

Utiliza la consola AWS Data Exchange o la API del catálogo de AWS Marketplace para publicar un nuevo producto que contenga las API. Para obtener información acerca de cómo publicar un producto nuevo con la API del catálogo de AWS Marketplace, consulte Uso AWS Data Exchange con la API AWS Marketplace de catálogo.

Publicación un producto nuevo que contenga API (consola)
Para publicar un producto nuevo que contenga API
  1. En el panel de navegación izquierdo de la consola de AWS Data Exchange, en Publicar datos, elija Productos.

  2. En Productos, elija Publicar producto nuevo para abrir el asistente Publicar producto nuevo.

  3. En Visibilidad del producto:

    1. Elija las Opciones de visibilidad del producto como Público o Privado.

      Todos los productos de AWS Data Exchange cuya visibilidad esté configurada como Pública requieren una oferta pública.

      Para obtener más información, consulte Visibilidad del producto.

    2. Elija la configuración de Información confidencial del producto.

      Para obtener más información, consulte Categorías de información confidenciales.

    3. Elija Siguiente.

  4. En Agregar datos:

    1. En Conjuntos de datos propios, seleccione las casillas de verificación situadas junto a los conjuntos de datos que quiera agregar y, a continuación, elija Agregar selección.

      nota

      Los conjuntos de datos que elija deben tener una revisión finalizada. No se pueden agregar conjuntos de datos sin versiones finalizadas.

    2. Vaya a Conjuntos de datos seleccionados para revisar sus selecciones.

      Puede revisar el Nombre del conjunto de datos, el Tipo de conjunto de datos y la fecha y hora de la Última actualización del conjunto de datos.

    3. Vaya a Seleccionar reglas de acceso a revisiones y elija las reglas de acceso a las revisiones que desee establecer para los conjuntos de datos incluidos en este producto.

      Para obtener más información, consulte Reglas de acceso a las revisiones.

    4. Elija Siguiente.

  5. En Definir producto:

    1. En Descripción general del producto, introduzca la información sobre el producto, incluidos el Nombre del producto, el Logotipo del producto, la información de Contacto de soporte y Categorías de productos.

      Para obtener más información, consulte Detalles del producto.

    2. (Opcional) En Diccionarios de datos y muestras (opcional), seleccione un conjunto de datos pulsando el botón de opción situado junto al nombre del conjunto de datos y, a continuación, elija Editar.

      1. En el cuadro de diálogo Editar, elija Cargar para cargar un diccionario de datos nuevo.

        Puede elegir un diccionario de datos, en formato .csv, con un tamaño máximo de 1 MB.

      2. Elija un diccionario de datos guardado en su ordenador y, a continuación, elija Abrir.

        El archivo .csv del diccionario de datos aparece en el cuadro de diálogo Editar.

        nota

        El diccionario de datos debe estar ajustado a la plantilla de diccionarios de datos de AWS Data Exchange. Si no tiene ningún diccionario de datos guardado para cargar, puede elegir el enlace de plantilla de diccionario de datos vacía o el enlace de diccionario de datos de ejemplo en la consola de AWS Data Exchange.

      3. Seleccione Vista previa del diccionario de datos para obtener una vista previa del diccionario de datos.

      4. En Muestras (opcional), elija Cargar muestras, seleccione una muestra de su ordenador y, a continuación, seleccione Abrir.

        Las muestras aparecen en el cuadro de diálogo Editar.

        nota

        Puede cargar hasta 10 muestras con un tamaño máximo de 50 MB. Es posible previsualizar las muestras en formato .csv.

      5. Introduzca una descripción en cada muestra que vaya a estar visible en la página de detalles del producto.

      6. Seleccione Guardar.

  6. En Definición del producto, introduzca una Descripción breve y una Descripción larga del producto.

    Si desea usar una plantilla para la descripción larga, seleccione Aplicar plantilla, elija el tipo de plantilla y, a continuación, rellena la plantilla con los detalles específicos del producto.

  7. Elija Siguiente.

  8. Configure su oferta en Agregar oferta pública (para ofertas públicas) o Agregar oferta personalizada (para ofertas privadas):

    Todos los productos de AWS Data Exchange cuya visibilidad esté configurada como Pública requieren una oferta pública.

    1. Solo para ofertas privadas:

      1. Elija uno de los Tipos de ofertas que aparecen en la lista: Oferta privada, Oferta privada renovada o Bring your own subscription (BYOS, Traiga su propia suscripción).

      2. En la sección Información de la cuenta del suscriptor, agregue al menos una cuenta de suscriptor a la que quiera extender la oferta.

    2. Elija las opciones de Precios y duración del acceso de la suscripción.

    3. En Costos medidos (opcional), elija Agregar.

      1. En Agregar costo medido, seleccione el tipo de coste de la llamada a la API en la lista de Tipo:

        • Por solicitud de API

        • Por solicitud de API satisfactoria

        • Por unidad de datos transferida en bytes

        • Nuevo costo medido personalizado

      2. Introduzca o actualice el Nombre de visualización del costo, que aparece en la factura del suscriptor.

      3. Si utiliza un Costo medido predefinido, se genera la Clave automáticamente; no se puede editar y no es necesario devolverla en el encabezado de la respuesta.

      4. Si va a crear un Nuevo costo medido personalizado, introduzca la Clave, que es el identificador del coste medido, en el encabezado de respuesta de la API (15 caracteres como máximo).

        Esta Clave se debe devolver como parte del encabezado de la respuesta de x-amz-dataexchange-metering.

        ejemplo Clave personalizada

        Si dispone de una clave personalizada llamada VertexCount y otra clave personalizada llamada EdgeCount, el encabezado de respuesta «x-amz-dataexchange-metering» podría tener un valor igual a VertexCount=3,EdgeCount=10 o se podrían devolver dos líneas de encabezado distintas:

        x-amz-dataexchange-metering: VertextCount=3

        x-amz-dataexchange-metering: EdgeCount=10

      5. Introduzca el precio por unidad que se cobra al suscriptor en Precio por unidad.

      6. (Opcional) Introduzca el número de unidades para mostrar un ejemplo del coste en la Calculadora de costos medidos.

      7. (Opcional) Introduzca una breve Descripción del coste medido que se muestra en la página de detalles del producto.

      8. Elija Agregar.

      9. (Opcional) Repita este procedimiento para agregar costes calculados adicionales. 

        El orden de los costes medidos aparece en la página de detalles del producto. No es posible volver a ordenarlos.

        nota

        Después de crear la oferta, es posible editar el precio y la descripción de un coste medido. Para obtener más información, consulte Actualización de los detalles del producto y la oferta.

    4. Solo para ofertas privadas, elija la Fecha de vencimiento de la oferta en la que el suscriptor debe aceptarla.

    5. Elija su Configuración de impuestos, su Acuerdo de suscripción a datos y su Política de reembolsos.

    6. (Opcional) Solo para ofertas públicas, configure la Verificación de las suscripciones, que permite controlar quién puede suscribirse el producto. Para obtener más información, consulte Verificación de suscripciones para proveedores.

    7. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

    8. Elija Siguiente.

  9. En la sección Revisar y publicar, revisa la información del producto.

    1. Amplíe la Vista previa de la página del producto para ver cómo quedará la página del producto después de publicarla.

    2. (Opcional) Haga clic en el botón Editar en cualquier sección para editar esa sección.

  10. Si está seguro de que desea que el producto y la oferta pública sean visibles y estén disponibles para todos, seleccione Publicar.

Ya ha completado la parte manual de la publicación de un producto de datos con una oferta pública. AWS Data Exchange prepara y publica el producto.

En la página Información general del producto, el estado del producto es Pendiente de aprobación y cambia a Publicado después de la publicación.

Paso 6: (Opcional) Copiar un producto

Después de crear su primer producto, puede copiar sus detalles y las ofertas públicas para crear un producto nuevo.

nota

Es posible copiar un producto público, privado, publicado o no publicado. No se copia las ofertas personalizadas asociadas al producto, pero sí las públicas.

Para copiar un producto
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación izquierdo, en Publicar datos, elija Productos.

  3. En Productos, elija el botón situado al lado del producto cuyo contenido desee copiar.

  4. Seleccione el menú desplegable Acciones y, a continuación, seleccione Crear copia.

  5. Continúe con el flujo de trabajo Publicar un producto nuevo, con los detalles ya rellenados, en función del producto que haya elegido en el paso 3. Para obtener más información, consulte Paso 5: Publicar un producto nuevo.

Publicar un producto que contenga conjuntos de datos de Amazon Redshift

Información general

Un conjunto de datos de Amazon Redshift contiene recursos compartidos de datos de AWS Data Exchange de Amazon Redshift. Cuando los clientes se suscriben a un producto que contiene recursos compartidos de datos, se les concede acceso de solo lectura a las tablas, las vistas, los esquemas y las funciones definidas por el usuario que el proveedor de datos añada al recurso compartido de datos.

Como proveedor de datos, debe crear un AWS Data Exchange para un recurso compartido de datos de Amazon Redshift en su clúster. A continuación, agregue al recurso compartido de datos los esquemas, las tablas, las vistas y las funciones definidas por el usuario a las que desea que accedan los suscriptores. A continuación, importe el recurso compartido de datos en AWS Data Exchange, cree un conjunto de datos, añádalo a un producto y publique el producto. Los suscriptores tienen acceso al recurso compartido de datos al suscribirse.

Una vez que haya configurado su recurso compartido de datos de Amazon Redshift en Amazon Redshift, podrá crear un nuevo conjunto de datos de Amazon Redshift en AWS Data Exchange. A continuación, puede crear una revisión y añadir activos de recurso compartido de datos de Amazon Redshift. Esto permite que las solicitudes al punto de conexión AWS Data Exchange se envíen mediante proxy a su recurso compartido de datos de Amazon Redshift. A continuación, puede agregar este conjunto de datos a un producto y añadir los precios. Luego, los suscriptores prospectivos pueden ver su producto y suscribirse a él en el catálogo de AWS Data Exchange.

En los temas siguientes se describe el proceso de creación de un conjunto de datos de Amazon Redshift y la publicación de un nuevo producto con conjuntos de datos de Amazon Redshift mediante la consola de AWS Data Exchange. El proceso consta de los pasos siguientes:

Paso 1: Crear un recurso compartido de datos de Amazon Redshift

Los activos son los datos en AWS Data Exchange. Para obtener más información, consulte Activos.

Para crear un recurso compartido de datos de Amazon Redshift
  1. Cree un recurso compartido de datos en el clúster de Amazon Redshift.

    Para obtener más información sobre cómo crear un recurso compartido de datos, consulte Trabajar con recursos compartidos de datos de AWS Data Exchange como productor en la Guía para desarrolladores de bases de datos de Amazon Redshift.

    nota

    Le recomendamos configurar su recurso compartido de datos como de acceso público. Si no lo hace, los clientes con clústeres de acceso público no podrán consumir sus datos.

  2. Paso 2: Crear un conjunto de datos de Amazon Redshift.

Paso 2: Crear un conjunto de datos de Amazon Redshift

Un conjunto de datos de Amazon Redshift contiene recursos compartidos de datos de AWS Data Exchange para Amazon Redshift. Para obtener más información, consulte Conjunto de datos de Amazon Redshift.

Para crear un conjunto de datos de Amazon Redshift
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación de la izquierda, en Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija Crear conjunto de datos para abrir el asistente Pasos para crear un conjunto de datos.

  4. En Seleccionar tipo de conjunto de datos, elija Recurso compartido de datos de Amazon Redshift.

  5. En Definir conjunto de datos, introduzca un Nombre y una Descripción para el conjunto de datos. Para obtener más información, consulte Prácticas recomendadas con conjuntos de datos.

  6. En Agregar etiquetas - opcional, agregue etiquetas.

  7. Seleccione Crear.

Paso 3: Crear una revisión

En el procedimiento siguiente, se crea una revisión después de haber creado un conjunto de datos en la consola de AWS Data Exchange. Para obtener más información, consulte Revisiones.

Para crear una revisión
  1. En la sección Información general sobre el conjunto de datos de la página de detalles del conjunto de datos:

    1. (Opcional) Elija Editar nombre para editar la información sobre su conjunto de datos.

    2. (Opcional) Elija Eliminar para eliminar el conjunto de datos.

  2. En la sección Revisiones, elija Crear revisión.

  3. En Definir revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

  4. En Agregar etiquetas - opcional, agregue las etiquetas asociadas al recurso.

  5. Seleccione Crear.

  6. Revise, edite o elimine los cambios del paso anterior.

Paso 4: Agregar activos de recursos compartidos de datos de Amazon Redshift a una revisión

En el procedimiento siguiente, se agregan activos de recursos compartidos de datos de Amazon Redshift y, a continuación, se finaliza la revisión en la consola de AWS Data Exchange. Para obtener más información, consulte Activos.

Para agregar activos a la revisión
  1. En la sección Recursos compartidos de datos de AWS Data Exchange para Amazon Redshift en la página de detalles del conjunto de datos, elija Agregar recursos compartidos de datos.

  2. En la sección Recursos compartidos de datos de AWS Data Exchange para Amazon Redshift en la página de detalles del conjunto de datos, elija Agregar recursos compartidos de datos.

    nota

    Puede agregar hasta 20 recursos compartidos de datos a una revisión.

    Se inicia un trabajo para importar los activos en la revisión.

  3. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

  4. Si tiene más datos que agregar, repita el paso 1.

  5. En Información general sobre la revisión, revise la revisión y sus activos.

  6. Elija Finalizar.

Ha finalizado correctamente una revisión de un conjunto de datos.

Puede editar o eliminar una revisión antes de agregarla a un producto.

Paso 5: Publicar un producto nuevo que contenga conjuntos de datos de Amazon Redshift

Después de crear al menos un conjunto de datos y finalizado una revisión con activos, ya se podrá publicar un producto con conjuntos de datos como de Amazon Redshift. Para obtener más información, consulte Detalles del producto. Asegúrese de disponer de todos los detalles necesarios sobre su producto y su oferta.

Para publicar un producto nuevo que contenga conjuntos de datos de Amazon Redshift
  1. En el panel de navegación izquierdo de la consola de AWS Data Exchange, en Publicar datos, elija Productos.

  2. En Productos, elija Publicar producto nuevo para abrir el asistente Publicar producto nuevo.

  3. En la sección Visibilidad del producto, elija las Opciones de visibilidad del producto y la configuración de Información confidencial y, a continuación, seleccione Siguiente. Para más información, consulte Visibilidad del producto y Categorías de información confidenciales.

  4. En la sección Agregar datos, en Conjuntos de datos propios, seleccione las casillas situadas junto a los conjuntos de datos que quiera agregar y, a continuación, elija Agregar selección.

    nota

    Los conjuntos de datos que elija deben tener una revisión finalizada. No se pueden agregar los conjuntos de datos sin versiones finalizadas.

    1. Vaya a Conjuntos de datos seleccionados para revisar sus selecciones.

      Puede revisar el Nombre del conjunto de datos, el Tipo de conjunto de datos y la fecha y hora de la Última actualización del conjunto de datos.

    2. Vaya a Seleccionar reglas de acceso a revisiones, elija las reglas de acceso a las revisiones que desee establecer para los conjuntos de datos incluidos en este producto y, a continuación, elija Siguiente.

      Para obtener más información, consulte Reglas de acceso a las revisiones.

  5. En la sección Definir producto, en Descripción general del producto, introduzca la información sobre el producto, incluidos el Nombre del producto, el Logotipo del producto, la información de Contacto de soporte y Categorías de productos.

    Para obtener más información, consulte Detalles del producto.

  6. (Opcional) En la sección Definir producto, en Diccionarios de datos y muestras (opcional), seleccione un conjunto de datos pulsando el botón de opción situado junto al nombre del conjunto de datos y, a continuación, seleccione Editar.

    Para más información, consulte Diccionarios de datos y Muestras.

    1. En el cuadro de diálogo Editar, en Cargar diccionario de datos, elija Agregar archivo para cargar un diccionario de datos nuevo.

      Puede elegir un diccionario de datos, en formato .csv, con un tamaño máximo de 1 MB.

    2. Elija un diccionario de datos guardado en su ordenador y, a continuación, elija Abrir.

      El archivo .csv del diccionario de datos aparece en el cuadro de diálogo Editar.

      nota

      El diccionario de datos debe estar ajustado a la plantilla de diccionarios de datos de AWS Data Exchange. Si no tiene ningún diccionario de datos guardado para cargar, puede elegir el enlace de plantilla de diccionario de datos vacía o el enlace de diccionario de datos de ejemplo en la consola de AWS Data Exchange.

    3. Elija Vista previa del diccionario de datos para previsualizarlo.

    4. En Muestras (opcional), elija Cargar muestras, seleccione una muestra de su ordenador y, a continuación, seleccione Abrir.

      Las muestras aparecen en el cuadro de diálogo Editar.

      nota

      Puede cargar hasta 10 muestras con un tamaño máximo de 50 MB. Es posible previsualizar las muestras en formato .csv.

    5. Introduzca una descripción en cada muestra que vaya a estar visible en la página de detalles del producto.

    6. Seleccione Guardar.

  7. En Definición del producto, introduzca una Descripción breve y una Descripción larga del producto.

    Si desea usar una plantilla para la descripción larga, seleccione Aplicar plantilla, elija el tipo de plantilla y, a continuación, rellena la plantilla con los detalles específicos del producto.

  8. Elija Siguiente.

  9. Configura su oferta.

    • Si va a crear una oferta pública, configure la oferta en la sección Agregar oferta pública. Todos los productos de AWS Data Exchange cuya visibilidad esté configurada como Pública requieren una oferta pública.

      1. Elija las opciones de Precios y duración del acceso de la suscripción.

      2. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      3. (Opcional) Configure la Verificación de las suscripciones, que permite controlar quién puede suscribirse el producto. Para obtener más información, consulte Verificación de suscripciones para proveedores.

      4. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      5. Elija Siguiente.

    • Si va a crear una oferta privada, configure los detalles de la oferta en la sección Agregar oferta personalizada.

      1. En la sección Información de la cuenta del suscriptor, agregue al menos una cuenta de suscriptor a la que quiera extender la oferta.

      2. Elija las opciones de Precios y duración del acceso de la suscripción.

      3. Elija la Fecha de vencimiento de la oferta en la que el suscriptor debe aceptarla.

      4. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      5. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      6. Elija Siguiente.

  10. En la sección Revisar y publicar, revise la información del producto y, a continuación, expanda la Vista previa de la página del producto para ver cómo quedará después de publicarla.

  11. Si está seguro de que desea que el producto y la oferta pública sean visibles y estén disponibles para todos, seleccione Publicar.

Ya ha completado la parte manual de la publicación de un producto de datos con una oferta pública. AWS Data Exchange prepara y publica el producto. En la página Información general del producto, el estado del producto es Pendiente de aprobación y cambia a Publicado después de la publicación.

Paso 6: (Opcional) Copiar un producto

Después de crear su primer producto, puede copiar sus detalles y las ofertas públicas para crear un producto nuevo.

nota

Es posible copiar un producto público, privado, publicado o no publicado. No se copia las ofertas personalizadas asociadas al producto, pero sí las públicas.

Para copiar un producto
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación izquierdo, en Publicar datos, elija Productos.

  3. En Productos, elija el botón situado al lado del producto cuyo contenido desee copiar.

  4. Seleccione el menú desplegable Acciones y, a continuación, seleccione Crear copia.

  5. Continúe el flujo de trabajo Publicar un producto, con los detalles ya rellenados, en función del producto que haya elegido en el paso 3. Para obtener más información, consulte Paso 5: Publicar un producto nuevo.

Publicar un producto que contenga acceso a datos de Amazon S3

Información general

Con AWS Data Exchange para Amazon S3, los proveedores pueden compartir el acceso directo a buckets de Amazon S3 o prefijos específicos y objetos de Amazon S3. Los proveedores también utilizan AWS Data Exchange para gestionar automáticamente las suscripciones, los derechos, la facturación y los pagos.

Como proveedor de datos, puede compartir el acceso directo a todo un bucket de Amazon S3 o a prefijos y objetos de Amazon S3 específicos sin tener que crear ni gestionar copias. Estos objetos compartidos de Amazon S3 se pueden cifrar en el lado del servidor con claves administradas por el cliente almacenadas en AWS Key Management Service (AWS KMS) o con Claves administradas por AWS (SSE-S3). Para obtener más información sobre la monitorización de las claves de KMS y conocer los contextos de cifrado, consulte Administración de claves para el acceso a datos de Amazon S3. Cuando un cliente se suscribe a sus productos de datos, AWS Data Exchange aprovisiona automáticamente un punto de acceso de Amazon S3 y actualiza sus políticas de recursos en su nombre para conceder acceso de solo lectura a los suscriptores. Los suscriptores pueden usar alias de puntos de acceso de Amazon S3 en los lugares donde utilizan nombres de bucket de Amazon S3 con el fin de acceder a datos en Amazon S3.

Cuando la suscripción finaliza, se revocan los permisos del suscriptor. Si decide rescindir anticipadamente un acuerdo con un suscriptor, póngase en contacto con AWS Support. Puede añadir las condiciones de las suscripciones en el Acuerdo de suscripción a datos (DSA).

Para poder publicar un producto que contenga un acceso a datos de Mazon S3, debe cumplir los requisitos previos siguientes:

Requisitos previos
  • Confirme que los buckets de Amazon S3 que alojan los datos estén configurados con la opción ACL deshabilitadas activada de forma forzada por el propietario del bucket de Amazon S3. Para obtener más información, consulte Control de la propiedad de los objetos y desactivación de las ACL del bucket en la Guía del usuario de Amazon Simple Storage Service.

  • Los objetos compartidos deben pertenecer a la clase Amazon S3 Standard Storage o se deben gestionar mediante S3 Intelligent Tiering para que los suscriptores puedan acceder a ellos correctamente. Si están en otras clases de almacenamiento o si se ha activado Intelligent Tiering con Deep Archive, tus suscriptores verán errores porque no tendrán permiso para RestoreObject.

  • Confirme que los buckets de Amazon S3 que alojan los datos tengan el cifrado inhabilitado o estén cifrados con claves administradas de Amazon S3 (SSE-S3) o claves administradas por el cliente almacenadas en AWS Key Management Service (AWS KMS).

  • Si utiliza claves administradas por el cliente, debe disponer de lo siguiente:

    1. Permisos de IAM para kms:CreateGrant en las claves KMS. Puede acceder a estos permisos mediante la política de claves, las credenciales de IAM o una concesión de AWS KMS sobre la clave de KMS. Para obtener más información sobre la administración de claves y comprender cómo AWS Data Exchange utiliza las concesiones de KMS de AWS, consulte Crear AWS KMS subvenciones.

      Para dar acceso, añada permisos a los usuarios, grupos o roles:

      Los usuarios necesitan acceso programático si desean interactuar con AWS fuera de la AWS Management Console. La forma de conceder el acceso programático depende del tipo de usuario que acceda a AWS.

      Para conceder acceso programático a los usuarios, seleccione una de las siguientes opciones.

      ¿Qué usuario necesita acceso programático? Para Mediante

      Identidad del personal

      (Usuarios administrados en el Centro de identidades de IAM)

      Utilice credenciales temporales para firmar las solicitudes programáticas a la AWS CLI, los SDK de AWS o las API de AWS.

      Siga las instrucciones de la interfaz que desea utilizar:

      IAM Utilice credenciales temporales para firmar las solicitudes programáticas a la AWS CLI, los SDK de AWS o las API de AWS. Siga las instrucciones de Uso de credenciales temporales con recursos de AWS de la Guía del Usuario de IAM.
      IAM

      (no recomendado)

      Utilice credenciales a largo plazo para firmar las solicitudes programáticas a la AWS CLI, los SDK de AWS o las API de AWS.

      Siga las instrucciones de la interfaz que desea utilizar:

      A continuación, se muestra un ejemplo de política de JSON que muestra cómo se puede agregar a la política de claves de la clave de KMS.

      { "Sid": "AllowCreateGrantPermission", "Effect": "Allow", "Principal": { "AWS": "<IAM identity who will call Dataexchange API>" }, "Action": "kms:CreateGrant", "Resource": "*" }

      La política siguiente muestra un ejemplo de incorporación de una política sobre la identidad de IAM que se utiliza.

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Sid": "AllowCreateGrantPermission", "Action": [ "kms:CreateGrant ], "Resource": [ <Enter KMS Key ARNs in your account> ] } ] }
      nota

      También se permiten las claves de KMS entre cuentas si se ha adquirido el permiso de kms:CreateGrant sobre las claves de KMS mediante el paso anterior. Si la clave es propiedad de otra cuenta, es necesario tener permisos sobre la política de claves y sus credenciales de IAM, tal y como se detalla en los ejemplos anteriores.

    2. Asegúrese de utilizar las claves de KMS para cifrar los objetos nuevos y existentes en el bucket de Amazon S3 mediante la característica de claves de bucket de Amazon S3. Para obtener más información, consulte Configuración de claves de bucket de S3 en la Guía del usuario de la consola de Amazon Simple Storage Service.

      • Para los objetos nuevos agregados a su bucket de Amazon S3, puede configurar el cifrado de claves de bucket de Amazon S3 de forma predeterminada. Si los objetos existentes se han cifrado sin utilizar la función de clave de bucket de Amazon S3, es necesario migrar estos objetos para utilizar la clave de bucket de Amazon S3 para el cifrado.

        Para habilitar la clave de bucket de Amazon S3 para los objetos existentes, utilice la operación copy. Para obtener más información, consulte Configuración de una clave de bucket de Amazon S3 en el nivel de objeto mediante operaciones por lotes.

      • No se admiten las claves KMS administradas por AWS ni las Claves propiedad de AWS. Es posible migrar de un esquema de cifrado no compatible a los que se admiten actualmente. Para obtener más información, consulte Cambiar el cifrado de Amazon S3 en el blog sobre almacenamiento de AWS.

    3. Configure los buckets de Amazon S3 que alojan los datos para confiar en los puntos de acceso propiedad de AWS Data Exchange. Debe actualizar estas políticas de bucket de Amazon S3 para conceder a AWS Data Exchange permisos para crear puntos de acceso de Amazon S3 y conceder o eliminar el acceso de los suscriptores en su nombre. Si falta la declaración de política, debe editar la política de buckets para añadir las ubicaciones de Amazon S3 a su conjunto de datos.

      A continuación, se muestra una política de ejemplo. Sustituya <Bucket ARN> por el valor adecuado.

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "s3:GetObject", "s3:ListBucket" ], "Resource": [ "<Bucket ARN>", "<Bucket ARN>/*" ], "Condition": { "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } } ] }

Puede delegar el uso compartido de datos mediante AWS Data Exchange en todo un bucket de Amazon S3. Sin embargo, puede limitar la delegación a los prefijos y objetos específicos del bucket que desee compartir en el conjunto de datos. A continuación se muestra un ejemplo de una política limitada. Sustituya <Bucket ARN> y "mybucket/folder1/*" con su propia información.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "DelegateToAdxGetObjectsInFolder1", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "s3:GetObject" ], "Resource": [ "arn:aws:s3:::mybucket/folder1/*" ], "Condition": { "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } }, { "Sid": "DelegateToAdxListObjectsInFolder1", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": "s3:ListBucket", "Resource": "arn:aws:s3:::mybucket", "Condition": { "StringLike": { "s3:prefix": [ "folder1/*" ] }, "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } } ] }

De forma parecida, para limitar el acceso a un solo archivo, el proveedor puede usar la política siguiente.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "DelegateToAdxGetMyFile", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "s3:GetObject" ], "Resource": [ "arn:aws:s3:::mybucket/folder1/myfile" ], "Condition": { "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } } ] }

En los temas siguientes se describe el proceso de creación de un conjunto de datos de Amazon S3 y la publicación de un nuevo producto con conjuntos de datos de Amazon S3 mediante la consola de AWS Data Exchange. El proceso consta de los pasos siguientes:

Paso 1: Creación de un conjunto de datos de Amazon S3

Para crear un conjunto de datos de Amazon S3
  1. En el panel de navegación de la izquierda, en Publicar datos, elija Conjuntos de datos propios.

  2. En el panel de navegación de la izquierda, en Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija Crear conjunto de datos para abrir el asistente Pasos para crear un conjunto de datos.

  4. En Seleccionar tipo de conjunto de datos, elija Acceso a datos de Amazon S3.

  5. En Definir conjunto de datos, introduzca un Nombre y una Descripción para el conjunto de datos. Para obtener más información, consulte Prácticas recomendadas con conjuntos de datos.

  6. (Opcional) En Agregar etiquetas - opcional, agregue etiquetas.

  7. Elija Crear conjunto de datos y continúe.

Paso 2: Configuración del acceso a los datos de Amazon S3

Elija los buckets de Amazon S3 o las ubicaciones de buckets de Amazon S3 que desea poner a disposición de los suscriptores. Puede seleccionar un bucket de Amazon S3 completo o especificar hasta cinco prefijos u objetos dentro de un bucket de Amazon S3. Para agregar más buckets de Amazon S3, es necesario crear otro recurso compartido de datos de Amazon S3.

Para configurar el acceso a datos compartidos de Amazon S3
  1. En la página Configurar el acceso a datos de Amazon S3, seleccione Elegir ubicaciones de Amazon S3.

  2. En Elegir ubicaciones de Amazon S3, introduzca el nombre de su bucket de Amazon S3 en la barra de búsqueda o seleccione su bucket de Amazon S3, prefijos o archivos de Amazon S3 y elija Agregar selección. A continuación, elija Agregar aplicación.

    nota

    Recomendamos elegir una carpeta de nivel superior donde se almacenen la mayoría de los objetos y prefijos con el fin de que los proveedores no tengan que volver a configurar los prefijos u objetos que van a compartir.

  3. En Detalles de configuración, elija la configuración El solicitante paga. Dispone de dos opciones:

    • Permitir que el solicitante pague (recomendado): los solicitantes pagarán todas las solicitudes y transferencias del bucket de Amazon S3. Recomendamos esta opción porque ayuda a proteger frente a costes imprevistos derivados de las solicitudes y transferencias de los suscriptores.

    • Deshabilitar el pago por el solicitante: usted paga las solicitudes y transferencias de los suscriptores en el bucket de Amazon S3.

      Para obtener más información sobre El solicitante paga, consulte Objetos en los buckets El solicitante paga en la Guía del usuario de Amazon Simple Storage Service.

  4. Seleccione la Política de bucket que mejor se adapte a sus necesidades. Seleccione General para utilizar una política para todo su bucket de Amazon S3. Se trata de una configuración que se realiza por una sola vez y no es necesaria ninguna configuración adicional para compartir prefijos u objetos en el futuro. Elija Específica para usar una política de bucket específica para las ubicaciones de Amazon S3 seleccionadas. Su bucket compartido de Amazon S3 necesita una política de bucket para crear correctamente un conjunto de datos de acceso a los datos de Amazon S3 y no es posible tener las ACL habilitadas.

    1. Para deshabilitar las ACL, vaya a los permisos de su bucket y configure Propiedad del objeto como Aplicada al propietario del Bucket.

    2. Para añadir una política de bucket, copie la declaración del bucket en el portapapeles. En la consola de Amazon S3, en la pestaña Permisos de Amazon S3, seleccione Editar en la sección de políticas de bucket, pegue la política de bucket en la declaración y Guarde los cambios.

  5. Si el bucket de Amazon S3 contiene objetos cifrados mediante claves AWS KMS administradas por el cliente, debe compartir todas esas claves KMS con AWS Data Exchange. Para obtener información sobre los requisitos previos necesarios para utilizar claves de KMS para cifrar objetos en su bucket de Amazon S3, consulte Publicar un producto que contenga acceso a datos de Amazon S3. Para compartir estas claves de KMS con AWS Data Exchange, haga lo siguiente:

    1. En la página Configurar acceso a datos de Amazon S3, en Claves de KMS administradas por el cliente, seleccione Elegir en su AWS KMS keys o Introducir ARN de AWS KMS key y seleccione todas las AWS KMS keys que se estén utilizando actualmente para cifrar las ubicaciones compartidas de Amazon S3. AWS Data Exchangeutiliza estas claves de KMS para crear permisos para que los suscriptores accedan a sus ubicaciones compartidas. Para obtener más información, consulte Concesiones en AWS KMS.

    nota

    AWS KMS tiene un límite de 50 000 concesiones por clave de KMS, incluidas las concesiones preexistentes.

  6. Revise sus ubicaciones de Amazon S3, las claves de KMS seleccionadas y los detalles de configuración, y elija Guardar y continuar.

Paso 3: Revisar y finalizar el conjunto de datos

Revise y finalice el conjunto de datos que acaba de crear. Si desea crear y agregar otro acceso a datos de Amazon S3 para compartir el acceso a buckets, prefijos u objetos adicionales de Amazon S3, seleccione Agregar otro acceso a datos de Amazon S3.

nota

Lo recomendamos cuando necesite compartir el acceso a los datos alojados en un bucket de Amazon S3 distinto del seleccionado anteriormente en el acceso inicial a los datos de Amazon S3.

Si desea realizar cambios antes de la publicación, puede guardar el conjunto de datos como borrador seleccionando Guardar borrador. A continuación, seleccione Finalizar conjunto de datos para agregarlo a su producto.

Paso 4: Agregar un conjunto de datos de Amazon S3 a un producto de AWS Data Exchange

En el procedimiento siguiente, agregue su conjunto de datos a un producto de AWS Data Exchange nuevo o existente.

Para añadir un conjunto de datos a un producto de AWS Data Exchange nuevo o existente
  1. En la página Conjuntos de datos propios, en Información general sobre el conjunto de datos, puede Editar el nombre, Eliminar o Crear un producto a partir del conjunto de datos.

  2. Complete la creación del producto especificando la descripción del producto, los casos de uso, los metadatos, los precios y los términos y condiciones.

  3. Revise y publique el producto cuando haya terminado.

    nota

    Cuando un cliente se suscribe a su producto, recibe un permiso de acceso para leer y usar los datos mediante el punto de acceso de Amazon S3 creado en su nombre.

Paso 5: Publicar un producto nuevo que contenga acceso a datos de Amazon S3

Después de crear al menos un conjunto de datos y finalizar una revisión con activos, ya se podrá publicar un producto con acceso a datos de Amazon S3. Para obtener más información, consulte Detalles del producto. Asegúrese de disponer de todos los detalles necesarios sobre su producto y su oferta.

nota

No es necesario crear una nueva revisión al actualizar los objetos compartidos de Amazon S3, a menos que las ubicaciones de Amazon S3 se hayan modificado y los suscriptores no puedan acceder a estos objetos.

Para publicar un producto nuevo que contenga acceso a datos de Amazon S3
  1. En el panel de navegación izquierdo de la consola de AWS Data Exchange, en Publicar datos, elija Productos.

  2. En Productos, elija Publicar producto nuevo para abrir el asistente Publicar producto nuevo.

  3. En la sección Visibilidad del producto, elija las Opciones de visibilidad del producto y la configuración de Información confidencial y, a continuación, seleccione Siguiente. Para más información, consulte Visibilidad del producto y Categorías de información confidenciales.

  4. En la sección Agregar datos, en Conjuntos de datos propios, seleccione las casillas situadas junto a los conjuntos de datos que quiera agregar y, a continuación, elija Agregar selección.

    nota

    Los conjuntos de datos que elija deben tener una revisión finalizada. No se pueden agregar conjuntos de datos sin versiones finalizadas.

    1. Vaya a Conjuntos de datos seleccionados para revisar sus selecciones.

      Puede revisar el Nombre del conjunto de datos, el Tipo de conjunto de datos y la fecha y hora de la Última actualización del conjunto de datos.

    2. Vaya a Seleccionar reglas de acceso a revisiones, elija las reglas de acceso a las revisiones que desee establecer para los conjuntos de datos incluidos en este producto y, a continuación, elija Siguiente.

      Para obtener más información, consulte Reglas de acceso a las revisiones.

  5. En la sección Definir producto, en Descripción general del producto, introduzca la información sobre el producto, incluidos el Nombre del producto, el Logotipo del producto, la información de Contacto de soporte y Categorías de productos.

    Para obtener más información, consulte Detalles del producto.

  6. (Opcional) En la sección Definir producto, en Diccionarios de datos y muestras (opcional), seleccione un conjunto de datos pulsando el botón de opción situado junto al nombre del conjunto de datos y, a continuación, seleccione Editar.

    Para más información, consulte Diccionarios de datos y Muestras.

    1. En el cuadro de diálogo Editar, en Cargar diccionario de datos, elija Agregar archivo para cargar un diccionario de datos nuevo.

      Puede elegir un diccionario de datos, en formato .csv, con un tamaño máximo de 1 MB.

    2. Elija un diccionario de datos guardado en su ordenador y, a continuación, elija Abrir.

      El archivo .csv del diccionario de datos aparece en el cuadro de diálogo Editar.

      nota

      El diccionario de datos debe estar ajustado a la plantilla de diccionarios de datos de AWS Data Exchange. Si no tiene ningún diccionario de datos guardado para cargar, puede elegir el enlace de plantilla de diccionario de datos vacía o el enlace de diccionario de datos de ejemplo en la consola de AWS Data Exchange.

    3. Seleccione Vista previa del diccionario de datos para obtener una vista previa del diccionario de datos.

    4. En Muestras (opcional), elija Cargar muestras, seleccione una muestra de su ordenador y, a continuación, seleccione Abrir.

      Las muestras aparecen en el cuadro de diálogo Editar.

      nota

      Puede cargar hasta 10 muestras con un tamaño máximo de 50 MB. Es posible previsualizar las muestras en formato .csv.

    5. Introduzca una descripción en cada muestra que vaya a estar visible en la página de detalles del producto.

    6. Seleccione Guardar.

  7. En Definición del producto, introduzca una Descripción breve y una Descripción larga del producto.

    Si desea usar una plantilla para la descripción larga, seleccione Aplicar plantilla, elija el tipo de plantilla y, a continuación, proporcione los detalles específicos del producto en la plantilla.

  8. Elija Siguiente.

  9. Configura su oferta.

    • Si va a crear una oferta pública, en la sección Agregar oferta pública, configure la oferta. Todos los productos de AWS Data Exchange cuya visibilidad esté configurada como Pública requieren una oferta pública.

      1. Elija las opciones de Precios y duración del acceso de la suscripción.

      2. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      3. (Opcional) Configure la Verificación de la suscripción para controlar quién puede suscribirse a este producto. Para obtener más información, consulte Verificación de suscripciones para proveedores.

      4. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      5. Elija Siguiente.

    • Si va a crear una oferta privada, configure los detalles de la oferta en la sección Agregar oferta personalizada.

      1. En la sección Información de la cuenta del suscriptor, agregue al menos una cuenta de suscriptor a la que quiera extender la oferta.

      2. Elija las opciones de Precios y duración del acceso de la suscripción.

      3. Elija la Fecha de vencimiento de la oferta en la que el suscriptor debe aceptarla.

      4. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      5. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      6. Elija Siguiente.

  10. En la sección Revisar y publicar, revise la información del producto y, a continuación, expanda la Vista previa de la página del producto para ver cómo quedará después de publicarla.

  11. Si está seguro de que desea que el producto y la oferta pública sean visibles y estén disponibles para todos, seleccione Publicar.

Ya ha completado la parte manual de la publicación de un producto de datos con una oferta pública. AWS Data Exchange prepara y publica el producto. En la página Información general del producto, el estado del producto es Pendiente de aprobación. El estado cambia a Publicado después de publicar el producto.

Paso 6: (Opcional) Copiar un producto

Después de crear su primer producto, puede copiar sus detalles y las ofertas públicas para crear un producto nuevo.

nota

Es posible copiar un producto público, privado, publicado o no publicado. Las ofertas personalizadas asociadas al producto no se pueden copiar, pero sí las públicas.

Para copiar un producto
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación izquierdo, en Publicar datos, elija Productos.

  3. En Productos, elija la opción situada al lado del producto cuyo contenido desea copiar.

  4. Seleccione el menú desplegable Acciones y, a continuación, elija Crear copia.

  5. Continúe el flujo de trabajo Publicar un producto, con los detalles ya rellenados, en función del producto que haya elegido en el paso 3. Para obtener más información, consulte Paso 5: Publicar un producto nuevo.

Publicar un producto que contenga conjuntos de datos y permisos de AWS Lake Formation (vista previa)

Información general

Si está interesado en publicar productos que contengan conjuntos de datos de permisos de datos de AWS Lake Formation durante esta vista previa, póngase en contacto con AWS Support.

Un conjunto de datos de permisos de datos de AWS Lake Formation contiene un conjunto de etiquetas de LF y permisos sobre los datos administrados por AWS Lake Formation. Cuando los clientes se suscriben a un producto que contiene permisos de datos de Lake Formation, se les concede acceso de solo lectura a las bases de datos, tablas y columnas asociadas a las etiquetas de LF agregadas al conjunto de datos.

Como proveedor de datos, empieza por crear etiquetas de LF en AWS Lake Formation y asociarlas a los datos que desea poner a disposición de los suscriptores. Para obtener más información sobre cómo etiquetar sus recursos en Lake Formation, consulte el Control de acceso basado en etiquetas de Lake Formation en la Guía para desarrolladores de AWS Lake Formation. A continuación, se importan esas etiquetas de LF y un conjunto de permisos de datos en AWS Data Exchange como un activo. Los suscriptores tienen acceso a los datos asociados a esas etiquetas de LF al suscribirse.

En los temas siguientes se describe el proceso de publicación de un producto que contiene permisos de datos de AWS Lake Formation. El proceso consta de los pasos siguientes:

Paso 1: Crear un conjunto de datos de AWS Lake Formation (vista previa)

Para crear un conjunto de datos de AWS Lake Formation
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación izquierdo, en Publicar datos, elija Productos.

  3. En Conjuntos de datos propios, elija Crear conjunto de datos para abrir el asistente Pasos para crear un conjunto de datos.

  4. En Seleccionar tipo de conjunto de datos, elija Permiso de datos de AWS Lake Formation.

  5. En Definir conjunto de datos, introduzca un Nombre y una Descripción para el conjunto de datos. Para obtener más información, consulte Prácticas recomendadas con conjuntos de datos.

  6. En Agregar etiquetas: opcional, seleccione Agregar nueva etiqueta.

  7. Elija Crear conjunto de datos y continúe.

Paso 2: Crear un permiso de datos de AWS Lake Formation (vista previa)

AWS Data Exchange utiliza etiquetas de LF para conceder permisos de datos. Elija las etiquetas de LF asociadas a los datos que desee compartir para conceder permisos sobre los datos a los suscriptores.

Para crear un permiso de datos de AWS Lake Formation
  1. En la página Crear permisos de datos de Lake Formation, elija Agregar etiqueta de LF.

  2. Introduzca la Clave y elija los Valores de las etiquetas de LF.

  3. Seleccione Vista previa de los recursos para ver cómo se interpretan las etiquetas de LF.

    1. En Vista previa de los recursos, seleccione los Recursos del catálogo de datos asociado.

      nota

      Asegúrese de revocar el grupo IAMAllowedPrincipals de los recursos siguientes. Para obtener más información, consulte Revocar credenciales de seguridad temporales de un rol de IAM en la Guía del usuario de IAM.

  4. Revise la interpretación de la expresión de etiquetas de LF en el cuadro de diálogo siguiente y de los Permisos asociados al conjunto de datos.

  5. En Acceso al servicio, seleccione su rol de servicio actual que permite a AWS Data Exchange asumir el rol y acceder, conceder y revocar los derechos a los permisos de datos de Lake Formation en su nombre. A continuación, elija Crear permiso de datos de Lake Formation. Para obtener más información acerca de cómo crear un rol de Servicio de AWS, consulte Crear un rol para delegar permisos a un servicio Servicio de AWS.

  6. En la sección Definir producto, en Descripción general del producto, introduzca la información sobre el producto, incluidos el Nombre del producto, el Logotipo del producto, la información de Contacto de soporte y Categorías de productos.

    Para obtener más información, consulte Detalles del producto.

  7. (Opcional) En la sección Definir producto, en Diccionarios de datos y muestras (opcional), seleccione un conjunto de datos pulsando el botón de opción situado junto al nombre del conjunto de datos y, a continuación, seleccione Editar.

    Para más información, consulte Diccionarios de datos y Muestras.

    1. En el cuadro de diálogo Editar, en Cargar diccionario de datos, elija Agregar archivo para cargar un diccionario de datos nuevo.

      Puede elegir un diccionario de datos, en formato .csv, con un tamaño máximo de 1 MB.

    2. Elija un diccionario de datos guardado en su ordenador y, a continuación, elija Abrir.

      El archivo .csv del diccionario de datos aparece en el cuadro de diálogo Editar.

      nota

      El diccionario de datos debe estar ajustado a la plantilla de diccionarios de datos de AWS Data Exchange. Si no tiene ningún diccionario de datos guardado para cargar, puede elegir el enlace de plantilla de diccionario de datos vacía o el enlace de diccionario de datos de ejemplo en la consola de AWS Data Exchange.

    3. Seleccione Vista previa del diccionario de datos para obtener una vista previa del diccionario de datos.

    4. En Muestras (opcional), elija Cargar muestras, seleccione una muestra de su ordenador y, a continuación, seleccione Abrir.

      Las muestras aparecen en el cuadro de diálogo Editar.

      nota

      Puede cargar hasta 10 muestras con un tamaño máximo de 50 MB. Es posible previsualizar las muestras en formato .csv.

    5. Introduzca una descripción en cada muestra que vaya a estar visible en la página de detalles del producto.

    6. Seleccione Guardar.

  8. En Definición del producto, introduzca una Descripción breve y una Descripción larga del producto.

    Si desea usar una plantilla para la descripción larga, seleccione Aplicar plantilla, elija el tipo de plantilla y, a continuación, proporcione los detalles específicos del producto en la plantilla.

  9. Elija Siguiente.

  10. Configura su oferta.

    • Si va a crear una oferta pública, en la sección Agregar oferta pública, configure la oferta. Todos los productos de AWS Data Exchange cuya visibilidad esté configurada como Pública requieren una oferta pública.

      1. Elija las opciones de Precios y duración del acceso de la suscripción.

      2. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      3. (Opcional) Configure la Verificación de la suscripción para controlar quién puede suscribirse a este producto. Para obtener más información, consulte Verificación de suscripciones para proveedores.

      4. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      5. Elija Siguiente.

    • Si va a crear una oferta privada, configure los detalles de la oferta en la sección Agregar oferta personalizada.

      1. En la sección Información de la cuenta del suscriptor, agregue al menos una cuenta de suscriptor a la que quiera extender la oferta.

      2. Elija las opciones de Precios y duración del acceso de la suscripción.

      3. Elija la Fecha de vencimiento de la oferta en la que el suscriptor debe aceptarla.

      4. Elija su configuración de impuestos sobre las ventas en EE. UU., su acuerdo de suscripción de datos (DSA) y su política de reembolsos.

      5. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de productos de AWS Data Exchange.

      6. Elija Siguiente.

  11. En la sección Revisar y publicar, revise la información del producto y, a continuación, expanda la Vista previa de la página del producto para ver cómo quedará después de publicarla.

  12. Si está seguro de que desea que el producto y la oferta pública sean visibles y estén disponibles para todos, seleccione Publicar.

Ya ha completado la parte manual de la publicación de un producto de datos con una oferta pública. AWS Data Exchange prepara y publica el producto. En la página Información general del producto, el estado del producto es Pendiente de aprobación. El estado cambia a Publicado después de publicar el producto.

Paso 3: Revisar y finalizar

Tras crear el permiso de datos de AWS Lake Formation (vista previa), puede Revisar y Finalizar el conjunto de datos.

Para revisar y finalizar
  1. Revise los Detalles del conjunto de datos y las Etiquetas del Paso 1 para comprobar su precisión.

  2. Revise las Expresiones de etiquetas de LF, Agregue otro permiso de datos de Lake Formation (opcional), los Recursos del catálogo de datos asociados y los detalles del trabajo.

    nota

    Los trabajos se eliminan 90 días después de su creación.

  3. Elija Finalizar.

Paso 5: (Opcional) Crear una revisión

Para crear una revisión
  1. En la sección Conjuntos de datos propios, elija el conjunto de datos del que desee añadir una revisión.

  2. Elija la pestaña Revisiones.

  3. En la sección Revisiones, elija Crear revisión.

  4. En la página Revisar permisos de datos de Lake Formation, elija Agregar etiqueta de LF.

  5. Revise los Permisos de la Base de datos y la Tabla.

  6. En Acceso al servicio, seleccione un rol de servicio existente y, a continuación, elija Crear permiso de datos de Lake Formation.

Paso 6: Publicar un nuevo producto que contenga conjuntos de datos de AWS Lake Formation (vista previa)

Después de crear al menos un conjunto de datos y finalizado una revisión con activos, ya se podrá publicar un producto con conjuntos de datos de AWS Lake Formation. Para obtener más información, consulte Detalles del producto. Asegúrese de disponer de todos los detalles necesarios sobre su producto.

Para publicar un nuevo producto que contenga conjuntos de datos de AWS Lake Formation (vista previa)
  1. Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

  2. En el panel de navegación izquierdo, en Publicar datos, elija Productos.

  3. En Productos, elija Publicar producto nuevo para abrir el asistente Publicar producto nuevo.

  4. En la sección Visibilidad del producto, elija las Opciones de visibilidad del producto y la configuración de Información confidencial y, a continuación, seleccione Siguiente. Para más información, consulte Visibilidad del producto y Categorías de información confidenciales.

  5. En la sección Agregar datos, en Conjuntos de datos propios, seleccione las casillas situadas junto a los conjuntos de datos que quiera agregar y, a continuación, elija Agregar selección.

    nota

    Los conjuntos de datos que elija deben tener una revisión finalizada. No se pueden agregar conjuntos de datos sin versiones finalizadas.

    1. Vaya a Conjuntos de datos seleccionados para revisar sus selecciones.

      Puede revisar el Nombre del conjunto de datos, el Tipo de conjunto de datos y la fecha y hora de la Última actualización del conjunto de datos.

    2. Vaya a Seleccionar reglas de acceso a revisiones, elija las reglas de acceso a las revisiones que desee establecer para los conjuntos de datos incluidos en este producto y, a continuación, elija Siguiente.

      Para obtener más información, consulte Reglas de acceso a las revisiones.

Consideraciones a la hora de publicar un conjunto de datos de permisos de datos de AWS Lake Formation (vista previa)

Para garantizar una experiencia de suscripción óptima, recomendamos encarecidamente no realizar ninguna de las siguientes modificaciones en los permisos que contenga su producto AWS Data Exchange para los conjuntos de datos de Lake Formation (vista previa) con suscriptores activos de ese producto.

  • Recomendamos no eliminar ni modificar los roles de IAM transferidos a AWS Data Exchange en los productos publicados que contienen conjuntos de datos de AWS Lake Formation. Si elimina o modifica estos roles de IAM, se producen los problemas siguientes:

    • Las Cuentas de AWS que tengan acceso a los permisos de datos de Lake Formation podrían conservar el acceso indefinidamente.

    • Las Cuentas de AWS suscritas a su producto que aún no hayan recibido acceso a los permisos de datos de Lake Formation no recibirán acceso.

    AWS Data Exchange no se hace responsable de ningún rol de IAM que elimine o modifique.

  • Le recomendamos que no revoque los permisos de datos de AWS Lake Formation concedidos a los roles de IAM transferidos a AWS Data Exchange en un producto publicado que contenga AWS Lake Formation conjuntos de datos. Si revoca los permisos de datos concedidos a dichos roles de IAM, se producen los siguientes problemas:

    • Las Cuentas de AWS que tengan acceso a los permisos de datos de Lake Formation podrían conservar el acceso indefinidamente.

    • Las Cuentas de AWS suscritas a su producto que aún no hayan recibido acceso a los permisos de datos de Lake Formation no recibirán acceso.

  • Recomendamos no revocar permisos de datos de AWS Lake Formation concedidos desde Cuentas de AWS con suscripciones activas a productos publicados que contengan conjuntos de datos de AWS Lake Formation. Si se revocan permisos de datos concedidos de Cuentas de AWS suscritas a su producto, esas cuentas perderán el acceso, lo que se traducirá en una mala experiencia para el cliente.

  • Recomendamos configurar la revisión multicuenta en AWS Glue Data Catalog con la revisión 3 al publicar productos que contengan conjuntos de datos de AWS Lake Formation. Si cambia de categoría la revisión multicuenta de su catálogo de lagos de datos y ha publicado productos que contienen conjuntos de datos de AWS Lake Formation, es posible que las Cuentas de AWS que se suscriban a su producto, pero aún no hayan recibido acceso a los permisos de datos de Lake Formation no puedan acceder a los datos.