CreateStream - Amazon Kinesis Video Streams
AnforderungssyntaxURIParameter anfordernAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere 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.

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.

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",
   "Tags": { 
      "string" : "string" 
   }
}

URIParameter anfordern

Die Anfrage verwendet keine URI Parameter.

Anforderungstext

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

DataRetentionInHours

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

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

KmsKeyId

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

Typ: Zeichenfolge

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

Pattern: .+

Erforderlich: Nein

MediaType

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. Wenn Sie sich für die Angabe von entscheidenMediaType, finden Sie Richtlinien unter Benennungsvoraussetzungen.

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 inJSON).

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

Ein Name für den Stream, den Sie erstellen.

Der Streamname ist ein Bezeichner 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

Tags

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 Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

StreamARN

Der Amazon-Ressourcenname (ARN) des Streams.

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 Fehler.

AccountStreamLimitExceededException

Die Anzahl der für das Konto erstellten Streams ist zu hoch.

HTTPStatuscode: 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.

HTTPStatuscode: 400

DeviceStreamLimitExceededException

Nicht implementiert.

HTTPStatuscode: 400

InvalidArgumentException

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

HTTPStatuscode: 400

InvalidDeviceException

Nicht implementiert.

HTTPStatuscode: 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 DescribeMediaStorageConfigurationAPI, um zu ermitteln, welchem Stream der angegebene Kanal zugeordnet ist.

  2. Das DescribeMappedResourceConfigurationAPI, um den Kanal zu bestimmen, dem der angegebene Stream zugeordnet ist.

  3. Das DescribeStream oder DescribeSignalingChannelAPI, um den Status der Ressource zu bestimmen.

HTTPStatuscode: 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.

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: