Listar unidades de negócio com o gasto
As unidades de negócio da organização, com as pessoas, a parte de cada uma (inteiros de 1 a 100 que somam 100 por pessoa) e o gasto no período, em USD. O gasto de uma pessoa entra em cada unidade na proporção da parte dela, então a soma das unidades fecha com o total. A linha com `id` nulo é "Sem unidade": membros sem unidade e quem gastou e não é mais membro. Quando a pessoa dona da chave não vê o consumo de terceiros, `external_allowed` vem falso e `external_cost` vem zerado. Exige o escopo governance:read.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Query Parameters
Janela do gasto: 24h, 7d, 30d (padrão), 90d, um mês (AAAA-MM) ou um intervalo de dias (AAAA-MM-DD..AAAA-MM-DD, até 366 dias). Bordas no fuso America/Sao_Paulo.
"30d"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/governance/units"{ "period": "string", "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "external_allowed": true, "can_manage": true, "units": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "internal_cost": 0, "external_cost": 0, "total_cost": 0, "members": [ { "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "name": "string", "share": 0, "cost": 0 } ] } ]}Listar projetos de um sistema de IA de terceiro
Os projetos do ativo. unlinked=true devolve só os que não foram vinculados a um time — o consumo que a organização paga e não consegue ratear, que é o achado de governança desta dimensão. O vínculo projeto→time é sempre MANUAL: não há casamento automático por nome, então a ausência do vínculo é o estado inteiro. A chave do projeto PRESERVA A CAIXA — é o identificador opaco do provedor, e é por ele que alguém abre o projeto lá. O cursor de keyset a devolve como saiu. A resposta traz truncated: sem ele, uma lista que bateu no teto seria indistinguível de uma lista completa. Além do escopo, exige da identidade da chave a permissão third_party_usage_view. Exige o escopo governance:read.
Criar unidade de negócio
Cria uma unidade. Quem já está em N unidades entra com 1/(N+1) e as outras partes dessa pessoa encolhem na proporção. A operação vai para a trilha de auditoria da Governança. Exige o escopo governance:write.