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: