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à.
TagStream
Aggiunge uno o più tag a uno stream. UNtagè una coppia chiave-valore (il valore è facoltativo) a cui è possibile definire e assegnareAWSrisorse AWS. Se si specifica un tag già esistente, il valore del tag viene sostituito con il valore specificato nella richiesta. Per ulteriori informazioni, consultaUtilizzo dei tag per l'allocazione dei costinella AWS Billing and Cost ManagementGuida per l'utente e Cost Management.
È necessario specificare oStreamName
o ilStreamARN
.
Questa operazione richiede l'autorizzazione per l'KinesisVideo:TagStream
Operazione .
Un flusso video Kinesis può supportare fino a 50 tag.
Sintassi della richiesta
POST /tagStream HTTP/1.1
Content-type: application/json
{
"StreamARN": "string
",
"StreamName": "string
",
"Tags": {
"string
" : "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) della risorsa a cui desideri aggiungere il tag o i tag.
Type: Stringa
Vincoli della 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 dello stream a cui aggiungere il tag o i tag.
Type: Stringa
Vincoli della lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+
: campo obbligatorio No
- Tags
-
Un elenco di tag da associare allo stream specificato. Ogni tag è una coppia chiave-valore (il valore è facoltativo).
Type: mappatura stringa a stringa
Voci mappa: Numero massimo di 50 item.
Vincoli della lunghezza della chiave: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello di chiave:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$
Vincoli della lunghezza valore: Lunghezza minima 0. La lunghezza massima è 256 caratteri.
Pattern valore:
[\p{L}\p{Z}\p{N}_.:/=+\-@]*
: campo obbligatorio Sì
Sintassi della risposta
HTTP/1.1 200
Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
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
- InvalidResourceFormatException
-
Il formato della
StreamARN
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
- TagsPerResourceExceededLimitException
-
Hai superato il limite di tag che è possibile associare alla risorsa. Un flusso video Kinesis può supportare fino a 50 tag.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: