Tagging dei flussi in Flusso di dati Amazon Kinesis

Puoi assegnare i tuoi metadati ai flussi Flusso di dati Amazon Kinesis sotto forma di tag. Un tag è un valore-chiave che definisci per un flusso. I tag sono un metodo semplice ma efficace di gestire le risorse AWS e di organizzare i dati, inclusi quelli di fatturazione.

Nozioni di base sui tag

Utilizzi la console di Flusso di dati Kinesis, la AWS CLI o l'API di Flusso di dati Kinesis per completare le seguenti attività:

• Aggiungere tag a un flusso.

• Elencare i tag per i tuoi flussi

• Rimuovere tag da un flusso

Puoi utilizzare i tag per categorizzare i flussi, Ad esempio, è possibile categorizzare i flussi 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. Puoi definire un set di tag che consente di monitorare i flussi 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

Monitoraggio dei costi mediante il tagging

Puoi utilizzare i tag per categorizzare e monitorare i costi AWS. Quando applichi tag alle risorse AWS, compresi i flussi, il report di allocazione dei costi di AWS include l'utilizzo e i costi aggregati in base ai tag. Puoi applicare i tag che rappresentano categorie di business (come centri di costo, nomi di applicazioni o proprietari) per organizzare i costi tra più servizi. Per ulteriori informazioni, consulta Utilizzo dei tag per l'allocazione dei costi ai fini dei report di fatturazione personalizzati nella AWS Billing User Guide (Guida per l'utente di Amazon API Gateway).

Limitazioni applicate ai tag

Ai tag si applicano le limitazioni seguenti.

Limitazioni di base

• Il numero massimo di tag per risorsa (flusso) è 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 un flusso eliminato.

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.

• Una chiave di tag non può iniziare con aws: perché questo prefisso è riservato per l'utilizzo da parte di AWS. AWS crea tag 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: _ . / = + - @.

Tagging dei flussi tramite la console di Flusso di dati Kinesis

Puoi aggiungere, elencare e rimuovere tag tramite la console di Flusso di dati Kinesis.

Visualizzazione di tag per un flusso

1. Apri la console di Flusso di dati Kinesis. Nella barra di navigazione, espandere il selettore delle regioni e selezionare una regione.

2. Nella pagina Stream List (Elenco del flusso) selezionare un flusso.

3. Nella pagina Stream Details (Dettagli del flusso) fare clic sulla scheda Tags (Tag).

Aggiunta di un tag a un flusso

1. Apri la console di Flusso di dati Kinesis. Nella barra di navigazione, espandere il selettore delle regioni e selezionare una regione.

2. Nella pagina Stream List (Elenco del flusso) selezionare un flusso.

3. Nella pagina Stream Details (Dettagli del flusso) fare clic sulla scheda Tags (Tag).

4. Specificare la chiave di tag nel campo Key (Chiave), specificare eventualmente un valore di tag nel campo Value (Valore), quindi scegliere Add Tag (Aggiungi tag).

   Se il pulsante Add Tag (Aggiungi tag) non è selezionabile, significa che la chiave di tag o il valore di tag specificati non soddisfano le limitazioni relative. Per ulteriori informazioni, consulta Limitazioni applicate ai tag.

5. Per visualizzare il nuovo tag nell'elenco della scheda Tag (Tag), fare clic sull'icona di aggiornamento.

Rimozione di un tag da un flusso

1. Apri la console di Flusso di dati Kinesis. Nella barra di navigazione, espandere il selettore delle regioni e selezionare una regione.

2. Nella pagina Stream List (Elenco del flusso) selezionare un flusso.

3. Nella pagina dei dettagli di flusso fare clic sulla scheda Tags (Tag), quindi fare clic sull'icona Rimuovi per il tag.

4. Nella finestra di dialogo Elimina tag fare clic su Yes, Delete (Sì, elimina).

Tagging di flussi mediante AWS CLI

Puoi aggiungere, elencare e rimuovere tag tramite AWS CLI. Per alcuni esempi, consultare la seguente documentazione.

add-tags-to-stream

Aggiunge o aggiorna i tag per il flusso specificato.

list-tags-for-stream

Elenca i tag per il flusso specificato.

remove-tags-from-stream

Rimuove i tag dal flusso specificato.

Tagging dei flussi tramite l'API di Flusso di dati Kinesis

Puoi aggiungere, elencare e rimuovere tag tramite l'API di Flusso di dati Kinesis. Per alcuni esempi, consultare la seguente documentazione:

AddTagsToStream

Aggiunge o aggiorna i tag per il flusso specificato.

ListTagsForStream

Elenca i tag per il flusso specificato.

RemoveTagsFromStream

Rimuove i tag dal flusso specificato.