ListStreams - Amazon Kinesis Video Streams
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ListStreams

Renvoie un tableau d'StreamInfoobjets. Chaque objet décrit un flux. Pour récupérer uniquement les flux qui répondent à une condition spécifique, vous pouvez spécifier unStreamNameCondition.

Syntaxe de la demande

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

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

Paramètres de demande URI

La demande n’utilise pas de paramètres URI.

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

MaxResults

Le nombre maximum de flux à renvoyer dans la réponse. La valeur par défaut est 10 000.

Type : entier

Plage valide : Valeur minimum de 1. Valeur maximum de 10 000.

Obligatoire : non

NextToken

Si vous spécifiez ce paramètre, lorsque le résultat d'une ListStreams opération est tronqué, l'appel renvoie le NextToken dans la réponse. Pour obtenir un autre lot de streams, fournissez ce jeton dans votre prochaine demande.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximale de 512.

Modèle : [a-zA-Z0-9+/=]*

Obligatoire : non

StreamNameCondition

Facultatif : renvoie uniquement les flux qui répondent à une condition spécifique. Actuellement, vous ne pouvez spécifier que le préfixe du nom d'un flux comme condition.

Type : objet StreamNameCondition

Obligatoire : non

Syntaxe de la réponse

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

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

NextToken

Si la réponse est tronquée, l'appel renvoie cet élément avec un jeton. Pour obtenir le prochain lot de streams, utilisez ce jeton dans votre prochaine demande.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximale de 512.

Modèle : [a-zA-Z0-9+/=]*

StreamInfoList

Tableau d’objets StreamInfo.

Type : tableau d’objets StreamInfo

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

ClientLimitExceededException

Kinesis Video Streams a limité le nombre de demandes car vous avez dépassé le nombre maximal d'appels clients autorisés. Essayez de passer l'appel plus tard.

Code d’état HTTP : 400

InvalidArgumentException

La valeur de ce paramètre d'entrée n'est pas valide.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :