UpdateStream - Amazon Kinesis Video Streams
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

UpdateStream

Aktualisiert Stream-Metadaten wie den Gerätenamen und den Medientyp.

Sie müssen den Stream-Namen oder den Amazon-Ressourcennamen (ARN) des Streams angeben.

Um sicherzustellen, dass Sie über die neueste Version des Streams verfügen, bevor Sie ihn aktualisieren, können Sie die Stream-Version angeben. Kinesis Video Streams weist jedem Stream eine Version zu. Wenn Sie einen Stream aktualisieren, weist Kinesis Video Streams eine neue Versionsnummer zu. Verwenden Sie die API, um die neueste Stream-Version zu erhalten. DescribeStream

UpdateStreamist ein asynchroner Vorgang, dessen Abschluss einige Zeit in Anspruch nimmt.

Anforderungssyntax

POST /updateStream HTTP/1.1
Content-type: application/json

{
   "CurrentVersion": "string",
   "DeviceName": "string",
   "MediaType": "string",
   "StreamARN": "string",
   "StreamName": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

CurrentVersion

Die Version des Streams, dessen Metadaten Sie aktualisieren möchten.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.

Pattern: [a-zA-Z0-9]+

Erforderlich: Ja

DeviceName

Der Name des Geräts, das in den Stream schreibt.

Anmerkung

In der aktuellen Implementierung verwendet Kinesis Video Streams diesen Namen nicht.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Nein

MediaType

Der Medientyp des Streams. Wird verwendetMediaType, um den Inhaltstyp anzugeben, den der Stream für die Nutzer des Streams enthält. Weitere Informationen zu Medientypen finden Sie unter Medientypen. Wenn Sie das MediaType angeben möchten, finden Sie weitere Informationen unter Benennungsvoraussetzungen.

Um Video auf der Konsole abzuspielen, müssen Sie den richtigen Videotyp angeben. Wenn es sich bei dem Video im Stream beispielsweise um H.264 handelt, geben Sie video/h264 als anMediaType.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

Erforderlich: Nein

StreamARN

Der ARN des Streams, dessen Metadaten Sie aktualisieren möchten.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.

Pattern: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Erforderlich: Nein

StreamName

Der Name des Streams, dessen Metadaten Sie aktualisieren möchten.

Der Streamname ist eine Kennung für den Stream und muss für jedes Konto und jede Region eindeutig sein.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Pattern: [a-zA-Z0-9_.-]+

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200

Antwortelemente

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

ClientLimitExceededException

Kinesis Video Streams hat die Anfrage gedrosselt, weil Sie das Limit der erlaubten Client-Aufrufe überschritten haben. Versuchen Sie später, den Anruf zu tätigen.

HTTP Status Code: 400

InvalidArgumentException

Der Wert für diesen Eingabeparameter ist ungültig.

HTTP Status Code: 400

NotAuthorizedException

Der Anrufer ist nicht autorisiert, diesen Vorgang auszuführen.

HTTP-Statuscode: 401

ResourceInUseException

Wenn der Eingang StreamARN oder ChannelARN Eingang bereits einer anderen Kinesis Video Stream-Ressource zugeordnet CLOUD_STORAGE_MODE ist oder wenn sich der angegebene Eingang StreamARN oder Eingang nicht im Status Aktiv ChannelARN befindet, versuchen Sie es mit einer der folgenden Methoden:

  1. Die DescribeMediaStorageConfiguration API, um zu ermitteln, welchem Stream der angegebene Kanal zugeordnet ist.

  2. Die DescribeMappedResourceConfiguration API zur Bestimmung des Kanals, dem der angegebene Stream zugeordnet ist.

  3. Die DescribeStream oder DescribeSignalingChannel API, um den Status der Ressource zu bestimmen.

HTTP Status Code: 400

ResourceNotFoundException

Amazon Kinesis Video Streams kann den von Ihnen angegebenen Stream nicht finden.

HTTP Status Code: 404

VersionMismatchException

Die von Ihnen angegebene Stream-Version ist nicht die neueste Version. Verwenden Sie die DescribeStreamAPI, um die neueste Version zu erhalten.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: