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.
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"
}
}URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
Anforderungstext
Die Anforderung 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
DataRetentionInHoursWert 0 ist, können Verbraucher immer noch die Fragmente verwenden, die im Service-Host-Puffer verbleiben. Dieser Puffer hat ein Aufbewahrungszeitlimit von 5 Minuten und ein Aufbewahrungsspeicherlimit 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 entscheiden MediaType, 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 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
-
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
- 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 Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- StreamARN
-
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 Fehler.
- AccountStreamLimitExceededException
-
Die Anzahl der für das Konto erstellten Streams ist zu hoch.
HTTP Status Code: 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 Status Code: 400
- DeviceStreamLimitExceededException
-
Nicht implementiert.
HTTP Status Code: 400
- InvalidArgumentException
-
Der Wert für diesen Eingabeparameter ist ungültig.
HTTP Status Code: 400
- InvalidDeviceException
-
Nicht implementiert.
HTTP Status Code: 400
- ResourceInUseException
-
Wenn der Eingang
StreamARNoderChannelARNEingang bereits einer anderen Kinesis Video Stream-Ressource zugeordnetCLOUD_STORAGE_MODEist oder wenn sich der angegebene EingangStreamARNoder Eingang nicht im Status AktivChannelARNbefindet, versuchen Sie es mit einer der folgenden Methoden:-
Die
DescribeMediaStorageConfigurationAPI, um zu ermitteln, welchem Stream der angegebene Kanal zugeordnet ist. -
Die
DescribeMappedResourceConfigurationAPI zur Bestimmung des Kanals, dem der angegebene Stream zugeordnet ist. -
Die
DescribeStreamoderDescribeSignalingChannelAPI, um den Status der Ressource zu bestimmen.
HTTP Status Code: 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 Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
