Lavori in AWS Data Exchange - AWS Data Exchange Guida per l'utente
Proprietà processoRegioni AWS e posti di lavoroImportazione di risorseEsportazione di risorseEsportazione delle revisioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lavori in AWS Data Exchange

AWS Data Exchange i lavori sono operazioni asincrone di importazione o esportazione.

In qualità di fornitore, puoi creare e gestire i set di dati che desideri pubblicare su un prodotto. Puoi scaricare (esportare) o copiare gli asset o le revisioni su Amazon Simple Storage Service (Amazon S3) o su un file firmato. URL Inoltre, i fornitori possono importare risorse da Amazon API Gateway API o importare risorse da un set di dati Amazon Redshift.

In qualità di abbonato, puoi visualizzare e accedere ai set di dati a cui hai diritto tramite un abbonamento. Puoi utilizzare le API operazioni per scaricare (esportare) o copiare i set di dati autorizzati su Amazon S3 per utilizzarli con una varietà di servizi di AWS analisi e apprendimento automatico.

Per creare o copiare risorse o copiare revisioni tramite job, puoi usare AWS Management Console, AWS Command Line Interface (AWS CLI), la tua REST applicazione o una delle. AWS SDKs

I lavori vengono eliminati 90 giorni dopo la loro creazione.

Proprietà processo

I lavori hanno le seguenti proprietà:

  • Job ID: un ID generato al momento della creazione del lavoro che identifica in modo univoco il lavoro.

  • Tipo di lavoro: sono supportati i seguenti tipi di lavoro:

    • Importazione da Amazon S3

    • Autorizzazione all'importazione e AWS Lake Formation ai dati (anteprima)

    • Importazione da firmato URL

    • Importazione da Amazon API Gateway API

    • Importazione da un AWS Data Exchange datashare per Amazon Redshift

    • Importazione di un accesso ai dati Amazon S3

    • Esportazione in Amazon S3

    • Esporta in formato firmato URL

  • Amazon Resource Name (ARN): un identificatore univoco per AWS le risorse.

  • Stato del lavoro: gli stati del lavoro sono WAITINGIN_PROGRESS,COMPLETED,CANCELLED,ERROR, oTIMED_OUT. Quando un lavoro viene creato, rimane nello WAITING stato fino all'avvio del lavoro.

  • Dettagli del lavoro: dettagli dell'operazione che deve essere eseguita dal lavoro, come i dettagli della destinazione di esportazione o i dettagli dell'origine di importazione.

Esempio risorsa lavorativa
{
    "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"
        }
    }
}

Regioni AWS e posti di lavoro

Se importi o esporti una risorsa da o verso un bucket Amazon S3 che si trova in una Regione AWS regione diversa dalla regione del set di dati, ti verranno addebitati i costi di trasferimento dei dati, in base alle politiche tariffarie di trasferimento dati di Amazon S3. Account AWS

Se esporti risorse in un formato firmatoURL, ti verranno addebitati i costi di trasferimento dei dati da Amazon S3 a Internet in base alle politiche tariffarie di Amazon S3. Account AWS

Al termine dell'abbonamento a un set di dati AWS Data Exchange for Files, conservi l'accesso a tutti i file che hai già esportato. Consulta il contratto di abbonamento ai dati per verificare se il contratto richiede l'eliminazione dei dati esportati al termine di un abbonamento.

Importazione di risorse

È possibile importare le risorse in una revisione nei seguenti modi:

Importazione di risorse da un bucket S3

Quando importi risorse da Amazon S3 a AWS Data Exchange, le autorizzazioni AWS Identity and Access Management (IAM) che utilizzi devono includere la possibilità di scrivere nei bucket S3 del AWS Data Exchange servizio e di leggere dal bucket S3 in cui sono archiviate le tue risorse. Puoi importare da qualsiasi bucket S3 a cui sei autorizzato ad accedere, indipendentemente dalla proprietà. Per ulteriori informazioni, consulta Autorizzazioni di Amazon S3.

Puoi importare fino a 100 risorse in un singolo processo.

Importazione di risorse da un bucket S3 ()AWS SDKs

Per importare risorse da un bucket Amazon S3 ()AWS SDKs

  1. Crea una CreateJob richiesta di tipo. IMPORT_ASSETS_FROM_S3

  2. Includi quanto segue nella richiesta:

    • AssetSources

      • Bucket

      • Key

    • DataSetID

    • RevisionID

  3. Avvia la CreateJob richiesta con un'StartJoboperazione che richiede quanto JobId restituito nel passaggio 1.

  4. (Facoltativo) Aggiorna la proprietà del nome delle risorse dopo averle create.

Importazione di risorse da un bucket S3 (console)

Per importare una risorsa da un bucket S3 (console)

  1. Apri il browser web e accedi alla AWS Data Exchange console.

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il set di dati con la revisione che desideri aggiornare.

  4. Nella scheda Revisioni, scegli Crea revisione per aprire la pagina Crea revisione.

    1. Per le impostazioni di revisione, fornisci un commento facoltativo per la revisione che descriva lo scopo della revisione.

    2. Per Aggiungi tag: facoltativo, aggiungi i tag associati alla risorsa.

    3. Scegli Create (Crea) .

      La tua nuova revisione è stata creata.

  5. Per la sezione Lavori, scegli Importa da Amazon S3.

  6. Segui le istruzioni nella finestra Importa da Amazon S3, quindi scegli Importa risorse.

    Viene avviato un processo per importare la risorsa nel set di dati. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Importazione di risorse da un oggetto firmato URL

Puoi usare signed URLs per importare risorse che non sono archiviate in Amazon S3.

Importazione di risorse da un file signed URL ()AWS SDKs

Per importare risorse da un oggetto firmato URL ()AWS SDKs

  1. Crea una CreateJob richiesta di tipoIMPORT_ASSET_FROM_SIGNED_URL.

  2. Includi quanto segue nella richiesta:

    • AssetName

    • DataSetID

    • Md5Hash

    • RevisionID

  3. Avvia la CreateJob richiesta con un'StartJoboperazione che richiede quanto JobId restituito nel passaggio 1.

  4. (Facoltativo) Aggiorna la proprietà del nome delle risorse dopo averle create.

  5. I dettagli della risposta includono quelli SignedUrl che puoi utilizzare per importare il file.

Nota

Il file firmato URL scade un minuto dopo la creazione.

Importazione di risorse da una console firmata URL

Per importare una risorsa da una console firmata URL

  1. Apri il tuo browser web e accedi alla AWS Data Exchange console.

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il set di dati contenente la risorsa che desideri aggiornare.

  4. Nella scheda Revisioni, scegli Crea revisione per aprire la pagina Crea revisione.

    1. Per le impostazioni di revisione, fornisci un commento facoltativo per la revisione che descriva lo scopo della revisione.

    2. Per Aggiungi tag: facoltativo, aggiungi i tag associati alla risorsa.

    3. Scegli Create (Crea) .

      La tua nuova revisione è stata creata.

  5. Per la sezione Lavori, scegli Carica.

  6. Segui le istruzioni nella finestra di caricamento, quindi scegli Apri.

    Viene avviato un processo per importare la risorsa nel set di dati. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Importazione di risorse da Amazon API Gateway API

AWS Data Exchange gli abbonati possono utilizzare le proprie IAM credenziali e AWS SDKs chiamare APIs dai fornitori di dati. AWS Data Exchange gestisce l'accesso APIs gestendo l'autenticazione e i diritti di abbonamento.

Importazione di API risorse da Amazon API Gateway API ()AWS SDKs

Nota

Attualmente, l'SendApiAssetoperazione non è supportata per quanto segue: SDKs

  • AWS SDK for .NET

  • AWS SDK for C++

  • AWS SDK for Java 2.x

Per importare risorse da un Amazon API Gateway API (AWS SDKs)

  1. Crea una CreateJob richiesta di tipoIMPORT_ASSET_FROM_API_GATEWAY_API.

  2. Includi quanto segue nella richiesta:

    • ApiID

    • DataSetID

    • ProtocolType

    • RevisionID

    • Stage

  3. Avvia la CreateJob richiesta con un'StartJoboperazione che richiede quanto JobId restituito nel passaggio 1.

  4. (Facoltativo) Esegui il GetJob polling dell'operazione per attendere il completamento del processo.

  5. (Facoltativo) Aggiorna la proprietà del nome delle risorse dopo averle create.

Importazione di API risorse da Amazon API Gateway API (console)

Per importare una risorsa da Amazon API Gateway API (console)

  1. Apri il browser Web e accedi alla AWS Data Exchange console.

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il set di dati contenente la risorsa che desideri aggiornare.

  4. Nella scheda Revisioni, scegli Crea revisione per aprire la pagina Crea revisione.

    1. Per le impostazioni di revisione, fornisci un commento facoltativo per la revisione che descriva lo scopo della revisione.

    2. Per Aggiungi tag: facoltativo, aggiungi i tag associati alla risorsa.

    3. Scegli Create (Crea) .

      La tua nuova revisione è stata creata.

  5. Per la sezione APIrisorse, scegli Aggiungi API fase.

  6. APINella pagina Aggiungi fase, seleziona Amazon API Gateway API e il nome dello stage dal tuo Account AWS o da un altro account.

  7. Per Document API for subscribers:

    1. Aggiorna il APInome con un nome chiaro e conciso che gli abbonati possano comprendere.

    2. Documenta la specifica Open API 3.0 inserendo la specifica nel campo, importando la specifica scegliendo Importa da. JSONfile o importando le specifiche selezionando Importa da Amazon API Gateway.

  8. Scegli Aggiungi API fase.

    Viene avviato un processo per importare le API risorse nel set di dati. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Importazione di risorse da un AWS Data Exchange datashare per Amazon Redshift

Quando importi asset utilizzando AWS Data Exchange datashare per Amazon Redshift, puoi iniziare a interrogare, analizzare e rendere operative tabelle Amazon Redshift di terze parti dopo la sottoscrizione.

Importazione di risorse da un AWS Data Exchange datashare per Amazon Redshift ()AWS SDKs

Per importare risorse da un AWS Data Exchange datashare per Amazon Redshift ()AWS SDKs

  1. Crea una CreateJob richiesta di tipo. IMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES

  2. Includi quanto segue nella richiesta:

    • AssetSources

      • DataShareArn

    • DataSetID

    • RevisionID

  3. Avvia la CreateJob richiesta con un'StartJoboperazione che richiede quanto JobId restituito nel passaggio 1.

  4. (Facoltativo) Esegui il GetJob polling dell'operazione per attendere il completamento del processo.

  5. (Facoltativo) Aggiorna la proprietà del nome delle risorse dopo averle create.

Importazione di risorse da un AWS Data Exchange datashare per Amazon Redshift (console)

Per importare una risorsa da un ADE datashare (per la console Amazon Redshift)

  1. Apri il browser Web e accedi alla console.AWS Data Exchange

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il set di dati contenente la risorsa che desideri aggiornare.

  4. Nella scheda Revisioni, scegli Crea revisione per aprire la pagina Crea revisione.

    1. Per le impostazioni di revisione, fornisci un commento facoltativo per la revisione che descriva lo scopo della revisione.

    2. Per Aggiungi tag: facoltativo, aggiungi i tag associati alla risorsa.

    3. Scegli Create (Crea) .

      La tua nuova revisione è stata creata.

  5. Per la sezione AWS Data Exchange datashare per Amazon Redshift, scegli Aggiungi datashare.

  6. Nella pagina Aggiungi AWS Data Exchange datashare alla revisione, seleziona il datashare o le condivisioni di dati che desideri aggiungere.

  7. Scegli Aggiungi datashare (s).

    Viene avviato un processo per importare le risorse nel set di dati. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Importazione di risorse da (Anteprima) AWS Lake Formation

Quando importate risorse da AWS Lake Formation a AWS Data Exchange, le IAM autorizzazioni che utilizzate devono includere le seguenti abilità:

  • Scrivi, concedi e revoca le autorizzazioni di Lake Formation

  • Crea condivisioni di risorse per tabelle, database e cataloghi

  • Aggiorna, elimina, associa e dissocia le condivisioni di risorse per qualsiasi condivisione di risorse a partire da Lake Formation

Per ulteriori informazioni sulle IAM autorizzazioni richieste e consigliate, vedere. Gestione delle identità e degli accessi in AWS Data Exchange

Importazione di risorse da AWS Lake Formation (Anteprima) () AWS SDKs

Per importare risorse da AWS Lake Formation (Anteprima) (AWSSDKs)

  1. Crea una CreateJob richiesta di tipoImport_Assets_From_Lake_Formation_Tag_Policy.

  2. Includi quanto segue nella richiesta:

    • AssetSources

      • CatalogId

      • Database

        • Expression

          • TagKey

          • TagValues

        • Permissions

      • Table

        • Expression

          • TagKey

          • TagValues

        • Permissions

    • RoleArn

    • DataSetId

    • RevisionId

  3. Avviare la CreateJob richiesta con un'StartJoboperazione che richiedeJobId.

  4. (Facoltativo) Esegui il GetJob polling dell'operazione per attendere il completamento del processo.

  5. (Facoltativo) Aggiorna la proprietà del nome delle risorse dopo averle create.

Importazione di risorse da AWS Lake Formation (Anteprima) (console)

Per importare una risorsa da AWS Lake Formation (Anteprima) (console)

  1. Apri il browser web e accedi alla AWS Data Exchange console.

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il set di dati con la revisione che desideri aggiornare.

  4. Nella scheda Revisioni, scegli Crea revisione per aprire la pagina Crea revisione.

    1. Per le impostazioni di revisione, fornisci un commento facoltativo per la revisione che descriva lo scopo della revisione.

    2. Per Aggiungi tag: facoltativo, aggiungi i tag associati alla risorsa.

    3. Scegli Create (Crea) .

      La tua nuova revisione è stata creata.

  5. Per la sezione di autorizzazione dei dati di Lake Formation, scegli Aggiungi tag LF.

  6. Scegli la chiave e i valori che desideri aggiungere e scegli Aggiungi tag LF.

    1. (Facoltativo) Scegliete Anteprima risorse per visualizzare le risorse del catalogo dati associate a cui state concedendo l'autorizzazione.

  7. In Accesso al servizio, selezionate il ruolo in AWS Data Exchange cui importare le AWS Lake Formation risorse.

  8. Scegli l'autorizzazione ai dati Create Lake Formation.

    Viene avviato un processo per importare le risorse nel set di dati. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato a Completato.

Esportazione di risorse

Sia i fornitori che gli abbonati possono esportare risorse da una revisione pubblicata di un prodotto. Esistono due modi per esportare le risorse:

Esportazione di risorse in un bucket S3

Quando esporti risorse in Amazon S3, IAM le autorizzazioni che utilizzi devono includere la capacità di leggere dai bucket S3 del AWS Data Exchange servizio e di scrivere nel bucket S3 in cui sono archiviate le risorse. Puoi esportare in qualsiasi bucket S3 a cui sei autorizzato ad accedere, indipendentemente dalla proprietà. Per ulteriori informazioni, consulta Autorizzazioni di Amazon S3.

AWS Data Exchange supporta parametri di crittografia configurabili durante l'esportazione di set di dati su Amazon S3. Nei dettagli del processo di esportazione, puoi specificare la configurazione di crittografia lato server di Amazon S3 che desideri applicare agli oggetti esportati. Puoi scegliere di utilizzare la crittografia lato server con Amazon S3 Managed Keys (SSE-S3) o la crittografia lato server con storage in (-). AWS KMS keys AWS Key Management Service SSE KMS Per ulteriori informazioni, consulta Protezione dei dati con la crittografia lato server nella Guida per l'utente di Amazon Simple Storage Service.

Importante

Ti consigliamo di prendere in considerazione le funzionalità di sicurezza di Amazon S3 durante l'esportazione di dati in Amazon S3. Per informazioni sulle linee guida generali e sulle best practice, consulta le best practice di sicurezza per Amazon S3 nella Guida per l'utente di Amazon Simple Storage Service.

Importante

Se il fornitore ha contrassegnato un prodotto come contenente informazioni sanitarie protette (PHI) ai sensi dell'Health Insurance Portability and Accountability Act del 1996 (HIPAA), non puoi esportare i set di dati del prodotto nel tuo account Account AWS a meno che non Account AWS sia indicato come HIPAA account (come definito nel AWS Business Associate Addendum riportato in). AWS Artifact

È possibile esportare fino a 100 risorse in un unico processo.

Il video seguente spiega di più su come esportare risorse da AWS Data Exchange.

Esportazione di risorse in un bucket S3 ()AWS SDKs

Per esportare risorse in un bucket S3 ()AWS SDKs

  1. Crea una CreateJob richiesta di tipo. EXPORT_ASSETS_TO_S3

  2. Includi quanto segue nella richiesta:

    • AssetDestinations

      • AssetID

      • Bucket

      • Key

    • DataSetID

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionID

  3. Avvia la CreateJob richiesta con un'StartJoboperazione che richiede quanto JobId restituito nel passaggio 1.

  4. (Facoltativo) Aggiorna la proprietà del nome delle risorse dopo averle create.

Nota

Per informazioni sull'esportazione di un'intera revisione come singolo lavoro, consultate. Esportazione delle revisioni

Esportazione di risorse in un bucket S3 come abbonato (console)

Per esportare una risorsa in un bucket S3 come abbonato (console)

  1. Apri il browser web e accedi alla console.AWS Data Exchange

  2. Nel riquadro di navigazione a sinistra, per I miei abbonamenti, scegli Dati autorizzati.

  3. In Dati titolati, scegli il prodotto con la revisione che desideri esportare.

  4. In Set di dati autorizzati, scegli il set di dati.

  5. Nella scheda Revisioni, scegli la revisione.

  6. Nella scheda Risorse, selezionate la casella di controllo accanto alle risorse che desiderate esportare.

  7. Seleziona Esporta azioni, quindi scegli Esporta gli asset selezionati in Amazon S3.

  8. Segui le istruzioni nella finestra Esporta in Amazon S3, quindi scegli Esporta.

    Viene avviato un processo per esportare la tua risorsa. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Esportazione di risorse in un bucket S3 come provider (console)

Per esportare una risorsa in un bucket S3 come provider (console)

  1. Apri il browser web e accedi alla AWS Data Exchange console.

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il set di dati che contiene la risorsa che desideri esportare.

  4. Vai alla scheda Prodotti per assicurarti che il set di dati sia associato a un prodotto pubblicato.

  5. Dalla scheda Revisioni, seleziona la revisione.

  6. Nella sezione Risorse importate, selezionate la casella di controllo accanto al nome della risorsa.

  7. Seleziona Esporta azioni, quindi scegli Esporta gli asset selezionati in Amazon S3.

  8. Segui le istruzioni nella finestra Esporta in Amazon S3, quindi scegli Esporta.

    Viene avviato un processo per esportare la tua risorsa. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Esportazione di risorse in un file firmato URL

Puoi usare signed URLs per esportare risorse che non sono archiviate in Amazon S3.

Esportazione di risorse in un file firmato URL ()AWS SDKs

Puoi usare signed URLs per esportare le risorse verso destinazioni diverse dai bucket S3.

Per esportare le risorse in un file firmato URL ()AWS SDKs

  1. Crea una CreateJob richiesta di tipoEXPORT_ASSET_TO_SIGNED_URL.

  2. Includi quanto segue nella richiesta:

    • AssetID

    • DataSetID

    • RevisionID

  3. Avvia la CreateJob richiesta con un'StartJoboperazione che richiede quanto JobId restituito nel passaggio 1.

  4. (Facoltativo) Aggiorna la proprietà del nome delle risorse dopo averle create.

  5. I dettagli della risposta includono quelli SignedUrl che puoi utilizzare per importare il file.

Nota

Il file firmato URL scade un minuto dopo la creazione.

Esportazione di risorse verso un sottoscrittore firmato URL come sottoscrittore (console)

Per esportare una risorsa verso un sottoscrittore firmato URL come abbonato (console)

  1. Apri il browser web e accedi alla AWS Data Exchange console.

  2. Nel riquadro di navigazione a sinistra, per I miei abbonamenti, scegli Dati autorizzati.

  3. In Dati titolati, scegli il prodotto con la revisione che desideri esportare.

  4. In Set di dati autorizzati, scegli il set di dati.

  5. Nella scheda Revisioni, scegli la revisione.

  6. Nella scheda Risorse, selezionate la casella di controllo accanto alle risorse che desiderate esportare.

  7. Seleziona Azioni di esportazione, quindi scegli Scarica le risorse selezionate.

    Viene avviato un processo per esportare la risorsa. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Esportazione di risorse verso un provider firmato URL come console

Per esportare una risorsa verso un provider firmato URL come provider (console)

  1. Apri il browser web e accedi alla AWS Data Exchange console.

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il prodotto con la revisione che desideri esportare.

  4. Vai alla scheda Prodotti per assicurarti che il set di dati sia associato a un prodotto pubblicato.

  5. Nella scheda Revisioni, scegli la revisione.

  6. Nella sezione Risorse importate, selezionate la casella di controllo accanto al nome della risorsa.

  7. Seleziona Azioni di esportazione, quindi scegli Scarica le risorse selezionate.

    Viene avviato un processo per esportare la risorsa. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Esportazione delle revisioni

Sia i provider che gli abbonati possono esportare le revisioni di un set di dati in un bucket S3 a cui dispongono delle autorizzazioni di accesso.

AWS Data Exchange supporta parametri di crittografia configurabili durante l'esportazione delle revisioni in Amazon S3. Nei dettagli del processo di esportazione, puoi specificare la configurazione di crittografia lato server di Amazon S3 che desideri applicare agli oggetti esportati. Puoi scegliere di utilizzare la crittografia lato server con Amazon S3 Managed Keys (SSE-S3) o la crittografia lato server con chiavi archiviate in (-). KMS AWS Key Management Service SSE KMS Per ulteriori informazioni, consulta Protezione dei dati con la crittografia lato server nella Guida per gli sviluppatori di Amazon Simple Storage Service.

Importante

Se il fornitore ha contrassegnato un prodotto come contenente informazioni sanitarie protette (PHI) ai sensi dell'Health Insurance Portability and Accountability Act del 1996 (HIPAA), non puoi esportare i set di dati del prodotto nel tuo account Account AWS a meno che non Account AWS sia indicato come HIPAA account (come definito nel AWS Business Associate Addendum riportato in). AWS Artifact

Il video seguente spiega ulteriori informazioni su come esportare risorse da AWS Data Exchange (a partire da 2:18).

Esportazione delle revisioni in un bucket S3 ()AWS SDKs

Per esportare una revisione in un bucket S3 ()AWS SDKs

  1. Crea una CreateJob richiesta di tipo. EXPORT_REVISIONS_TO_S3

  2. Includi quanto segue nella richiesta:

    • DataSetId

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionDestinations

      • Bucket

      • KeyPattern

      • RevisionId

  3. Avvia la CreateJob richiesta con un'StartJoboperazione che richiede quanto JobId restituito nel passaggio 1.

  4. Le risorse appena create hanno una proprietà name uguale alla chiave dell'oggetto S3 originale. La chiave oggetto Amazon S3 utilizza per impostazione predefinita il modello di chiave. ${Asset.Name}

    Puoi aggiornare la proprietà del nome degli asset dopo averli creati.

    Per ulteriori informazioni sui modelli chiave, consulta. Schemi chiave durante l'esportazione delle revisioni

Nota

Se si utilizza DataSet.Name come riferimento dinamico, è necessario disporre dell'IAMautorizzazionedataexchange:GetDataSet. Per ulteriori informazioni, consulta AWS Data Exchange APIautorizzazioni: riferimento alle azioni e alle risorse.

Esportazione delle revisioni in un bucket S3 come provider (console)

Per esportare una revisione in un bucket S3 come provider (console)

  1. Apri il browser web e accedi alla console.AWS Data Exchange

  2. Nel riquadro di navigazione a sinistra, per Pubblica dati, scegli Set di dati proprietari.

  3. In Set di dati di proprietà, scegli il prodotto con la revisione che desideri esportare.

  4. Vai alla scheda Prodotti per assicurarti che il set di dati sia associato a un prodotto pubblicato.

  5. Nella scheda Revisioni, scegli la revisione.

  6. Nella sezione Risorse importate, selezionate la casella di controllo accanto al nome della risorsa.

  7. Seleziona Esporta azioni, quindi scegli Esporta gli asset selezionati in Amazon S3.

  8. Segui le istruzioni nella finestra Esporta in Amazon S3, quindi scegli Esporta.

    Viene avviato un processo per esportare la tua risorsa. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Esportazione delle revisioni in un bucket S3 come abbonato (console)

Per esportare una revisione in un bucket S3 come abbonato (console)

  1. Apri il browser web e accedi alla console.AWS Data Exchange

  2. Nel riquadro di navigazione a sinistra, per I miei abbonamenti, scegli Dati autorizzati.

  3. In Dati titolati, scegli il prodotto con la revisione che desideri esportare.

  4. In Set di dati autorizzati, scegli il set di dati.

  5. Nella scheda Revisioni, seleziona la revisione, quindi scegli Esporta in Amazon S3.

  6. In Esporta revisione su Amazon S3, seleziona un'opzione di destinazione, la destinazione della cartella bucket Amazon S3, configura le opzioni di crittografia, quindi scegli Esporta.

    Viene avviato un processo per esportare la revisione. Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato in Completato.

Esportazione automatica delle revisioni in un bucket S3 come abbonato

Quando il provider pubblica nuove revisioni, puoi scegliere di esportare automaticamente le nuove revisioni nel tuo bucket Amazon S3. Puoi esportare nuove revisioni in un massimo di cinque bucket S3. Le nuove revisioni appariranno automaticamente nei bucket S3 che hai selezionato.

Nota

Per esportare automaticamente le revisioni in un bucket S3 di tua scelta, il bucket S3 deve avere una policy relativa ai bucket con autorizzazioni impostate per consentire l'esportazione dei dati al suo interno. AWS Data Exchange Per ulteriori informazioni, consulta Prerequisiti per le autorizzazioni relative alla policy del bucket S3.

Prerequisiti per le autorizzazioni relative alla policy del bucket S3

Prima di poter esportare automaticamente le revisioni in un bucket S3, devi disabilitare i pagamenti dei richiedenti e il bucket S3 deve avere una policy relativa ai bucket con le autorizzazioni impostate per consentire l'esportazione dei dati al suo interno. AWS Data Exchange Le seguenti procedure forniscono informazioni su come modificare la policy del bucket S3 esistente o creare una policy per i bucket S3 con queste autorizzazioni.

Se il bucket S3 è configurato per SSE la KMS crittografia, l'utente che configura il processo di esportazione automatica deve disporre dell'CreateGrantautorizzazione sulla KMS chiave AWS Data Exchange per copiare gli oggetti nel bucket S3.

Importante

Per verificare che i prerequisiti per le autorizzazioni della policy del bucket S3 siano soddisfatti, un oggetto con il formato di denominazione _ADX-TEST-ACCOUNTID# viene aggiunto al bucket S3 durante il processo di esportazione automatica.

Modifica di una policy esistente per i bucket S3

Se il tuo bucket S3 ha una policy sui bucket, completa la seguente procedura per consentire AWS Data Exchange l'esportazione dei dati al suo interno.

Per modificare una policy sui bucket S3 esistente

  1. Vai al bucket in cui desideri esportare le revisioni.

  2. Seleziona la scheda Autorizzazioni e scegli Modifica nella sezione relativa alla politica del bucket.

  3. Copia la seguente dichiarazione e incollala alla fine dell'elenco delle istruzioni.

    
    {
      "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. Sostituiscilo <BUCKET-NAME> con il nome del tuo bucket S3 e sostituiscilo <AWS ID> con il tuo AWS ID.

  5. Scegli Save changes (Salva modifiche).

  6. Se desideri aggiungere altri bucket come destinazione per i tuoi lavori di esportazione automatica, ripeti la procedura, a partire dal passaggio 1.

Creazione di una policy sui bucket S3

Se il tuo bucket S3 non dispone di una policy sui bucket, completa la seguente procedura per creare una policy sui bucket S3 che consenta l'esportazione dei dati al suo interno. AWS Data Exchange

Per creare una policy sui bucket S3

  1. Vai al bucket in cui desideri esportare le revisioni.

  2. Seleziona la scheda Autorizzazioni e scegli Modifica nella sezione relativa alla politica del bucket.

  3. Copia la seguente policy completa del bucket e incollala nell'editor della policy del 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>Sostituiscila con il nome del tuo bucket S3 e <AWS ID> sostituiscila con il tuo ID. AWS

  5. Scegli Save changes (Salva modifiche).

  6. Se desideri aggiungere altri bucket come destinazione per i tuoi lavori di esportazione automatica, ripeti la procedura, a partire dal passaggio 1.

Esportazione automatica delle revisioni in un bucket S3 come abbonato (console)

Nota

Per esportare automaticamente le revisioni in un bucket S3 di tua scelta, il bucket S3 deve avere una policy relativa ai bucket con autorizzazioni impostate per consentire l'esportazione dei dati al suo interno. AWS Data Exchange Per ulteriori informazioni, consulta Prerequisiti per le autorizzazioni relative alla policy del bucket S3.

Per esportare automaticamente una revisione in un bucket S3 come abbonato (console)

  1. Apri il browser web e accedi alla console.AWS Data Exchange

  2. Nel riquadro di navigazione a sinistra, per I miei abbonamenti, scegli Dati autorizzati.

  3. In Dati titolati, scegli il prodotto con la revisione che desideri esportare.

  4. In Set di dati autorizzati, scegli il set di dati.

  5. Nella scheda Revisioni, in Esportazione automatica delle destinazioni dei lavori, scegli Azioni, quindi scegli Aggiungi destinazione lavoro di esportazione automatica.

  6. In Aggiungi destinazione del lavoro di esportazione automatica, scegli l'opzione Destinazione semplice o avanzata.

    1. Se scegli l'opzione Simple, seleziona la destinazione della cartella del bucket Amazon S3 dall'elenco a discesa e le opzioni di crittografia, quindi scegli Aggiungi destinazione bucket.

    2. Se scegli l'opzione Advanced, seleziona la destinazione della cartella del bucket Amazon S3 dall'elenco a discesa, seleziona il modello di denominazione delle chiavi e aggiungilo al percorso.

  7. Esamina l'output.

  8. Imposta le opzioni di crittografia, esamina i prezzi di Amazon S3, quindi scegli Aggiungi destinazione del bucket.

    La destinazione del bucket Amazon S3 viene visualizzata nella scheda Revisioni in Esportazione automatica delle destinazioni dei lavori.

    Viene avviato un processo per esportare automaticamente la revisione.

    Per verificare che i prerequisiti per le autorizzazioni della policy del bucket S3 siano soddisfatti, al bucket S3 _ADX-TEST-ACCOUNTID# viene aggiunto un oggetto con il formato di denominazione.

    Al termine del lavoro, il campo Stato nella sezione Lavori viene aggiornato su Completato.

    Per aggiungere un'altra destinazione, scegli Azioni, quindi Aggiungi destinazione del lavoro di esportazione automatica.

    Per modificare, seleziona la destinazione da modificare, scegli Azioni, quindi Modifica configurazione della destinazione.

    Per eliminare, scegli Azioni, quindi scegli Rimuovi la destinazione del lavoro di esportazione automatica.

Esportazione automatica delle revisioni in un bucket S3 come abbonato ()AWS SDKs

Nota

Per esportare automaticamente le revisioni in un bucket S3 di tua scelta, il bucket S3 deve avere una policy relativa ai bucket con autorizzazioni impostate per consentire l'esportazione dei dati al suo interno. AWS Data Exchange Per ulteriori informazioni, consulta Prerequisiti per le autorizzazioni relative alla policy del bucket S3.

Per esportare automaticamente una revisione in un bucket S3 ()AWS SDKs

  1. Crea una richiesta. Create_Event_Action

  2. Includi quanto segue nella richiesta:

    • Action

      • ExportRevisionToS3

        • Encryption

          • KmsKeyArn

          • Type

      • RevisionDestination

        • Bucket

        • KeyPattern

    • Event

      • RevisionPublished

        • DataSetId

  3. Se necessario, modificate lo schema dei tasti. La chiave oggetto Amazon S3 utilizza per impostazione predefinita il modello di chiave. {Revision.CreatedAt}/{Asset.Name}

    Per ulteriori informazioni sui modelli chiave, consulta. Schemi chiave durante l'esportazione delle revisioni

    Per verificare che i prerequisiti per le autorizzazioni relative alla policy del bucket S3 siano soddisfatti, _ADX-TEST-ACCOUNTID# viene aggiunto un oggetto con il formato di denominazione al bucket S3.

Schemi chiave durante l'esportazione delle revisioni

Quando esporti una revisione, ogni risorsa diventa un oggetto nel bucket S3. I nomi degli oggetti si basano su uno schema chiave fornito dall'utente. Potete utilizzare riferimenti dinamici che rappresentano gli attributi degli asset per creare uno schema per i nomi generati automaticamente durante l'esportazione. Utilizzate i riferimenti dinamici mostrati nella tabella seguente.

Riferimenti dinamici Descrizione
${Asset.Id} L'ID della risorsa.
${Asset.Name} Il nome della risorsa.
${DataSet.Id} L'ID del set di dati da esportare.
${DataSet.Name} Il nome del set di dati da esportare.
${Revision.CreatedAt} La UTC data e l'ora di creazione della revisione, nel seguente formato: YYYY -MM-:MM:. DDTHH SSZ Ad esempio: 2021-10-08T 16:33:19.787 Z
${Revision.CreatedAt.Day} Il giorno del mese in cui è stata creata la revisione.
${Revision.CreatedAt.Month} Il mese in cui è stata creata la revisione.
${Revision.CreatedAt.Year} L'anno in cui è stata creata la revisione.
${Revision.Id} L'ID della revisione che viene esportata.

È possibile utilizzare questi riferimenti dinamici per creare i modelli chiave per i nomi delle risorse. È necessario includere almeno uno dei due riferimenti Asset dinamici, che sono ${Asset.Name} e${Asset.Id}.

Ad esempio, utilizzando ${Revision.Id}/${Asset.Name} come modello chiave si ottengono oggetti Amazon S3 che utilizzano l'ID di revisione e il nome dell'asset (separati da una barra) come nome dell'oggetto.

Se esporti una revisione con l'ID testRevisionId con due asset denominati asset1 easset2, gli asset vengono esportati nelle seguenti posizioni in Amazon S3:

  • <bucket>/testRevisionId/asset1

  • <bucket>/testRevisionId/asset2

Nota

Gli oggetti risultanti devono avere nomi univoci. Se hanno gli stessi nomi degli oggetti esistenti nel bucket S3, l'esportazione sovrascriverà gli oggetti esistenti. Se la revisione che state esportando ha nomi non univoci (ad esempio, due risorse con lo stesso nome), l'esportazione avrà esito negativo. L'unico riferimento dinamico univoco è. ${Asset.Id}