DescribeStream - Amazon Kinesis Video Streams

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

DescribeStream

Restituisce le informazioni più recenti sul flusso specificato. È necessario specificare ilStreamNameo ilStreamARN.

Sintassi della richiesta

POST /describeStream HTTP/1.1 Content-type: application/json { "StreamARN": "string", "StreamName": "string" }

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

StreamARN

L'Amazon Resource Name (ARN) del flusso.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.

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

campo obbligatorio: No

StreamName

Il nome del flusso .

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z0-9_.-]+

campo obbligatorio: No

Sintassi della risposta

HTTP/1.1 200 Content-type: application/json { "StreamInfo": { "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.

StreamInfo

Un oggetto che descrive lo stream.

Tipo: StreamInfo oggetto

Errori

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

ClientLimitExceededException

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

Codice di stato HTTP: 400

InvalidArgumentException

Il valore per questo parametro di input non è valido.

Codice di stato HTTP: 400

NotAuthorizedException

L'intermediario non è autorizzato a eseguire questa operazione.

Codice di stato HTTP: 401

ResourceNotFoundException

Amazon Kinesis Video Streams non riesce a trovare lo stream specificato.

Codice di stato HTTP: 404

Vedi anche

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