View a markdown version of this page

Einen Custom Event Bus mit anderen Accounts teilen - Amazon EventBridge

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.

Einen Custom Event Bus mit anderen Accounts teilen

Teilen Sie den Bus mit AWS Resource Access Manager (AWS RAM), damit ein anderes Konto in Ihrem Bus veröffentlicht, ihm Abonnenten oder Veranstaltungsquellen zuordnen können. Wählen Sie dann eine der vier verwalteten Berechtigungen aus. Teilen Sie sich beispielsweise den orders Bus mit einem Konto, das 444455556666 Sie verwendetAWSRAMEventBridgeEventBusV2SubscribeOnly, und dieses Konto kann Abonnenten für ihn erstellen. Schreiben Sie stattdessen eine Ressourcenrichtlinie für den Bus, wenn Sie eine expliziteDeny, einen Bedingungsschlüssel oder eine Erteilung benötigen, die keine verwaltete Berechtigung zum Ausdruck bringt. Das andere Konto benötigt immer noch dieselben Aktionen in seinen eigenen Identitätsrichtlinien, da beide Seiten dies zulassen müssen.

Voraussetzungen für die gemeinsame Nutzung eines Busses

  • Sie sind mit identitäts- und ressourcenbasierten IAM-Richtlinien vertraut, da für die gemeinsame Nutzung eines Busses die gleichen Berechtigungen sowohl für den Bus als auch für die Identität des Verbrauchers erforderlich sind.

  • Sie müssen der Besitzer des Busses sein. Mit einem Kundenkonto können Sie sich nicht einen Bus teilen.

  • Um Inhalte für Konten in Ihrer Organisation ohne Einladung freizugeben, aktivieren Sie das Teilen mit AWS Organizations in AWS RAM. Um Inhalte mit einem Konto außerhalb Ihrer Organisation zu teilen, muss das Konto die Einladung zur gemeinsamen Nutzung der Ressource annehmen, bevor es den Bus nutzen kann.

  • Der Bus und die Abonnenten des Verbrauchers befinden sich in derselben Region und Partition. Ein Verbraucher veröffentlicht auf dem Bus und generiert Abonnenten auf dem Bus in der Region des Busses.

Einen Bus teilen

Wir empfehlen AWS RAM eine Ressourcenrichtlinie, die Sie selbst schreiben. Damit hast du einen Ort AWS RAM, an dem du sehen und widerrufen kannst, was du geteilt hast. AWS RAM arbeitet auch mit dir zusammen AWS Organizations und schreibt die AWS_RAM Ressourcenrichtlinien des Busses für dich. Erstellen Sie eine Ressourcenfreigabe, die den Bus-ARN, die Verbraucherkonten oder Organisationseinheiten und eine der vier AWS verwalteten Berechtigungen für den Busressourcentyp benennt, jeweils unterarn:aws:ram::aws:permission/name.

In der folgenden Tabelle ist aufgeführt, was das Verbraucherkonto mit den einzelnen verwalteten Berechtigungen tun kann.

Verwaltete BerechtigungWas kann das Verbraucherkonto

AWSRAMEventBridgeEventBusV2PublishOnly

Veröffentlichen Sie es im Bus und beschreiben Sie den Bus

AWSRAMEventBridgeEventBusV2SubscribeOnly

Verbinden Sie Abonnenten mit dem Bus, aktualisieren Sie ihre Filter und beschreiben Sie den Bus

AWSRAMEventBridgeEventBusV2EventSourceAccess

Fügen Sie Ereignisquellen hinzu, aktualisieren Sie sie und beschreiben Sie den Bus

AWSRAMEventBridgeEventBusV2FullAccess

Veröffentlichen Sie mit einer der APIs, beschreiben Sie den Bus und erstellen, aktualisieren und löschen Sie seine eigenen Abonnenten und Ereignisquellen

aws ram create-resource-share \ --name orders-bus-share \ --resource-arns arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef \ --principals 444455556666 \ --permission-arns arn:aws:ram::aws:permission/AWSRAMEventBridgeEventBusV2SubscribeOnly

Um weniger als eine verwaltete Berechtigung zu erteilen oder einen Bedingungsschlüssel hinzuzufügen, erstellen Sie eine vom AWS RAM Kunden verwaltete Berechtigung. AWS RAM lehnt eine Aktion ab, in der nur ein Busbesitzer als Aktion bezeichnet wird. Lesen Sie eine Berechtigung zusammen mit dem AWS RAM GetPermission Vorgang zurück, anstatt von der genauen Aktionsliste auszugehen.

Einen Bus nicht teilen

Um die gemeinsame Nutzung zu beenden, entfernen Sie den Bus oder den Prinzipal aus der Ressourcenfreigabe oder löschen Sie die gemeinsame Nutzung. EventBridgeautorisiert einen Abonnenten oder eine Ereignisquelle, wenn sie erstellt wird, sodass ein Abonnent, den der Verbraucher erstellt hat, während die Freigabe aktiv war, weiterhin zustellt, nachdem Sie die gemeinsame Nutzung aufgehoben haben. Um es zu beenden, widerrufe es mit. RevokeResource Weitere Informationen zum Widerrufen eines Abonnenten oder einer Ereignisquelle finden Sie unterEinen Abonnenten oder eine Ereignisquelle sperren. Sobald der Share weg ist, kann der Nutzer keine neuen Abonnenten mehr veröffentlichen oder neue Abonnenten erstellen.

Sie arbeiten mit einem Bus, der mit Ihnen geteilt wird

Ein Bus, der mit Ihrem Konto geteilt wird, erscheint in Ihren ListEventBuses Ergebnissen mit dem Konto des Besitzers in seinem ARN, und Sie verwenden ihn mit diesem ARN in der Region des Busses. Was du darauf erstellst, gehört dir: Wenn du Abonnenten für den gemeinsamen Bus auflistest, siehst du nur deine eigenen Abonnenten, während der Busbesitzer sie alle sieht. Wenn Sie sich einen Bus teilen, wird nur dieser Bus angezeigt. Sie sehen nie die anderen Busse des Besitzers. Sie können den Bus nicht aktualisieren oder löschen, seine Ressourcenrichtlinie ändern oder ihn gemeinsam nutzen, und Sie können nicht auf einen Abonnenten reagieren, der einem anderen Konto gehört. Der Busbesitzer kann alle Ihre Abonnenten oder Eventquellen mit abmelden. Eine RevokeResource gesperrte Ressource wird dauerhaft gesperrt und Sie können sie nur löschen.

Fakturierung und Messung

Wenn Sie sich einen Bus teilen, fallen keine eigenen Gebühren an. Veröffentlichung, Lieferung und Aufbewahrung werden wie auf der EventBridge Amazon-Preisseite beschrieben abgerechnet. Der Busbesitzer kann das Liefervolumen pro Kundenkonto in den EventsDelivered EgressBytes Kennzahlen mit der SubscriberAccount Dimension einsehen. Weitere Informationen zur Beobachtbarkeit finden Sie unterBeobachtbarkeit für den Custom Event Bus: Metriken, Protokolle und CloudTrail.

Schreiben Sie eine benutzerdefinierte Ressourcenrichtlinie

Ein Event-Bus ist die einzige Custom Event Bus-Ressource, für die eine Ressourcenrichtlinie gilt. Jeder andere Ressourcen-ARN wird EventBridge zurückgewiesen. Ein Bus enthält zwei benannte Richtlinien. Bei der default Richtlinie handelt es sich um die Richtlinie, die Sie in der vollständigen Sprache der IAM-Richtlinien, einschließlich der Deny Anweisungen, verfassen. AWS_RAMwurde nur von Ihren Ressourcenanteilen verfasst AWS RAM und spiegelt diese wider.

EventBridge wertet sowohl aus, wenn es einen Anrufer von einem anderen Konto aus autorisiert, als auch ein expliziter Eingang überschreibt einen Deny Allow in dem anderen. Wenn ein kontoübergreifender Anrufer abgelehnt wird und die von Ihnen verfasste Richtlinie dies anscheinend zulässt, lesen Sie die andere Richtlinie.

Mit der folgenden default Richtlinie für den orders Bus können Konten Abonnenten 444455556666 anbinden und den Bus lesen, und sonst nichts.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowPartnerAccountToSubscribe", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::444455556666:root" }, "Action": [ "events:CreateSubscriber", "events:DescribeEventBus" ], "Resource": "arn:aws:events:us-east-1:111122223333:event-busv2/orders/EXAMPLE1234567890abcdef" } ] }

Verwalten Sie die Richtlinien mit PutResourcePolicyGetResourcePolicy,DeleteResourcePolicy, undListResourcePolicies. Jeder nimmt den Bus ARN rein--resource-arn. Die ersten drei wirken sich ausdefault, wenn Sie etwas weglassen--policy-name. Sie können weder schreiben noch löschenAWS_RAM: Das Benennen schlägt fehl mitAccessDeniedException. GetResourcePolicyschlägt fehl, ResourceNotFoundException wenn die benannte Richtlinie nicht existiert, anstatt ein leeres Dokument zurückzugeben. Behandeln Sie das also so, als ob es keine Richtlinie gibt. Ein Bus, über den Sie nur gemeinsam genutzt haben, AWS RAM hat keine default Richtlinie, also get-resource-policy ohne --policy-name gibt diesen Fehler zurück. Gehen Sie weiter, um die Richtlinie --policy-name AWS_RAM zu lesen, die die Richtlinie AWS RAM geschrieben hat. ListResourcePoliciesgibt nur Richtliniennamen und Revisions-IDs zurück, niemals Dokumente. Um einen Schreib- oder Löschvorgang an Bedingungen zu knüpfen, übergeben Sie die aktuelle Version der Richtlinie--expected-revision-id. Bei einer Nichtübereinstimmung schlägt der Vorgang fehl. ConflictException Ein default Richtliniendokument kann bis zu 20 KB groß sein; eine größere Richtlinie schlägt fehl mitPolicyLengthExceededException. Dieses Kontingent ist in Service Quotas einstellbar.

EventBridge lehnt eine default Richtlinie ab, die öffentlichen Zugriff gewähren würdePublicPolicyException, und fügt sie nicht hinzu. Diese Prüfung ist immer aktiviert. Ein Kontoauszug gewährt öffentlichen Zugriff, wenn sein Hauptbenutzer ein Platzhalter ist und keine Bedingung die Anrufer auf bestimmte Konten oder Hauptbenutzer beschränkt. Eine Bedingung für den Inhalt der Veranstaltung, wie z. B.events:source, identifiziert den Anrufer nicht. Eine Bedingung wie aws:PrincipalOrgID tut. Eine Richtlinie, die Sie schreiben, ist unsichtbar für Sie AWS RAM, also ist es Ihre eigene Nachverfolgung.

Ereignisse, die ohne Aufforderung zur Veröffentlichung eintreffen

Ereignisse kommen auch in einem Bus ohne Direktverbindung PutEvents oder PutRawEvents Anruf an: von einer Ereignisquelle oder von einer Regel oder einem Teilnehmer auf einem anderen Bus, dessen Ziel dieser Bus ist. EventBridge autorisiert eine Ereignisquelle einmal, wenn Sie sie erstellen. Es überprüft nichts erneut, wenn Ereignisse eintreffen, sodass eine Busrichtlinie den Verkehr danach nicht mehr filtern kann. Weitere Hinweise zu Ereignisquellen finden Sie unterEreignisquellen für einen benutzerdefinierten Event-Bus. Eine Regel oder ein Abonnent, die Sie selbst auf einen Bus zeigen, wird bei der Aufnahme unter der von Ihnen angegebenen Rolle einmal für jedes Ereignis autorisiert. EventBridge wählt die Aktion pro Ereignis aus: events:PutEvents für eine echte AWS Service- oder Partnerveranstaltung und events:PutRawEvents für eine von Ihnen initiierte Veranstaltung. Sie können die verwendete Aktion nicht auswählen. Einem Forwarder, der beide Arten von Ereignissen über einen Pfad überträgt, müssen beide Aktionen in der Identitätsrichtlinie der Rolle und in der Ressourcenrichtlinie des Zielbusses gewährt werden. Wenn nur eine Person gewährt wird, wird der halbe Stream verweigert.