Marcando seus streams do Firehose no Amazon Data Firehose

Você pode atribuir seus próprios metadados aos streams do Firehose que você cria no Amazon Data Firehose na forma de tags. Tag é um par de chave-valor que você define para um stream. Usar tags é uma maneira simples, porém poderosa, de gerenciar AWS recursos e organizar dados, incluindo dados de faturamento.

Conceitos básicos de tags

Você pode usar a API Amazon Data Firehose para concluir as seguintes tarefas:

• Adicione tags a um stream do Firehose.

• Liste as tags dos seus streams do Firehose.

• Remova as tags de um stream do Firehose.

Você pode usar tags para categorizar seus streams do Firehose. Por exemplo, você pode categorizar os streams do Firehose por finalidade, proprietário ou ambiente. Como você define a chave e o valor para cada marca, você pode criar um conjunto de categorias personalizado para atender às suas necessidades específicas. Por exemplo, você pode definir um conjunto de tags que ajuda a rastrear streams do Firehose por proprietário e aplicativo associado.

Estes são diversos exemplos de tags:

• Project: Project name

• Owner: Name

• Purpose: Load testing

• Application: Application name

• Environment: Production

Se você especificar tags na CreateDeliveryStream ação, o Amazon Data Firehose executará uma autorização adicional na firehose:TagDeliveryStream ação para verificar se os usuários têm permissão para criar tags. Se você não fornecer essa permissão, as solicitações para criar novos streams do Firehose com tags de recursos do IAM falharão, conforme a seguirAccessDeniedException.

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.

O exemplo a seguir demonstra uma política que permite aos usuários criar um stream do Firehose e aplicar tags.

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

Monitoramento de custos com marcação

Você pode usar tags para categorizar e monitorar seus AWS custos. Quando você aplica tags aos seus AWS recursos, incluindo streams do Firehose, seu relatório de alocação de AWS custos inclui o uso e os custos agregados por tags. Você pode organizar seus custos de vários serviços aplicando tags que representam categorias de negócios (como centros de custos, nomes de aplicativos ou proprietários). Para obter mais informações, consulte Usar etiquetas de alocação de custos para relatórios de faturamento personalizados no Manual do usuário do AWS Billing .

Restrições de tag

As restrições a seguir se aplicam às tags no Amazon Data Firehose.

Restrições básicas

• O número máximo de tags por recurso (stream) é 50.

• As chaves e os valores de tags diferenciam maiúsculas de minúsculas.

• Você não pode alterar nem editar as tags de um stream excluído.

Restrições de chaves de marcas

• Cada chave de marca deve ser exclusiva. Se você adicionar uma marca com uma chave que já estiver em uso, sua nova marca existente substituirá o par de chave-valor.

• Não é possível iniciar uma chave de tag com aws:, pois esse prefixo é reservado para uso pela AWS. A AWS cria tags que começam com esse prefixo em seu nome, mas você não pode editá-las ou excluí-las.

• As chaves de marca devem ter entre 1 e 128 caracteres Unicode.

• As chaves de marca devem conter os seguintes caracteres: letras Unicode, dígitos, espaço em branco e os seguintes caracteres especiais: _ . / = + - @.

Restrições de valor de marcas

• Os valores de marca devem ter entre 0 e 255 caracteres Unicode.

• Os valores de marca podem estar em branco. Caso contrário, elas devem conter os seguintes caracteres: letras Unicode, dígitos, espaço em branco e qualquer um dos seguintes caracteres especiais: _ . / = + - @.

Marcação de streams do Firehose usando a API Amazon Data Firehose

Você pode especificar tags ao invocar CreateDeliveryStreampara criar um novo stream do Firehose. Para streams existentes do Firehose, você pode adicionar, listar e remover tags usando as três operações a seguir:

• TagDeliveryStream

• ListTagsForDeliveryStream

• UntagDeliveryStream