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

ListStreams

Gibt ein Array von StreamInfo Objekten zurück. Jedes Objekt beschreibt einen Stream. Um nur Streams abzurufen, die eine bestimmte Bedingung erfüllen, können Sie a angebenStreamNameCondition.

Anforderungssyntax

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

{
   "MaxResults": number,
   "NextToken": "string",
   "StreamNameCondition": { 
      "ComparisonOperator": "string",
      "ComparisonValue": "string"
   }
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

MaxResults

Die maximale Anzahl von Streams, die in der Antwort zurückgegeben werden sollen. Der Standardwert ist 10 000.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 10000.

Erforderlich: Nein

NextToken

Wenn Sie diesen Parameter angeben und das Ergebnis einer ListStreams Operation gekürzt wird, gibt der Aufruf NextToken in der Antwort den zurück. Um einen weiteren Stapel von Streams zu erhalten, geben Sie dieses Token in Ihrer nächsten Anfrage an.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 512.

Pattern: [a-zA-Z0-9+/=]*

Erforderlich: Nein

StreamNameCondition

Optional: Gibt nur Streams zurück, die eine bestimmte Bedingung erfüllen. Derzeit können Sie nur das Präfix eines Streamnamens als Bedingung angeben.

Typ: StreamNameCondition Objekt

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "StreamInfoList": [ 
      { 
         "CreationTime": number,
         "DataRetentionInHours": number,
         "DeviceName": "string",
         "KmsKeyId": "string",
         "MediaType": "string",
         "Status": "string",
         "StreamARN": "string",
         "StreamName": "string",
         "Version": "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.

NextToken

Wenn die Antwort gekürzt ist, gibt der Aufruf dieses Element mit einem Token zurück. Verwenden Sie dieses Token in Ihrer nächsten Anfrage, um den nächsten Stapel von Streams abzurufen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 512.

Pattern: [a-zA-Z0-9+/=]*

StreamInfoList

Ein Array von StreamInfo-Objekten.

Typ: Array von StreamInfo-Objekten

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

Weitere Informationen finden Sie unter:

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