ListTagsForStream - Flusso di video Amazon Kinesis

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

ListTagsForStream

Restituisce un elenco di tag associati allo stream specificato.

Nella richiesta, è necessario specificare il StreamName o ilStreamARN.

Sintassi della richiesta

POST /listTagsForStream HTTP/1.1 Content-type: application/json { "NextToken": "string", "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.

NextToken

Se si specifica questo parametro e il risultato di una ListTagsForStream chiamata viene troncato, la risposta include un token che è possibile utilizzare nella richiesta successiva per recuperare il successivo batch di tag.

Tipo: String

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

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

Campo obbligatorio: no

StreamARN

L'Amazon Resource Name (ARN) dello stream per cui desideri elencare i tag.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 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 dello stream per cui desideri elencare i tag.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 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 { "NextToken": "string", "Tags": { "string" : "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 specificate questo parametro e il risultato di una ListTags chiamata viene troncato, la risposta include un token che potete utilizzare nella richiesta successiva per recuperare il successivo set di tag.

Tipo: String

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

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

Tags

Una mappa delle chiavi e dei valori dei tag associati allo stream specificato.

Tipo: mappatura stringa a stringa

Voci sulla mappa: numero massimo di 50 elementi.

Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.

Modello di chiave:^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

Modello di valore: [\p{L}\p{Z}\p{N}_.:/=+\-@]*

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

InvalidResourceFormatException

Il formato di StreamARN non è valido.

Codice di stato HTTP: 400

NotAuthorizedException

Il chiamante 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: