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` `UpdateStream`ist 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](#API_UpdateStream_RequestSyntax) ** 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](#API_UpdateStream_RequestSyntax) ** Der Name des Geräts, das in den Stream schreibt. 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](#API_UpdateStream_RequestSyntax) ** Der Medientyp des Streams. Wird verwendet`MediaType`, um den Inhaltstyp anzugeben, den der Stream für die Nutzer des Streams enthält. Weitere Informationen zu Medientypen finden Sie unter [Medientypen](http://www.iana.org/assignments/media-types/media-types.xhtml). Wenn Sie das `MediaType` angeben möchten, finden Sie weitere Informationen unter [Benennungsvoraussetzungen](https://tools.ietf.org/html/rfc6838#section-4.2). 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 an`MediaType`. 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](#API_UpdateStream_RequestSyntax) ** 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](#API_UpdateStream_RequestSyntax) ** 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 Fehlertypen](CommonErrors.md). ** 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-Statuscode: 400 ** InvalidArgumentException ** Der Wert für diesen Eingabeparameter ist ungültig. HTTP-Statuscode: 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. 1. Die `DescribeMappedResourceConfiguration` API zur Bestimmung des Kanals, dem der angegebene Stream zugeordnet ist. 1. Die `DescribeStream` oder `DescribeSignalingChannel` API, um den Status der Ressource zu bestimmen. HTTP-Statuscode: 400 ** ResourceNotFoundException ** Amazon Kinesis Video Streams kann den von Ihnen angegebenen Stream nicht finden. HTTP-Statuscode: 404 ** VersionMismatchException ** Die von Ihnen angegebene Stream-Version ist nicht die neueste Version. Verwenden Sie die [DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)API, um die neueste Version zu erhalten. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateStream)