Migration in den Namespace ChimeSdkMediaPipelines

Sie verwenden den ChimeSdkMediaPipelines Namespace, um die API-Endpunkte der Media Pipeline in jeder AWS Region anzusprechen, in der sie verfügbar sind. Verwenden Sie diesen Namespace, wenn Sie gerade erst anfangen, das Amazon Chime SDK zu verwenden. Weitere Informationen zu Regionen finden Sie Verfügbare Regionen in diesem Handbuch.

Bestehende Anwendungen, die den Amazon Chime-Namespace verwenden, sollten eine Migration in den dedizierten Namespace einplanen.

Gründe für die Migration Ihrer Pipelines

Wir empfehlen Ihnen, aus den folgenden Gründen in den ChimeSdkMediaPipelines Namespace zu migrieren:

Wahl des API-Endpunkts

Der Amazon Chime SDK Media Capture-Namespace ist der einzige API-Namespace, der API-Endpunkte in jeder Region verwenden kann, in der sie verfügbar sind. Weitere Informationen zu Regionen finden Sie unterVerfügbare Regionen. Wenn Sie andere API-Endpunkte verwenden möchtenus-east-1, müssen Sie den ChimeSdkMediaPipelines Namespace verwenden. Weitere Informationen zu den aktuellen Endpunkten finden Sie API-Zuordnung in diesem Handbuch.

Aktualisierte und neue Media-Pipeline-APIs

Wir fügen nur Media-Pipeline-APIs im ChimeSdkMediaPipelines Namespace hinzu oder aktualisieren sie.

Bevor Sie Ihre Pipelines migrieren

Bevor Sie migrieren, sollten Sie sich der Unterschiede zwischen den Namespaces bewusst sein. In der folgenden Tabelle werden sie aufgeführt und beschrieben.

Item	Namespace für Medienleitungen	Chime-Namensraum
Namespace-Namen	ChimeSdkMediaPipelines	Glockenspiel
Regionen	Mehrere	nur us-east-1
Endpunkte	https://media-pipelines-chime. region .amazonaws.com	https://service.chime.aws.amazon.com
Dienstauftraggeber	mediapipelines.chime.amazonaws.com	chime.amazonaws.com
APIs	Nur APIs für Medien-Pipelines	APIs für Medien-Pipelines und andere Teile von Amazon Chime
Treffen	Medien-Pipelines in den eu-central-1 Regionen us-west-2ap-southeast-1, und funktionieren nur mit Besprechungen, die im Amazon Chime SDK Meetings-Namespace erstellt wurden. Medienleitungen in der us-east-1 Region funktionieren mit Besprechungen, die von einem beliebigen Meeting-Endpunkt in einem der Namespaces erstellt wurden.	Medien-Pipelines funktionieren mit Besprechungen, die von einem beliebigen Meeting-Endpunkt in einem der Namespaces erstellt wurden.
Aktive Standardmedien-Pipelines	100 in der Region us-east-1 und 10 in den Regionen us-west-2, ap-Southeast-1 und eu-central-1.	100 nur in US-East-1.
Serviceverknüpfte Rolle	AWSServiceRoleForAmazonChimeSDKMediaPipelines
Tags (Markierungen)	Verfügbar	Nicht verfügbar für die Media Pipeline-APIs.
CloudTrailQuelle des Ereignisses	chime-sdk-media-pipelines.amazonaws.com	chime.amazonaws.com.
Media Live-Anschluss	Verfügbar	Nicht verfügbar für die Media Pipeline-APIs.
Zusammensetzen	Verfügbar	Nicht verfügbar für die Media Pipeline-APIs.
Verkettung	Verfügbar	Nicht verfügbar.

Die folgende Liste enthält weitere Informationen zu den Unterschieden zwischen Chime und AWS ChimeSdkMediaPipelines Namespaces.

Namespace-Namen

Der Amazon Chime SDK-Namespace verwendet den AWS.Chime formalen Namen. Der Amazon Chime SDK Media Pipelines Namespace verwendet den AWS.ChimeSDKMediaPipelines formalen Namen. Das genaue Format des Namens variiert je nach Plattform.

Diese Codezeile von Node.js befasst sich beispielsweise mit dem chime Namespace:

const chimeMediaPipelines = AWS.Chime();

Um zum Media Pipelines SDK-Namespace zu migrieren, aktualisieren Sie diesen Code mit dem neuen Namespace und der Endpunktregion.

const chimeMediaPipelines = AWS.ChimeSDKMediaPipelines({ region: "eu-central-1" });

Regionen

Der Amazon Chime-Namespace adressiert nur API-Endpunkte in der Region US-EAST-1. Der Amazon Chime SDK Media Pipelines Namespace adressiert Amazon Chime SDK Media Pipelines API-Endpunkte in jeder Region, in der sie vorhanden sind. Eine aktuelle Liste der Media Pipeline-Regionen finden Sie Verfügbare Regionen in diesem Handbuch.

Endpunkte

Um eine Media Capture-Pipeline zu ändern, müssen Sie denselben Endpunkt verwenden, in dem Sie die Pipeline erstellt haben. Wenn Sie beispielsweise Pipelines über einen Endpunkt in eu-central-1 erstellt haben, müssen Sie eu-central-1 verwenden, um mit dieser Pipeline zu interagieren. Weitere Informationen zu den aktuellen Endpunkten finden Sie API-Zuordnung in diesem Handbuch.

Dienstauftraggeber

Der Amazon Chime SDK Media Pipelines Namespace verwendet ein neues Serviceprinzip:. mediapipelines.chime.amazonaws.com Wenn Sie über Amazon S3-Bucket- oder andere IAM-Richtlinien verfügen, die Zugriff auf Dienste gewähren, müssen Sie diese Richtlinien aktualisieren, um dem neuen Service Principal Zugriff zu gewähren.

Wenn Sie beispielsweise eine Medienpipeline erstellen, müssen Sie dem neuen Service Principal die in Erstellung eines Amazon S3-Buckets dieser Liste aufgeführten Richtlinienberechtigungen hinzufügen. Weitere Informationen zu Richtlinien finden Sie unter AWS JSON Policy elements: Principal im IAM-Benutzerhandbuch.

APIs

Der Amazon Chime SDK Media Pipelines Namespace enthält nur APIs, die Medien-Pipelines erstellen und verwalten. Der Amazon Chime-Namespace umfasst APIs für Medien-Pipelines, Besprechungen und andere Teile des Amazon Chime-Dienstes.

Treffen

Medienleitungen in der IAD-Region funktionieren mit Besprechungen, die von einem beliebigen Meeting-Endpunkt mit einem beliebigen Namespace erstellt wurden.

Serviceverknüpfte Rolle

Nur für den Amazon Chime SDK Media Pipelines Namespace. Erstellen Sie die AWSServiceRoleForAmazonChimeSDKMediaPipelines-Rolle.

Tags (Markierungen)

Der Amazon Chime SDK Media Pipelines Namespace unterstützt Tags. Die Rolle muss über die Berechtigung verfügen, den TagResource Vorgang aufzurufen, wenn sie die CreateMediaCapturePipelineoder CreateMediaLiveConnectorPipelineAPIs mit einem oder mehreren Tags aufruft.