Jobs in AWS Data Exchange - AWS Data Exchange Benutzerleitfaden
AuftragseigenschaftenAWS-Regionen und ArbeitsplätzeAssets werden importiertAssets werden exportiertRevisionen werden exportiert

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Jobs in AWS Data Exchange

AWS Data Exchange Jobs sind asynchrone Import- oder Exportvorgänge.

Als Anbieter können Sie Ihre Datensätze, die Sie in einem Produkt veröffentlichen möchten, erstellen und verwalten. Sie können Ihre Ressourcen oder Überarbeitungen in Amazon Simple Storage Service (Amazon S3) oder in eine signierte URL Version herunterladen (exportieren) oder kopieren. Darüber hinaus können Anbieter Assets aus einem Amazon API Gateway API oder Assets aus einem Amazon Redshift Redshift-Datensatz importieren.

Als Abonnent können Sie die Datensätze, auf die Sie über ein Abonnement Anspruch haben, einsehen und darauf zugreifen. Sie können die API Operationen verwenden, um Ihre berechtigten Datensätze herunterzuladen (zu exportieren) oder nach Amazon S3 zu kopieren, um sie mit einer Vielzahl von AWS Analyse- und Machine-Learning-Diensten zu verwenden.

Um Assets zu erstellen oder zu kopieren oder Revisionen über Jobs zu kopieren, können Sie die AWS Management Console, AWS Command Line Interface (AWS CLI), Ihre eigene REST Anwendung oder eine der AWS SDKs folgenden verwenden.

Jobs werden 90 Tage nach ihrer Erstellung gelöscht.

Auftragseigenschaften

Jobs haben die folgenden Eigenschaften:

  • Job-ID — Eine bei der Erstellung des Jobs generierte ID, die den Job eindeutig identifiziert.

  • Jobtyp — Die folgenden Jobtypen werden unterstützt:

    • Importieren aus Amazon S3

    • Eine AWS Lake Formation Datenberechtigung importieren (Vorschau)

    • Aus einer signierten Datei importieren URL

    • Aus Amazon API Gateway importieren API

    • Aus einem AWS Data Exchange Datashare für Amazon Redshift importieren

    • Importieren Sie einen Amazon S3 S3-Datenzugriff

    • Exportieren zu Amazon S3

    • In signiertes Format exportieren URL

  • Amazon-Ressourcenname (ARN) — Eine eindeutige Kennung für AWS Ressourcen.

  • Jobstatus — Die Jobstatus sind WAITINGIN_PROGRESS,COMPLETED,CANCELLED,ERROR, oderTIMED_OUT. Wenn ein Job erstellt wird, befindet er sich in diesem WAITING Status, bis der Job gestartet wird.

  • Auftragsdetails — Details des Vorgangs, der vom Job ausgeführt werden soll, z. B. Details zum Exportziel oder Details zur Importquelle.

Beispiel Jobressource
{
    "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"
        }
    }
}

AWS-Regionen und Arbeitsplätze

Wenn Sie ein Asset in oder aus einem Amazon S3 S3-Bucket importieren oder exportieren, das sich in einer AWS-Region anderen Region als der Region des Datensatzes befindet, werden Ihnen AWS-Konto die Datenübertragungskosten gemäß den Amazon S3 S3-Preisrichtlinien für Datenübertragungen in Rechnung gestellt.

Wenn Sie Assets in ein signiertes System exportierenURL, werden Ihnen AWS-Konto gemäß den Amazon S3-Preisrichtlinien die Kosten für die Datenübertragung von Amazon S3 ins Internet in Rechnung gestellt.

Wenn Ihr Abonnement AWS Data Exchange für einen For Files-Datensatz endet, haben Sie weiterhin Zugriff auf alle Dateien, die Sie bereits exportiert haben. Prüfen Sie Ihre Datenabonnementvereinbarung, um zu überprüfen, ob Ihre Vereinbarung vorschreibt, dass Sie exportierte Daten löschen, wenn Sie ein Abonnement beenden.

Assets werden importiert

Sie können Elemente auf folgende Weise in eine Revision importieren:

Assets aus einem S3-Bucket importieren

Wenn Sie Assets aus Amazon S3 importieren AWS Data Exchange, müssen die AWS Identity and Access Management (IAM) -Berechtigungen, die Sie verwenden, die Fähigkeit beinhalten, in die AWS Data Exchange Service S3-Buckets zu schreiben und aus dem S3-Bucket zu lesen, in dem Ihre Assets gespeichert sind. Sie können aus jedem S3-Bucket importieren, für den Sie Zugriffsrechte haben, unabhängig davon, welcher Eigentümer Sie sind. Weitere Informationen finden Sie unter Amazon-S3-Berechtigungen.

Sie können bis zu 100 Assets in einem einzigen Job importieren.

Assets aus einem S3-Bucket importieren (AWS SDKs)

Um Assets aus einem Amazon S3 S3-Bucket zu importieren (AWS SDKs)

  1. Erstellen Sie eine CreateJob Anfrage des TypsIMPORT_ASSETS_FROM_S3.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • AssetSources

      • Bucket

      • Key

    • DataSetID

    • RevisionID

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, für den die in Schritt 1 JobId zurückgegebenen Daten erforderlich sind.

  4. (Optional) Aktualisieren Sie die Namenseigenschaft der Assets, nachdem sie erstellt wurden.

Assets aus einem S3-Bucket (Konsole) importieren

Um ein Asset aus einem S3-Bucket (Konsole) zu importieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich bei der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze den Datensatz mit der Revision aus, die Sie aktualisieren möchten.

  4. Wählen Sie auf der Registerkarte Revisionen die Option Revision erstellen aus, um die Seite Revision erstellen zu öffnen.

    1. Geben Sie für die Revisionseinstellungen optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.

    2. Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.

    3. Wählen Sie Create (Erstellen) aus.

      Ihre neue Revision wird erstellt.

  5. Wählen Sie für den Bereich Jobs die Option Aus Amazon S3 importieren aus.

  6. Folgen Sie den Anweisungen im Fenster Aus Amazon S3 importieren und wählen Sie dann Assets importieren.

    Es wird ein Job gestartet, um Ihr Asset in Ihren Datensatz zu importieren. Nachdem der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Elemente aus einer signierten Datei werden importiert URL

Sie können signiert verwendenURLs, um Assets zu importieren, die nicht in Amazon S3 gespeichert sind.

Importieren von Assets aus einem signierten URL (AWS SDKs)

Um Assets aus einer signierten URL (AWS SDKs) Datei zu importieren

  1. Erstellen Sie eine CreateJob Anfrage des TypsIMPORT_ASSET_FROM_SIGNED_URL.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • AssetName

    • DataSetID

    • Md5Hash

    • RevisionID

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, für den die in Schritt 1 JobId zurückgegebenen Daten erforderlich sind.

  4. (Optional) Aktualisieren Sie die Namenseigenschaft der Assets, nachdem sie erstellt wurden.

  5. Zu den Antwortdetails gehören SignedUrl die, mit denen Sie Ihre Datei importieren können.

Anmerkung

Die signierte URL Datei läuft eine Minute nach ihrer Erstellung ab.

Assets aus einer signierten Datei URL (Konsole) importieren

Um ein Asset aus einem signierten Objekt URL (Konsole) zu importieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich bei der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze den Datensatz aus, der das Asset enthält, das Sie aktualisieren möchten.

  4. Wählen Sie auf der Registerkarte Revisionen die Option Revision erstellen aus, um die Seite Revision erstellen zu öffnen.

    1. Geben Sie für die Revisionseinstellungen optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.

    2. Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.

    3. Wählen Sie Create (Erstellen) aus.

      Ihre neue Revision wird erstellt.

  5. Wählen Sie für den Bereich Jobs die Option Upload aus.

  6. Folgen Sie den Anweisungen im Upload-Fenster und wählen Sie dann Öffnen.

    Es wird ein Job gestartet, um Ihr Asset in Ihren Datensatz zu importieren. Nachdem der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Assets von einem Amazon API Gateway importieren API

AWS Data Exchange Abonnenten können ihre IAM Anmeldeinformationen verwenden und APIs von AWS SDKs Datenanbietern aus anrufen. AWS Data Exchange verwaltet den Zugriff auf, APIs indem es sich um Authentifizierungs- und Abonnementberechtigungen kümmert.

APIAssets von einem Amazon API Gateway importieren API (AWS SDKs)

Anmerkung

Derzeit wird der SendApiAsset Vorgang für Folgendes nicht unterstütztSDKs:

  • AWS SDK for .NET

  • AWS SDK for C++

  • AWS SDK for Java 2.x

Um Ressourcen von einem Amazon API Gateway zu importieren API (AWS SDKs)

  1. Erstellen Sie eine CreateJob Anfrage des TypsIMPORT_ASSET_FROM_API_GATEWAY_API.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • ApiID

    • DataSetID

    • ProtocolType

    • RevisionID

    • Stage

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, für den die in Schritt 1 JobId zurückgegebenen Daten erforderlich sind.

  4. (Optional) Rufen Sie den GetJob Vorgang ab, um zu warten, bis der Job abgeschlossen ist.

  5. (Optional) Aktualisieren Sie die Namenseigenschaft der Assets, nachdem sie erstellt wurden.

APIAssets von einem Amazon API Gateway API (Konsole) importieren

Um ein Asset von einem Amazon API Gateway API (Konsole) zu importieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich bei der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze den Datensatz aus, der das Asset enthält, das Sie aktualisieren möchten.

  4. Wählen Sie auf der Registerkarte Revisionen die Option Revision erstellen aus, um die Seite Revision erstellen zu öffnen.

    1. Geben Sie für die Revisionseinstellungen optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.

    2. Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.

    3. Wählen Sie Create (Erstellen) aus.

      Ihre neue Revision wird erstellt.

  5. Wählen Sie für den Bereich „APIAssets“ die Option „APIPhase hinzufügen“ aus.

  6. Wählen Sie auf der Seite APIPhase hinzufügen das Amazon API Gateway API und den Namen der Phase aus Ihrem AWS-Konto oder einem anderen Konto aus.

  7. Für Dokument API für Abonnenten:

    1. Ändern Sie den APINamen auf einen klaren und präzisen Namen, den Abonnenten verstehen können.

    2. Dokumentieren Sie die Open API 3.0-Spezifikation, indem Sie die Spezifikation in das Feld eingeben und die Spezifikation importieren, indem Sie Import aus wählen. JSONDatei, oder importieren Sie die Spezifikation, indem Sie Import von Amazon API Gateway wählen.

  8. Wählen Sie API Phase hinzufügen.

    Es wird ein Job gestartet, um Ihre API Assets in Ihren Datensatz zu importieren. Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Importieren von Assets aus einem AWS Data Exchange Datashare für Amazon Redshift

Wenn Sie Assets mithilfe von AWS Data Exchange Datashare for Amazon Redshift importieren, können Sie nach dem Abonnement mit der Abfrage, Analyse und Operationalisierung von Amazon Redshift Redshift-Tabellen von Drittanbietern beginnen.

Importieren von Assets aus einem AWS Data Exchange Datashare für Amazon Redshift ()AWS SDKs

So importieren Sie Assets aus einem AWS Data Exchange Datashare für Amazon Redshift ()AWS SDKs

  1. Erstellen Sie eine CreateJob Anfrage des Typs. IMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • AssetSources

      • DataShareArn

    • DataSetID

    • RevisionID

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, für den die in Schritt 1 JobId zurückgegebenen Daten erforderlich sind.

  4. (Optional) Rufen Sie den GetJob Vorgang ab, um zu warten, bis der Job abgeschlossen ist.

  5. (Optional) Aktualisieren Sie die Namenseigenschaft der Assets, nachdem sie erstellt wurden.

Importieren von Assets aus einem AWS Data Exchange Datashare für Amazon Redshift (Konsole)

Um ein Asset aus einem ADE Datashare zu importieren (für die Amazon Redshift Redshift-Konsole)

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich bei der Konsole an.AWS Data Exchange

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze den Datensatz aus, der das Asset enthält, das Sie aktualisieren möchten.

  4. Wählen Sie auf der Registerkarte Revisionen die Option Revision erstellen aus, um die Seite Revision erstellen zu öffnen.

    1. Geben Sie für die Revisionseinstellungen optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.

    2. Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.

    3. Wählen Sie Create (Erstellen) aus.

      Ihre neue Revision wird erstellt.

  5. Wählen Sie für den Abschnitt AWS Data Exchange Datashares für Amazon Redshift die Option Datashares hinzufügen aus.

  6. Wählen Sie auf der Seite „ AWS Data Exchange Datenfreigabe zur Revision hinzufügen“ die Datenfreigabe oder die Datenfreigaben aus, die Sie hinzufügen möchten.

  7. Wählen Sie Datenfreigabe (en) hinzufügen aus.

    Es wird ein Job gestartet, um Ihre Assets in Ihren Datensatz zu importieren. Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Elemente aus (Vorschau) importieren AWS Lake Formation

Wenn Sie Elemente von AWS Lake Formation bis importieren AWS Data Exchange, müssen die von Ihnen verwendeten IAM Berechtigungen die folgenden Funktionen beinhalten:

  • An Lake Formation schreiben, Berechtigungen erteilen und widerrufen

  • Erstellen Sie gemeinsam genutzte Ressourcen für Tabellen, Datenbanken und Kataloge

  • Aktualisieren, Löschen, Zuordnen und Trennen von Ressourcenfreigaben für alle Ressourcenfreigaben, die mit Lake Formation beginnen

Weitere Informationen zu den erforderlichen und empfohlenen IAM Berechtigungen finden Sie unterIdentitäts- und Zugriffsmanagement in AWS Data Exchange.

Elemente aus AWS Lake Formation (Vorschau) importieren (AWSSDKs)

Um Elemente aus AWS Lake Formation (Vorschau) zu importieren (AWSSDKs)

  1. Erstellen Sie eine CreateJob Anfrage des TypsImport_Assets_From_Lake_Formation_Tag_Policy.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • AssetSources

      • CatalogId

      • Database

        • Expression

          • TagKey

          • TagValues

        • Permissions

      • Table

        • Expression

          • TagKey

          • TagValues

        • Permissions

    • RoleArn

    • DataSetId

    • RevisionId

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, der die erfordertJobId.

  4. (Optional) Rufen Sie den GetJob Vorgang ab, um zu warten, bis der Job abgeschlossen ist.

  5. (Optional) Aktualisieren Sie die Namenseigenschaft der Assets, nachdem sie erstellt wurden.

Elemente aus AWS Lake Formation (Vorschau) (Konsole) importieren

Um ein Asset aus AWS Lake Formation (Vorschau) (Konsole) zu importieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich bei der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze den Datensatz mit der Revision aus, die Sie aktualisieren möchten.

  4. Wählen Sie auf der Registerkarte Revisionen die Option Revision erstellen aus, um die Seite Revision erstellen zu öffnen.

    1. Geben Sie für die Revisionseinstellungen optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.

    2. Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.

    3. Wählen Sie Create (Erstellen) aus.

      Ihre neue Revision wird erstellt.

  5. Wählen Sie für den Bereich Datenberechtigungen für Lake Formation die Option LF-Tag hinzufügen aus.

  6. Wählen Sie den Schlüssel und die Werte aus, die Sie hinzufügen möchten, und wählen Sie LF-Tag hinzufügen.

    1. (Optional) Wählen Sie „Ressource (n) in der Vorschau anzeigen“, um die zugehörigen Datenkatalogressourcen anzuzeigen, denen Sie die Berechtigung erteilen.

  7. Wählen Sie unter Dienstzugriff die Rolle aus, in die die AWS Lake Formation Ressourcen importiert werden sollen AWS Data Exchange.

  8. Wählen Sie die Datenberechtigung Lake Formation erstellen aus.

    Es wird ein Job gestartet, um Ihre Assets in Ihren Datensatz zu importieren. Nachdem der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Assets werden exportiert

Sowohl Anbieter als auch Abonnenten können Ressourcen aus einer veröffentlichten Version eines Produkts exportieren. Es gibt zwei Möglichkeiten, Ressourcen zu exportieren:

Exportieren von Assets in einen S3-Bucket

Wenn Sie Assets nach Amazon S3 exportieren, müssen die von Ihnen verwendeten IAM Berechtigungen die Fähigkeit beinhalten, aus den AWS Data Exchange Service S3-Buckets zu lesen und in den S3-Bucket zu schreiben, in dem Ihre Assets gespeichert sind. Sie können in jeden S3-Bucket exportieren, für den Sie Zugriffsrechte haben, unabhängig davon, welcher Eigentümer Sie sind. Weitere Informationen finden Sie unter Amazon-S3-Berechtigungen.

AWS Data Exchange unterstützt konfigurierbare Verschlüsselungsparameter beim Exportieren von Datensätzen nach Amazon S3. In Ihren Exportauftragsdetails können Sie die serverseitige Amazon S3 S3-Verschlüsselungskonfiguration angeben, die Sie auf die exportierten Objekte anwenden möchten. Sie können wählen, ob Sie serverseitige Verschlüsselung mit Amazon S3-Managed Keys (SSE-S3) oder serverseitige Verschlüsselung mit AWS KMS keys gespeichert in (-) verwenden möchten. AWS Key Management Service SSE KMS Weitere Informationen finden Sie unter Schutz von Daten durch serverseitige Verschlüsselung im Amazon Simple Storage Service User Guide.

Wichtig

Wir empfehlen, dass Sie beim Exportieren von Daten nach Amazon S3 die Sicherheitsfunktionen von Amazon S3 berücksichtigen. Informationen zu allgemeinen Richtlinien und bewährten Methoden finden Sie unter Bewährte Sicherheitsmethoden für Amazon S3 im Amazon Simple Storage Service-Benutzerhandbuch.

Wichtig

Wenn der Anbieter ein Produkt so gekennzeichnet hat, dass es geschützte Gesundheitsinformationen (PHI) enthält, die dem Health Insurance Portability and Accountability Act von 1996 (HIPAA) unterliegen, dürfen Sie die Datensätze des Produkts nicht in Ihr Konto exportieren, AWS-Konto es sei denn, dieses AWS-Konto ist als HIPAA Konto gekennzeichnet (wie im AWS Business Associate Addendum definiert unter). AWS Artifact

Sie können bis zu 100 Assets in einem einzigen Job exportieren.

Das folgende Video erklärt mehr darüber, wie Sie Assets aus exportieren können AWS Data Exchange.

Exportieren von Assets in einen S3-Bucket (AWS SDKs)

Um Assets in einen S3-Bucket zu exportieren (AWS SDKs)

  1. Erstellen Sie eine CreateJob Anfrage des TypsEXPORT_ASSETS_TO_S3.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • AssetDestinations

      • AssetID

      • Bucket

      • Key

    • DataSetID

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionID

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, für den die in Schritt 1 JobId zurückgegebenen Daten erforderlich sind.

  4. (Optional) Aktualisieren Sie die Namenseigenschaft der Assets, nachdem sie erstellt wurden.

Anmerkung

Informationen zum Exportieren einer gesamten Revision als einzelnen Job finden Sie unterRevisionen werden exportiert.

Exportieren von Assets in einen S3-Bucket als Abonnent (Konsole)

Um ein Asset als Abonnent (Konsole) in einen S3-Bucket zu exportieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich bei der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Meine Abonnements die Option Berechtigte Daten aus.

  3. Wählen Sie unter Berechtigte Daten das Produkt mit der Version aus, die Sie exportieren möchten.

  4. Wählen Sie unter Berechtigte Datensätze den Datensatz aus.

  5. Wählen Sie auf der Registerkarte Revisionen die Revision aus.

  6. Aktivieren Sie auf der Registerkarte Assets das Kontrollkästchen neben den Assets, die Sie exportieren möchten.

  7. Wählen Sie Aktionen exportieren und dann Ausgewählte Assets nach Amazon S3 exportieren aus.

  8. Folgen Sie den Anweisungen im Fenster Nach Amazon S3 exportieren und wählen Sie dann Exportieren.

    Ein Job zum Exportieren Ihres Assets wird gestartet. Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Exportieren von Assets in einen S3-Bucket als Anbieter (Konsole)

Um ein Asset als Anbieter (Konsole) in einen S3-Bucket zu exportieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich bei der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze den Datensatz aus, der das Asset enthält, das Sie exportieren möchten.

  4. Navigieren Sie zur Registerkarte Produkte, um sicherzustellen, dass der Datensatz mit einem veröffentlichten Produkt verknüpft ist.

  5. Wählen Sie auf der Registerkarte Revisionen die Revision aus.

  6. Aktivieren Sie für den Abschnitt Importierte Assets das Kontrollkästchen neben dem Asset-Namen.

  7. Wählen Sie Aktionen exportieren und dann Ausgewählte Assets nach Amazon S3 exportieren aus.

  8. Folgen Sie den Anweisungen im Fenster Nach Amazon S3 exportieren und wählen Sie dann Exportieren.

    Ein Job zum Exportieren Ihres Assets wird gestartet. Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Exportieren von Assets in ein signiertes URL

Sie können signierte Dateien verwendenURLs, um Assets zu exportieren, die nicht in Amazon S3 gespeichert sind.

Exportieren von Assets in ein signiertes URL (AWS SDKs)

Sie können signed verwendenURLs, um Assets an andere Ziele als S3-Buckets zu exportieren.

Um Assets in ein signiertes URL ()AWS SDKs Format zu exportieren

  1. Erstellen Sie eine CreateJob Anfrage des TypsEXPORT_ASSET_TO_SIGNED_URL.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • AssetID

    • DataSetID

    • RevisionID

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, für den die in Schritt 1 JobId zurückgegebenen Daten erforderlich sind.

  4. (Optional) Aktualisieren Sie die Namenseigenschaft der Assets, nachdem sie erstellt wurden.

  5. Zu den Antwortdetails gehören SignedUrl die, mit denen Sie Ihre Datei importieren können.

Anmerkung

Die signierte URL Datei läuft eine Minute nach ihrer Erstellung ab.

Exportieren von Assets an einen Nutzer, der URL als Abonnent angemeldet ist (Konsole)

Um ein Asset an einen Abonnenten zu exportieren, der URL als Abonnent angemeldet ist (Konsole)

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Meine Abonnements die Option Berechtigte Daten aus.

  3. Wählen Sie unter Berechtigte Daten das Produkt mit der Version aus, die Sie exportieren möchten.

  4. Wählen Sie unter Berechtigte Datensätze den Datensatz aus.

  5. Wählen Sie auf der Registerkarte Revisionen die Revision aus.

  6. Aktivieren Sie auf der Registerkarte Assets das Kontrollkästchen neben den Assets, die Sie exportieren möchten.

  7. Wählen Sie Aktionen exportieren und dann Ausgewählte Assets herunterladen aus.

    Es wird ein Job gestartet, um Ihr Asset zu exportieren. Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Exportieren von Ressourcen in eine URL als Anbieter signierte Konsole

Um ein Asset in ein System zu exportieren, das URL als Anbieter signiert ist (Konsole)

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze das Produkt mit der Version aus, die Sie exportieren möchten.

  4. Gehen Sie zur Registerkarte Produkte, um sicherzustellen, dass der Datensatz mit einem veröffentlichten Produkt verknüpft ist.

  5. Wählen Sie auf der Registerkarte Revisionen die Revision aus.

  6. Aktivieren Sie für den Abschnitt Importierte Assets das Kontrollkästchen neben dem Asset-Namen.

  7. Wählen Sie Aktionen exportieren und anschließend Ausgewählte Assets herunterladen aus.

    Es wird ein Job gestartet, um Ihr Asset zu exportieren. Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Revisionen werden exportiert

Sowohl Anbieter als auch Abonnenten können Revisionen eines Datensatzes in einen S3-Bucket exportieren, für den sie über Zugriffsberechtigungen verfügen.

AWS Data Exchange unterstützt konfigurierbare Verschlüsselungsparameter beim Exportieren von Revisionen nach Amazon S3. In Ihren Exportauftragsdetails können Sie die serverseitige Amazon S3 S3-Verschlüsselungskonfiguration angeben, die Sie auf die exportierten Objekte anwenden möchten. Sie können wählen, ob Sie serverseitige Verschlüsselung mit Amazon S3-Managed Keys (SSE-S3) oder serverseitige Verschlüsselung mit KMS Schlüsseln verwenden möchten, die in (-) gespeichert sind. AWS Key Management Service SSE KMS Weitere Informationen finden Sie unter Schützen von Daten mit serverseitiger Verschlüsselung im Amazon Simple Storage Service-Entwicklerhandbuch.

Wichtig

Wenn der Anbieter ein Produkt so gekennzeichnet hat, dass es geschützte Gesundheitsinformationen (PHI) enthält, die dem Health Insurance Portability and Accountability Act von 1996 (HIPAA) unterliegen, dürfen Sie die Datensätze des Produkts nicht in Ihr Konto exportieren, AWS-Konto es sei denn, dieses AWS-Konto ist als HIPAA Konto gekennzeichnet (wie im AWS Business Associate Addendum definiert unter). AWS Artifact

Im folgenden Video erfahren Sie mehr darüber, wie Sie Ressourcen aus exportieren können AWS Data Exchange (ab 2:18 Uhr).

Exportieren von Revisionen in einen S3-Bucket ()AWS SDKs

Um eine Revision in einen S3-Bucket zu exportieren ()AWS SDKs

  1. Erstellen Sie eine CreateJob Anfrage des TypsEXPORT_REVISIONS_TO_S3.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • DataSetId

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionDestinations

      • Bucket

      • KeyPattern

      • RevisionId

  3. Starten Sie die CreateJob Anforderung mit einem StartJob Vorgang, für den die in Schritt 1 JobId zurückgegebenen Daten erforderlich sind.

  4. Die neu erstellten Assets haben eine Namenseigenschaft, die dem Schlüssel des ursprünglichen S3-Objekts entspricht. Der Amazon S3 S3-Objektschlüssel verwendet standardmäßig das Schlüsselmuster${Asset.Name}.

    Sie können die Namenseigenschaft der Assets aktualisieren, nachdem sie erstellt wurden.

    Weitere Informationen zu Schlüsselmustern finden Sie unterWichtige Muster beim Exportieren von Revisionen.

Anmerkung

Wenn Sie DataSet.Name als dynamische Referenz verwenden, benötigen Sie die IAM entsprechende Genehmigungdataexchange:GetDataSet. Weitere Informationen finden Sie unter AWS Data Exchange APIBerechtigungen: Referenz zu Aktionen und Ressourcen.

Exportieren von Revisionen in einen S3-Bucket als Anbieter (Konsole)

Um eine Revision als Anbieter (Konsole) in einen S3-Bucket zu exportieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Daten veröffentlichen die Option Eigene Datensätze aus.

  3. Wählen Sie unter Eigene Datensätze das Produkt mit der Version aus, die Sie exportieren möchten.

  4. Gehen Sie zur Registerkarte Produkte, um sicherzustellen, dass der Datensatz mit einem veröffentlichten Produkt verknüpft ist.

  5. Wählen Sie auf der Registerkarte Revisionen die Revision aus.

  6. Aktivieren Sie für den Abschnitt Importierte Assets das Kontrollkästchen neben dem Asset-Namen.

  7. Wählen Sie Aktionen exportieren und dann Ausgewählte Assets nach Amazon S3 exportieren aus.

  8. Folgen Sie den Anweisungen im Fenster Nach Amazon S3 exportieren und wählen Sie dann Exportieren.

    Ein Job zum Exportieren Ihres Assets wird gestartet. Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Exportieren von Revisionen in einen S3-Bucket als Abonnent (Konsole)

Um als Abonnent (Konsole) eine Revision in einen S3-Bucket zu exportieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Meine Abonnements die Option Berechtigte Daten aus.

  3. Wählen Sie unter Berechtigte Daten das Produkt mit der Version aus, die Sie exportieren möchten.

  4. Wählen Sie unter Berechtigte Datensätze den Datensatz aus.

  5. Wählen Sie auf der Registerkarte Revisionen die Revision aus und klicken Sie dann auf Nach Amazon S3 exportieren.

  6. Wählen Sie unter Revision nach Amazon S3 exportieren eine Zieloption und das Ziel des Amazon S3 S3-Bucket-Ordners aus, konfigurieren Sie die Verschlüsselungsoptionen und wählen Sie dann Exportieren aus.

    Ein Job zum Exportieren Ihrer Revision wird gestartet. Nach Abschluss des Jobs wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.

Automatisches Exportieren von Revisionen in einen S3-Bucket als Abonnent

Wenn der Anbieter neue Versionen veröffentlicht, können Sie auswählen, ob neue Versionen automatisch in Ihren Amazon S3 S3-Bucket exportiert werden sollen. Sie können neue Versionen in bis zu fünf S3-Buckets exportieren. Neue Revisionen werden automatisch in den von Ihnen ausgewählten S3-Buckets angezeigt.

Anmerkung

Um Revisionen automatisch in einen S3-Bucket Ihrer Wahl zu exportieren, muss Ihr S3-Bucket über eine Bucket-Richtlinie verfügen, deren Berechtigungen für den Export von Daten in diesen AWS Data Exchange Bucket festgelegt sind. Weitere Informationen finden Sie unter Voraussetzungen für S3-Bucket-Richtlinienberechtigungen.

Voraussetzungen für S3-Bucket-Richtlinienberechtigungen

Bevor Sie Revisionen automatisch in einen S3-Bucket exportieren können, müssen Sie Requester Pays deaktivieren und für Ihren S3-Bucket muss eine Bucket-Richtlinie mit Berechtigungen eingerichtet sein, die den Export von Daten in AWS Data Exchange diesen Bucket ermöglichen. Die folgenden Verfahren enthalten Informationen dazu, wie Sie entweder Ihre bestehende S3-Bucket-Richtlinie bearbeiten oder eine S3-Bucket-Richtlinie mit diesen Berechtigungen erstellen können.

Wenn Ihr S3-Bucket für KMS Verschlüsselung konfiguriert istSSE, muss der Benutzer, der den Autoexport-Job konfiguriert, über die CreateGrant Berechtigung für den KMS Schlüssel verfügen, AWS Data Exchange um die Objekte in Ihren S3-Bucket zu kopieren.

Wichtig

Um zu überprüfen, ob die Voraussetzungen für die S3-Bucket-Richtlinienberechtigungen erfüllt sind, _ADX-TEST-ACCOUNTID# wird dem S3-Bucket während des automatischen Exportvorgangs ein Objekt mit dem Benennungsformat hinzugefügt.

Bearbeitung einer vorhandenen S3-Bucket-Richtlinie

Wenn Ihr S3-Bucket über eine Bucket-Richtlinie verfügt, gehen Sie wie folgt vor AWS Data Exchange , um Daten dorthin exportieren zu können.

Um eine bestehende S3-Bucket-Richtlinie zu bearbeiten

  1. Navigieren Sie zu dem Bucket, in den Sie Revisionen exportieren möchten.

  2. Wählen Sie den Tab „Berechtigungen“ und anschließend im Abschnitt „Bucket-Richtlinie“ die Option Bearbeiten aus.

  3. Kopieren Sie die folgende Anweisung und fügen Sie sie am Ende der Kontoausweisliste ein.

    
    {
      "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>Ersetzen Sie es durch den Namen Ihres S3-Buckets und <AWS ID> ersetzen Sie es durch Ihre AWS ID.

  5. Wählen Sie Änderungen speichern.

  6. Wenn Sie weitere Buckets als Ziel für Ihre Autoexport-Jobs hinzufügen möchten, wiederholen Sie den Vorgang ab Schritt 1.

Eine S3-Bucket-Richtlinie erstellen

Wenn Ihr S3-Bucket keine Bucket-Richtlinie hat, gehen Sie wie folgt vor, um eine S3-Bucket-Richtlinie zu erstellen, mit der Daten dorthin exportiert werden können AWS Data Exchange .

Um eine S3-Bucket-Richtlinie zu erstellen

  1. Navigieren Sie zu dem Bucket, in den Sie Revisionen exportieren möchten.

  2. Wählen Sie den Tab „Berechtigungen“ und anschließend im Abschnitt „Bucket-Richtlinie“ die Option Bearbeiten aus.

  3. Kopieren Sie die folgende vollständige Bucket-Richtlinie und fügen Sie sie in den Bucket-Policy-Editor ein.

    {
  "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>Ersetzen Sie es durch den Namen Ihres S3-Buckets und <AWS ID> ersetzen Sie es durch Ihre AWS ID.

  5. Wählen Sie Änderungen speichern.

  6. Wenn Sie weitere Buckets als Ziel für Ihre Autoexport-Jobs hinzufügen möchten, wiederholen Sie den Vorgang ab Schritt 1.

Automatisches Exportieren von Revisionen in einen S3-Bucket als Abonnent (Konsole)

Anmerkung

Um Revisionen automatisch in einen S3-Bucket Ihrer Wahl zu exportieren, muss Ihr S3-Bucket über eine Bucket-Richtlinie verfügen, deren Berechtigungen für den Export von Daten in diesen AWS Data Exchange Bucket festgelegt sind. Weitere Informationen finden Sie unter Voraussetzungen für S3-Bucket-Richtlinienberechtigungen.

Um als Abonnent (Konsole) eine Revision automatisch in einen S3-Bucket zu exportieren

  1. Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data Exchange Konsole an.

  2. Wählen Sie im linken Navigationsbereich für Meine Abonnements die Option Berechtigte Daten aus.

  3. Wählen Sie unter Berechtigte Daten das Produkt mit der Version aus, die Sie exportieren möchten.

  4. Wählen Sie unter Berechtigte Datensätze den Datensatz aus.

  5. Wählen Sie auf der Registerkarte Revisionen unter Auftragsziele für Autoexport die Option Aktionen und dann Autoexport-Auftragsziel hinzufügen aus.

  6. Wählen Sie unter Autoexport-Jobziel hinzufügen entweder die Option Einfaches oder Erweitertes Ziel aus.

    1. Wenn Sie die Option Einfach wählen, wählen Sie das Amazon S3 S3-Bucket-Ordner-Ziel aus der Drop-down-Liste und den Verschlüsselungsoptionen aus und wählen Sie dann Bucket-Ziel hinzufügen.

    2. Wenn Sie die Option Erweitert wählen, wählen Sie das Ziel des Amazon S3 S3-Bucket-Ordners aus der Dropdownliste aus, wählen Sie das Schlüsselbenennungsmuster aus und hängen Sie es an den Pfad an.

  7. Überprüfen Sie die Ausgabe.

  8. Legen Sie die Verschlüsselungsoptionen fest, überprüfen Sie die Amazon S3 S3-Preise und wählen Sie dann Bucket-Ziel hinzufügen.

    Das Amazon S3 S3-Bucket-Ziel wird auf der Registerkarte Revisionen unter Jobziele für den automatischen Export angezeigt.

    Ein Job wird gestartet, um Ihre Revision automatisch zu exportieren.

    Um zu überprüfen, ob die Voraussetzungen für S3-Bucket-Richtlinienberechtigungen erfüllt sind, _ADX-TEST-ACCOUNTID# wird dem S3-Bucket ein Objekt mit dem Benennungsformat hinzugefügt.

    Nachdem der Job abgeschlossen ist, wird das Feld Status im Abschnitt Jobs auf Completed aktualisiert.

    Um ein weiteres Ziel hinzuzufügen, wählen Sie Aktionen und dann Autoexport-Jobziel hinzufügen.

    Wählen Sie zum Bearbeiten das Ziel aus, das Sie bearbeiten möchten, wählen Sie Aktionen und dann Zielkonfiguration bearbeiten aus.

    Um zu löschen, wählen Sie Aktionen und dann Autoexport-Jobziel entfernen aus.

Automatisches Exportieren von Revisionen in einen S3-Bucket als Abonnent ()AWS SDKs

Anmerkung

Um Revisionen automatisch in einen S3-Bucket Ihrer Wahl zu exportieren, muss Ihr S3-Bucket über eine Bucket-Richtlinie verfügen, deren Berechtigungen für den Export von Daten in diesen AWS Data Exchange Bucket festgelegt sind. Weitere Informationen finden Sie unter Voraussetzungen für S3-Bucket-Richtlinienberechtigungen.

Um eine Revision automatisch in einen S3-Bucket zu exportieren ()AWS SDKs

  1. Erstellen Sie eine Create_Event_Action Anfrage.

  2. Nehmen Sie Folgendes in die Anfrage auf:

    • Action

      • ExportRevisionToS3

        • Encryption

          • KmsKeyArn

          • Type

      • RevisionDestination

        • Bucket

        • KeyPattern

    • Event

      • RevisionPublished

        • DataSetId

  3. Ändern Sie bei Bedarf das Schlüsselmuster. Der Amazon S3 S3-Objektschlüssel verwendet standardmäßig das Schlüsselmuster{Revision.CreatedAt}/{Asset.Name}.

    Weitere Informationen zu Schlüsselmustern finden Sie unterWichtige Muster beim Exportieren von Revisionen.

    Um zu überprüfen, ob die Voraussetzungen für S3-Bucket-Richtlinienberechtigungen erfüllt sind, _ADX-TEST-ACCOUNTID# wird dem S3-Bucket ein Objekt mit dem Benennungsformat hinzugefügt.

Wichtige Muster beim Exportieren von Revisionen

Wenn Sie eine Revision exportieren, wird jedes Asset zu einem Objekt im S3-Bucket. Die Namen der Objekte basieren auf einem Schlüsselmuster, das Sie angeben. Sie können dynamische Referenzen verwenden, die Asset-Attribute darstellen, um ein Muster für die Namen zu erstellen, die beim Export automatisch generiert werden. Verwenden Sie die in der folgenden Tabelle aufgeführten dynamischen Referenzen.

Dynamische Verweise Beschreibung
${Asset.Id} Die ID des Assets.
${Asset.Name} Der Name des Vermögenswerts.
${DataSet.Id} Die ID des Datensatzes, der exportiert wird.
${DataSet.Name} Der Name des Datensatzes, der exportiert wird.
${Revision.CreatedAt} UTCDatum und Uhrzeit der Erstellung der Revision im folgenden Format: YYYY -MM DDTHH -:MM:. SSZ Zum Beispiel: 2021-10-08T 16:33:19.787 Z
${Revision.CreatedAt.Day} Der Tag des Monats, an dem die Revision erstellt wurde.
${Revision.CreatedAt.Month} Der Monat, in dem die Revision erstellt wurde.
${Revision.CreatedAt.Year} Das Jahr, in dem die Revision erstellt wurde.
${Revision.Id} Die ID der Revision, die exportiert wird.

Sie können diese dynamischen Verweise verwenden, um die Schlüsselmuster für Ihre Asset-Namen zu erstellen. Sie müssen mindestens einen der beiden Asset dynamischen Verweise angeben, nämlich ${Asset.Name} und${Asset.Id}.

Die Verwendung ${Revision.Id}/${Asset.Name} als Schlüsselmuster führt beispielsweise zu Amazon S3 S3-Objekten, die die Revisions-ID und den Asset-Namen (durch einen Schrägstrich getrennt) als Objektnamen verwenden.

Wenn Sie eine Revision mit der ID exportierentestRevisionId, die zwei Assets mit dem Namen asset1 und hatasset2, werden die Assets an die folgenden Speicherorte in Amazon S3 exportiert:

  • <bucket>/testRevisionId/asset1

  • <bucket>/testRevisionId/asset2

Anmerkung

Ihre resultierenden Objekte müssen eindeutige Namen haben. Wenn sie dieselben Namen wie bestehende Objekte im S3-Bucket haben, überschreibt Ihr Export die vorhandenen Objekte. Wenn die Revision, die Sie exportieren, nicht eindeutige Namen hat (z. B. zwei Assets mit demselben Namen), schlägt der Export fehl. Die einzige dynamische Referenz, die einzigartig ist, ist${Asset.Id}.