# Dicionário de Campos GCP

#### Lista de Campos Nativos

<table><thead><tr><th width="122">Prefixo</th><th width="183">Campo Billing GCP</th><th width="419">Descrição</th></tr></thead><tbody><tr><td></td><td>billingAccountId</td><td>Identificador da conta de faturamento associada a um projeto.</td></tr><tr><td></td><td>child</td><td>Identificador do recurso filho, estabelecendo relações hierárquicas entre recursos.</td></tr><tr><td>cost</td><td>cost</td><td>Custo total do recurso.</td></tr><tr><td>cost</td><td>cost_at_list<br></td><td>Custo registrado no momento de uma consulta ou lista de faturamento.</td></tr><tr><td>cost</td><td>cost_usd</td><td>O custo total do serviço ou recurso em dólares americanos (USD).</td></tr><tr><td>create</td><td>create_time</td><td>Hora e data em que o recurso foi criado.</td></tr><tr><td>creator</td><td>creator</td><td>Registra o usuário ou a conta de serviço que criou um recurso</td></tr><tr><td>currency</td><td>currency</td><td>Moeda utilizada para o cálculo dos custos.</td></tr><tr><td>currency</td><td>currency_conversion_rate</td><td>Taxa de conversão de moeda utilizada para converter os valores de uma moeda para a moeda da conta de faturamento.</td></tr><tr><td></td><td>database_type</td><td>Tipo de banco de dados que é utilizado ou configurado em um recurso específico</td></tr><tr><td></td><td>delete_time</td><td>Hora e data em que o recurso foi deletado.</td></tr><tr><td></td><td>folder_id</td><td>Identificador único do pasta no Google Cloud</td></tr><tr><td>group</td><td>group</td><td>Grupo ao qual o recurso está associado.</td></tr><tr><td></td><td>iam_policy</td><td>Política de gerenciamento de identidade e acesso (IAM) associada a um recurso,</td></tr><tr><td>labels</td><td>labels/marketplace-vendor</td><td>Etiqueta associada ao fornecedor de serviços de marketplace, se o serviço foi adquirido através de um fornecedor de marketplace.</td></tr><tr><td>labels</td><td>labels/vendor</td><td>Etiqueta associada ao fornecedor de um serviço ou produto, podendo ser usado para identificar provedores específicos.</td></tr><tr><td>labels</td><td>label.chave</td><td>Valor associado a uma label específica (as labels são pares chave-valor que você pode atribuir aos seus recursos para organizá-los e filtrá-los).</td></tr><tr><td>location</td><td>location/location</td><td>Localização geográfica onde o recurso ou serviço está sendo executado</td></tr><tr><td>location</td><td>location/region</td><td>A região da GCP onde o serviço ou recurso foi utilizado.</td></tr><tr><td>location</td><td>location/zone</td><td>A zona dentro da região onde o serviço foi utilizado, como uma zona específica de um datacenter.</td></tr><tr><td></td><td>machine_type</td><td>Refere-se ao tipo de máquina ou configuração de instância</td></tr><tr><td>metadata</td><td>metadata</td><td>Metadados personalizados associados ao recurso, podendo armazenar informações específicas para o seu uso.</td></tr><tr><td></td><td>modifier</td><td>Indica o usuário ou a conta de serviço que modificou um recurso após sua criação</td></tr><tr><td></td><td>net_cost<br></td><td>Custo líquido de um recurso ou serviço, considerando ajustes financeiros como descontos.</td></tr><tr><td>network</td><td>network</td><td>Rede à qual o recurso está conectado.</td></tr><tr><td>network</td><td>network_tier</td><td>Categoria de rede utilizada para o tráfego de dados</td></tr><tr><td>organization</td><td>organization_id</td><td>Identificador único da organização de folders e projetos no Google Cloud</td></tr><tr><td>parent</td><td>parent</td><td>Identificador do recurso pai, estabelecendo relações hierárquicas entre recursos.</td></tr><tr><td>price</td><td>price/unit</td><td>A unidade de preço aplicada ao serviço.</td></tr><tr><td>price</td><td>price/pricing_unit_quantity<br></td><td>A quantidade da unidade de preços que foi aplicada, como 1 hora ou 1 GB.</td></tr><tr><td>project</td><td>project_id</td><td>Identificador único do projeto.</td></tr><tr><td>project</td><td>project/number</td><td>O número do projeto.</td></tr><tr><td>project</td><td>project/name</td><td>O nome do projeto na GCP</td></tr><tr><td>quota</td><td>quota</td><td>A quota define a quantidade de recursos que um projeto ou conta pode consumir em um determinado período</td></tr><tr><td></td><td>region</td><td>Refere-se à região geográfica onde um recurso está localizado ou será provisionado.</td></tr><tr><td>resource</td><td>resource_id</td><td>Identificador único do recurso.</td></tr><tr><td>resource</td><td>resource/global_name</td><td>Nome único de um recurso global na GCP.</td></tr><tr><td>resource</td><td>resource_type</td><td>Tipo de recurso (instância, disco, bucket, etc.).</td></tr><tr><td>service</td><td>service/id</td><td>Identificador único do serviço utilizado</td></tr><tr><td>service</td><td>service_account</td><td>Conta de serviço utilizada para acessar o recurso.</td></tr><tr><td>service</td><td>service/description</td><td>Descrição textual do recurso</td></tr><tr><td>sku</td><td>sku</td><td>Código do produto ou serviço.</td></tr><tr><td>sku</td><td>sku/id</td><td>O identificador único do SKU que está sendo cobrado.</td></tr><tr><td>sku</td><td>sku/description</td><td>Descrição do SKU, identificando o serviço específico ou produto que está sendo cobrado.</td></tr><tr><td></td><td>state</td><td>Refere-se ao estado atual ou à fase em que o recurso se encontra no processo de provisionamento ou operação.</td></tr><tr><td></td><td>status</td><td>Estado atual ou status do recurso.</td></tr><tr><td></td><td>storage_class</td><td>Classe de armazenamento associada a um recurso de armazenamento,</td></tr><tr><td></td><td>subnet</td><td>Sub-rede à qual o recurso está conectado.</td></tr><tr><td></td><td>unit_price</td><td>Preço unitário do recurso.</td></tr><tr><td></td><td>update_time</td><td>Hora e data da última atualização do recurso.</td></tr><tr><td>usage</td><td>usage/unit</td><td>A unidade de medida do uso </td></tr><tr><td>usage</td><td>usage_amount</td><td>Quantidade de uso do recurso.</td></tr><tr><td>usage</td><td>usage_end_time</td><td>Data e hora de término do uso.</td></tr><tr><td>usage</td><td>usage_start_time</td><td>Data e hora de início do uso.</td></tr><tr><td>user</td><td>user</td><td>Usuário que criou ou modificou o recurso.</td></tr><tr><td>user</td><td>user_email</td><td>Endereço de e-mail de um usuário que tem acesso a recursos, projetos ou serviços</td></tr></tbody></table>

#### Lista de Campos Personalizados

<table><thead><tr><th width="257">Nome</th><th width="477">Descrição </th></tr></thead><tbody><tr><td>credits/type</td><td>Tipo de crédito utilizado</td></tr><tr><td>credits/amount</td><td>Valor do crédito utilizado</td></tr></tbody></table>

#### Campos Globais GCP

| Prefixo | Campo Pier                           | Descrição Técnica                                                                                                                                                                                                                              |
| ------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pier    | pier/gcp/big-query/categories        | <p>Definição: Classificação de custos por operação no BigQuery<br>Governança:<br>- storage: Cobrança por GB/mês<br>- query: Cobrança por TB processado<br>- streaming: Taxa por GB inserido<br>Uso típico: Rateio entre times de analytics</p> |
| pier    | pier/gcp/big-query/storagetype       | <p>Definição: Tier de armazenamento de dados<br>Governança:<br>- ACTIVE: Dados acessados ≥1x/mês<br>- LONG\_TERM: Dados acessados <1x/ano<br>Uso típico: Otimização de políticas de retenção</p>                                               |
| pier    | pier/gcp/cloud-run/categories        | <p>Definição: Segmentação de custos por recurso consumido<br>Governança:<br>- execution: CPU-seconds<br>- networking: Egress traffic<br>Uso típico: Chargeback por microsserviço</p>                                                           |
| pier    | pier/gcp/cloud-run/cobertura         | <p>Definição: Modelo de precificação aplicado<br>Governança:<br>- ON\_DEMAND: Sem desconto<br>- COMMITTED: Desconto por uso mínimo<br>Uso típico: Comparação de custos serverless</p>                                                          |
| pier    | pier/gcp/cloud-sql/categories        | <p>Definição: Componentes de custo do Cloud SQL<br>Governança:<br>- instance: Custo base por vCPU<br>- storage: GB provisionado<br>Uso típico: Análise de dimensionamento</p>                                                                  |
| pier    | pier/gcp/cloud-sql/cobertura         | <p>Definição: Tipo de contrato aplicado<br>Governança:<br>- COMMITTED\_USE: Exige commitment\_id<br>- SUSTAINED\_USE: Desconto automático<br>Uso típico: Cálculo de ROI para reservas</p>                                                      |
| pier    | pier/gcp/cloud-sql/engine            | <p>Definição: Especificação técnica do SGBD<br>Governança:<br>- Formato: {ENGINE} {VERSION}<br>- Ex: PostgreSQL 14<br>Uso típico: Gestão de licenças</p>                                                                                       |
| pier    | pier/gcp/cloud-storage/categories    | <p>Definição: Tipo de operação no Cloud Storage<br>Governança:<br>- storage: Custo por GB<br>- operations: Taxa por 10k ops<br>Uso típico: Otimização de padrões de acesso</p>                                                                 |
| pier    | pier/gcp/cloud-storage/storage\_type | <p>Definição: Classe de armazenamento<br>Governança:<br>- STANDARD: SLA 99.9%<br>- ARCHIVE: Retrieval delay ≥1h<br>Uso típico: Arquivo de dados frios</p>                                                                                      |
| pier    | pier/gcp/cobertura                   | <p>Definição: Modelo de compra agregado<br>Governança:<br>- ON\_DEMAND: Pay-as-you-go<br>- RESERVATIONS: Compromisso pré-pago<br>Uso típico: Análise de portfólio</p>                                                                          |
| pier    | pier/gcp/computecategory             | <p>Definição: Família de instâncias<br>Governança:<br>- GENERAL\_PURPOSE: Série N<br>- MEMORY\_OPTIMIZED: Série M<br>Uso típico: Seleção de instâncias</p>                                                                                     |
| pier    | pier/gcp/compute-engine/categories   | <p>Definição: Componentes de custo de VMs<br>Governança:<br>- instance: Custo base<br>- disk: Armazenamento persistente<br>Uso típico: Breakdown de infraestrutura</p>                                                                         |
| pier    | pier/gcp/compute-engine/cobertura    | <p>Definição: Modelo de precificação<br>Governança:<br>- SPOT: Até 60% desconto<br>- CUD: Compromisso 1/3 anos<br>Uso típico: Comparação de TCO</p>                                                                                            |
| pier    | pier/gcp/custoporcobertura           | <p>Definição: Distribuição % por modelo<br>Governança:<br>- Soma deve ser 100%<br>- Inclui créditos<br>Uso típico: Relatório financeiro</p>                                                                                                    |
| pier    | pier/gcp/net\_cost                   | <p>Definição: Custo líquido final<br>Governança:<br>- Inclui descontos<br>- Exclui impostos<br>Uso típico: Fechamento mensal</p>                                                                                                               |