Puestos de trabajo en AWS Data Exchange - AWS Data Exchange Guía del usuario
Propiedades del trabajoRegiones de AWS y puestos de trabajoImportación de activosExportación de activosExportar revisiones

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.

Puestos de trabajo en AWS Data Exchange

AWS Data Exchange los trabajos son operaciones de importación o exportación asíncronas.

Como proveedor, puede crear y administrar los conjuntos de datos que desee publicar en un producto. Puede descargar (exportar) o copiar sus activos o revisiones en Amazon Simple Storage Service (Amazon S3) o firmados. URL Además, los proveedores pueden importar activos de un Amazon API Gateway API o de un conjunto de datos de Amazon Redshift.

Como suscriptor, puede ver y acceder a los conjuntos de datos a los que tiene derecho mediante una suscripción. Puede utilizar las API operaciones para descargar (exportar) o copiar los conjuntos de datos autorizados a Amazon S3 para usarlos con una variedad de servicios de AWS análisis y aprendizaje automático.

Para crear o copiar activos o copiar revisiones de trabajos, puede utilizar AWS Management Console, AWS Command Line Interface (AWS CLI), su propia REST aplicación o una de las AWS SDKs.

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

Propiedades del trabajo

Los trabajos tienen las propiedades siguientes:

  • ID de trabajo: ID que se genera al crear el trabajo y que lo identifica de forma inequívoca.

  • Tipo de trabajo: se admiten los tipos de trabajos siguientes:

    • Importación desde Amazon S3

    • Importar un permiso de datos de AWS Lake Formation (vista previa)

    • Importar desde firmado URL

    • Importar desde Amazon API Gateway API

    • Importación desde un recurso AWS Data Exchange compartido de datos para Amazon Redshift

    • Importar un acceso a datos de Amazon S3

    • Exportar a Amazon S3.

    • Exportar a firmado URL

  • Amazon Resource Name (ARN): identificador único de los AWS recursos.

  • Estado del trabajo: los estados de los trabajos son WAITING, IN_PROGRESS, COMPLETED, CANCELLED, ERROR o TIMED_OUT. Al crear un trabajo, permanece en el estado WAITING hasta que se inicie.

  • Detalles del trabajo: detalles de la operación que el trabajo debe realizar, como los detalles del destino de la exportación o los detalles del origen de la importación.

ejemplo recurso de trabajo
{
    "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/6cEXAMPLE818f7c7a23b3d0EXAMPLE1c",
    "Id": "6cEXAMPLE818f7c7a23b3d0EXAMPLE1c",
    "State": "COMPLETED",
    "Type": "IMPORT_ASSETS_FROM_S3",
    "CreatedAt": "2019-10-11T14:12:24.640Z",
    "UpdatedAt": "2019-10-11T14:13:00.804Z",
    "Details": {
        "ImportAssetsFromS3": {
            "AssetSources": [
                {
                    "Bucket": "amzn-s3-demo-bucket",
                    "Key": "MyKey"
                }
            ],
            "DataSetId": "14EXAMPLE4460dc9b005a0dEXAMPLE2f",
            "RevisionId": "e5EXAMPLE224f879066f999EXAMPLE42"
        }
    }
}

Regiones de AWS y puestos de trabajo

Si importa o exporta un activo a o desde un depósito de Amazon S3 que se encuentra en una Región de AWS región diferente a la del conjunto de datos, Cuenta de AWS se le cobrarán los costes de transferencia de datos, de acuerdo con las políticas de precios de transferencia de datos de Amazon S3.

Si exporta activos a un usuario firmadoURL, Cuenta de AWS se le cobrarán los costes de transferencia de datos de Amazon S3 a Internet de acuerdo con las políticas de precios de Amazon S3.

Cuando finalice tu suscripción a un conjunto de datos de AWS Data Exchange For Files, conservarás el acceso a todos los archivos que ya hayas exportado. Revise su Acuerdo de suscripción a datos para comprobar si su acuerdo exige que elimine los datos exportados al finalizar una suscripción.

Importación de activos

Puede importar activos a una revisión de las maneras siguientes:

Importar activos desde un bucket de S3

Al importar activos de Amazon S3 a AWS Data Exchange, los permisos AWS Identity and Access Management (IAM) que utilice deben incluir la capacidad de escribir en los buckets de S3 del AWS Data Exchange servicio y leer desde el bucket de S3 donde están almacenados sus activos. Es posible importar desde cualquier bucket de S3 al que tenga permiso de acceso, independientemente de su propiedad. Para obtener más información, consulte Permisos de Amazon S3.

Puede importar hasta 100 activos en un solo trabajo.

Importación de activos desde un bucket de S3 ()AWS SDKs

Para importar activos de un bucket de Amazon S3 (AWS SDKs)

  1. Cree una solicitud de CreateJob de tipo IMPORT_ASSETS_FROM_S3.

  2. Incluya lo siguiente en la solicitud:

    • AssetSources

      • Bucket

      • Key

    • DataSetID

    • RevisionID

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el valor de JobId devuelto en el paso 1.

  4. (Opcional) Actualice la propiedad del nombre de activo después de crearlo.

Importar activos desde un bucket de S3 (consola)

Para importar un activo desde un bucket de S3 (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 Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija el conjunto de datos de la revisión que desee actualizar.

  4. En la pestaña Revisiones, elija Crear revisión para abrir la página Crear revisión.

    1. En Configuración de la revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

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

    3. Seleccione Crear.

      Se crea la nueva revisión.

  5. En la sección Trabajos, seleccione Importar desde Amazon S3.

  6. Siga las indicaciones de la ventana Importar desde Amazon S3 y, a continuación, elija Importar activos.

    Se inicia un trabajo para importar el activo en el conjunto de datos. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Importación de activos desde un archivo firmado URL

Puede utilizar activos firmados URLs para importar activos que no estén almacenados en Amazon S3.

Importación de activos desde un archivo firmado URL (AWS SDKs)

Para importar activos desde un objeto firmado URL (AWS SDKs)

  1. Cree una solicitud de CreateJob de tipo IMPORT_ASSET_FROM_SIGNED_URL.

  2. Incluya lo siguiente en la solicitud:

    • AssetName

    • DataSetID

    • Md5Hash

    • RevisionID

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el valor de JobId devuelto en el paso 1.

  4. (Opcional) Actualice la propiedad del nombre de activo después de crearlo.

  5. Los detalles de la respuesta incluyen la SignedUrl que puede usar para importar el archivo.

nota

El firmado URL caduca un minuto después de su creación.

Importación de activos desde un archivo firmado URL (consola)

Para importar un activo desde un activo firmado URL (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 Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija el conjunto de datos que contenga el activo que desee actualizar.

  4. En la pestaña Revisiones, elija Crear revisión para abrir la página Crear revisión.

    1. En Configuración de la revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

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

    3. Seleccione Crear.

      Se crea la nueva revisión.

  5. En la sección Trabajos, elija Cargar.

  6. Siga las indicaciones de la ventana de carga y, a continuación, seleccione Abrir.

    Se inicia un trabajo para importar el activo en el conjunto de datos. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Importación de activos desde un Amazon API Gateway API

AWS Data Exchange los suscriptores pueden usar sus IAM credenciales y AWS SDKs llamar APIs desde los proveedores de datos. AWS Data Exchange gestiona el acceso APIs gestionando los derechos de autenticación y suscripción.

Importación de API activos desde un Amazon API Gateway API (AWS SDKs)

nota

Actualmente, la SendApiAsset operación no es compatible con lo siguienteSDKs:

  • AWS SDK for .NET

  • AWS SDK for C++

  • AWS SDK for Java 2.x

Para importar activos desde un Amazon API Gateway API (AWS SDKs)

  1. Cree una solicitud de CreateJob de tipo IMPORT_ASSET_FROM_API_GATEWAY_API.

  2. Incluya lo siguiente en la solicitud:

    • ApiID

    • DataSetID

    • ProtocolType

    • RevisionID

    • Stage

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el valor de JobId devuelto en el paso 1.

  4. (Opcional) Realice un sondeo de la operación GetJob para esperar a que se complete el trabajo.

  5. (Opcional) Actualice la propiedad del nombre de activo después de crearlo.

Importación de API activos desde un Amazon API Gateway API (consola)

Para importar un activo desde una Amazon API Gateway 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 Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija el conjunto de datos que contenga el activo que desee actualizar.

  4. En la pestaña Revisiones, elija Crear revisión para abrir la página Crear revisión.

    1. En Configuración de la revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

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

    3. Seleccione Crear.

      Se crea la nueva revisión.

  5. Para la sección de APIactivos, selecciona Añadir API etapa.

  6. En la página Añadir API etapa, selecciona Amazon API Gateway API y el nombre de la etapa de tu cuenta Cuenta de AWS o de otra cuenta.

  7. Para el documento API para suscriptores:

    1. Actualiza el APInombre por un nombre claro y conciso que los suscriptores puedan entender.

    2. Documente la especificación Open API 3.0 ingresándola en el campo e importándola seleccionando Importar desde. JSONarchivar o importar la especificación seleccionando Importar desde Amazon API Gateway.

  8. Seleccione Añadir API etapa.

    Se inicia un trabajo para importar sus API activos a su conjunto de datos. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Importación de activos desde un recurso AWS Data Exchange compartido de datos para Amazon Redshift

Al importar activos mediante AWS Data Exchange datashare para Amazon Redshift, puede empezar a consultar, analizar y poner en funcionamiento tablas de Amazon Redshift de terceros después de suscribirse.

Importación de activos desde un recurso AWS Data Exchange compartido de datos para Amazon Redshift ()AWS SDKs

Para importar activos de un recurso compartido de AWS Data Exchange datos para Amazon Redshift ()AWS SDKs

  1. Cree una solicitud de CreateJob de tipo IMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES.

  2. Incluya lo siguiente en la solicitud:

    • AssetSources

      • DataShareArn

    • DataSetID

    • RevisionID

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el valor de JobId devuelto en el paso 1.

  4. (Opcional) Realice un sondeo de la operación GetJob para esperar a que se complete el trabajo.

  5. (Opcional) Actualice la propiedad del nombre de activo después de crearlo.

Importación de activos desde un AWS Data Exchange recurso compartido de datos para Amazon Redshift (consola)

Para importar un activo desde un recurso compartido de ADE datos (para la consola 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 el conjunto de datos que contenga el activo que desee actualizar.

  4. En la pestaña Revisiones, elija Crear revisión para abrir la página Crear revisión.

    1. En Configuración de la revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

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

    3. Seleccione Crear.

      Se crea la nueva revisión.

  5. En la sección Recursos compartidos de datos de AWS Data Exchange para Amazon Redshift, elija Agregar recursos compartidos de datos.

  6. En la página Agregar un AWS Data Exchange recurso compartido de datos a la revisión, seleccione el recurso compartido o los recursos compartidos de datos que desee agregar.

  7. Elija Agregar recursos compartidos de datos.

    Se inicia un trabajo para importar sus activos en su conjunto de datos. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Importación de activos desde (vista previa) AWS Lake Formation

Al importar activos de AWS Lake Formation a AWS Data Exchange, los IAM permisos que utilice deben incluir las siguientes capacidades:

  • escritura, conceder y revocar permisos de Lake Formation

  • Crear recursos compartidos para tablas, bases de datos y catálogos

  • Actualizar, eliminar, asociar y desasociar recursos compartidos de cualquier recurso compartido que comience por Lake Formation

Para obtener más información sobre IAM los permisos necesarios y recomendados, consulteGestión de identidad y acceso en AWS Data Exchange.

Importación de activos desde AWS Lake Formation (Vista previa) (AWSSDKs)

Para importar activos desde AWS Lake Formation (Preview) (AWSSDKs)

  1. Cree una solicitud de CreateJob de tipo Import_Assets_From_Lake_Formation_Tag_Policy.

  2. Incluya lo siguiente en la solicitud:

    • AssetSources

      • CatalogId

      • Database

        • Expression

          • TagKey

          • TagValues

        • Permissions

      • Table

        • Expression

          • TagKey

          • TagValues

        • Permissions

    • RoleArn

    • DataSetId

    • RevisionId

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el JobId.

  4. (Opcional) Realice un sondeo de la operación GetJob para esperar a que se complete el trabajo.

  5. (Opcional) Actualice la propiedad del nombre de activo después de crearlo.

Importación de activos desde AWS Lake Formation (vista previa) (consola)

Para importar un activo desde AWS Lake Formation (Vista previa) (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 Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija el conjunto de datos de la revisión que desee actualizar.

  4. En la pestaña Revisiones, elija Crear revisión para abrir la página Crear revisión.

    1. En Configuración de la revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

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

    3. Seleccione Crear.

      Se crea la nueva revisión.

  5. En la sección Permiso de datos de Lake Formation, elija Agregar etiqueta LF.

  6. Elija la Clave y los Valores que desee agregar y elija Agregar etiqueta LF.

    1. (Opcional) Elija Vista previa de los recursos para ver los recursos del catálogo de datos asociados a los que va a conceder el permiso.

  7. En Acceso al servicio, seleccione el rol al que desee importar los AWS Lake Formation recursos AWS Data Exchange.

  8. Elija Crear permiso de datos de Lake Formation.

    Se inicia un trabajo para importar sus activos en su conjunto de datos. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Exportación de activos

Tanto los proveedores como los suscriptores pueden exportar los activos de una revisión publicada de un producto. Es posible exportar activos de dos formas:

Exportar activos a un bucket de S3

Al exportar activos a Amazon S3, los IAM permisos que utilice deben incluir la capacidad de leer los buckets de S3 del AWS Data Exchange servicio y escribir en el bucket de S3 donde se almacenan los activos. Es posible importar desde cualquier bucket de S3 al que tenga permiso de acceso, independientemente de su propiedad. Para obtener más información, consulte Permisos de Amazon S3.

AWS Data Exchange admite parámetros de cifrado configurables al exportar conjuntos de datos a Amazon S3. En los detalles de su trabajo de exportación, puede especificar la configuración de cifrado del lado del servidor de Amazon S3 que desee aplicar a los objetos exportados. Puede optar por utilizar el cifrado del lado del servidor con claves gestionadas por Amazon SSE S3 (-S3) o el cifrado del lado del servidor con claves almacenadas en (-). AWS KMS keys AWS Key Management Service SSE KMS Para obtener más información, consulte Protección de los datos con el cifrado del servidor en la Guía del usuario de Amazon Simple Storage Service.

importante

Le recomendamos tener en cuenta las características de seguridad de Amazon S3 al exportar datos a Amazon S3. Para obtener información sobre las directrices generales y las prácticas recomendadas, consulte las prácticas recomendadas de seguridad para Amazon S3 en la Guía del usuario de Amazon Simple Storage Service.

importante

Si el proveedor ha marcado un producto como que contiene información de salud protegida (PHI) sujeto a la Ley de Portabilidad y Responsabilidad de los Seguros Médicos de 1996 (HIPAA), no podrá exportar los conjuntos de datos del producto Cuenta de AWS a su cuenta, a menos que Cuenta de AWS se designe como una HIPAA cuenta (según se define en el Apéndice de AWS Socio Comercial que se encuentra en). AWS Artifact

Puede exportar hasta 100 activos en un solo trabajo.

En el vídeo siguiente se explica más sobre cómo exportar activos desde AWS Data Exchange.

Exportación de activos a un bucket de S3 ()AWS SDKs

Para exportar activos a un bucket de S3 (AWS SDKs)

  1. Cree una solicitud de CreateJob de tipo EXPORT_ASSETS_TO_S3.

  2. Incluya lo siguiente en la solicitud:

    • AssetDestinations

      • AssetID

      • Bucket

      • Key

    • DataSetID

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionID

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el valor de JobId devuelto en el paso 1.

  4. (Opcional) Actualice la propiedad del nombre de activo después de crearlo.

nota

Para obtener información sobre la exportación de una revisión completa como un solo trabajo, consulte Exportar revisiones.

Exportar activos a un bucket de S3 como suscriptor (consola)

Para exportar activos a un bucket de S3 como suscriptor (consola)

  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 Mis suscripciones, elija Datos con derechos.

  3. En Datos con derechos, seleccione el producto que contenga la revisión que desee exportar.

  4. En Conjuntos de datos con derechos, elija el conjunto de datos.

  5. En la pestaña Revisiones, seleccione la revisión.

  6. En la pestaña Activos, active la casilla de verificación junto a los activos que desee exportar.

  7. Seleccione Exportar acciones y, a continuación, elija Exportar activos seleccionados a Amazon S3.

  8. Siga las indicaciones de la ventana Exportar a Amazon S3 y, a continuación, elija Exportar.

    Se inicia un trabajo para exportar el activo. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Exportar activos a un bucket de S3 como proveedor (consola)

Para exportar activos a un bucket de S3 como proveedor (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 Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija el conjunto de datos que contenga el activo que desee exportar.

  4. Vaya a la pestaña Productos para asegurarse de que el conjunto de datos esté asociado a un producto publicado.

  5. En la pestaña Revisiones, seleccione la revisión.

  6. En la sección Activos importados, seleccione la casilla de verificación junto al nombre del activo.

  7. Seleccione Exportar acciones y, a continuación, elija Exportar activos seleccionados a Amazon S3.

  8. Siga las indicaciones de la ventana Exportar a Amazon S3 y, a continuación, elija Exportar.

    Se inicia un trabajo para exportar el activo. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Exportación de activos a un sitio firmado URL

Puede utilizar activos firmados URLs para exportar que no estén almacenados en Amazon S3.

Exportación de activos a un archivo firmado URL (AWS SDKs)

Puede utilizar signed URLs para exportar activos a destinos distintos de los depósitos de S3.

Para exportar activos a un objeto firmado URL ()AWS SDKs

  1. Cree una solicitud de CreateJob de tipo EXPORT_ASSET_TO_SIGNED_URL.

  2. Incluya lo siguiente en la solicitud:

    • AssetID

    • DataSetID

    • RevisionID

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el valor de JobId devuelto en el paso 1.

  4. (Opcional) Actualice la propiedad del nombre de activo después de crearlo.

  5. Los detalles de la respuesta incluyen la SignedUrl que puede usar para importar el archivo.

nota

El firmado URL caduca un minuto después de su creación.

Exportación de activos a una persona URL que ha firmado como suscriptor (consola)

Para exportar un activo a una persona que ha firmado URL como suscriptor (consola)

  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 Mis suscripciones, elija Datos con derechos.

  3. En Datos con derechos, seleccione el producto que contenga la revisión que desee exportar.

  4. En Conjuntos de datos con derechos, elija el conjunto de datos.

  5. En la pestaña Revisiones, seleccione la revisión.

  6. En la pestaña Activos, active la casilla de verificación junto a los activos que desee exportar.

  7. Seleccione Exportar acciones y, a continuación, elija Descargar activos seleccionados.

    Se inicia un trabajo para exportar el activo. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Exportación de activos a un proveedor registrado URL (consola)

Para exportar un activo a un proveedor firmado URL como proveedor (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 Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija el producto que tenga la revisión que desee exportar.

  4. Vaya a la pestaña Productos para asegurarse de que el conjunto de datos esté asociado a un producto publicado.

  5. En la pestaña Revisiones, seleccione la revisión.

  6. En la sección Activos importados, seleccione la casilla de verificación junto al nombre del activo.

  7. Seleccione Exportar acciones y, a continuación, elija Descargar activos seleccionados.

    Se inicia un trabajo para exportar el activo. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Exportar revisiones

Tanto los proveedores como los suscriptores pueden exportar las revisiones de un conjunto de datos a un bucket de S3 al que tengan permiso de acceso.

AWS Data Exchange admite parámetros de cifrado configurables al exportar revisiones a Amazon S3. En los detalles de su trabajo de exportación, puede especificar la configuración de cifrado del lado del servidor de Amazon S3 que desee aplicar a los objetos exportados. Puede optar por utilizar el cifrado del lado del servidor con claves gestionadas por Amazon SSE S3 (-S3) o el cifrado del lado del servidor con KMS claves almacenadas en (-). AWS Key Management Service SSE KMS Para obtener más información, consulte Protección de datos mediante cifrado del lado del servidor en la guía del desarrollador de Amazon Simple Storage Service.

importante

Si el proveedor ha marcado un producto como que contiene información de salud protegida (PHI) sujeto a la Ley de Portabilidad y Responsabilidad de los Seguros Médicos de 1996 (HIPAA), no podrá exportar los conjuntos de datos del producto Cuenta de AWS a su cuenta, a menos que Cuenta de AWS se designe como una HIPAA cuenta (según se define en el Apéndice de AWS Socio Comercial que se encuentra en). AWS Artifact

En el vídeo siguiente se explica más sobre cómo exportar activos desde AWS Data Exchange (a partir de 2:18).

Exportación de revisiones a un bucket de S3 ()AWS SDKs

Para exportar una revisión a un bucket de S3 (AWS SDKs)

  1. Cree una solicitud de CreateJob de tipo EXPORT_REVISIONS_TO_S3.

  2. Incluya lo siguiente en la solicitud:

    • DataSetId

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionDestinations

      • Bucket

      • KeyPattern

      • RevisionId

  3. Inicie la solicitud de CreateJob con una operación de StartJob que requiera el valor de JobId devuelto en el paso 1.

  4. Los activos recién creados tienen una propiedad de nombre igual a la clave del objeto S3 original. El valor predeterminado de la clave de objeto de Amazon S3 es el patrón de clave ${Asset.Name}.

    Es posible actualizar la propiedad del nombre de activo después de crearlo.

    Para obtener más información sobre el uso de patrones de claves, consulte Patrones de claves a la hora de exportar revisiones.

nota

Si la utiliza DataSet.Name como referencia dinámica, debe tener el IAM permisodataexchange:GetDataSet. Para obtener más información, consulte AWS Data Exchange APIpermisos: referencia de acciones y recursos.

Exportar revisiones a un bucket de S3 como proveedor (consola)

Para exportar una revisión a un bucket de S3 como proveedor (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 Publicar datos, elija Conjuntos de datos propios.

  3. En Conjuntos de datos propios, elija el producto que tenga la revisión que desee exportar.

  4. Vaya a la pestaña Productos para asegurarse de que el conjunto de datos esté asociado a un producto publicado.

  5. En la pestaña Revisiones, seleccione la revisión.

  6. En la sección Activos importados, seleccione la casilla de verificación junto al nombre del activo.

  7. Seleccione Exportar acciones y, a continuación, elija Exportar activos seleccionados a Amazon S3.

  8. Siga las indicaciones de la ventana Exportar a Amazon S3 y, a continuación, elija Exportar.

    Se inicia un trabajo para exportar el activo. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Exportar revisiones a un bucket de S3 como suscriptor (consola)

Para exportar una revisión a un bucket de S3 como suscriptor (consola)

  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 Mis suscripciones, elija Datos con derechos.

  3. En Datos con derechos, seleccione el producto que contenga la revisión que desee exportar.

  4. En Conjuntos de datos con derechos, elija el conjunto de datos.

  5. En la pestaña Revisiones, seleccione la revisión y, a continuación, elija Exportar a Amazon S3.

  6. En Exportar revisión a Amazon S3, seleccione una opción de destino, el destino de la carpeta de bucket de Amazon S3, configure las opciones de cifrado y, a continuación, elija Exportar.

    Se inicia un trabajo para exportar la revisión. Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Exportar revisiones a un bucket de S3 como suscriptor automáticamente

Cuando el proveedor publique revisiones nuevas, puede seleccionar exportar automáticamente las nuevas revisiones a su bucket de Amazon S3. Puede exportar las revisiones nuevas a un máximo de cinco buckets de S3. Las nuevas revisiones aparecerán automáticamente en los buckets de S3 que haya seleccionado.

nota

Para exportar automáticamente las revisiones a un bucket de S3 que elija, su bucket de S3 debe tener una política de bucket con permisos establecidos que permitan exportar datos AWS Data Exchange a él. Para obtener más información, consulte Prerrequisitos sobre los permisos de las políticas del bucket de S3.

Prerrequisitos sobre los permisos de las políticas del bucket de S3

Para poder exportar automáticamente las revisiones a un bucket de S3, debe deshabilitar los pagos por parte del solicitante y su bucket de S3 debe tener una política de bucket con permisos configurados para permitir la exportación de datos AWS Data Exchange a él. Los procedimientos siguientes proporcionan información sobre cómo editar las políticas del bucket de S3 existentes o crear una política de bucket de S3 con estos permisos.

Si su bucket de S3 está configurado para SSE el KMS cifrado, el usuario que configure el trabajo de exportación automática debe tener CreateGrant permiso sobre la KMS clave AWS Data Exchange para copiar los objetos en su bucket de S3.

importante

Para comprobar que se cumplen los prerrequisitos sobre los permisos de las políticas del bucket de S3, se agrega un objeto con el formato de denominación _ADX-TEST-ACCOUNTID# al bucket de S3 durante el proceso de exportación automática.

Exitar una política de bucket de S3 existente

Si su bucket de S3 tiene una política de bucket, complete el procedimiento siguiente para permitir a AWS Data Exchange exportar datos a él.

Para editar una política de bucket de S3 existente

  1. Vaya hasta el bucket al que desea exportar las revisiones.

  2. Seleccione la pestaña Permisos y elija Editar en la sección de políticas del bucket.

  3. Copie la declaración siguiente y péguela al final de la lista de declaraciones.

    
    {
      "Effect": "Allow",
      "Principal": {
      "Service": "dataexchange.amazonaws.com"
      },
      "Action": [
        "s3:PutObject",
        "s3:PutObjectAcl"
      ],
      "Resource": "arn:aws:s3:::<BUCKET-NAME>/*",
      "Condition": {
        "StringEquals": { 
          "aws:SourceAccount": "<AWS ID>"
        }
      }
    }

  4. <BUCKET-NAME>Sustitúyalo por el nombre de tu bucket de S3 y <AWS ID> sustitúyelo por tu AWS ID.

  5. Elija Guardar cambios.

  6. Si desea añadir más buckets como destino para sus trabajos de exportación automática, repita el procedimiento, empezando por el paso 1.

Creación de una política sobre un bucket de S3

Si su bucket de S3 no tiene una política de bucket, complete el siguiente procedimiento para crear una política de bucket de S3 que le permita AWS Data Exchange exportar datos a dicho depósito.

Para crear una política de bucket de S3

  1. Vaya hasta el bucket al que desea exportar las revisiones.

  2. Seleccione la pestaña Permisos y elija Editar en la sección de políticas del bucket.

  3. Copie la política de bucket siguiente y péguela en el editor de políticas de bucket.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
      "Service": "dataexchange.amazonaws.com"
      },
      "Action": [
        "s3:PutObject",
        "s3:PutObjectAcl"
      ],
      "Resource": "arn:aws:s3:::<BUCKET-NAME>/*",
      "Condition": {
        "StringEquals": { 
          "aws:SourceAccount": "<AWS ID>"
        }
      }
    }
  ]
}

  4. <BUCKET-NAME>Sustitúyalo por el nombre de tu bucket de S3 y <AWS ID> sustitúyelo por tu AWS ID.

  5. Elija Guardar cambios.

  6. Si desea añadir más buckets como destino para sus trabajos de exportación automática, repita el procedimiento, empezando por el paso 1.

Exportación automática de revisiones a un bucket de S3 como suscriptor (consola)

nota

Para exportar automáticamente las revisiones al bucket de S3 que elijas, tu bucket de S3 debe tener una política de bucket con permisos establecidos que permitan exportar datos AWS Data Exchange a él. Para obtener más información, consulte Prerrequisitos sobre los permisos de las políticas del bucket de S3.

Para exportar una revisión automáticamente a un bucket de S3 como suscriptor (consola)

  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 Mis suscripciones, elija Datos con derechos.

  3. En Datos con derechos, seleccione el producto que contenga la revisión que desee exportar.

  4. En Conjuntos de datos con derechos, elija el conjunto de datos.

  5. En la pestaña Revisiones, en Destinos de trabajo de exportación automática, elija Acciones y, a continuación, elija Agregar destino de trabajo de exportación automática.

  6. En Agregar destino de trabajo de exportación automática, elija la opción de destino Simple o Avanzado.

    1. Si elige la opción Simple, seleccione el destino de la carpeta de bucket de Amazon S3 en la lista desplegable y las opciones de cifrado y, a continuación, elija Agregar destino de bucket.

    2. Si elige la opción Avanzado, seleccione el destino de la carpeta de bucket de Amazon S3 en la lista desplegable, seleccione el Patrón de nomenclatura de la clave y agréguelo a la ruta.

  7. Revise la Salida.

  8. Defina Opciones de cifrado, revise los Precios de Amazon S3 y, a continuación, elija Agregar destino de bucket.

    El destino del bucket de Amazon S3 aparece en la pestaña Revisiones, dentro de Destinos de trabajo de exportación automática.

    Se inicia un trabajo para exportar automáticamente la revisión.

    Para comprobar que se cumplen los prerrequisitos sobre los permisos de las políticas del bucket de S3, se agrega un objeto con el formato de denominación _ADX-TEST-ACCOUNTID# al bucket de S3.

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

    Para agregar otro destino, elija Acciones y, a continuación, Agregar destino de trabajo de exportación automática.

    Para editar, seleccione el destino que desee editar, elija Acciones y, a continuación, Editar configuración de destino.

    Para eliminar, elija Acciones y, a continuación, elija Eliminar el destino del trabajo de exportación automática.

Exportación automática de revisiones a un bucket de S3 como suscriptor (AWS SDKs)

nota

Para exportar automáticamente las revisiones al bucket de S3 que elija, su bucket de S3 debe tener una política de bucket con permisos establecidos que permitan exportar datos AWS Data Exchange a él. Para obtener más información, consulte Prerrequisitos sobre los permisos de las políticas del bucket de S3.

Para exportar automáticamente una revisión a un bucket de S3 (AWS SDKs)

  1. Cree una solicitud de Create_Event_Action.

  2. Incluya lo siguiente en la solicitud:

    • Action

      • ExportRevisionToS3

        • Encryption

          • KmsKeyArn

          • Type

      • RevisionDestination

        • Bucket

        • KeyPattern

    • Event

      • RevisionPublished

        • DataSetId

  3. Modifique el patrón de claves si es necesario. El valor predeterminado de la clave de objeto de Amazon S3 es el patrón de clave {Revision.CreatedAt}/{Asset.Name}.

    Para obtener más información sobre el uso de patrones de claves, consulte Patrones de claves a la hora de exportar revisiones.

    Para comprobar que se cumplen los prerrequisitos sobre los permisos de las políticas del bucket de S3, se agrega un objeto con el formato de denominación _ADX-TEST-ACCOUNTID# al bucket de S3.

Patrones de claves a la hora de exportar revisiones

Al exportar una revisión, cada activo se convierte en un objeto en el bucket de S3. Los nombres de los objetos se basan en un patrón de claves proporcionado por usted. Puede utilizar referencias dinámicas que representen los atributos de los activos para crear un patrón para los nombres generados automáticamente durante la exportación. Utilice las referencias dinámicas que se muestran en la tabla siguiente.

Referencias dinámicas Descripción
${Asset.Id} ID del recurso.
${Asset.Name} Nombre del activo.
${DataSet.Id} Identificador del conjunto de datos que se va a exportar.
${DataSet.Name} Nombre del conjunto de datos que se va a exportar.
${Revision.CreatedAt} La UTC fecha y la hora en que se creó la revisión, en el siguiente formato: YYYY -MM DDTHH -:MM:. SSZ Por ejemplo: 2021-10-08T16:33:19.787Z
${Revision.CreatedAt.Day} Día del mes en que se creó la revisión.
${Revision.CreatedAt.Month} Mes en que se creó la revisión.
${Revision.CreatedAt.Year} Año en que se creó la revisión.
${Revision.Id} Identificador de la revisión que se va a exportar.

Es posible utilizar estas referencias dinámicas para crear los patrones de claves para los nombres de sus activos. Es necesario incluir al menos una de las dos referencias dinámicas de Asset, que son ${Asset.Name} y ${Asset.Id}.

Por ejemplo, utilizar ${Revision.Id}/${Asset.Name} como patrón de claves, los objetos de Amazon S3 utilizan el identificador de revisión y el nombre del activo (separados por una barra diagonal) como nombre del objeto.

Si exporta una revisión con el identificador testRevisionId que tiene dos activos llamados asset1 y asset2, los activos se exportan a las ubicaciones de Amazon S3 siguientes:

  • <bucket>/testRevisionId/asset1

  • <bucket>/testRevisionId/asset2

nota

Los objetos resultantes deben tener nombres únicos. Si tienen los mismos nombres que los objetos existentes en el bucket de S3, la exportación sobrescribirá los objetos existentes. Si la revisión que va a exportar tiene nombres repetidos (por ejemplo, dos activos con el mismo nombre), la exportación fallará. La única referencia dinámica única es ${Asset.Id}.