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. # CreateStream Erzeugt einen neuen Kinesis-Videostream. Wenn Sie einen neuen Stream erstellen, weist Kinesis Video Streams ihm eine Versionsnummer zu. Wenn Sie die Metadaten des Streams ändern, aktualisiert Kinesis Video Streams die Version. `CreateStream` ist ein asynchroner Vorgang. Weitere Information zur Funktionsweise des Services finden Sie unter [Funktionsweise](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html). Sie müssen über Berechtigungen für die `KinesisVideo:CreateStream`-Aktion verfügen. ## Anforderungssyntax ``` POST /createStream HTTP/1.1 Content-type: application/json { "DataRetentionInHours": number, "DeviceName": "string", "KmsKeyId": "string", "MediaType": "string", "StreamName": "string", "StreamStorageConfiguration": { "DefaultStorageTier": "string" }, "Tags": { "string" : "string" } } ``` ## URI-Anfrageparameter Die Anforderung verwendet keine URI-Parameter. ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [DataRetentionInHours](#API_CreateStream_RequestSyntax) ** Die Anzahl der Stunden, für die Sie die Daten im Stream behalten möchten. Kinesis Video Streams speichert die Daten in einem Datenspeicher, der dem Datenstrom zugeordnet ist. Der Standardwert ist 0. Er gibt an, dass der Stream keine Daten beibehält. Das Minimum ist 1 Stunde. Wenn der `DataRetentionInHours` Wert 0 ist, können Verbraucher immer noch die Fragmente verwenden, die im Service-Host-Puffer verbleiben. Dieser Puffer hat eine Aufbewahrungszeit von 5 Minuten und eine Speicherbegrenzung von 200 MB. Fragmente werden aus dem Puffer entfernt, wenn einer der Grenzwerte erreicht ist. Typ: Ganzzahl Gültiger Bereich: Mindestwert 0. Erforderlich: Nein ** [DeviceName](#API_CreateStream_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 ** [KmsKeyId](#API_CreateStream_RequestSyntax) ** Die ID des Schlüssels AWS Key Management Service (AWS KMS), den Kinesis Video Streams zum Verschlüsseln von Stream-Daten verwenden soll. Wenn keine Schlüssel-ID angegeben ist, wird standardmäßig der von Kinesis Video verwaltete Schlüssel (`aws/kinesisvideo`) verwendet. Weitere Informationen finden Sie unter [DescribeKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters). Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen. Pattern: `.+` Erforderlich: Nein ** [MediaType](#API_CreateStream_RequestSyntax) ** Der Medientyp des Streams. Nutzer des Streams können diese Informationen bei der Verarbeitung des Streams verwenden. Weitere Informationen zu Medientypen finden Sie unter [Medientypen](http://www.iana.org/assignments/media-types/media-types.xhtml). Wenn Sie sich für die Angabe von entscheiden`MediaType`, finden Sie Richtlinien unter [Benennungsvoraussetzungen](https://tools.ietf.org/html/rfc6838#section-4.2). Zu den gültigen Werten gehören beispielsweise "video/h264" and "video/h264,audio/aac“. Dieser Parameter ist optional; der Standardwert ist `null` (oder leer in JSON). 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 ** [StreamName](#API_CreateStream_RequestSyntax) ** Ein Name für den Stream, den Sie erstellen. 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: Ja ** [StreamStorageConfiguration](#API_CreateStream_RequestSyntax) ** Die Konfiguration für den Speicher des Streams, einschließlich der Standardspeicherebene für Stream-Daten. Diese Konfiguration bestimmt, wie Stream-Daten gespeichert und abgerufen werden, wobei verschiedene Stufen unterschiedliche Leistungs- und Kostenoptimierungsstufen bieten. Wenn nicht angegeben, verwendet der Stream die Standardspeicherkonfiguration mit HOT-Stufe, um eine optimale Leistung zu erzielen. Typ: [StreamStorageConfiguration](API_StreamStorageConfiguration.md) Objekt Erforderlich: Nein ** [Tags](#API_CreateStream_RequestSyntax) ** Eine Liste von Tags, die dem angegebenen Stream zugeordnet werden sollen. Jedes Tag ist ein Schlüssel-Wert-Paar (der Wert ist optional). Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge Karteneinträge: Maximale Anzahl von 50 Elementen. Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen. Schlüssel-Muster: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen. Wertemuster: `[\p{L}\p{Z}\p{N}_.:/=+\-@]*` Erforderlich: Nein ## Antwortsyntax ``` HTTP/1.1 200 Content-type: application/json { "StreamARN": "string" } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [StreamARN](#API_CreateStream_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des -Stream. 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]+` ## Fehler Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md). ** AccountStreamLimitExceededException ** Die Anzahl der für das Konto erstellten Streams ist zu hoch. HTTP-Statuscode: 400 ** 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 ** DeviceStreamLimitExceededException ** Nicht implementiert. HTTP-Statuscode: 400 ** InvalidArgumentException ** Der Wert für diesen Eingabeparameter ist ungültig. HTTP-Statuscode: 400 ** InvalidDeviceException ** Nicht implementiert. HTTP-Statuscode: 400 ** 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 zur Bestimmung des Status der Ressource. HTTP-Statuscode: 400 ** TagsPerResourceExceededLimitException ** Sie haben das Limit an Tags überschritten, die Sie der Ressource zuordnen können. Ein Kinesis-Videostream kann bis zu 50 Tags unterstützen. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateStream)