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à.
# Etichetta le tue risorse Amazon Kinesis Data Streams
*Puoi assegnare i tuoi metadati agli stream e ai fan-out consumer avanzati che crei in Amazon Kinesis Data Streams sotto forma di tag.* Un tag è un valore-chiave che definisci per un flusso. L'uso dei tag è un modo semplice ma efficace per gestire le AWS risorse e organizzare i dati, inclusi i dati di fatturazione.
**Topics**
+ [Rivedi le nozioni di base sui tag](#tagging-basics)
+ [Tieni traccia dei costi utilizzando i tag](#tagging-billing)
+ [Comprendi le restrizioni relative ai tag](#tagging-restrictions)
+ [Etichetta i flussi utilizzando la console Kinesis Data Streams](#tagging-console)
+ [Contrassegna i flussi utilizzando il AWS CLI](#tagging-cli)
+ [Etichetta i flussi utilizzando Kinesis Data Streams APIs](#tagging-api)
+ [Tagga i consumatori utilizzando il AWS CLI](#tagging-consumers-cli)
+ [Tagga i consumatori utilizzando Kinesis Data Streams APIs](#tagging-consumers-api)
## Rivedi le nozioni di base sui tag
Le risorse Kinesis Data Streams che puoi etichettare includono flussi di dati e consumatori fan-out avanzati. Utilizzi la AWS CLI console Kinesis Data Streams o l'API Kinesis Data Streams per completare le seguenti attività:
+ Crea una risorsa con tag
+ Aggiungere tag a una risorsa
+ Elenca i tag per le tue risorse
+ Rimuovi i tag da una risorsa
**Nota**
Non puoi applicare tag ai consumatori con fan-out avanzato utilizzando la console Kinesis Data Streams. Per applicare i tag ai consumatori, usa l' AWS CLI API Kinesis Data Streams.
Puoi utilizzare i tag per categorizzare le risorse . Ad esempio, puoi categorizzarle in base a scopo, proprietario o ambiente. Poiché definisci una chiave e un valore per ogni tag, puoi creare un set di categorie personalizzate per soddisfare esigenze specifiche. Ad esempio, potresti definire un set di tag che ti aiuti a tenere traccia delle risorse per proprietario e applicazione associata. Di seguito sono riportati vari esempi di tag:
+ Progetto: nome del progetto
+ Proprietario: nome
+ Scopo: test di carico
+ Applicazione: nome dell'applicazione
+ Ambiente: produzione
**Importante**
Per aggiungere tag durante la creazione di uno stream, devi includere le `kinesis:AddTagsToStream` autorizzazioni `kinesis:CreateStream` e le relative autorizzazioni. **Non puoi utilizzare l'**`kinesis:TagResource`autorizzazione per taggare gli stream durante la creazione.
Per aggiungere tag durante la registrazione dei consumatori, devi includere le `kinesis:RegisterStreamConsumer` autorizzazioni `kinesis:TagResource` e.
## Tieni traccia dei costi utilizzando i tag
Puoi utilizzare i tag per classificare e tenere traccia AWS dei costi. Quando applichi i tag alle tue risorse Kinesis Data Streams AWS , il report sull'allocazione dei costi include l'utilizzo e i costi aggregati per tag. Puoi applicare tag che rappresentano categorie aziendali, come centri di costo, nomi delle applicazioni o proprietari, per organizzare i costi su più servizi. Per ulteriori informazioni, consulta [Utilizzo dei tag per l'allocazione dei costi ai fini dei report di fatturazione personalizzati](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *AWS Billing User Guide (Guida per l'utente di Amazon API Gateway)*.
## Comprendi le restrizioni relative ai tag
Ai tag si applicano le limitazioni seguenti:
**Limitazioni di base**
+ Il numero massimo di tag per ogni risorsa è 50.
+ Per le chiavi e i valori dei tag viene fatta la distinzione tra maiuscole e minuscole.
+ Non è possibile cambiare o modificare i tag di una risorsa eliminata.
**Limitazioni applicate alle chiavi di tag**
+ Ogni chiave di tag deve essere univoca. Se aggiungi un tag con una chiave già in uso, il nuovo tag sovrascrive la coppia chiave-valore esistente.
+ Non puoi iniziare una chiave di tag con `aws:` perché questo prefisso è riservato all'uso di AWS. AWS crea tag che iniziano con questo prefisso per tuo conto, ma non puoi modificarli o eliminarli.
+ Le chiavi di tag devono avere una lunghezza compresa tra 1 e 128 caratteri Unicode.
+ Le chiavi di tag devono contenere i seguenti caratteri: lettere Unicode, cifre, spazio e i seguenti caratteri speciali: `_ . / = + - @`.
**Limitazioni applicate ai valori dei tag**
+ I valori dei tag devono avere una lunghezza compresa tra 0 e 255 caratteri Unicode.
+ I valori dei tag possono essere vuoti. In caso contrario, devono contenere i seguenti caratteri: lettere Unicode, cifre, spazio e i seguenti caratteri speciali: `_ . / = + - @`.
## Etichetta i flussi utilizzando la console Kinesis Data Streams
Puoi aggiungere, aggiornare, elencare e rimuovere tag dai tuoi stream utilizzando la console Kinesis Data Streams.
**Visualizzazione di tag per un flusso**
1. [Accedi Console di gestione AWS e apri la console Kinesis all'indirizzo https://console.aws.amazon.com /kinesis.](https://console.aws.amazon.com/kinesis)
1. **Nel riquadro di navigazione a sinistra, scegli Flussi di dati.**
1. Nella pagina **Flussi di dati**, scegli lo stream a cui vuoi taggare.
1. Nella pagina dei dettagli dello stream, scegli **Configurazione**.
1. Nella sezione **Tag**, visualizza i tag applicati allo stream.
**Per creare un flusso di dati con un tag**
1. Apri la console del flusso di dati Kinesis.
1. Nel riquadro di navigazione a sinistra, scegli **Flussi di dati**.
1. Selezionare **Create data stream (Crea flusso di dati)**.
1. Nella pagina **Crea flusso di dati**, inserisci un nome per il tuo flusso di dati.
1. Per la **capacità del flusso di dati**, scegli la modalità di capacità **On-demand** o **Provisioned**.
Per ulteriori informazioni sulle modalità di capacità, vedere. [Scegli la modalità giusta per lo streaming](how-do-i-size-a-stream.md)
1. Nella sezione **Tag**, effettuate le seguenti operazioni:
1. Scegli **Aggiungi nuovo tag**.
1. Per **Chiave**, inserite il tag e, facoltativamente, specificate un **valore nel campo Valore**.
Se visualizzi un errore, significa che la chiave o il valore del tag che hai specificato non soddisfano le restrizioni relative ai tag. Per ulteriori informazioni, consulta [Comprendi le restrizioni relative ai tag](#tagging-restrictions).
1. Selezionare **Create data stream (Crea flusso di dati)**.
**Per aggiungere o aggiornare un tag in uno stream**
1. Apri la console del flusso di dati Kinesis.
1. Nel riquadro di navigazione a sinistra, scegli **Flussi di dati**.
1. Nella pagina **Flussi di dati**, scegli lo stream a cui desideri aggiungere o aggiornare i tag.
1. Nella pagina dei dettagli dello stream, scegli **Configurazione**.
1. Nella sezione **Tag** scegli **Gestisci tag**.
1. In **Tag**, esegui una delle seguenti operazioni:
+ Per aggiungere un nuovo tag, scegli **Aggiungi nuovo tag**, quindi inserisci i dati **Chiave** e **Valore** del tag. Ripetere questa operazione tutte le volte necessarie.
Il numero massimo di tag che puoi aggiungere per ogni stream è 50.
+ Per aggiornare un tag esistente, inserisci un nuovo valore di tag nel campo **Valore** della **chiave** di quel tag.
Se visualizzi un errore, la chiave o il valore del tag che hai specificato non soddisfa le restrizioni del tag. Per ulteriori informazioni, consulta [Comprendi le restrizioni relative ai tag](#tagging-restrictions).
1. Scegli **Salva modifiche**.
**Rimozione di un tag da un flusso**
1. Apri la console del flusso di dati Kinesis.
1. Nel riquadro di navigazione a sinistra, scegli **Flussi di dati**.
1. Nella pagina **Flussi di dati**, scegli il flusso da cui desideri rimuovere i tag.
1. Nella pagina dei dettagli dello stream, scegli **Configurazione**.
1. Nella sezione **Tag** scegli **Gestisci tag**.
1. Trova la coppia di tag **Chiave** e **Valore** che desideri rimuovere. Quindi scegli **Rimuovi**.
1. Scegli **Save changes** (Salva modifiche).
## Contrassegna i flussi utilizzando il AWS CLI
Puoi aggiungere, elencare e rimuovere tag dai tuoi stream utilizzando. AWS CLI Per alcuni esempi, consultare la seguente documentazione.
[crea-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)
Crea uno stream con tag.
[add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)
Aggiunge o aggiorna i tag per il flusso specificato.
[list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)
Elenca i tag per il flusso specificato.
[remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)
Rimuove i tag dal flusso specificato.
## Etichetta i flussi utilizzando Kinesis Data Streams APIs
Puoi aggiungere, elencare e rimuovere tag dai tuoi stream utilizzando Kinesis Data Streams. APIs Per alcuni esempi, consultare la seguente documentazione:
[CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)
Crea uno stream con tag.
[AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)
Aggiunge o aggiorna i tag per il flusso specificato.
[ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)
Elenca i tag per il flusso specificato.
[RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)
Rimuove i tag dal flusso specificato.
## Tagga i consumatori utilizzando il AWS CLI
Puoi aggiungere, elencare e rimuovere tag sui tuoi consumatori utilizzando il AWS CLI. Per alcuni esempi, consultare la seguente documentazione:
[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)
Registra un consumatore per un flusso di dati Kinesis con tag.
[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)
Aggiunge o aggiorna i tag per la risorsa Kinesis specificata.
[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)
Elenca i tag per la risorsa Kinesis specificata.
[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)
Rimuove i tag dalla risorsa Kinesis specificata.
## Tagga i consumatori utilizzando Kinesis Data Streams APIs
Puoi aggiungere, elencare e rimuovere tag sui tuoi consumatori utilizzando Kinesis APIs Data Streams. Per alcuni esempi, consultare la seguente documentazione:
[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)
Registra un consumatore per un flusso di dati Kinesis con tag.
[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)
Aggiunge o aggiorna i tag per la risorsa Kinesis specificata.
[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)
Elenca i tag per la risorsa Kinesis specificata.
[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)
Rimuove i tag dalla risorsa Kinesis specificata.