Taggare i flussi Firehose in Amazon Data Firehose

Puoi assegnare i tuoi metadati ai flussi Firehose che crei in Amazon Data Firehose 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 AWS le risorse e organizzare i dati, compresi i dati di fatturazione.

Nozioni di base sui tag

Puoi utilizzare l'API Amazon Data Firehose per completare le seguenti attività:

• Aggiungere tag a uno stream Firehose.

• Elenca i tag per i tuoi stream Firehose.

• Rimuove i tag da uno stream Firehose.

Puoi usare i tag per classificare i tuoi stream Firehose. Ad esempio, è possibile classificare i flussi Firehose per 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, è possibile definire un set di tag che consenta di tracciare i flussi Firehose per proprietario e applicazione associata.

Di seguito sono illustrati alcuni esempi di tag:

• Project: Project name

• Owner: Name

• Purpose: Load testing

• Application: Application name

• Environment: Production

Se specifichi tag nell'CreateDeliveryStreamazione, Amazon Data Firehose esegue un'autorizzazione aggiuntiva sull'firehose:TagDeliveryStreamazione per verificare se gli utenti dispongono delle autorizzazioni per creare tag. Se non si fornisce questa autorizzazione, le richieste di creazione di nuovi flussi Firehose con tag di risorse IAM falliranno con uno degli AccessDeniedException esempi seguenti.

AccessDeniedException 
User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.

L'esempio seguente illustra una politica che consente agli utenti di creare uno stream Firehose e applicare i tag.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:CreateDeliveryStream",
            "Resource": "*",
            }
        },
        {
            "Effect": "Allow",
            "Action": "firehose:TagDeliveryStream",
            "Resource": "*",
            }
        }
    ]
}

Monitoraggio dei costi mediante il tagging

È possibile utilizzare i tag per classificare e tenere traccia dei costi. AWS Quando applichi tag alle tue AWS risorse, inclusi i flussi Firehose, il report sull'allocazione AWS dei costi include l'utilizzo e i costi aggregati per tag. Puoi organizzare i costi tra più servizi applicando tag che rappresentano categorie di business (come centri di costo, nomi di applicazioni o proprietari). 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

Le seguenti restrizioni si applicano ai tag in Amazon Data Firehose.

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: _ . / = + - @.

Etichettatura dei flussi Firehose con l'API Amazon Data Firehose

È possibile specificare i tag quando si richiama CreateDeliveryStreamper creare un nuovo stream Firehose. Per gli stream Firehose esistenti, è possibile aggiungere, elencare e rimuovere tag utilizzando le tre operazioni seguenti:

• TagDeliveryStream

• ListTagsForDeliveryStream

• UntagDeliveryStream