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

DeleteStream

Supprime un flux vidéo Kinesis et les données qu'il contient.

Cette méthode marque le flux à supprimer et rend les données du flux immédiatement inaccessibles.

Pour vous assurer que vous disposez de la dernière version du flux avant de le supprimer, vous pouvez spécifier la version du flux. Kinesis Video Streams attribue une version à chaque flux. Lorsque vous mettez à jour un flux, Kinesis Video Streams attribue un nouveau numéro de version. Pour obtenir la dernière version du stream, utilisez l'DescribeStreamAPI.

Cette opération nécessite une autorisation pour l’action KinesisVideo:DeleteStream.

Syntaxe de la demande

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

{
   "CurrentVersion": "string",
   "StreamARN": "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.

CurrentVersion

Facultatif : version du flux que vous souhaitez supprimer.

Spécifiez la version à titre de sauvegarde pour vous assurer que vous supprimez le flux correct. Pour obtenir la version du stream, utilisez l'DescribeStreamAPI.

Si ce n'est pas spécifié, seul le CreationTime est vérifié avant de supprimer le flux.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.

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

Obligatoire : non

StreamARN

Le nom de ressource Amazon (ARN) du flux que vous souhaitez supprimer.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.

Modèle : arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Obligatoire : oui

Syntaxe de la réponse

HTTP/1.1 200

Eléments de réponse

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

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

NotAuthorizedException

L'appelant n'est pas autorisé à effectuer cette opération.

Code d'état HTTP : 401

ResourceInUseException

Lorsque l'entrée StreamARN ou ChannelARN l'entrée CLOUD_STORAGE_MODE est déjà mappée à une autre ressource Kinesis Video Stream, ou si l'StreamARNentrée ChannelARN fournie n'est pas active, essayez l'une des solutions suivantes :

  1. L'DescribeMediaStorageConfigurationAPI permettant de déterminer à quoi le canal donné est mappé.

  2. L'DescribeMappedResourceConfigurationAPI permettant de déterminer le canal auquel le flux donné est mappé.

  3. L'DescribeSignalingChannelAPI DescribeStream or pour déterminer le statut de la ressource.

Code d’état HTTP : 400

ResourceNotFoundException

Amazon Kinesis Video Streams ne trouve pas le flux que vous avez spécifié.

Code d’état HTTP : 404

VersionMismatchException

La version de diffusion que vous avez spécifiée n'est pas la dernière version. Pour obtenir la dernière version, utilisez l'DescribeStreamAPI.

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 :