ListStreams - Amazon Kinesis Video Streams
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

ListStreams

Restituisce una serie di StreamInfo oggetti. Ogni oggetto descrive un flusso. Per recuperare solo i flussi che soddisfano una condizione specifica, puoi specificare a. StreamNameCondition

Sintassi della richiesta

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

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

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

MaxResults

Il numero massimo di stream da restituire nella risposta. Il valore predefinito è 10.000.

Tipo: integer

Intervallo valido: valore minimo di 1. Valore massimo pari a 10000.

Campo obbligatorio: no

NextToken

Se si specifica questo parametro, quando il risultato di un'ListStreamsoperazione viene troncato, la chiamata restituisce il NextToken valore nella risposta. Per ricevere un altro batch di stream, fornisci questo token nella tua prossima richiesta.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 512 caratteri.

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

Campo obbligatorio: no

StreamNameCondition

Facoltativo: restituisce solo gli stream che soddisfano una condizione specifica. Attualmente, puoi specificare solo il prefisso del nome di uno stream come condizione.

Tipo: oggetto StreamNameCondition

Campo obbligatorio: no

Sintassi della risposta

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"
      }
   ]
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

NextToken

Se la risposta viene troncata, la chiamata restituisce questo elemento con un token. Per ottenere il prossimo batch di stream, usa questo token nella tua prossima richiesta.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 512 caratteri.

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

StreamInfoList

Un array di oggetti StreamInfo.

Tipo: matrice di oggetti StreamInfo

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.

Codice di stato HTTP: 400

InvalidArgumentException

Il valore di questo parametro di input non è valido.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: