VMware Cloud on AWS: Apresentando as APIs de Relatório de Uso

Acompanhar o consumo de VMware Cloud on AWS em hosts, SPLA e encargos não relacionados a hosts hoje exige extrações manuais de dados e a espera pela fatura a cada trimestre. Clientes que estão desenvolvendo práticas de FinOps e operações financeiras de cloud maduras têm solicitado consistentemente acesso programático a esses dados, em um formato que suas ferramentas existentes possam consumir. Hoje, estamos atendendo a essa demanda com três novas APIs de Relatório de Uso para Uso de Host, Uso de Microsoft SPLA e Uso Diverso (encargos não relacionados a hosts) cobrindo encargos de rede como EIP, TGW, transferência de dados e Direct Connect.

Essas APIs de Relatório de Uso fornecem dados de uso com granularidade diária através de endpoints limpos e filtráveis que se integram diretamente aos seus fluxos de trabalho existentes de gerenciamento de custos, BI e relatórios. Seja para rastrear custos, analisar padrões de consumo ou construir painéis personalizados, essas APIs oferecem a flexibilidade para recuperar e organizar dados de uso nos seus termos. Todas as três APIs estão oficialmente disponíveis para todos os clientes de VMware Cloud on AWS.

O que está disponível

1. API de Relatório de Uso de Host GET /activityanalytic/{org_id}/hosts/{freq}/usage-report

Recupere dados diários de consumo de host para qualquer período, divididos por tipo de instância e grupo de região. Cada registro inclui o SKU, região, tipo de instância, contagem de assinaturas, contagem de uso real de host e excedente. Isso fornece os dados necessários para prever faturas, entender picos de uso, planejamento financeiro, chargeback e dimensionamento correto de assinaturas. A API retorna o uso máximo de host por dia, por tipo de instância, por grupo de região. Os valores são agregados em todos os SDDCs, permitindo comparar o consumo real com as assinaturas adquiridas. Os dados de uso de host estão disponíveis a partir de 01/02/2025. Para mais detalhes, consulte os detalhes da API no portal do desenvolvedor.

Exemplo de Resposta da API:

// Conteúdo de exemplo da resposta da API

// Conteúdo de exemplo da resposta da API

2. API de Relatório de Uso de SPLA GET /activityanalytic/{org_id}/spla/{freq}/usage-report

Acesse seus dados de uso de Microsoft SPLA programaticamente, divididos por tipo de instância, SKU, quantidade e ID do recurso (ID do SDDC). Esta API permite rastrear precisamente o consumo de licenças em seus SDDCs e validar os próximos encargos de SPLA. A API considera o uso máximo de SPLA para o dia por tipo de instância, tipo de licença SPLA e SDDC. Os dados de uso de SPLA estão disponíveis a partir de 01/01/2026.

Formato do SKU: VOD-<Tipo de Instância>-MSFT-<Tipo de Licença> Tipos de Instância: I3, I4I, I7I, I3EN Tipos de Licença:

• DC : Windows DC Server, Comercial
• DCA : Windows DC Server, Acadêmico
• SQL : MSFT Windows SQL Server Enterprise, Comercial
• SQLA : MSFT Windows SQL Server Enterprise, Acadêmico

Adicionaremos descrições de SKU em uma futura atualização para facilitar a referência. Para mais detalhes, consulte os detalhes da API no portal do desenvolvedor.

Exemplo de Resposta da API:

// Conteúdo de exemplo da resposta da API

// Conteúdo de exemplo da resposta da API

3. API de Relatório de Uso Diverso (Encargos de Rede Não Relacionados a Hosts) GET /activityanalytic/{org_id}/misc/{freq}/usage-report

Recupere dados de uso diário para encargos suplementares e adicionais. Isso oferece visibilidade total sobre os custos de rede e auxiliares que contribuem para o seu custo total de propriedade.

Tipos de encargos cobertos:

• Transferência de Dados de Saída (Por GB)
• Transferência de Dados entre Regiões (Por GB)
• Direct Connect (Por GB)
• Elastic IP (Por Endereço IP, Por Hora)
• Transit Connect (Por Hora, Por GB, Por Anexo)

As quantidades diárias são somadas para cada tipo de encargo. Dados históricos estão disponíveis a partir de 01/01/2026. Para mais detalhes, consulte os detalhes da API no portal do desenvolvedor.

Exemplo de Resposta da API:

// Conteúdo de exemplo da resposta da API

// Conteúdo de exemplo da resposta da API

Principais Recursos

Todas as três APIs compartilham um conjunto comum de recursos projetados para integração operacional.

• Intervalos de datas personalizados. Consulte qualquer data de início e fim para corresponder aos seus períodos de relatório, ciclos de faturamento ou necessidades de análise ad-hoc. O intervalo máximo por chamada de API é de 31 dias, mas você pode chamar a API várias vezes para recuperar dados por períodos mais longos.
• Filtragem granular. Filtre os resultados por região, tipo de instância, SKU e outros atributos chave para recuperar exatamente os dados de que você precisa.
• Operações de classificação e filtragem. Parâmetros de consulta padrão para organizar e estruturar as respostas da API para corresponder às suas ferramentas downstream.
• Granularidade diária. Registros em nível de dia em todos os três endpoints, fornecendo a resolução necessária para análise de tendências, detecção de anomalias e alocação precisa de custos.

Casos de Uso

• Previsão de faturas. Acompanhe o consumo diário em relação aos direitos de assinatura para identificar tendências de excedente precocemente e projetar totais de faturas futuras em todos os tipos de encargos.
• Painéis e relatórios de uso. Integre dados de uso de host, SPLA e diversos em sua plataforma de BI ou ferramentas de gerenciamento de custos para uma visão unificada dos gastos com VMC.
• Planejamento de capacidade. Analise as tendências de uso de host ao longo do tempo para informar decisões de renovação de assinatura e previsão de capacidade com dados de consumo reais.

Gerador de Relatórios de Uso HTML

Para equipes que precisam de um resumo visual sem construir integrações de API, também estamos lançando o Gerador de Relatórios de Uso HTML. Esta ferramenta de linha de comando produz um relatório HTML com a marca Broadcom, combinando dados de uso de host, SPLA e diversos em gráficos de tendências diárias, controles de filtragem e tabelas de dados detalhadas. Para instruções de configuração e exemplos de uso, consulte o artigo da KB – Gerador de Relatórios de Uso Interativo.

Como Começar

Todas as três APIs estão oficialmente disponíveis. Para começar a recuperar dados de uso:

1. Autentique-se usando suas credenciais de API do VMware Cloud on AWS.
2. Identifique o ID da sua organização no console VMC.
3. Escolha seu endpoint e especifique um intervalo de datas (até 31 dias por chamada).
4. Adicione filtros opcionais para região, tipo de instância ou SKU para refinar os resultados.

Para referências completas da API, detalhes de autenticação e exemplos adicionais:

• Documentação da API de Uso de Host
• Documentação da API de Uso de SPLA
• Documentação da API de Encargos Diversos (Encargos Não Relacionados a Hosts)

Próximos Passos

Continuaremos a investir na visibilidade de uso com visualização aprimorada no console VMC, recursos adicionais de filtragem e agregação, e opções de exportação em massa para grandes conjuntos de dados. Para perguntas, feedback ou solicitações de recursos, entre em contato com sua equipe de contas. Sua contribuição informa diretamente nosso roadmap.

Descubra mais no Blog VMware Cloud Foundation (VCF) Assine para receber as últimas postagens em seu e-mail. Digite seu e-mail… Assinar

Como parceira certificada, a VirtuAllIT pode auxiliar sua empresa na implementação e otimização dessas novas APIs de Relatório de Uso do VMware Cloud on AWS, garantindo que você aproveite ao máximo a visibilidade e o controle sobre seus custos e consumo na cloud.