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.
Veröffentlichung eines neuen Produkts
In den folgenden Themen wird beschrieben, wie ein neues Produkt AWS Data Exchange mithilfe der AWS Data Exchange Konsole veröffentlicht wird.
Themen
- Veröffentlichung eines Produkts mit dateibasierten Daten
- Ein Produkt veröffentlichen, das APIs enthält
- Veröffentlichung eines Produkts mit Amazon Redshift Redshift-Datensätzen
- Veröffentlichung eines Produkts mit Amazon S3 S3-Datenzugriff
- Veröffentlichung eines Produkts, das Datensätze mit AWS Lake Formation Datenberechtigungen enthält (Vorschau)
Das folgende Video erklärt mehr darüber, wie Sie ein neues Datenprodukt auf veröffentlichenAWS Data Exchange.
Veröffentlichung eines Produkts mit dateibasierten Daten
In den folgenden Themen wird das Erstellen eines Datensatzes und das Veröffentlichen eines neuen Produkts mit dateibasierten Daten AWS Data Exchange mithilfe der Konsole beschrieben. AWS Data Exchange Der Prozess umfasst die folgenden Schritte:
Schritte
Schritt 1: Assets erstellen
Vermögenswerte sind die Daten inAWS Data Exchange. Weitere Informationen finden Sie unter Objekte.
Bevor Sie ein neues dateibasiertes Datenprodukt erstellen und veröffentlichen, müssen Sie:
-
Erstellen Sie Ihre Dateien.
AWS Data Exchangeunterstützt alle Dateitypen.
-
Speichern Sie Ihre Dateien als Objekte in Amazon Simple Storage Service (Amazon S3) oder auf Ihrem lokalen Computer.
Weitere Informationen zum Speichern von Dateien in Amazon S3 finden Sie im Amazon S3 S3-Benutzerhandbuch.
Schritt 2: Erstellen Sie einen Datensatz
Datensätze in AWS Data Exchange sind dynamisch und werden mithilfe von Revisionen versioniert, wobei jede Revision mindestens ein Asset enthält. Weitere Informationen finden Sie unter Daten in AWS Data Exchange.
Um einen Datensatz zu erstellen
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Eigene Datensätze aus.
-
Wählen Sie unter Eigene Datensätze die Option Datensatz erstellen aus, um den Assistenten für Schritte zur Datensatzerstellung zu öffnen.
-
Wählen Sie unter Datensatztyp auswählen die Option Dateien aus.
-
Geben Sie im Feld Datensatz definieren einen Namen und eine Beschreibung für Ihren Datensatz ein. Weitere Informationen finden Sie unter Bewährte Verfahren für Datensätze.
-
(Optional) Fügen Sie unter Tags hinzufügen — optional Tags hinzu.
-
Klicken Sie auf Create data set.
Schritt 3: Erstellen Sie eine Revision
Im folgenden Verfahren erstellen Sie eine Revision, nachdem Sie einen Datensatz in der AWS Data Exchange Konsole erstellt haben. Weitere Informationen finden Sie unter Überarbeitungen.
Um eine Revision zu erstellen
-
Gehen Sie auf der Seite mit den Datensatz-Details im Bereich Datensatzübersicht wie folgt vor:
-
(Optional) Wählen Sie „Name bearbeiten“, um Informationen zu Ihrem Datensatz zu bearbeiten.
-
(Optional) Wählen Sie Löschen, um den Datensatz zu löschen.
-
-
Wählen Sie im Abschnitt Revisionen die Option Revision erstellen aus.
-
Geben Sie unter Revision definieren optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.
-
(Optional) Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.
-
Wählen Sie Revision erstellen aus.
-
Überprüfen, bearbeiten oder löschen Sie Ihre Änderungen aus dem vorherigen Schritt.
Schritt 4: Assets in eine Revision importieren
Im folgenden Verfahren importieren Sie Datenbestände und schließen dann die Revision in der AWS Data Exchange Konsole ab. Weitere Informationen finden Sie unter Objekte.
Um Ressourcen in die Revision zu importieren
-
Wählen Sie auf der Seite mit den Datensatzdetails im Abschnitt Jobs entweder Aus Amazon S3 importieren oder Hochladen (zum Hochladen von Ihrem Computer), je nachdem, wo die Datenbestände für den Datensatz aktuell gespeichert sind.
-
Folgen Sie je nach Ihrer Auswahl den Anweisungen. 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.
-
Wenn Sie weitere Daten hinzufügen möchten, wiederholen Sie Schritt 1.
-
Überprüfen Sie in der Revisionsübersicht Ihre Revision und ihre Inhalte.
-
Wählen Sie Revision abschließen aus.
Sie haben eine Revision für einen Datensatz erfolgreich abgeschlossen.
Sie können eine Revision bearbeiten oder löschen, bevor Sie sie einem Produkt hinzufügen.
Eine Revision bearbeiten
Um die Revision zu bearbeiten, nachdem Sie sie abgeschlossen haben
-
Wählen Sie in der Revisionsübersicht die Option De-finalisieren aus.
Es wird eine Meldung angezeigt, dass sich die Revision nicht mehr im finalisierten Zustand befindet.
-
Um die Revision zu bearbeiten, wählen Sie in der Revisionsübersicht die Optionen Aktionen, Bearbeiten aus.
-
Nehmen Sie Ihre Änderungen vor und wählen Sie dann Aktualisieren.
-
Überprüfen Sie Ihre Änderungen und wählen Sie dann Finalize aus.
Löschen Sie eine Revision
Um die Revision zu löschen, nachdem Sie sie abgeschlossen haben
-
Wählen Sie in der Revisionsübersicht die Option Löschen aus.
-
Geben Sie
Delete
im Dialogfeld „Revision löschen“ etwas ein, und wählen Sie dann Löschen aus.
Warnung
Dadurch werden die Revision und alle zugehörigen Elemente gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.
Schritt 5: Veröffentlichen Sie ein neues Produkt
Nachdem Sie mindestens einen Datensatz erstellt und eine Überarbeitung mit Ressourcen abgeschlossen haben, können Sie diesen Datensatz als Teil eines Produkts veröffentlichen. Weitere Informationen finden Sie unter Produktdetails. Stellen Sie sicher, dass Sie über alle erforderlichen Informationen zu Ihrem Produkt und Angebot verfügen.
Um ein neues Produkt zu veröffentlichen
-
Wählen Sie im linken Navigationsbereich der AWS Data ExchangeKonsole
unter Daten veröffentlichen die Option Produkte aus. -
Wählen Sie unter Produkte die Option Neues Produkt veröffentlichen aus, um den Assistenten zur Veröffentlichung neuer Produkte zu öffnen.
-
Wählen Sie im Abschnitt Produktsichtbarkeit die Optionen für die Produktsichtbarkeit und die Konfiguration Vertrauliche Informationen für Ihr Produkt aus und klicken Sie dann auf Weiter. Weitere Informationen finden Sie unter Sichtbarkeit des Produkts und Sensible Informationskategorien.
-
Aktivieren Sie im Abschnitt Daten hinzufügen unter Eigene Datensätze die Kontrollkästchen neben den Datensätzen, die Sie hinzufügen möchten, und wählen Sie dann Ausgewählte hinzufügen aus.
Anmerkung
Für die ausgewählten Datensätze muss eine endgültige Version vorliegen. Datensätze ohne abgeschlossene Versionen können nicht hinzugefügt werden.
-
Gehen Sie zu Ausgewählte Datensätze, um Ihre Auswahl zu überprüfen.
Sie können den Namen des Datensatzes, den Typ des Datensatzes und den Zeitstempel der letzten Aktualisierung des Datensatzes überprüfen.
-
Gehen Sie zu Revisionszugriffsregeln auswählen, wählen Sie die Revisionszugriffsregeln aus, die Sie für die in diesem Produkt enthaltenen Datensätze festlegen möchten, und klicken Sie dann auf Weiter. Weitere Details finden Sie unter Revision der Zugriffsregeln.
-
-
Geben Sie im Abschnitt Produkt definieren unter Produktübersicht Informationen zu Ihrem Produkt ein, einschließlich Produktname, Produktlogo, Support-Kontaktinformationen und Produktkategorien.
Weitere Informationen finden Sie unter Produktdetails.
-
(Optional) Wählen Sie im Abschnitt Produkt definieren unter Datenwörterbücher und Beispiele — optional einen Datensatz aus, indem Sie auf das Optionsfeld neben dem Datensatznamen klicken und dann Bearbeiten wählen.
-
Wählen Sie im Dialogfeld Bearbeiten unter Datenwörterbuch hochladen die Option Datei hinzufügen aus, um ein neues Datenwörterbuch hochzuladen.
Sie können ein Datenwörterbuch im CSV-Format mit einer maximalen Größe von 1 MB auswählen.
-
Wählen Sie ein auf Ihrem Computer gespeichertes Datenwörterbuch und dann Öffnen aus.
Die CSV-Datei mit dem Datenwörterbuch wird im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Ihr Datenwörterbuch muss der AWS Data Exchange Datenwörterbuchvorlage entsprechen. Wenn Sie kein gespeichertes Datenwörterbuch zum Hochladen haben, können Sie entweder den leeren Link zur Datenwörterbuchvorlage oder den Beispiellink für ein Datenwörterbuch in der AWS Data Exchange Konsole wählen.
-
Wählen Sie Datenwörterbuchvorschau, um eine Vorschau anzuzeigen.
-
Wählen Sie unter Beispiele — optional die Option Beispiele hochladen aus, wählen Sie ein Beispiel von Ihrem Computer aus und wählen Sie dann Öffnen aus.
Die Samples werden im Dialogfeld „Bearbeiten“ angezeigt.
Anmerkung
Sie können bis zu 10 Samples mit einer maximalen Größe von 50 MB hochladen. Beispiele im CSV-Format können in der Vorschau angezeigt werden.
-
Geben Sie für jedes Muster eine Beschreibung ein, die auf der Produktdetailseite angezeigt wird.
-
Wählen Sie Speichern aus.
-
-
Geben Sie unter Produktdefinition eine Kurzbeschreibung und eine Langbeschreibung Ihres Produkts ein.
Wenn Sie eine Vorlage für Ihre ausführliche Beschreibung verwenden möchten, wählen Sie Vorlage anwenden aus, wählen Sie Ihren Vorlagentyp aus und füllen Sie dann die Vorlage mit Ihren spezifischen Produktdetails aus.
-
Wählen Sie Weiter.
-
Konfigurieren Sie Ihr Angebot.
-
Wenn Sie ein öffentliches Angebot erstellen, konfigurieren Sie Ihr Angebot im Abschnitt Öffentliches Angebot hinzufügen. Für alle AWS Data Exchange Produkte, deren Sichtbarkeit auf Öffentlich gesetzt ist, ist ein öffentliches Angebot erforderlich.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie Ihre US-Mehrwertsteuereinstellungen, Ihren Datenabonnementvertrag (DSA) und Ihre Rückerstattungsrichtlinie aus.
-
(Optional) Richten Sie die Abonnementbestätigung ein, mit der Sie steuern können, wer dieses Produkt abonnieren kann. Weitere Informationen finden Sie unter Abonnementüberprüfung für Anbieter.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
Wenn du ein privates Angebot erstellst, konfiguriere die Angebotsdetails im Abschnitt Benutzerdefiniertes Angebot hinzufügen.
-
Fügen Sie im Abschnitt Informationen zum Abonnentenkonto mindestens ein Abonnentenkonto hinzu, auf das Sie das Angebot erweitern möchten.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie das Ablaufdatum des Angebots, bis zu dem der Abonnent das Angebot annehmen muss.
-
Wählen Sie Ihre Einstellungen für die US-Umsatzsteuer, den Datenabonnementvertrag (DSA) und die Rückerstattungsrichtlinie aus.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
-
Überprüfen Sie im Bereich Überprüfen und veröffentlichen Ihre Produktinformationen und erweitern Sie dann die Vorschau der Produktseite, um zu sehen, wie sie nach der Veröffentlichung aussehen werden.
-
Wenn Sie sicher sind, dass das Produkt und das öffentliche Angebot sichtbar und für alle verfügbar sein sollen, wählen Sie Veröffentlichen.
Sie haben jetzt den manuellen Teil der Veröffentlichung eines Datenprodukts mit einem öffentlichen Angebot abgeschlossen. AWS Data Exchangebereitet Ihr Produkt vor und veröffentlicht es. Auf der Produktübersichtsseite lautet der Status Ihres Produkts Wartet auf Genehmigung und ändert sich nach der Veröffentlichung in Veröffentlicht.
Schritt 6: (Optional) Kopieren Sie ein Produkt
Nachdem Sie Ihr erstes Produkt erstellt haben, können Sie dessen Details und öffentliche Angebote kopieren, um ein neues Produkt zu erstellen.
Anmerkung
Sie können ein öffentliches, privates, veröffentlichtes oder unveröffentlichtes Produkt kopieren. Benutzerdefinierte Angebote, die mit dem Produkt verknüpft sind, werden nicht kopiert, öffentliche Angebote werden jedoch kopiert.
Um ein Produkt zu kopieren
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Produkte aus.
-
Wählen Sie unter Produkte die Schaltfläche neben dem Produkt aus, das Sie kopieren möchten.
-
Wählen Sie das Drop-down-Menü Aktionen aus und wählen Sie dann Kopie erstellen aus.
-
Fahren Sie mit dem Workflow „Neues Produkt veröffentlichen“ fort, wobei die Details für das Produkt, das Sie in Schritt 3 ausgewählt haben, bereits ausgefüllt sind. Weitere Informationen finden Sie unter Schritt 5: Veröffentlichen Sie ein neues Produkt.
Ein Produkt veröffentlichen, das APIs enthält
Übersicht
In den folgenden Themen wird der Prozess der Erstellung eines REST-API-Datensatzes und der Veröffentlichung eines neuen Produkts beschrieben, das APIs enthältAWS Data Exchange. Sie können den Vorgang entweder mit der AWS Data Exchange Konsole oder mit dem abschließenAWS Command Line Interface.
Nachdem Sie Ihre Amazon API Gateway Gateway-REST-API eingerichtet haben, können Sie einen neuen API-Datensatz in erstellenAWS Data Exchange. Anschließend können Sie eine Revision erstellen und API-Assets hinzufügen.
Durch das Erstellen und Veröffentlichen eines API-Assets können Abonnentenanfragen an einen AWS Data Exchange Endpunkt per Proxy an Ihre API-Gateway-API weitergeleitet werden. Anschließend können Sie diesen Datensatz zu einem Produkt hinzufügen und Preise hinzufügen. Anschließend können Abonnenten Ihr Produkt im Katalog und im AWS Marketplace Katalog ansehen und abonnieren. AWS Data Exchange
AWS Data ExchangeEs sind Funktionen verfügbar, darunter revisionäre Zugriffsregeln, private Produkte, private Angebote und Abonnementverifizierung.
Sie können nur die vertragsbasierte Preisgestaltung, die Preisgestaltung nach Maß (bei der der Vertragspreis 0$ beträgt) oder eine Kombination aus gemessener und vertraglich festgelegter Preisgestaltung wählen.
Sie können zwischen standardmäßigen und nach der Berechnung berechneten Kosten wählen. Es stehen drei Arten von Standardkosten zur Verfügung:
-
Pro API-Anfrage
-
Pro erfolgreicher API-Anfrage
-
Pro übertragener Dateneinheit in Byte
Anmerkung
Die gemessenen Kosten gelten für alle API-Datensätze in einem Produkt. Wenn Sie also unterschiedliche Preise für dieselbe Dimension für verschiedene API-Datensätze berechnen möchten, empfehlen wir Ihnen, diese Datensätze in verschiedenen Produkten zu erstellen.
Der Prozess umfasst die folgenden Schritte:
Schritte
- Voraussetzungen
- Schritt 1: Aktualisieren Sie die API-Ressourcenrichtlinie
- Schritt 2: Erstellen Sie einen API-Datensatz
- Schritt 3: Erstellen Sie eine Revision
- Schritt 4: Fügen Sie API-Assets zu einer Revision hinzu
- Schritt 5: Veröffentlichen Sie ein neues Produkt mit APIs
- Schritt 6: (Optional) Kopieren Sie ein Produkt
Voraussetzungen
Bevor Sie ein Produkt mit APIs veröffentlichen können, müssen Sie die folgenden Voraussetzungen erfüllen:
-
Bevor Sie eines davon AWS -Service verwenden könnenAWS Data Exchange, müssen Sie sich registrieren AWS und einen Administratorbenutzer erstellen. Weitere Informationen finden Sie unter Erste Schritte im AWS IAM Identity Center-Benutzerhandbuch.
-
Um Produkte auf erstellen zu könnenAWS Data Exchange, müssen Sie sich AWS-Konto als AWS Marketplace Verkäufer registrieren. Verwenden Sie dieses Konto, um Ihre Datensätze zu erstellen. Das Konto mit der API Gateway Gateway-Ressource muss sich nicht in demselben Konto befinden, das die Datensätze erstellt.
-
Ihre REST-API muss sich auf Amazon API Gateway mit einer Integration befinden, die ein geeignetes Anfrage- und Antwortmodell für den Zugriff auf Ihre Daten verwendet, z. B. Amazon DynamoDB oder. AWS Lambda Weitere Informationen finden Sie unter Entwickeln einer REST-API in API Gateway und Arbeiten mit REST-APIs im Amazon API Gateway Developer Guide.
Anmerkung
Es werden nur öffentliche API-Gateway-APIs unterstützt.
-
Ihre API-Gateway-REST-API muss in der Lage sein, Aufrufe vom AWS Data Exchange Service Principal zu authentifizieren und zu autorisieren. Jede Anfrage AWS Data Exchange an Ihre API verwendet das Signature Version 4 (Sigv4) -Protokoll, das mit Anmeldeinformationen signiert ist. AWS Data Exchange AWS Data Exchangefunktioniert mit benutzerdefinierten Domänen und Domänenschlüsselzuordnungen.
Anmerkung
AWS Data Exchangeunterstützt Amazon Cognito, No-Auth und Autorisierer nicht. AWS Lambda
-
Wenn Ihre API Gateway Gateway-REST-API ein benutzerdefiniertes Identitätssystem für die Authentifizierung und Autorisierung verwendet, konfigurieren Sie es für die Verwendung der IAM-Authentifizierung und importieren Sie ein OpenAPI-Schema, das Ihre API beschreibt. AWS Data Exchangeruft Ihre API-Gateway-REST-API mit ihren eigenen Dienstanmeldedaten auf und enthält Abonnenteninformationen wie die Konto-ID.
-
Ihre API-Gateway-REST-API ist für die Integration in Ihr Backend verantwortlich. Führen Sie dazu einen der folgenden Schritte aus:
-
Hängen Sie jeder Anfrage, die über Ihre API Gateway eingeht, ein langlebiges Authentifizierungstoken an, das das Backend überprüfen kann.
-
Verwenden Sie API Gateway, um eine Lambda-Funktion aufzurufen, die Anmeldeinformationen generieren und Ihre API aufrufen kann.
-
Ihre API wird gemäß der Spezifikation für die API-Integrationsanfrage aufgerufen.
Weitere Informationen finden Sie unter den folgenden Themen:
Sicherheit von API-Datensätzen
AWS Data Exchangeverschlüsselt den Verkehr von Ende zu Ende mit Transport Layer Security (TLS) 1.2. Alle Metadaten werden im Ruhezustand verschlüsselt. AWS Data Exchangespeichert keine Abonnentenanfragen oder Antworten von Ihrem Backend. Wir extrahieren nur Metering-Metadaten, die für die Abrechnung erforderlich sind.
Spezifikation der API-Integrationsanfrage
Bei aktivierter API AWS Data Exchange werden alle Header (mit Ausnahme der unter aufgeführten HeaderHeader-Weiterleitung), der Hauptteil, die HTTP-Methode, der Pfad und die Abfragezeichenfolgen unverändert aus der Kundenanfrage weitergeleitet und die folgenden Header angehängt.
// These headers help prevent Confused Deputy attacks. They enable the SourceAccount // and SourceArn variables in IAM policies. 'x-amz-source-account': ACCOUNT_ID, 'x-amz-source-arn': `arn:aws:dataexchange:${REGION}:${OWNER_ACCOUNT_ID}:data-sets/${DATA_SET_ID}/revisions/${REVISION_ID}/assets/${ASSET_ID}`, // These headers identify the API Asset in Data Exchange. 'x-amzn-dataexchange-asset-id': ASSET_ID, 'x-amzn-dataexchange-data-set-id': DATA_SET_ID, 'x-amzn-dataexchange-revision-id': REVISION_ID, // This header identifies the Data Exchange Product. 'x-amzn-dataexchange-product-id': PRODUCT_ID, // This header identifies the caller of Data Exchange. It will contain subscriber // information. 'x-amzn-dataexchange-requester-account-id': REQUESTER_ACCOUNT_ID, // Providers can attach custom metadata in the form of key/value pairs // to a particular subscription. We will send these key/value pairs as stringified // JSON. 'x-amz-dataexchange-subscription-metadata': STRINGIFIED_METADATA,
Header-Weiterleitung
AWS Data Exchangeentfernt alle Header im Zusammenhang mit der Authentifizierung oder dem Namespace für Amazon, bevor sie an ein Anbieter-Backend weitergeleitet werden. AWS Data ExchangeInsbesondere entfernt:
-
Authentication
-Header -
Alle Header, die beginnen mit
x-amz
Der host
Header wird als Folge des Proxyings überschrieben.
Schritt 1: Aktualisieren Sie die API-Ressourcenrichtlinie
Wenn Sie über eine Amazon API Gateway Gateway-REST-API verfügen, die die Voraussetzungen erfüllt, müssen Sie Ihre API-Ressourcenrichtlinie aktualisieren, damit Sie Ihre API aufrufen können, wenn ein Abonnent eine Anfrage zum Abrufen des API-Schemas stellt. AWS Data Exchange
Um Ihre API-Ressourcenrichtlinie zu aktualisieren
-
Fügen Sie der Ressourcenrichtlinie Ihrer API die folgende Richtlinie hinzu:
{ "Effect": "Allow", "Principal": {"Service": "dataexchange.amazonaws.com"}, "Action": "execute-api:Invoke", "Resource": "*", "Condition": {"StringEquals": {"aws:SourceAccount": "<account-id>"}} }
-
account-id
Ersetzen Sie es durch das Konto, das den API-Datensatz erstellen wird.Das Konto mit der API-Gateway-Ressource muss sich nicht in demselben Konto befinden, das den Datensatz erstellt.
Diese Richtlinie beschränkt diese Berechtigungen auf Aufrufe durch den AWS Data Exchange Service Principal und verlangt, dass nur Ihr Konto die Integration mit Ihrer API autorisieren AWS Data Exchange kann.
Anmerkung
Wenn Sie über eine Ressourcenrichtlinie verfügen, die diesen Aufruf ausdrücklich AWS Data Exchange ablehnt, müssen Sie diese Ablehnung entfernen oder einschränken.
Sie sind jetzt bereit, einen API-Datensatz zu erstellen.
Schritt 2: Erstellen Sie einen API-Datensatz
Datensätze in AWS Data Exchange sind dynamisch und werden mithilfe von Revisionen versioniert, wobei jede Revision mindestens ein Asset enthält. Weitere Informationen finden Sie unter Daten in AWS Data Exchange.
Sie verwenden entweder die AWS Data Exchange Konsole oder dieAWS Command Line Interface, um einen API-Datensatz zu erstellen:
Einen API-Datensatz erstellen (Konsole)
Um einen API-Datensatz (Konsole) zu erstellen
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Meine Daten die Option Eigene Datensätze aus.
-
Wählen Sie unter Eigene Datensätze die Option Datensatz erstellen aus, um den Assistenten für Schritte zur Datensatzerstellung zu öffnen.
-
Wählen Sie unter Datensatztyp auswählen die Option Amazon API Gateway API aus.
-
Geben Sie unter Datensatz definieren einen Namen und eine Beschreibung für Ihren Datensatz ein. Weitere Informationen finden Sie unter Bewährte Verfahren für Datensätze.
-
(Optional) Fügen Sie unter Tags hinzufügen — optional Tags hinzu.
-
Wählen Sie Erstellen aus.
Sie sind jetzt bereit, eine Revision zu erstellen.
Einen API-Datensatz erstellen (AWS CLI)
So erstellen Sie einen API-Datensatz (CLI)
-
Verwenden Sie den
create-data-set
Befehl, um einen API-Datensatz zu erstellen:$ aws dataexchange create-data-set \ --asset-type API_GATEWAY_API \ --description 'Data Set Description' \ --name 'Data Set Name' { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID", "AssetType": "API_GATEWAY_API", "CreatedAt": "2021-09-11T00:16:46.349000+00:00", "Description": "Data Set Description", "Id": "$DATA_SET_ID", "Name": "Data Set Name", "Origin": "OWNED", "UpdatedAt": "2021-09-11T00:16:46.349000+00:00" }
-
Beachten Sie den neuen Asset-Typ von
API_GATEWAY_API
.
Sie sind jetzt bereit, eine Revision zu erstellen.
Schritt 3: Erstellen Sie eine Revision
Im folgenden Verfahren erstellen Sie eine Revision, nachdem Sie einen Datensatz erstellt haben. Weitere Informationen finden Sie unter Überarbeitungen.
Sie verwenden entweder die AWS Data Exchange Konsole oder dieAWS Command Line Interface, um eine Revision zu erstellen:
Eine Revision erstellen (Konsole)
Um eine Revision zu erstellen (Konsole)
-
Gehen Sie auf der Seite mit den Datensatz-Details im Abschnitt „Datensatzübersicht“ wie folgt vor:
-
(Optional) Wählen Sie „Name bearbeiten“, um Informationen zu Ihrem Datensatz zu bearbeiten.
-
(Optional) Wählen Sie Löschen, um den Datensatz zu löschen.
-
-
Wählen Sie im Abschnitt Revisionen die Option Revision erstellen aus.
-
Geben Sie unter Revision definieren optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.
-
(Optional) Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.
-
Wählen Sie Revision erstellen aus.
-
Überprüfen, bearbeiten oder löschen Sie Ihre Änderungen aus dem vorherigen Schritt.
Sie sind jetzt bereit, API-Assets zur Revision hinzuzufügen.
Eine Revision erstellen (AWS CLI)
Um eine Revision zu erstellen (AWS CLI)
-
Verwenden Sie den
create-revision
Befehl, um eine Revision zu erstellen:$ aws dataexchange create-revision \ --data-set-id $DATA_SET_ID \ --comment 'First Atlas Revision' { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID", "Comment": "First Atlas Revision", "CreatedAt": "2021-09-11T00:18:49.160000+00:00", "DataSetId": "$DATA_SET_ID", "Finalized": false, "Id": "$REVISION_ID", "UpdatedAt": "2021-09-11T00:18:49.160000+00:00" }
-
Fügen Sie die API-Assets zur Revision hinzu.
Anmerkung
Sie müssen die ID der API-Gateway-REST-API, die Sie importieren möchten, sowie die Phase kennen.
Schritt 4: Fügen Sie API-Assets zu einer Revision hinzu
API-Assets enthalten die Informationen, die Abonnenten benötigen, um Aufrufe an Ihre API zu tätigen. Weitere Informationen finden Sie unter Objekte.
Im folgenden Verfahren importieren Sie Datenbestände und schließen dann die Revision ab.
Sie verwenden entweder die AWS Data Exchange Konsole oder dieAWS CLI, um einer Revision Elemente hinzuzufügen:
Hinzufügen von API-Assets zu einer Revision (Konsole)
Um der Revision Assets hinzuzufügen (Konsole)
-
Wählen Sie auf der Seite mit den Datensatzdetails im Abschnitt API-Assets die Option API-Stufe hinzufügen aus.
-
Geben Sie unter Phase „API auswählen“ für Amazon API Gateway API eine API in das Eingabefeld ein oder wählen Sie eine der folgenden Optionen aus der Drop-down-Liste aus:
-
API in einer anderen AWS-Konto — das ist eine kontoübergreifende API, für deren Zugriff Ihnen eine Zugriffsberechtigung erteilt wurde.
-
In diesem AWS-Konto Fall ist dies eine API in IhremAWS-Konto.
-
Wenn Sie sich für eine andere API entschieden habenAWS-Konto, geben Sie die API-ID und den Namen der API-Stufe in die Eingabefelder ein.
-
Wenn Sie Darin ausgewählt habenAWS-Konto, wählen Sie den Namen der API-Stufe aus der Drop-down-Liste
Anmerkung
Sie können eine neue API-Phase erstellen, indem Sie Create new wählen und den Schritten im Modal Create new API on Amazon API Gateway folgen. Sobald die neue Phase erstellt wurde, wiederholen Sie Schritt 2.
-
-
Unter Erweiterte Konfiguration — optional können Sie den bestehenden Amazon API Gateway Gateway-Nutzungsplan Connect wählen, um die Drosselung und die Kontingentbeschränkungen zu verwenden, die im bestehenden Nutzungsplan definiert sind, und den API-Schlüssel eingeben.
-
Geben Sie unter Dokument-API für Abonnenten Einzelheiten zur API an, die den Abonnenten angezeigt wird, nachdem sie Ihr Produkt abonniert haben.
-
Geben Sie als API-Name einen Namen ein, anhand dessen Abonnenten das API-Asset identifizieren können.
Anmerkung
Wenn ein In this ausgewählt AWS-Konto wurde, wird der API-Name automatisch ausgefüllt, den Sie bei Bedarf ändern können.
Wenn eine API in einer anderen ausgewählt AWS-Konto wurde, wird der API-Name mit einem Standardnamen aufgefüllt, den Sie entsprechend ändern sollten, damit der Abonnent leicht verstehen kann, um was es sich handelt.
-
Für die OpenAPI 3.0-Spezifikation gilt entweder:
-
Geben Sie die OpenAPI 3.0-Spezifikationsdatei ein oder kopieren Sie sie und fügen Sie sie ein.
-
Wählen Sie Aus .JSON-Datei importieren und wählen Sie dann die zu importierende JSON-Datei von Ihrem lokalen Computer aus.
Die importierte Spezifikation wird im Feld angezeigt.
-
Wählen Sie Aus Amazon API Gateway importieren und wählen Sie dann eine Spezifikation für den Import aus.
Die importierte Spezifikation wird im Feld angezeigt.
-
-
Für zusätzliche Dokumentation — optional — geben Sie alle zusätzlichen Informationen ein, die für den Abonnenten nützlich sind, um mehr über Ihre API zu erfahren. Markdown wird unterstützt.
Anmerkung
Sie können die OpenAPI-Spezifikation und die zusätzliche Dokumentation nicht bearbeiten, nachdem Sie dieses Asset zu einer Revision hinzugefügt haben.
Wenn Sie diese Informationen aktualisieren möchten und die Revision noch nicht abgeschlossen ist, können Sie das Asset ersetzen.
Wenn Sie diese Informationen aktualisieren möchten und die Revision abgeschlossen ist, können Sie eine neue Version mit dem aktualisierten Objekt erstellen.
-
-
Wählen Sie „API-Phase hinzufügen“.
Es wird ein Job gestartet, um Ihr Asset (in diesem Fall die API) in Ihren Datensatz zu importieren.
Anmerkung
Wenn Sie keine API auf Amazon API Gateway haben, werden Sie aufgefordert, eine zu erstellen.
-
Nachdem der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.
-
Wenn Sie weitere APIs hinzufügen möchten, wiederholen Sie Schritt 2.
-
Überprüfen Sie unter Revisionsübersicht Ihre Revision und ihre Inhalte.
-
Wählen Sie Finalize aus.
Sie haben eine Revision für einen Datensatz erfolgreich abgeschlossen.
Sie können eine Revision bearbeiten oder löschen, bevor Sie sie einem Produkt hinzufügen.
Sie sind jetzt bereit, ein neues API-Datenprodukt zu veröffentlichen.
Hinzufügen von API-Assets zu einer Revision (AWS CLI)
Sie können API-Assets hinzufügen, indem Sie einen IMPORT_ASSET_FROM_API_GATEWAY_API
Job ausführen.
So fügen Sie API-Assets zu einer Revision hinzu (AWS CLI):
-
Verwenden Sie den
create-job
Befehl, um API-Assets zur Revision hinzuzufügen:$ aws dataexchange create-job \ --type IMPORT_ASSET_FROM_API_GATEWAY_API \ --details '{"ImportAssetFromApiGatewayApi":{"DataSetId":"$DATA_SET_ID","RevisionId":"$REVISION_ID","ApiId":"$API_ID","Stage":"$API_STAGE","ProtocolType":"REST"}}' { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/$JOB_ID", "CreatedAt": "2021-09-11T00:38:19.875000+00:00", "Details": { "ImportAssetFromApiGatewayApi": { "ApiId": "$API_ID", "DataSetId": "$DATA_SET_ID", "ProtocolType": "REST", "RevisionId": "$REVISION_ID", "Stage": "$API_STAGE" } }, "Id": "$JOB_ID", "State": "WAITING", "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API", "UpdatedAt": "2021-09-11T00:38:19.875000+00:00" } $ aws dataexchange start-job --job-id $JOB_ID $ aws dataexchange get-job --job-id $JOB_ID { "Arn": "arn:aws:dataexchange:us-east-1:0123456789012:jobs/$JOB_ID", "CreatedAt": "2021-09-11T00:38:19.875000+00:00", "Details": { "ImportAssetFromApiGatewayApi": { "ApiId": "$API_ID", "DataSetId": "$DATA_SET_ID", "ProtocolType": "REST", "RevisionId": "$REVISION_ID", "Stage": "$API_STAGE" "ApiEndpoint": "string", "ApiKey": "string", "ApiName": "string", "ApiDescription": "string", "ApiSpecificationDownloadUrl": "string", "ApiSpecificationDownloadUrlExpiresAt": "string" } }, "Id": "$JOB_ID", "State": "COMPLETED", "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API", "UpdatedAt": "2021-09-11T00:38:52.538000+00:00" }
-
Verwenden Sie den
list-revision-assets
Befehl, um zu bestätigen, dass das neue Asset ordnungsgemäß erstellt wurde:$ aws dataexchange list-revision-assets \ --data-set-id $DATA_SET_ID \ --revision-id $REVISION_ID { "Assets": [ { "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID/assets/$ASSET_ID", "AssetDetails": { "ApiGatewayApiAsset": { "ApiEndpoint": "https://$API_ID.execute-api.us-east-1.amazonaws.com/$API_STAGE", "ApiId": "$API_ID", "ProtocolType": "REST", "Stage": "$API_STAGE" } }, "AssetType": "API_GATEWAY_API", "CreatedAt": "2021-09-11T00:38:52.457000+00:00", "DataSetId": "$DATA_SET_ID", "Id": "$ASSET_ID", "Name": "$ASSET_ID/$API_STAGE", "RevisionId": "$REVISION_ID", "UpdatedAt": "2021-09-11T00:38:52.457000+00:00" } ] }
Sie sind jetzt bereit, das API-Datenprodukt zu veröffentlichen.
Bearbeiten Sie eine Revision
Um die Revision zu bearbeiten, nachdem Sie sie abgeschlossen haben
-
Wählen Sie in der Revisionsübersicht die Option De-finalisieren aus.
Es wird eine Meldung angezeigt, dass sich die Revision nicht mehr im finalisierten Zustand befindet.
-
Um die Revision zu bearbeiten, wählen Sie in der Revisionsübersicht die Optionen Aktionen, Bearbeiten aus.
-
Nehmen Sie Ihre Änderungen vor und wählen Sie dann Aktualisieren.
-
Überprüfen Sie Ihre Änderungen und wählen Sie dann Finalize aus.
Lösche eine Revision
Um die Revision zu löschen, nachdem Sie sie abgeschlossen haben
-
Wählen Sie in der Revisionsübersicht die Option Löschen aus.
-
Geben Sie
Delete
im Dialogfeld „Revision löschen“ einen Text ein, und wählen Sie dann Löschen aus.
Warnung
Dadurch werden die Revision und alle zugehörigen Elemente gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.
Schritt 5: Veröffentlichen Sie ein neues Produkt mit APIs
Nachdem Sie mindestens einen Datensatz erstellt und eine Überarbeitung mit Ressourcen abgeschlossen haben, können Sie diesen Datensatz als Teil eines Produkts veröffentlichen. Weitere Informationen finden Sie unter Produktdetails. Stellen Sie sicher, dass Sie über alle erforderlichen Informationen zu Ihrem Produkt und Angebot verfügen.
Sie verwenden die AWS Data Exchange Konsole oder die AWS Marketplace Katalog-API, um ein neues Produkt mit APIs zu veröffentlichen. Weitere Informationen zum Veröffentlichen eines neuen Produkts mithilfe der AWS Marketplace Katalog-API finden Sie unterVerwendung AWS Data Exchange mit der AWS Marketplace Catalog API.
Veröffentlichung eines neuen Produkts mit APIs (Konsole)
Um ein neues Produkt mit APIs zu veröffentlichen
-
Wählen Sie im linken Navigationsbereich der AWS Data ExchangeKonsole
unter Daten veröffentlichen die Option Produkte aus. -
Wählen Sie unter Produkte die Option Neues Produkt veröffentlichen aus, um den Assistenten zur Veröffentlichung neuer Produkte zu öffnen.
-
Unter Produktsichtbarkeit:
-
Wählen Sie für die Sichtbarkeit Ihres Produkts entweder „Öffentlich“ oder „Privat“.
Für alle AWS Data Exchange Produkte, deren Sichtbarkeit auf „Öffentlich“ eingestellt ist, ist ein öffentliches Angebot erforderlich.
Weitere Informationen finden Sie unter Sichtbarkeit des Produkts.
-
Wählen Sie die Konfiguration für sensible Informationen für Ihr Produkt aus.
Weitere Informationen finden Sie unter Sensible Informationskategorien.
-
Wählen Sie Weiter.
-
-
Unter Daten hinzufügen:
-
Aktivieren Sie unter Eigene Datensätze die Kontrollkästchen neben den Datensätzen, die Sie hinzufügen möchten, und wählen Sie dann Ausgewählte hinzufügen aus.
Anmerkung
Für die ausgewählten Datensätze muss eine endgültige Version vorliegen. Datensätze ohne abgeschlossene Versionen werden nicht hinzugefügt.
-
Gehen Sie zu Ausgewählte Datensätze, um Ihre Auswahl zu überprüfen.
Sie können den Namen des Datensatzes, den Typ des Datensatzes und den Zeitstempel der letzten Aktualisierung des Datensatzes überprüfen.
-
Gehen Sie zu Revisionszugriffsregeln auswählen und wählen Sie die Revisionszugriffsregeln aus, die Sie für die in diesem Produkt enthaltenen Datensätze festlegen möchten.
Weitere Informationen finden Sie unter Revision der Zugriffsregeln.
-
Wählen Sie Weiter.
-
-
Unter Produkt definieren:
-
Geben Sie unter Produktübersicht Informationen zu Ihrem Produkt ein, einschließlich Produktname, Produktlogo, Support-Kontaktinformationen und Produktkategorien.
Weitere Informationen finden Sie unter Produktdetails.
-
(Optional) Wählen Sie unter Datenwörterbücher und Beispiele — optional einen Datensatz aus, indem Sie auf das Optionsfeld neben dem Namen des Datensatzes klicken und dann Bearbeiten auswählen.
-
Wählen Sie im Dialogfeld Bearbeiten die Option Hochladen aus, um ein neues Datenwörterbuch hochzuladen.
Sie können ein Datenwörterbuch im CSV-Format mit einer maximalen Größe von 1 MB auswählen.
-
Wählen Sie ein gespeichertes Datenwörterbuch auf Ihrem Computer aus und wählen Sie dann Öffnen.
Die CSV-Datei mit dem Datenwörterbuch wird im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Ihr Datenwörterbuch muss der AWS Data Exchange Datenwörterbuchvorlage entsprechen. Wenn Sie kein gespeichertes Datenwörterbuch zum Hochladen haben, können Sie entweder den leeren Link zur Datenwörterbuchvorlage oder den Beispiellink für ein Datenwörterbuch in der AWS Data Exchange Konsole wählen.
-
Wählen Sie Datenwörterbuchvorschau, um eine Vorschau des Datenwörterbuchs anzuzeigen.
-
Wählen Sie unter Beispiele — optional die Option Beispiele hochladen aus, wählen Sie ein Beispiel von Ihrem Computer aus und wählen Sie dann Öffnen aus.
Die Samples werden im Dialogfeld „Bearbeiten“ angezeigt.
Anmerkung
Sie können bis zu 10 Samples mit einer maximalen Größe von 50 MB hochladen. Beispiele im CSV-Format können in der Vorschau angezeigt werden.
-
Geben Sie für jedes Muster eine Beschreibung ein, die auf der Produktdetailseite angezeigt wird.
-
Wählen Sie Speichern aus.
-
-
-
Geben Sie unter Produktdefinition eine Kurzbeschreibung und eine Langbeschreibung Ihres Produkts ein.
Wenn Sie eine Vorlage für Ihre ausführliche Beschreibung verwenden möchten, wählen Sie Vorlage anwenden aus, wählen Sie Ihren Vorlagentyp aus und füllen Sie dann die Vorlage mit Ihren spezifischen Produktdetails aus.
-
Wählen Sie Weiter.
-
Konfigurieren Sie Ihr Angebot entweder unter Öffentliches Angebot hinzufügen (für öffentliches Angebot) oder Benutzerdefiniertes Angebot hinzufügen (für private Angebote):
Für alle AWS Data Exchange Produkte, deren Sichtbarkeit auf Öffentlich gesetzt ist, ist ein öffentliches Angebot erforderlich.
-
Nur für private Angebote:
-
Wählen Sie eine der aufgeführten Angebotstypen: Privatangebot, Erneuertes Privatangebot oder Bring Your Own Subscription (BYOS).
-
Fügen Sie im Abschnitt Informationen zum Abonnentenkonto mindestens ein Abonnentenkonto hinzu, auf das Sie das Angebot erweitern möchten.
-
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie für Kostenberechnung — optional die Option Hinzufügen aus.
-
Wählen Sie unter „Gemessene Kosten hinzufügen“ die Art der Kosten für den API-Aufruf aus der Liste Typ aus:
-
Pro API-Anfrage
-
Pro erfolgreicher API-Anfrage
-
Pro übertragener Dateneinheit in Byte
-
Neue individuell berechnete Kosten
-
-
Geben Sie den Anzeigenamen für die Kosten ein, der auf der Rechnung des Abonnenten angezeigt wird, oder aktualisieren Sie ihn.
-
Wenn du vordefinierte, gemessene Kosten verwendest, wird der Schlüssel automatisch generiert, kann nicht bearbeitet werden und muss nicht im Antwort-Header zurückgesendet werden.
-
Wenn Sie eine neue benutzerdefinierte Kostenberechnung erstellen, geben Sie den Schlüssel ein. Dabei handelt es sich um die Kennung für die gemessenen Kosten im API-Antwort-Header (maximal 15 Zeichen).
Dieser Schlüssel sollte als Teil des
x-amz-dataexchange-metering
Antwort-Headers zurückgesendet werden.Beispiel Benutzerdefinierter Schlüssel
Wenn Sie einen benutzerdefinierten Schlüssel aufgerufen
VertexCount
und einen anderen benutzerdefinierten Schlüssel aufgerufen habenEdgeCount
, könnte der Antwortheader „x-amz-dataexchange-metering“ den Wert habenVertexCount=3,EdgeCount=10
oder Sie könnten zwei separate Header-Zeilen zurückgeben:x-amz-dataexchange-metering: VertextCount=3
x-amz-dataexchange-metering: EdgeCount=10
-
Geben Sie im Feld Preis/Einheit den Preis ein, der dem Abonnenten pro Einheit berechnet wird.
-
(Optional) Geben Sie die Anzahl der Einheiten ein, um ein Beispiel für die Kosten im Rechner für gemessene Kosten anzuzeigen.
-
(Optional) Geben Sie eine kurze Beschreibung der gemessenen Kosten ein, die auf der Produktdetailseite angezeigt wird.
-
Wählen Sie Hinzufügen aus.
-
(Optional) Wiederholen Sie den Vorgang, um weitere gemessene Kosten hinzuzufügen.
Die Reihenfolge der gemessenen Kosten wird auf der Produktdetailseite angezeigt. Sie können sie nicht nachbestellen.
Anmerkung
Nachdem das Angebot erstellt wurde, können Sie den Preis und die Beschreibung eines gemessenen Preises bearbeiten. Weitere Informationen finden Sie unter Aktualisierung der Produkt- und Angebotsdetails.
-
-
Nur für private Angebote wählen Sie das Ablaufdatum des Angebots aus, bis zu dem der Abonnent das Angebot annehmen muss.
-
Wählen Sie Ihre Steuereinstellungen, den Datenabonnementvertrag (DSA) und die Rückerstattungsrichtlinie aus.
-
(Optional) Lege nur für öffentliche Angebote die Abonnementbestätigung fest, sodass du kontrollieren kannst, wer dieses Produkt abonnieren kann. Weitere Informationen finden Sie unter Abonnementüberprüfung für Anbieter.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
Überprüfen Sie im Bereich Überprüfen und veröffentlichen Ihre Produktinformationen.
-
Erweitern Sie die Vorschau der Produktseite, um zu sehen, wie die Produktseite nach der Veröffentlichung aussehen wird.
-
(Optional) Wählen Sie in einem beliebigen Abschnitt die Schaltfläche Bearbeiten, um diesen Abschnitt zu bearbeiten.
-
-
Wenn Sie sicher sind, dass Sie das Produkt und das öffentliche Angebot sichtbar und für alle verfügbar machen möchten, wählen Sie Veröffentlichen.
Sie haben jetzt den manuellen Teil der Veröffentlichung eines Datenprodukts mit einem öffentlichen Angebot abgeschlossen. AWS Data Exchangebereitet Ihr Produkt vor und veröffentlicht es.
Auf der Produktübersichtsseite lautet der Status Ihres Produkts Wartet auf Genehmigung und ändert sich nach der Veröffentlichung in Veröffentlicht.
Schritt 6: (Optional) Kopieren Sie ein Produkt
Nachdem Sie Ihr erstes Produkt erstellt haben, können Sie dessen Details und öffentliche Angebote kopieren, um ein neues Produkt zu erstellen.
Anmerkung
Sie können ein öffentliches, privates, veröffentlichtes oder unveröffentlichtes Produkt kopieren. Benutzerdefinierte Angebote, die mit dem Produkt verknüpft sind, werden nicht kopiert, öffentliche Angebote werden jedoch kopiert.
Um ein Produkt zu kopieren
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Produkte aus.
-
Wählen Sie unter Produkte die Schaltfläche neben dem Produkt aus, das Sie kopieren möchten.
-
Wählen Sie das Drop-down-Menü Aktionen aus und wählen Sie dann Kopie erstellen aus.
-
Fahren Sie mit dem Workflow „Neues Produkt veröffentlichen“ fort, wobei die Details für das Produkt, das Sie in Schritt 3 ausgewählt haben, bereits ausgefüllt sind. Weitere Informationen finden Sie unter Schritt 5: Veröffentlichen Sie ein neues Produkt.
Veröffentlichung eines Produkts mit Amazon Redshift Redshift-Datensätzen
Übersicht
Ein Amazon Redshift-Datensatz enthält AWS Data Exchange Datenfreigaben für Amazon Redshift. Wenn Kunden ein Produkt abonnieren, das Datashares enthält, erhalten sie Lesezugriff auf die Tabellen, Ansichten, Schemas und benutzerdefinierten Funktionen, die ein Datenanbieter dem Datashare hinzufügt.
Als Datenanbieter erstellen Sie eine Datenfreigabe AWS Data Exchange für Amazon Redshift in Ihrem Cluster. Anschließend fügen Sie dem Datshare die Schemas, Tabellen, Ansichten und benutzerdefinierten Funktionen hinzu, auf die die Abonnenten zugreifen sollen. Anschließend importieren Sie den Datashare inAWS Data Exchange, erstellen einen Datensatz, fügen ihn einem Produkt hinzu und veröffentlichen das Produkt. Abonnenten erhalten nach Abschluss des Abonnements Zugriff auf den Datashare.
Nachdem Sie Ihren Amazon Redshift-Datashare in Amazon Redshift eingerichtet haben, können Sie in Amazon Redshift einen neuen Amazon Redshift-Datensatz erstellen. AWS Data Exchange Anschließend können Sie eine Revision erstellen und Amazon Redshift Datashare hinzufügen. Auf diese Weise können Anfragen an den AWS Data Exchange Endpunkt per Proxy an Ihren Amazon Redshift Redshift-Datashare weitergeleitet werden. Sie können diesen Datensatz dann einem Produkt hinzufügen und Preise hinzufügen. Potenzielle Abonnenten können sich dann Ihr Produkt ansehen und es im AWS Data Exchange Katalog abonnieren.
Die folgenden Themen beschreiben den Prozess der Erstellung eines Amazon Redshift Redshift-Datensatzes und der Veröffentlichung eines neuen Produkts mit Amazon Redshift Redshift-Datensätzen mithilfe der AWS Data Exchange Konsole. Der Prozess umfasst die folgenden Schritte:
Schritte
- Schritt 1: Erstellen Sie ein Amazon Redshift Datashare Asset
- Schritt 2: Erstellen Sie einen Amazon Redshift Redshift-Datensatz
- Schritt 3: Erstellen Sie eine Revision
- Schritt 4: Amazon Redshift Datashare Assets zu einer Revision hinzufügen
- Schritt 5: Veröffentlichen Sie ein neues Produkt mit Amazon Redshift Redshift-Datensätzen
- Schritt 6: (Optional) Kopieren Sie ein Produkt
Schritt 1: Erstellen Sie ein Amazon Redshift Datashare Asset
Vermögenswerte sind die Daten in. AWS Data Exchange Weitere Informationen finden Sie unter Objekte.
So erstellen Sie ein Amazon Redshift Redshift-Datenfreigabe-Asset
-
Erstellen Sie eine Datenfreigabe innerhalb Ihres Amazon Redshift Redshift-Clusters.
Weitere Informationen zum Erstellen einer Datenfreigabe finden Sie unter Arbeiten mit AWS Data Exchange Datenfreigaben als Produzent im Amazon Redshift Database Developer Guide.
Anmerkung
Wir empfehlen, Ihr Datashare als öffentlich zugänglich festzulegen. Wenn Sie dies nicht tun, können Kunden mit öffentlich zugänglichen Clustern Ihre Daten nicht nutzen.
-
Schritt 2: Erstellen Sie einen Amazon Redshift Redshift-Datensatz.
Schritt 2: Erstellen Sie einen Amazon Redshift Redshift-Datensatz
Ein Amazon Redshift-Datensatz umfasst AWS Data Exchange Datenfreigaben für Amazon Redshift. Weitere Informationen finden Sie unter Amazon Redshift Redshift-Datensatz.
So erstellen Sie einen Amazon Redshift Redshift-Datensatz
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Eigene Datensätze aus.
-
Wählen Sie unter Eigene Datensätze die Option Datensatz erstellen aus, um den Assistenten für Schritte zur Datensatzerstellung zu öffnen.
-
Wählen Sie unter Datensatztyp auswählen die Option Amazon Redshift Datashare aus.
-
Geben Sie unter Datensatz definieren einen Namen und eine Beschreibung für Ihren Datensatz ein. Weitere Informationen finden Sie unter Bewährte Verfahren für Datensätze.
-
Fügen Sie unter Tags hinzufügen — optional Tags hinzu.
-
Wählen Sie Erstellen aus.
Schritt 3: Erstellen Sie eine Revision
Im folgenden Verfahren erstellen Sie eine Revision, nachdem Sie einen Datensatz in der AWS Data Exchange Konsole erstellt haben. Weitere Informationen finden Sie unter Überarbeitungen.
Um eine Revision zu erstellen
-
Gehen Sie auf der Seite mit den Datensatz-Details im Bereich Datensatzübersicht wie folgt vor:
-
(Optional) Wählen Sie „Name bearbeiten“, um Informationen zu Ihrem Datensatz zu bearbeiten.
-
(Optional) Wählen Sie Löschen, um den Datensatz zu löschen.
-
-
Wählen Sie im Abschnitt Revisionen die Option Revision erstellen aus.
-
Geben Sie unter Revision definieren optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.
-
Fügen Sie unter Tags hinzufügen — optional Tags hinzu, die der Ressource zugeordnet sind.
-
Wählen Sie Erstellen aus.
-
Überprüfe, bearbeite oder lösche deine Änderungen aus dem vorherigen Schritt.
Schritt 4: Amazon Redshift Datashare Assets zu einer Revision hinzufügen
Im folgenden Verfahren fügen Sie Amazon Redshift Datashare zu einer Revision hinzu und schließen dann die Revision in der Konsole ab. AWS Data Exchange Weitere Informationen finden Sie unter Objekte.
Um der Revision Ressourcen hinzuzufügen
-
Wählen Sie auf der Seite mit den AWS Data ExchangeDatensatzdetails im Abschnitt Datashares for Amazon Redshift die Option Datashares hinzufügen aus.
-
Wählen Sie unter AWS Data ExchangeDatenfreigaben für Amazon Redshift die Datenfreigaben aus und klicken Sie dann auf Datenfreigabe (en) hinzufügen.
Anmerkung
Sie können einer Revision bis zu 20 Datashares hinzufügen.
Es wird ein Job gestartet, um Ihre Assets in Ihre Revision zu importieren.
-
Wenn der Job abgeschlossen ist, wird das Feld Status im Bereich Jobs auf Abgeschlossen aktualisiert.
-
Wenn Sie weitere Daten hinzufügen möchten, wiederholen Sie Schritt 1.
-
Überprüfen Sie unter Revisionsübersicht Ihre Revision und ihre Inhalte.
-
Wählen Sie Finalize aus.
Sie haben eine Revision für einen Datensatz erfolgreich abgeschlossen.
Sie können eine Revision bearbeiten oder löschen, bevor Sie sie einem Produkt hinzufügen.
Schritt 5: Veröffentlichen Sie ein neues Produkt mit Amazon Redshift Redshift-Datensätzen
Nachdem Sie mindestens einen Datensatz erstellt und eine Überarbeitung mit Assets abgeschlossen haben, sind Sie bereit, ein Produkt mit Amazon Redshift Redshift-Datensätzen zu veröffentlichen. Weitere Informationen finden Sie unter Produktdetails. Stellen Sie sicher, dass Sie über alle erforderlichen Informationen zu Ihrem Produkt und Angebot verfügen.
Um ein neues Produkt mit Amazon Redshift Redshift-Datensätzen zu veröffentlichen
-
Wählen Sie im linken Navigationsbereich der AWS Data ExchangeKonsole
unter Daten veröffentlichen die Option Produkte aus. -
Wählen Sie unter Produkte die Option Neues Produkt veröffentlichen aus, um den Assistenten zur Veröffentlichung neuer Produkte zu öffnen.
-
Wählen Sie im Abschnitt Produktsichtbarkeit die Optionen für die Produktsichtbarkeit und die Konfiguration Vertrauliche Informationen für Ihr Produkt aus und klicken Sie dann auf Weiter. Weitere Informationen finden Sie unter Sichtbarkeit des Produkts und Sensible Informationskategorien.
-
Aktivieren Sie im Abschnitt Daten hinzufügen unter Eigene Datensätze die Kontrollkästchen neben den Datensätzen, die Sie hinzufügen möchten, und wählen Sie dann Ausgewählte hinzufügen aus.
Anmerkung
Für die ausgewählten Datensätze muss eine endgültige Version vorliegen. Datensätze ohne abgeschlossene Versionen werden nicht hinzugefügt.
-
Gehen Sie zu Ausgewählte Datensätze, um Ihre Auswahl zu überprüfen.
Sie können den Namen des Datensatzes, den Typ des Datensatzes und den Zeitstempel der letzten Aktualisierung des Datensatzes überprüfen.
-
Gehen Sie zu Revisionszugriffsregeln auswählen, wählen Sie die Revisionszugriffsregeln aus, die Sie für die in diesem Produkt enthaltenen Datensätze festlegen möchten, und klicken Sie dann auf Weiter.
Weitere Details finden Sie unter Revision der Zugriffsregeln.
-
-
Geben Sie im Abschnitt Produkt definieren unter Produktübersicht Informationen zu Ihrem Produkt ein, einschließlich Produktname, Produktlogo, Support-Kontaktinformationen und Produktkategorien.
Weitere Informationen finden Sie unter Produktdetails.
-
(Optional) Wählen Sie im Abschnitt Produkt definieren unter Datenwörterbücher und Beispiele — optional einen Datensatz aus, indem Sie auf das Optionsfeld neben dem Datensatznamen klicken und dann Bearbeiten wählen.
Weitere Informationen finden Sie unter Datenwörterbücher und Beispiele.
-
Wählen Sie im Dialogfeld Bearbeiten unter Datenwörterbuch hochladen die Option Datei hinzufügen aus, um ein neues Datenwörterbuch hochzuladen.
Sie können ein Datenwörterbuch im CSV-Format mit einer maximalen Größe von 1 MB auswählen.
-
Wählen Sie ein gespeichertes Datenwörterbuch auf Ihrem Computer aus und wählen Sie dann Öffnen.
Die CSV-Datei mit dem Datenwörterbuch wird im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Ihr Datenwörterbuch muss der AWS Data Exchange Datenwörterbuchvorlage entsprechen. Wenn Sie kein gespeichertes Datenwörterbuch zum Hochladen haben, können Sie entweder den leeren Link zur Datenwörterbuchvorlage oder den Beispiellink für ein Datenwörterbuch in der AWS Data Exchange Konsole wählen.
-
Wählen Sie Datenwörterbuchvorschau, um eine Vorschau anzuzeigen.
-
Wählen Sie unter Beispiele — optional die Option Beispiele hochladen aus, wählen Sie ein Beispiel von Ihrem Computer aus und wählen Sie dann Öffnen aus.
Die Beispiele werden im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Sie können bis zu 10 Samples mit einer maximalen Größe von 50 MB hochladen. Beispiele im CSV-Format können in der Vorschau angezeigt werden.
-
Geben Sie für jedes Muster eine Beschreibung ein, die auf der Produktdetailseite angezeigt wird.
-
Wählen Sie Speichern aus.
-
-
Geben Sie unter Produktdefinition eine Kurzbeschreibung und eine Langbeschreibung Ihres Produkts ein.
Wenn Sie eine Vorlage für Ihre ausführliche Beschreibung verwenden möchten, wählen Sie Vorlage anwenden aus, wählen Sie Ihren Vorlagentyp aus und füllen Sie dann die Vorlage mit Ihren spezifischen Produktdetails aus.
-
Wählen Sie Weiter.
-
Konfigurieren Sie Ihr Angebot.
-
Wenn Sie ein öffentliches Angebot erstellen, konfigurieren Sie Ihr Angebot im Abschnitt Öffentliches Angebot hinzufügen. Für alle AWS Data Exchange Produkte, deren Sichtbarkeit auf Öffentlich gesetzt ist, ist ein öffentliches Angebot erforderlich.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie Ihre US-Mehrwertsteuereinstellungen, Ihren Datenabonnementvertrag (DSA) und Ihre Rückerstattungsrichtlinie aus.
-
(Optional) Richten Sie die Abonnementbestätigung ein, mit der Sie steuern können, wer dieses Produkt abonnieren kann. Weitere Informationen finden Sie unter Abonnementüberprüfung für Anbieter.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
Wenn Sie ein privates Angebot erstellen, konfigurieren Sie die Angebotsdetails im Abschnitt Benutzerdefiniertes Angebot hinzufügen.
-
Fügen Sie im Abschnitt Informationen zum Abonnentenkonto mindestens ein Abonnentenkonto hinzu, auf das Sie das Angebot erweitern möchten.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie das Ablaufdatum des Angebots, bis zu dem der Abonnent das Angebot annehmen muss.
-
Wählen Sie Ihre Einstellungen für die US-Umsatzsteuer, den Datenabonnementvertrag (DSA) und die Rückerstattungsrichtlinie aus.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
-
Überprüfen Sie im Bereich Überprüfen und veröffentlichen Ihre Produktinformationen und erweitern Sie dann die Vorschau der Produktseite, um zu sehen, wie sie nach der Veröffentlichung aussehen werden.
-
Wenn Sie sicher sind, dass das Produkt und das öffentliche Angebot sichtbar und für alle verfügbar sein sollen, wählen Sie Veröffentlichen.
Sie haben jetzt den manuellen Teil der Veröffentlichung eines Datenprodukts mit einem öffentlichen Angebot abgeschlossen. AWS Data Exchangebereitet Ihr Produkt vor und veröffentlicht es. Auf der Produktübersichtsseite lautet der Status Ihres Produkts Wartet auf Genehmigung und ändert sich nach der Veröffentlichung in Veröffentlicht.
Schritt 6: (Optional) Kopieren Sie ein Produkt
Nachdem Sie Ihr erstes Produkt erstellt haben, können Sie dessen Details und öffentliche Angebote kopieren, um ein neues Produkt zu erstellen.
Anmerkung
Sie können ein öffentliches, privates, veröffentlichtes oder unveröffentlichtes Produkt kopieren. Benutzerdefinierte Angebote, die mit dem Produkt verknüpft sind, werden nicht kopiert, öffentliche Angebote werden jedoch kopiert.
Um ein Produkt zu kopieren
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Produkte aus.
-
Wählen Sie unter Produkte die Schaltfläche neben dem Produkt aus, das Sie kopieren möchten.
-
Wählen Sie das Drop-down-Menü Aktionen aus und wählen Sie dann Kopie erstellen aus.
-
Fahren Sie mit dem Workflow „Produkt veröffentlichen“ fort, wobei die Details für das Produkt, das Sie in Schritt 3 ausgewählt haben, bereits ausgefüllt sind. Weitere Informationen finden Sie unter Schritt 5: Veröffentlichen Sie ein neues Produkt.
Veröffentlichung eines Produkts mit Amazon S3 S3-Datenzugriff
Übersicht
Mit AWS Data Exchange for Amazon S3 können Anbieter den direkten Zugriff auf Amazon S3 S3-Buckets oder bestimmte Präfixe und Amazon S3 S3-Objekte gemeinsam nutzen. Anbieter verwenden AWS Data Exchange sie auch, um Abonnements, Ansprüche, Rechnungen und Zahlungen automatisch zu verwalten.
Als Datenanbieter können Sie den direkten Zugriff auf einen gesamten Amazon S3 S3-Bucket oder bestimmte Präfixe und Amazon S3 S3-Objekte gemeinsam nutzen, ohne Kopien erstellen oder verwalten zu müssen. Diese gemeinsam genutzten Amazon S3 S3-Objekte können serverseitig mit vom Kunden verwalteten Schlüsseln verschlüsselt werden, die in AWS Key Management Service (AWS KMS) oder mit Von AWS verwaltete Schlüssel (SSE-S3) gespeichert sind. Weitere Informationen zur Überwachung Ihrer KMS-Schlüssel und zum Verständnis von Verschlüsselungskontexten finden Sie unter. Schlüsselverwaltung für den Amazon S3 S3-Datenzugriff Wenn ein Kunde Ihre Datenprodukte abonniert, stellt er AWS Data Exchange automatisch einen Amazon S3 S3-Zugangspunkt bereit und aktualisiert seine Ressourcenrichtlinien in Ihrem Namen, um Abonnenten nur Lesezugriff zu gewähren. Abonnenten können die Amazon S3-Zugriffspunkt-Aliase an Orten verwenden, an denen sie Amazon S3 S3-Bucket-Namen für den Zugriff auf Daten in Amazon S3 verwenden.
Wenn das Abonnement endet, werden die Berechtigungen des Abonnenten widerrufen. Wenn Sie eine Vereinbarung mit einem Abonnenten vorzeitig beenden möchten, wenden Sie sich an AWS Support
Bevor Sie ein Produkt mit Amazon S3-Datenzugriff veröffentlichen können, müssen Sie die folgenden Voraussetzungen erfüllen:
Voraussetzungen
-
Vergewissern Sie sich, dass die Amazon S3 S3-Buckets, die die Daten hosten, so konfiguriert sind, dass die Einstellung Amazon S3 S3-Bucket Owner erforced aktiviert ist. ACLs Disabled ist aktiviert. Weitere Informationen finden Sie unter Kontrolle des Besitzes von Objekten und Deaktivieren von ACLs für Ihren Bucket im Amazon Simple Storage Service-Benutzerhandbuch.
-
Ihre gemeinsam genutzten Objekte müssen der Amazon S3 S3-Standardspeicherklasse angehören oder mit S3 Intelligent Tiering verwaltet werden, damit Abonnenten erfolgreich auf sie zugreifen können. Wenn sie zu anderen Speicherklassen gehören oder wenn Sie Intelligent Tiering mit Deep Archive aktiviert haben, erhalten Ihre Abonnenten Fehlermeldungen, weil sie nicht dazu berechtigt sind.
RestoreObject
-
Vergewissern Sie sich, dass in den Amazon S3-Buckets, in denen die Daten gehostet werden, die Verschlüsselung deaktiviert oder mit von Amazon S3 verwalteten Schlüsseln (SSE-S3) oder kundenverwalteten Schlüsseln, die in AWS Key Management Service (AWS KMS) gespeichert sind, verschlüsselt wurde.
-
Wenn Sie vom Kunden verwaltete Schlüssel verwenden, müssen Sie über Folgendes verfügen:
-
IAM-Berechtigungen für
kms:CreateGrant
die KMS-Schlüssel. Sie können über die Schlüsselrichtlinie, die IAM-Anmeldeinformationen oder durch eine AWS KMS Erteilung des KMS-Schlüssels auf diese Berechtigungen zugreifen. Weitere Informationen zur Schlüsselverwaltung und zur AWS Data Exchange Verwendung von AWS KMS KMS-Zuschüssen finden Sie unterAWS KMS Zuschüsse erstellen.Um Zugriff zu gewähren, fügen Sie Ihren Benutzern, Gruppen oder Rollen Berechtigungen hinzu:
-
Benutzer und Gruppen in AWS IAM Identity Center:
Erstellen Sie einen Berechtigungssatz. Befolgen Sie die Anweisungen unter Erstellen eines Berechtigungssatzes im AWS IAM Identity Center-Benutzerhandbuch.
-
Benutzer, die in IAM über einen Identitätsanbieter verwaltet werden:
Erstellen Sie eine Rolle für den Identitätsverbund. Befolgen Sie die Anweisungen unter Erstellen einer Rolle für einen externen Identitätsanbieter (Verbund) im IAM-Benutzerhandbuch.
-
IAM-Benutzer:
-
Erstellen Sie eine Rolle, die Ihr Benutzer annehmen kann. Folgen Sie den Anweisungen unter Erstellen einer Rolle für einen IAM-Benutzer im IAM-Benutzerhandbuch.
-
(Nicht empfohlen) Weisen Sie einem Benutzer eine Richtlinie direkt zu oder fügen Sie einen Benutzer zu einer Benutzergruppe hinzu. Befolgen Sie die Anweisungen unter Hinzufügen von Berechtigungen zu einem Benutzer (Konsole) im IAM-Benutzerhandbuch.
-
Benutzer benötigen programmgesteuerten Zugriff, wenn sie außerhalb der AWS Management Console mit AWS interagieren möchten. Die Vorgehensweise, um programmgesteuerten Zugriff zu gewähren, hängt davon ab, welcher Benutzertyp auf zugreift AWS.
Um Benutzern programmgesteuerten Zugriff zu gewähren, wählen Sie eine der folgenden Optionen.
Welcher Benutzer benötigt programmgesteuerten Zugriff? Bis Von Mitarbeiteridentität
(Benutzer, die in IAM Identity Center verwaltet werden)
Verwenden Sie temporäre Anmeldeinformationen, um programmgesteuerte Anforderungen an die AWS CLI, AWS-SDKs oder AWS-APIs zu signieren. Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten.
-
Informationen zur AWS CLI finden Sie unter Konfigurieren der AWS CLI für die Verwendung von AWS IAM Identity Center im AWS Command Line Interface-Benutzerhandbuch.
-
Informationen zu AWS-SDKs, Tools und AWS-APIs finden Sie unter IAM-Identity-Center-Authentifizierung im Referenzhandbuch zu AWS-SDKs und Tools.
IAM Verwenden Sie temporäre Anmeldeinformationen, um programmgesteuerte Anforderungen an die AWS CLI, AWS-SDKs oder AWS-APIs zu signieren. Folgen Sie den Anweisungen unter Verwenden temporärer Anmeldeinformationen mit AWS-Ressourcen im IAM-Benutzerhandbuch. IAM (Nicht empfohlen)
Verwenden Sie langfristige Anmeldeinformationen, um programmgesteuerte Anforderungen an die AWS CLI, AWS-SDKs oder AWS-APIs zu signieren.Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten.
-
Informationen zur AWS CLI finden Sie unter Authentifizierung mit IAM-Benutzer-Anmeldeinformationen im AWS Command Line Interface-Benutzerhandbuch.
-
Informationen zu AWS-SDKs und Tools finden Sie unter Authentifizierung mit langfristigen Anmeldeinformationen im Referenzhandbuch zu AWS-SDKs und Tools.
-
Informationen zu AWS-APIs finden Sie unter Verwalten von Zugriffsschlüsseln für IAM-Benutzer im IAM-Benutzerhandbuch.
Im Folgenden finden Sie ein Beispiel für eine JSON-Richtlinie, die zeigt, wie Sie die Schlüsselrichtlinie des KMS-Schlüssels erweitern können.
{ "Sid": "AllowCreateGrantPermission", "Effect": "Allow", "Principal": { "AWS": "<IAM identity who will call Dataexchange API>" }, "Action": "kms:CreateGrant", "Resource": "*" }
Die folgende Richtlinie zeigt ein Beispiel für eine Hinzufügung einer Richtlinie für die verwendete IAM-Identität.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Sid": "AllowCreateGrantPermission", "Action": [ "kms:CreateGrant ], "Resource": [ <Enter KMS Key ARNs in your account> ] } ] }
Anmerkung
Kontoübergreifende KMS-Schlüssel sind auch zulässig, wenn die
kms:CreateGrant
entsprechenden Berechtigungen für die KMS-Schlüssel im vorherigen Schritt eingeholt wurden. Wenn ein anderes Konto Eigentümer des Schlüssels ist, müssen Sie über Berechtigungen für die Schlüsselrichtlinie und Ihre IAM-Anmeldeinformationen verfügen, wie in den obigen Beispielen beschrieben. -
-
Stellen Sie sicher, dass Sie KMS-Schlüssel verwenden, um bestehende und neue Objekte im Amazon S3-Bucket mithilfe der Amazon S3 S3-Bucket-Schlüsselfunktion zu verschlüsseln. Weitere Informationen finden Sie unter Konfiguration von S3-Bucket-Keys im Amazon Simple Storage Service-Benutzerhandbuch.
-
Für neue Objekte, die Ihrem Amazon S3 S3-Bucket hinzugefügt werden, können Sie standardmäßig die Amazon S3 S3-Bucket-Schlüsselverschlüsselung einrichten. Wenn vorhandene Objekte ohne Verwendung der Amazon S3Bucket-Schlüsselfunktion verschlüsselt wurden, müssen diese Objekte migriert werden, um den Amazon S3 S3-Bucket-Schlüssel für die Verschlüsselung zu verwenden.
Verwenden Sie den
copy
Vorgang, um den Amazon S3 S3-Bucket-Schlüssel für bestehende Objekte zu aktivieren. Weitere Informationen finden Sie unter Konfiguration eines Amazon S3 S3-Bucket-Schlüssels auf Objektebene mithilfe von Batch-Operationen. -
AWSverwaltete KMS-Schlüssel oder werden AWS-eigene Schlüssel nicht unterstützt. Sie können von einem nicht unterstützten Verschlüsselungsschema zu den derzeit unterstützten wechseln. Weitere Informationen finden Sie im AWS Storage-Blog unter Ändern Ihrer Amazon S3 S3-Verschlüsselung
.
-
-
Stellen Sie die Amazon S3 S3-Buckets, die die Daten hosten, so ein, dass sie AWS Data Exchange eigenen Access Points vertrauen. Sie müssen diese Amazon S3 S3-Bucket-Richtlinien aktualisieren, um AWS Data Exchange Berechtigungen zum Erstellen von Amazon S3 S3-Zugriffspunkten zu erteilen und Abonnenten in Ihrem Namen Zugriff zu gewähren oder zu entfernen. Wenn die Richtlinienerklärung fehlt, müssen Sie die Bucket-Richtlinie bearbeiten, um die Amazon S3 S3-Standorte zu Ihrem Datensatz hinzuzufügen.
Nachfolgend eine Beispielrichtlinie.
<Bucket ARN>
Ersetzen Sie durch den entsprechenden Wert.{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "s3:GetObject", "s3:ListBucket" ], "Resource": [ "<Bucket ARN>", "<Bucket ARN>/*" ], "Condition": { "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } } ] }
-
Sie können die gemeinsame Nutzung von Daten AWS Data Exchange an einen gesamten Amazon S3 S3-Bucket delegieren. Sie können die Delegierung jedoch auf die spezifischen Präfixe und Objekte des Buckets beschränken, die Sie im Datensatz gemeinsam nutzen möchten. Im Folgenden finden Sie ein Beispiel für eine bereichsbezogene Richtlinie. Ersetzen Sie <Bucket ARN>
und "mybucket/folder1/*"
durch Ihre eigenen Informationen.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "DelegateToAdxGetObjectsInFolder1", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "s3:GetObject" ], "Resource": [ "arn:aws:s3:::mybucket/folder1/*" ], "Condition": { "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } }, { "Sid": "DelegateToAdxListObjectsInFolder1", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": "s3:ListBucket", "Resource": "arn:aws:s3:::mybucket", "Condition": { "StringLike": { "s3:prefix": [ "folder1/*" ] }, "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } } ] }
In ähnlicher Weise kann ein Anbieter die folgende Richtlinie verwenden, um den Zugriff nur auf eine einzelne Datei zu beschränken.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "DelegateToAdxGetMyFile", "Effect": "Allow", "Principal": { "AWS": "*" }, "Action": [ "s3:GetObject" ], "Resource": [ "arn:aws:s3:::mybucket/folder1/myfile" ], "Condition": { "StringEquals": { "s3:DataAccessPointAccount": [ "337040091392", "504002150500", "366362662752", "330489627928", "291973504423", "461002523379", "036905324694", "540564263739", "675969394711", "108584782536", "844053218156" ] } } } ] }
In den folgenden Themen wird beschrieben, wie Sie mithilfe der AWS Data Exchange Konsole einen Amazon S3 S3-Datensatz erstellen und ein neues Produkt mit Amazon S3 S3-Datensätzen veröffentlichen. Der Prozess umfasst die folgenden Schritte:
Schritte
- Schritt 1: Erstellen Sie einen Amazon S3 S3-Datensatz
- Schritt 2: Amazon S3 S3-Datenzugriff konfigurieren
- Schritt 3: Überprüfen und finalisieren Sie den Datensatz
- Schritt 4: Einen Amazon S3 S3-Datensatz zu einem AWS Data Exchange Produkt hinzufügen
- Schritt 5: Veröffentlichen Sie ein neues Produkt mit Zugriff auf Amazon S3
- Schritt 6: (Optional) Kopieren Sie ein Produkt
Schritt 1: Erstellen Sie einen Amazon S3 S3-Datensatz
Um einen Amazon S3 S3-Datensatz zu erstellen
-
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Eigene Datensätze aus.
-
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Eigene Datensätze aus.
-
Wählen Sie unter Eigene Datensätze die Option Datensatz erstellen aus, um den Assistenten für Schritte zur Datensatzerstellung zu öffnen.
-
Wählen Sie unter Datensatztyp auswählen die Option Amazon S3 S3-Datenzugriff aus.
-
Geben Sie unter Datensatz definieren einen Namen und eine Beschreibung für Ihren Datensatz ein. Weitere Informationen finden Sie unter Bewährte Verfahren für Datensätze.
-
(Optional) Fügen Sie unter Tags hinzufügen — optional Tags hinzu.
-
Wählen Sie Datensatz erstellen und fahren Sie fort.
Schritt 2: Amazon S3 S3-Datenzugriff konfigurieren
Wählen Sie die Amazon S3 S3-Buckets oder Amazon S3 S3-Bucket-Standorte aus, die Sie Abonnenten zur Verfügung stellen möchten. Sie können einen ganzen Amazon S3 S3-Bucket auswählen oder bis zu fünf Präfixe oder Objekte innerhalb eines Amazon S3 S3-Buckets angeben. Um weitere Amazon S3 S3-Buckets hinzuzufügen, müssen Sie eine weitere Amazon S3 S3-Datenfreigabe erstellen.
So konfigurieren Sie den gemeinsamen Amazon S3 S3-Datenzugriff
-
Wählen Sie auf der Seite Amazon S3 S3-Datenzugriff konfigurieren die Option Amazon S3 S3-Standorte auswählen aus.
-
Geben Sie unter Amazon S3 S3-Standorte auswählen Ihren Amazon S3 S3-Bucket-Namen in die Suchleiste ein oder wählen Sie Ihren Amazon S3 S3-Bucket, Ihre Präfixe oder Amazon S3 S3-Dateien aus und wählen Sie Ausgewählte hinzufügen aus. Wählen Sie dann Standorte hinzufügen aus.
Anmerkung
Wir empfehlen, einen Ordner der obersten Ebene zu wählen, in dem die meisten Objekte und Präfixe gespeichert sind, damit Anbieter nicht neu konfigurieren müssen, welche Präfixe oder Objekte gemeinsam genutzt werden sollen.
-
Wählen Sie in den Konfigurationsdetails Ihre Konfiguration „Requester Pays“ aus. Es gibt zwei Optionen:
-
Enable Requester Pays (empfohlen) — Anforderer zahlen für alle Anfragen und Transfers im Amazon S3 S3-Bucket. Wir empfehlen diese Option, da sie zum Schutz vor unbeabsichtigten Kosten beiträgt, die durch Anfragen und Übertragungen von Abonnenten entstehen.
-
Deaktivieren Sie Requester Pays — Sie zahlen für Abonnentenanfragen und Transfers im Amazon S3 S3-Bucket.
Weitere Informationen zu Requester Pays finden Sie unter Objects in Requester Pays Buckets im Amazon Simple Storage Service-Benutzerhandbuch.
-
-
Wählen Sie die Bucket-Richtlinie aus, die Ihren Anforderungen am besten entspricht. Wählen Sie Allgemein, um eine Bucket-Richtlinie für Ihren gesamten Amazon S3 S3-Bucket zu verwenden. Dies ist eine einmalige Konfiguration, und es ist keine zusätzliche Konfiguration erforderlich, um Präfixe oder Objekte in future gemeinsam zu nutzen. Wählen Sie Spezifisch, um eine Bucket-Richtlinie zu verwenden, die für die ausgewählten Amazon S3 S3-Standorte spezifisch ist. Ihr gemeinsam genutzter Amazon S3 S3-Bucket benötigt eine Bucket-Richtlinie, um erfolgreich einen Amazon S3 S3-Datenzugriffsdatensatz zu erstellen, und ACLs können nicht aktiviert sein.
-
Um ACLs zu deaktivieren, navigieren Sie zu Ihren Bucket-Berechtigungen und setzen Sie Object Ownership auf Bucket owner enforced.
-
Um eine Bucket-Richtlinie hinzuzufügen, kopieren Sie die Bucket-Anweisung in Ihre Zwischenablage. Wählen Sie in der Amazon S3 S3-Konsole auf der Registerkarte Amazon S3 S3-Berechtigungen im Abschnitt Bucket-Richtlinie die Option Bearbeiten aus, fügen Sie die Bucket-Richtlinie in die Erklärung ein und speichern Sie die Änderungen.
-
-
Wenn der Amazon S3 S3-Bucket Objekte enthält, die mit vom AWS KMS Kunden verwalteten Schlüsseln verschlüsselt wurden, müssen Sie all diese KMS-Schlüssel mit teilenAWS Data Exchange. Informationen zu den erforderlichen Voraussetzungen für die Verwendung von KMS-Schlüsseln zur Verschlüsselung von Objekten in Ihrem Amazon S3 S3-Bucket finden Sie unterVeröffentlichung eines Produkts mit Amazon S3 S3-Datenzugriff. Gehen Sie wie folgt vorAWS Data Exchange, um diese KMS-Schlüssel mit anderen zu teilen:
-
Wählen Sie auf der Seite Amazon S3 S3-Datenzugriff konfigurieren unter Vom Kunden verwaltete KMS-Schlüssel die Option Wählen Sie aus Ihren AWS KMS keys oder geben Sie AWS KMS key ARN ein und wählen Sie alle aus, die AWS KMS keysderzeit zur Verschlüsselung der gemeinsam genutzten Amazon S3 S3-Speicherorte verwendet werden. AWS Data Exchangeverwendet diese KMS-Schlüssel, um Abonnenten Zugriff auf Ihre gemeinsamen Standorte zu gewähren. Weitere Informationen finden Sie unter Zuschüsse in AWS KMS.
Anmerkung
AWS KMShat ein Limit von 50.000 Zuschüssen pro KMS-Schlüssel, einschließlich bereits vorhandener Zuschüsse.
-
-
Überprüfen Sie Ihre Amazon S3 S3-Standorte, ausgewählten KMS-Schlüssel und Konfigurationsdetails und wählen Sie Speichern und fortfahren.
Schritt 3: Überprüfen und finalisieren Sie den Datensatz
Überprüfen und finalisieren Sie Ihren neu erstellten Datensatz. Wenn Sie einen weiteren Amazon S3 S3-Datenzugriff erstellen und hinzufügen möchten, um den Zugriff auf weitere Amazon S3 S3-Buckets, -Präfixe und Objekte gemeinsam zu nutzen, wählen Sie Anderen Amazon S3 S3-Datenzugriff hinzufügen.
Anmerkung
Wir empfehlen dies, wenn Sie den Zugriff auf Daten gemeinsam nutzen müssen, die in einem anderen Amazon S3 S3-Bucket gehostet werden als dem, der zuvor beim ersten Amazon S3 S3-Datenzugriff ausgewählt wurde.
Wenn Sie vor der Veröffentlichung Änderungen vornehmen möchten, können Sie den Datensatz als Entwurf speichern, indem Sie Entwurf speichern wählen. Wählen Sie dann Datensatz finalisieren, um ihn Ihrem Produkt hinzuzufügen.
Schritt 4: Einen Amazon S3 S3-Datensatz zu einem AWS Data Exchange Produkt hinzufügen
Im folgenden Verfahren fügen Sie Ihren Datensatz zu einem neuen oder vorhandenen AWS Data Exchange Produkt hinzu.
Um einen Datensatz zu einem neuen oder vorhandenen AWS Data Exchange Exchange-Produkt hinzuzufügen
-
Auf der Seite Eigene Datensätze können Sie unter Datensatzübersicht den Namen bearbeiten, löschen oder Produkt aus Datensatz erstellen.
-
Schließen Sie die Produkterstellung ab und geben Sie dabei die Produktbeschreibung, Anwendungsfälle, Metadaten, Preise und Geschäftsbedingungen an.
-
Überprüfen und veröffentlichen Sie das Produkt, wenn Sie fertig sind.
Anmerkung
Wenn ein Kunde Ihr Produkt abonniert, erhält der Kunde die Zugriffsberechtigung, Ihre Daten über den in Ihrem Namen erstellten Amazon S3 S3-Zugangspunkt zu lesen und zu verwenden.
Schritt 5: Veröffentlichen Sie ein neues Produkt mit Zugriff auf Amazon S3
Nachdem Sie mindestens einen Datensatz erstellt und eine Überarbeitung mit Ressourcen abgeschlossen haben, können Sie ein Produkt mit Amazon S3 S3-Datenzugriff veröffentlichen. Weitere Informationen finden Sie unter Produktdetails. Stellen Sie sicher, dass Sie über alle erforderlichen Informationen zu Ihrem Produkt und Angebot verfügen.
Anmerkung
Sie müssen keine neue Version erstellen, wenn Sie die gemeinsam genutzten Amazon S3 S3-Objekte aktualisieren, es sei denn, die Amazon S3 S3-Standorte wurden geändert und diese Objekte sind für Abonnenten nicht zugänglich.
Um ein neues Produkt mit Zugriff auf Amazon S3 zu veröffentlichen
-
Wählen Sie im linken Navigationsbereich der AWS Data ExchangeKonsole
unter Daten veröffentlichen die Option Produkte aus. -
Wählen Sie unter Produkte die Option Neues Produkt veröffentlichen aus, um den Assistenten zur Veröffentlichung neuer Produkte zu öffnen.
-
Wählen Sie im Abschnitt Produktsichtbarkeit die Optionen für die Produktsichtbarkeit und die Konfiguration Vertrauliche Informationen für Ihr Produkt aus und klicken Sie dann auf Weiter. Weitere Informationen finden Sie unter Sichtbarkeit des Produkts und Sensible Informationskategorien.
-
Aktivieren Sie im Abschnitt Daten hinzufügen unter Eigene Datensätze die Kontrollkästchen neben den Datensätzen, die Sie hinzufügen möchten, und wählen Sie dann Ausgewählte hinzufügen aus.
Anmerkung
Für die ausgewählten Datensätze muss eine endgültige Version vorliegen. Datensätze ohne abgeschlossene Versionen werden nicht hinzugefügt.
-
Gehen Sie zu Ausgewählte Datensätze, um Ihre Auswahl zu überprüfen.
Sie können den Namen des Datensatzes, den Typ des Datensatzes und den Zeitstempel der letzten Aktualisierung des Datensatzes überprüfen.
-
Gehen Sie zu Revisionszugriffsregeln auswählen, wählen Sie die Revisionszugriffsregeln aus, die Sie für die in diesem Produkt enthaltenen Datensätze festlegen möchten, und klicken Sie dann auf Weiter.
Weitere Details finden Sie unter Revision der Zugriffsregeln.
-
-
Geben Sie im Abschnitt Produkt definieren unter Produktübersicht Informationen zu Ihrem Produkt ein, einschließlich Produktname, Produktlogo, Support-Kontaktinformationen und Produktkategorien.
Weitere Informationen finden Sie unter Produktdetails.
-
(Optional) Wählen Sie im Abschnitt Produkt definieren unter Datenwörterbücher und Beispiele — optional einen Datensatz aus, indem Sie auf das Optionsfeld neben dem Datensatznamen klicken und dann Bearbeiten wählen.
Weitere Informationen finden Sie unter Datenwörterbücher und Beispiele.
-
Wählen Sie im Dialogfeld Bearbeiten unter Datenwörterbuch hochladen die Option Datei hinzufügen aus, um ein neues Datenwörterbuch hochzuladen.
Sie können ein Datenwörterbuch im CSV-Format mit einer maximalen Größe von 1 MB auswählen.
-
Wählen Sie ein gespeichertes Datenwörterbuch auf Ihrem Computer aus und wählen Sie dann Öffnen.
Die CSV-Datei mit dem Datenwörterbuch wird im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Ihr Datenwörterbuch muss der AWS Data Exchange Datenwörterbuchvorlage entsprechen. Wenn Sie kein gespeichertes Datenwörterbuch zum Hochladen haben, können Sie entweder den leeren Link zur Datenwörterbuchvorlage oder den Beispiellink für ein Datenwörterbuch in der AWS Data Exchange Konsole wählen.
-
Wählen Sie Datenwörterbuchvorschau, um eine Vorschau des Datenwörterbuchs anzuzeigen.
-
Wählen Sie unter Beispiele — optional die Option Beispiele hochladen aus, wählen Sie ein Beispiel von Ihrem Computer aus und wählen Sie dann Öffnen aus.
Die Beispiele werden im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Sie können bis zu 10 Samples mit einer maximalen Größe von 50 MB hochladen. Beispiele im CSV-Format können in der Vorschau angezeigt werden.
-
Geben Sie für jedes Muster eine Beschreibung ein, die auf der Produktdetailseite angezeigt wird.
-
Wählen Sie Speichern aus.
-
-
Geben Sie unter Produktdefinition eine Kurzbeschreibung und eine Langbeschreibung Ihres Produkts ein.
Wenn Sie eine Vorlage für Ihre ausführliche Beschreibung verwenden möchten, wählen Sie Vorlage anwenden aus, wählen Sie Ihren Vorlagentyp aus und geben Sie dann Ihre spezifischen Produktdetails in die Vorlage ein.
-
Wählen Sie Weiter.
-
Konfigurieren Sie Ihr Angebot.
-
Wenn Sie ein öffentliches Angebot erstellen, konfigurieren Sie Ihr Angebot im Abschnitt Öffentliches Angebot hinzufügen. Für alle AWS Data Exchange Produkte, deren Sichtbarkeit auf Öffentlich gesetzt ist, ist ein öffentliches Angebot erforderlich.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie Ihre US-Mehrwertsteuereinstellungen, Ihren Datenabonnementvertrag (DSA) und Ihre Rückerstattungsrichtlinie aus.
-
(Optional) Richten Sie die Abonnementverifizierung ein, um zu kontrollieren, wer dieses Produkt abonnieren kann. Weitere Informationen finden Sie unter Abonnementüberprüfung für Anbieter.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
Wenn du ein privates Angebot erstellst, konfiguriere die Angebotsdetails im Abschnitt Benutzerdefiniertes Angebot hinzufügen.
-
Fügen Sie im Abschnitt Informationen zum Abonnentenkonto mindestens ein Abonnentenkonto hinzu, auf das Sie das Angebot erweitern möchten.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie das Ablaufdatum des Angebots, bis zu dem der Abonnent das Angebot annehmen muss.
-
Wählen Sie Ihre Einstellungen für die US-Umsatzsteuer, den Datenabonnementvertrag (DSA) und die Rückerstattungsrichtlinie aus.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
-
Überprüfen Sie im Bereich Überprüfen und veröffentlichen Ihre Produktinformationen und erweitern Sie dann die Vorschau der Produktseite, um zu sehen, wie sie nach der Veröffentlichung aussehen werden.
-
Wenn Sie sicher sind, dass das Produkt und das öffentliche Angebot sichtbar und für alle verfügbar sein sollen, wählen Sie Veröffentlichen.
Sie haben jetzt den manuellen Teil der Veröffentlichung eines Datenprodukts mit einem öffentlichen Angebot abgeschlossen. AWS Data Exchangebereitet Ihr Produkt vor und veröffentlicht es. Auf der Produktübersichtsseite lautet der Status Ihres Produkts Wartet auf Genehmigung. Der Status ändert sich zu Veröffentlicht, nachdem das Produkt veröffentlicht wurde.
Schritt 6: (Optional) Kopieren Sie ein Produkt
Nachdem Sie Ihr erstes Produkt erstellt haben, können Sie dessen Details und öffentliche Angebote kopieren, um ein neues Produkt zu erstellen.
Anmerkung
Sie können ein öffentliches, privates, veröffentlichtes oder unveröffentlichtes Produkt kopieren. Benutzerdefinierte Angebote, die mit dem Produkt verknüpft sind, können nicht kopiert werden, öffentliche Angebote können jedoch kopiert werden.
Um ein Produkt zu kopieren
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Produkte aus.
-
Wählen Sie unter Produkte die Option neben dem Produkt aus, das Sie kopieren möchten.
-
Wählen Sie die Dropdownliste Aktionen aus und wählen Sie dann Kopie erstellen aus.
-
Fahren Sie mit dem Workflow „Produkt veröffentlichen“ fort, wobei die Details für das Produkt, das Sie in Schritt 3 ausgewählt haben, bereits ausgefüllt sind. Weitere Informationen finden Sie unter Schritt 5: Veröffentlichen Sie ein neues Produkt.
Veröffentlichung eines Produkts, das Datensätze mit AWS Lake Formation Datenberechtigungen enthält (Vorschau)
Übersicht
Wenn Sie in dieser Vorschau Produkte veröffentlichen möchten, die AWS Lake Formation Datenberechtigungsdatensätze enthalten, wenden Sie sich an AWS Support
Ein AWS Lake Formation Datenberechtigungsdatensatz enthält eine Reihe von LF-Tags und Berechtigungen für Daten, die von verwaltet werden. AWS Lake Formation Wenn Kunden ein Produkt abonnieren, das Lake Formation Formation-Datenberechtigungen enthält, erhalten sie nur Lesezugriff auf die Datenbanken, Tabellen und Spalten, die den LF-Tags zugeordnet sind, die dem Datensatz hinzugefügt wurden.
Als Datenanbieter erstellen Sie zunächst LF-Tags in den Daten, die Sie Abonnenten zur Verfügung stellen möchten, AWS Lake Formation und verknüpfen diese Tags mit den Daten, die Sie Abonnenten zur Verfügung stellen möchten. Weitere Informationen zum Taggen Ihrer Ressourcen in Lake Formation finden Sie unter Tag-Based Access Control auf Lake Formation im AWS Lake FormationEntwicklerhandbuch. Anschließend importieren Sie diese LF-Tags und eine Reihe von Datenberechtigungen in AWS Data Exchange als Asset. Abonnenten erhalten beim Abonnement Zugriff auf die mit diesen LF-Tags verknüpften Daten.
In den folgenden Themen wird der Prozess der Veröffentlichung eines Produkts beschrieben, das AWS Lake Formation Datenberechtigungen enthält. Der Prozess umfasst die folgenden Schritte:
Schritte
- Schritt 1: Einen AWS Lake Formation Datensatz erstellen (Vorschau)
- Schritt 2: Erstellen Sie eine AWS Lake Formation Datenberechtigung (Vorschau)
- Schritt 3: Überprüfen und abschließen
- Schritt 5: (Optional) Erstellen Sie eine Revision
- Schritt 6: Veröffentlichen Sie ein neues Produkt mit AWS Lake Formation Datensätzen (Vorschau)
- Überlegungen beim Veröffentlichen eines AWS Lake Formation Datensatzes mit Datenberechtigungen (Vorschau)
Schritt 1: Einen AWS Lake Formation Datensatz erstellen (Vorschau)
So erstellen Sie ein AWS Lake Formation-Dataset:
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Produkte aus.
-
Wählen Sie unter Eigene Datensätze die Option Datensatz erstellen aus, um den Assistenten für Schritte zur Datensatzerstellung zu öffnen.
-
Wählen Sie unter Datensatztyp auswählen die Option AWS Lake FormationDatenberechtigung aus.
-
Geben Sie im Feld Datensatz definieren einen Namen und eine Beschreibung für Ihren Datensatz ein. Weitere Informationen finden Sie unter Bewährte Verfahren für Datensätze.
-
Wählen Sie unter Tags hinzufügen — optional die Option Neues Tag hinzufügen aus.
-
Wählen Sie Datensatz erstellen und fahren Sie fort.
Schritt 2: Erstellen Sie eine AWS Lake Formation Datenberechtigung (Vorschau)
AWS Data Exchangeverwendet LF-Tags, um Datenberechtigungen zu erteilen. Wählen Sie die LF-Tags aus, die mit den Daten verknüpft sind, die Sie teilen möchten, um Abonnenten Berechtigungen für die Daten zu gewähren.
Um eine Datenberechtigung zu erstellen AWS Lake Formation
-
Wählen Sie auf der Berechtigungsseite für Create Lake Formation Formation-Daten die Option LF-Tag hinzufügen aus.
-
Geben Sie den Schlüssel ein und wählen Sie Ihre LF-Tag-Werte aus.
-
Wählen Sie „Ressource (n) in der Vorschau anzeigen“, um zu sehen, wie Ihre LF-Tags interpretiert werden.
-
Wählen Sie unter Ressource (n) in der Vorschau anzeigen Ihre zugehörige (n) Datenkatalogressource (n) aus.
Anmerkung
Stellen Sie sicher, dass Sie die
IAMAllowedPrincipals
Gruppe für die folgenden Ressourcen sperren. Weitere Informationen finden Sie unter Temporäre Sicherheitsanmeldeinformationen für die IAM-Rolle widerrufen im IAM-Benutzerhandbuch.
-
-
Sehen Sie sich die Interpretation des LF-Tag-Ausdrucks im Dialogfeld unten und die mit dem Datensatz verknüpften Berechtigungen an.
-
Wählen Sie für Dienstzugriff Ihre bestehende Servicerolle aus, mit AWS Data Exchange der Sie die Rolle übernehmen und in Ihrem Namen auf Lake Formation Formation-Datenberechtigungen zugreifen, diese gewähren und entziehen können. Wählen Sie dann die Datenberechtigung Create Lake Formation. Weitere Informationen zum Erstellen einer Rolle für eine finden Sie unter Eine Rolle erstellenAWS -Service, um Berechtigungen an eine AWS -Service zu delegieren.
-
Geben Sie im Abschnitt Produkt definieren unter Produktübersicht Informationen zu Ihrem Produkt ein, einschließlich Produktname, Produktlogo, Support-Kontaktinformationen und Produktkategorien.
Weitere Informationen finden Sie unter Produktdetails.
-
(Optional) Wählen Sie im Abschnitt Produkt definieren unter Datenwörterbücher und Beispiele — optional einen Datensatz aus, indem Sie auf das Optionsfeld neben dem Datensatznamen klicken und dann Bearbeiten wählen.
Weitere Informationen finden Sie unter Datenwörterbücher und Beispiele.
-
Wählen Sie im Dialogfeld Bearbeiten unter Datenwörterbuch hochladen die Option Datei hinzufügen aus, um ein neues Datenwörterbuch hochzuladen.
Sie können ein Datenwörterbuch im CSV-Format mit einer maximalen Größe von 1 MB auswählen.
-
Wählen Sie ein gespeichertes Datenwörterbuch auf Ihrem Computer aus und wählen Sie dann Öffnen.
Die CSV-Datei mit dem Datenwörterbuch wird im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Ihr Datenwörterbuch muss der AWS Data Exchange Datenwörterbuchvorlage entsprechen. Wenn Sie kein gespeichertes Datenwörterbuch zum Hochladen haben, können Sie entweder den leeren Link zur Datenwörterbuchvorlage oder den Beispiellink für ein Datenwörterbuch in der AWS Data Exchange Konsole wählen.
-
Wählen Sie Datenwörterbuchvorschau, um eine Vorschau des Datenwörterbuchs anzuzeigen.
-
Wählen Sie unter Beispiele — optional die Option Beispiele hochladen aus, wählen Sie ein Beispiel von Ihrem Computer aus und wählen Sie dann Öffnen aus.
Die Beispiele werden im Dialogfeld Bearbeiten angezeigt.
Anmerkung
Sie können bis zu 10 Samples mit einer maximalen Größe von 50 MB hochladen. Beispiele im CSV-Format können in der Vorschau angezeigt werden.
-
Geben Sie für jedes Muster eine Beschreibung ein, die auf der Produktdetailseite angezeigt wird.
-
Wählen Sie Speichern aus.
-
-
Geben Sie unter Produktdefinition eine Kurzbeschreibung und eine Langbeschreibung Ihres Produkts ein.
Wenn Sie eine Vorlage für Ihre ausführliche Beschreibung verwenden möchten, wählen Sie Vorlage anwenden aus, wählen Sie Ihren Vorlagentyp aus und geben Sie dann Ihre spezifischen Produktdetails in die Vorlage ein.
-
Wählen Sie Weiter.
-
Konfigurieren Sie Ihr Angebot.
-
Wenn Sie ein öffentliches Angebot erstellen, konfigurieren Sie Ihr Angebot im Abschnitt Öffentliches Angebot hinzufügen. Für alle AWS Data Exchange Produkte, deren Sichtbarkeit auf Öffentlich gesetzt ist, ist ein öffentliches Angebot erforderlich.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie Ihre US-Mehrwertsteuereinstellungen, Ihren Datenabonnementvertrag (DSA) und Ihre Rückerstattungsrichtlinie aus.
-
(Optional) Richten Sie die Abonnementverifizierung ein, um zu kontrollieren, wer dieses Produkt abonnieren kann. Weitere Informationen finden Sie unter Abonnementüberprüfung für Anbieter.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
Wenn du ein privates Angebot erstellst, konfiguriere die Angebotsdetails im Abschnitt Benutzerdefiniertes Angebot hinzufügen.
-
Fügen Sie im Abschnitt Informationen zum Abonnentenkonto mindestens ein Abonnentenkonto hinzu, auf das Sie das Angebot erweitern möchten.
-
Wählen Sie Ihre Optionen für Preise und Zugriffsdauer für das Abonnement aus.
-
Wählen Sie das Ablaufdatum des Angebots, bis zu dem der Abonnent das Angebot annehmen muss.
-
Wählen Sie Ihre Einstellungen für die US-Umsatzsteuer, den Datenabonnementvertrag (DSA) und die Rückerstattungsrichtlinie aus.
-
Wählen Sie Ihre Option zur automatischen Verlängerung. Weitere Informationen finden Sie unter Erstellen eines Angebots fürAWS Data ExchangeProdukte.
-
Wählen Sie Weiter.
-
-
-
Überprüfen Sie im Bereich Überprüfen und veröffentlichen Ihre Produktinformationen und erweitern Sie dann die Vorschau der Produktseite, um zu sehen, wie sie nach der Veröffentlichung aussehen werden.
-
Wenn Sie sicher sind, dass das Produkt und das öffentliche Angebot sichtbar und für alle verfügbar sein sollen, wählen Sie Veröffentlichen.
Sie haben jetzt den manuellen Teil der Veröffentlichung eines Datenprodukts mit einem öffentlichen Angebot abgeschlossen. AWS Data Exchangebereitet Ihr Produkt vor und veröffentlicht es. Auf der Produktübersichtsseite lautet der Status Ihres Produkts Wartet auf Genehmigung. Der Status ändert sich zu Veröffentlicht, nachdem das Produkt veröffentlicht wurde.
Schritt 3: Überprüfen und abschließen
Nachdem Sie Ihre AWS Lake Formation Datenberechtigung (Vorschau) erstellt haben, können Sie Ihren Datensatz überprüfen und finalisieren.
Zur Überprüfung und Finalisierung
-
Überprüfen Sie die Details und Tags Ihres Datensatzes in Schritt 1 auf Richtigkeit.
-
Überprüfen Sie Ihre LF-Tag-Ausdrücke, fügen Sie eine weitere Lake Formation Formation-Datenberechtigung hinzu (optional), die zugehörigen Datenkatalogressourcen und die Jobdetails.
Anmerkung
Job werden 90 Tage nach ihrer Erstellung gelöscht.
-
Wählen Sie Finalize.
Schritt 5: (Optional) Erstellen Sie eine Revision
Um eine Revision zu erstellen
-
Wählen Sie im Abschnitt Eigene Datensätze den Datensatz aus, für den Sie eine Revision hinzufügen möchten.
-
Wählen Sie die Registerkarte Revisionen.
-
Wählen Sie im Abschnitt Revisionen die Option Revision erstellen aus.
-
Wählen Sie auf der Seite mit den Datenberechtigungen für Revise Lake Formation die Option LF-Tag hinzufügen aus.
-
Überprüfen Sie die Berechtigungen für Datenbank und Tabelle.
-
Wählen Sie unter Dienstzugriff eine vorhandene Servicerolle aus und wählen Sie dann Create Lake Formation Formation-Datenberechtigung aus.
Schritt 6: Veröffentlichen Sie ein neues Produkt mit AWS Lake Formation Datensätzen (Vorschau)
Nachdem Sie mindestens einen Datensatz erstellt und eine Revision mit Ressourcen abgeschlossen haben, können Sie ein Produkt mit AWS Lake Formation Datensätzen veröffentlichen. Weitere Informationen finden Sie unter Produktdetails. Stellen Sie sicher, dass Sie über alle erforderlichen Informationen zu Ihrem Produkt verfügen.
Um ein neues Produkt mit AWS Lake Formation Datensätzen zu veröffentlichen (Vorschau)
-
Öffnen Sie Ihren Webbrowser und melden Sie sich an der AWS Data ExchangeKonsole
an. -
Wählen Sie im linken Navigationsbereich unter Daten veröffentlichen die Option Produkte aus.
-
Wählen Sie unter Produkte die Option Neues Produkt veröffentlichen aus, um den Assistenten zur Veröffentlichung neuer Produkte zu öffnen.
-
Wählen Sie im Abschnitt Produktsichtbarkeit die Optionen Produktsichtbarkeit und Konfiguration für vertrauliche Informationen für Ihr Produkt aus und klicken Sie dann auf Weiter. Weitere Informationen finden Sie unter Sichtbarkeit des Produkts und Sensible Informationskategorien.
-
Aktivieren Sie im Abschnitt Daten hinzufügen unter Eigene Datensätze die Kontrollkästchen neben den Datensätzen, die Sie hinzufügen möchten, und wählen Sie dann Ausgewählte hinzufügen aus.
Anmerkung
Für die ausgewählten Datensätze muss eine endgültige Version vorliegen. Datensätze ohne abgeschlossene Versionen werden nicht hinzugefügt.
-
Gehen Sie zu Ausgewählte Datensätze, um Ihre Auswahl zu überprüfen.
Sie können den Namen des Datensatzes, den Typ des Datensatzes und den Zeitstempel der letzten Aktualisierung des Datensatzes überprüfen.
-
Gehen Sie zu Revisionszugriffsregeln auswählen, wählen Sie die Revisionszugriffsregeln aus, die Sie für die in diesem Produkt enthaltenen Datensätze festlegen möchten, und klicken Sie dann auf Weiter.
Weitere Details finden Sie unter Revision der Zugriffsregeln.
-
Überlegungen beim Veröffentlichen eines AWS Lake Formation Datensatzes mit Datenberechtigungen (Vorschau)
Um ein optimales Abonnentenerlebnis zu gewährleisten, raten wir dringend davon ab, die folgenden Änderungen an den Berechtigungen vorzunehmen, die Ihr Produkt AWS Data Exchange für Lake Formation Formation-Datensätze (Preview) mit aktiven Abonnenten dieses Produkts enthält.
-
Wir empfehlen, keine IAM-Rollen zu löschen oder zu ändern, die AWS Data Exchange in veröffentlichten Produkten, die AWS Lake Formation Datensätze enthalten, weitergegeben wurden. Wenn Sie solche IAM-Rollen löschen oder ändern, treten die folgenden Probleme auf:
-
AWS-Kontendie Zugriff auf die Lake Formation Formation-Datenberechtigungen haben, behalten den Zugriff möglicherweise auf unbestimmte Zeit.
-
AWS-KontenPersonen, die Ihr Produkt abonnieren, aber noch keinen Zugriff auf die Datenberechtigungen von Lake Formation erhalten haben, erhalten keinen Zugriff.
AWS Data Exchangehaftet nicht für IAM-Rollen, die Sie löschen oder ändern.
-
-
Wir empfehlen, dass Sie erteilte AWS Lake Formation Datenberechtigungen für IAM-Rollen, an die ein veröffentlichtes Produkt mit AWS Data Exchange AWS Lake Formation Datensätzen weitergegeben wurde, nicht widerrufen. Wenn Sie solchen IAM-Rollen erteilte Datenberechtigungen entziehen, treten die folgenden Probleme auf:
-
AWS-Kontendie Zugriff auf die Lake Formation Formation-Datenberechtigungen haben, behalten den Zugriff möglicherweise auf unbestimmte Zeit.
-
AWS-KontenPersonen, die Ihr Produkt abonnieren, aber noch keinen Zugriff auf die Datenberechtigungen von Lake Formation erhalten haben, erhalten keinen Zugriff.
-
-
Wir empfehlen, erteilte AWS Lake Formation Datenberechtigungen AWS-Konten bei aktiven Abonnements für veröffentlichte Produkte, die AWS Lake Formation Datensätze enthalten, nicht zu widerrufen. Wenn Sie den AWS-Konten Abonnenten Ihres Produkts erteilte Datenberechtigungen entziehen, verlieren diese Konten den Zugriff, was zu einem schlechten Kundenerlebnis führt.
-
Wir empfehlen, bei der Veröffentlichung von Produkten, die AWS Lake Formation Datensätze enthaltenAWS Glue Data Catalog, die kontoübergreifende Version in Ihrem System auf Version 3 einzustellen. Wenn Sie die kontoübergreifende Version Ihres Data Lake-Katalogs herunterstufen, während Sie Produkte veröffentlicht haben, die AWS Lake Formation Datensätze enthalten, erhalten diejenigen, AWS-Konten die Ihr Produkt abonnieren, aber noch keinen Zugriff auf die Lake Formation Formation-Datenberechtigungen erhalten haben, möglicherweise keinen Zugriff auf die Daten.