Migrar a partir de APIs de Detalhes de Uso da EA
Os clientes da EA que anteriormente usavam as APIs de relatórios corporativos por trás do ponto de extremidade consumption.azure.com para obter detalhes de uso e taxas de mercado precisam migrar para soluções novas e aprimoradas. As instruções são descritas abaixo, juntamente com as diferenças contratuais entre a API antiga e as novas soluções.
O conjunto de dados é referido como detalhes de custo em vez de detalhes de uso.
Nota
Todas as APIs do Azure Enterprise Reporting são desativadas. Você deve migrar para as APIs do Microsoft Cost Management o mais rápido possível.
Novas soluções geralmente disponíveis
A tabela a seguir fornece um resumo dos destinos de migração disponíveis, juntamente com um resumo do que considerar ao escolher qual solução é melhor para você.
| Solução | Description | Considerações | Informações de integração |
|---|---|---|---|
| Exportações | Despejos de dados recorrentes para armazenamento em um cronograma | - A solução mais escalável para as suas cargas de trabalho. - Pode ser configurado para usar particionamento de arquivos para conjuntos de dados maiores. - Ótimo para estabelecer e aumentar um conjunto de dados de custo que pode ser integrado com seus próprios armazenamentos de dados consultáveis. -Requer acesso a uma conta de armazenamento que possa conter os dados. |
- Configurar no portal do Azure Automatize a criação de exportação com a API - Referência da API de exportação |
| API de detalhes de custo | Download sob demanda | - Útil para conjuntos de dados de pequeno custo. - Útil para cenários em que as exportações para o armazenamento do Azure não são viáveis devido a questões de segurança ou capacidade de gerenciamento. |
- Obtenha conjuntos de dados de pequeno custo sob demanda - API de detalhes de custo |
Geralmente, recomendamos o uso de Exportações se você tiver necessidades contínuas de ingestão de dados e/ou um grande conjunto de dados de detalhes de custo mensal. Para obter mais informações, consulte Dados de detalhes de custo de ingestão. Se precisar de informações adicionais para ajudá-lo a tomar uma decisão para sua carga de trabalho, consulte Escolher uma solução de detalhes de custo.
Atribuir permissões a um SPN para chamar as APIs
Se você deseja chamar as APIs de Exportações ou Detalhes de Custo programaticamente, precisará configurar uma Entidade de Serviço com a permissão correta. Para obter mais informações, consulte Atribuir permissões a APIs do ACM.
Evite a API de Detalhes de Uso de Consumo da Microsoft
A API de Detalhes de Uso de Consumo é outro ponto de extremidade que atualmente oferece suporte a clientes EA. Não migre para esta API. Migre para Exportações ou para a API de Detalhes de Custo, conforme descrito anteriormente neste documento. A API de Detalhes de Uso de Consumo será preterida no futuro e está localizada atrás do ponto de extremidade a seguir.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
Essa API é um ponto de extremidade síncrono e não poderá ser dimensionada à medida que seus gastos e o tamanho do conjunto de dados de custo mês a mês aumentam. Se você estiver usando a API de Detalhes de Uso de Consumo, recomendamos migrar dela para Exportações da API de Detalhes de Custo o mais rápido possível. Um anúncio formal de depreciação será feito em uma data futura. Para saber mais sobre como migrar da API de Detalhes de Uso do Consumo, consulte Migrar da API de Detalhes de Uso do Consumo.
Benefícios da migração
Nossas novas soluções oferecem muitos benefícios em relação às APIs de Detalhes de Uso de Relatórios EA. Aqui está um resumo:
- Segurança e estabilidade - As novas soluções requerem a entidade de serviço e/ou tokens de utilizador para aceder aos dados. Eles são mais seguros do que as chaves de API usadas para autenticação nas APIs de Relatórios EA. As chaves nessas APIs herdadas são válidas por seis meses e podem expor dados financeiros confidenciais se vazadas. Além disso, se as chaves não forem renovadas e integradas às cargas de trabalho antes do vencimento de seis meses, o acesso aos dados será revogado. Isso quebra as cargas de trabalho dos clientes.
- Escalabilidade - As APIs de Relatórios EA não são criadas para serem bem dimensionadas à medida que o uso do Azure aumenta. O conjunto de dados de detalhes de uso pode ficar extremamente grande à medida que você implanta mais recursos na nuvem. As novas soluções são assíncronas e têm extensas melhorias de infraestrutura por trás delas para garantir downloads bem-sucedidos para conjuntos de dados de qualquer tamanho.
- Conjunto de dados único para todos os detalhes de uso - os detalhes de uso do Azure e do Azure Marketplace foram mesclados em um conjunto de dados nas novas soluções. O conjunto de dados único reduz o número de APIs que você precisa ligar para ver todas as suas cobranças.
- Amortização de compra - Os clientes que compram Reservas podem ver uma visão Amortizada dos seus custos usando as novas soluções.
- Consistência do esquema - Cada solução disponível fornece arquivos com campos correspondentes. Ele permite que você se mova facilmente entre soluções com base no seu cenário.
- Integração de alocação de custos - os clientes do Enterprise Agreement e do Microsoft Customer Agreement podem usar a nova solução para exibir cobranças em relação às regras de alocação de custos que eles configuraram. Para obter mais informações sobre alocação de custos, consulte Alocar custos.
- Avançar melhorias - As novas soluções estão sendo ativamente desenvolvidas no futuro. As soluções recebem todos os novos recursos à medida que são lançadas.
APIs de uso corporativo para migrar
A tabela a seguir resume as diferentes APIs que você pode estar usando hoje para ingerir dados de detalhes de custo. Se você estiver usando uma das APIs a seguir, precisará migrar para uma das novas soluções descritas anteriormente. Todas as APIs estão atrás do ponto de https://consumption.azure.com extremidade.
| Ponto final | Comentários da API |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
- Método API: GET - Síncrono (sem sondagem) - Formato dos dados: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
- Método API: GET - Síncrono (sem sondagem) - Formato dos dados: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
- Método API: GET - Síncrono (sem sondagem) - Formato de dados: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
- Método API: GET - Síncrono (sem sondagem) - Formato de dados: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
- Método API: GET - Síncrono (sem sondagem) - Formato de dados: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- Método API: POST - Assíncrono (baseado em sondagem) - Formato dos dados: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- Método API: POST - Assíncrono (baseado em sondagem) - Formato dos dados: CSV |
Mapeamento de campo de dados
A tabela a seguir fornece um resumo dos campos antigos disponíveis nas soluções que você está usando no momento, juntamente com o campo a ser usado nas novas soluções.
| Campo antigo | Novo campo | Comentários |
|---|---|---|
| accountId | Não disponível - Use AccountName para obter as informações da conta. | |
| accountName | AccountName | |
| contaProprietárioE-mail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| encargosFaturadosSeparadamente | isAzureCreditEligible | As propriedades são opostas. Se isAzureCreditEnabled é verdade, ChargesBilledSeparately seria falsa. |
| consumidoQuantidade | Quantidade | |
| consumedService | ConsumedService | |
| consumidoServiceId | ConsumedService | consumedServiceId fornece apenas um valor numérico.ConsumedService Fornece o nome do serviço. |
| custo | CostInBillingCurrency | |
| costCenter | CostCenter | |
| data | Date | O formato no campo antigo era aaaa-mm-dd, enquanto o novo campo está no formato mm/dd/aaaa. |
| departmentId | InvoiceSectionId | O campo está vazio no momento. Use DepartmentName para obter as informações do departamento. |
| nome_do_departamento | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Se for caso disso, utilize a seringa e Term fields avançandoFrequency. |
|
| localização | ResourceLocationNormalizado | ResourceLocationNormalized está presente no relatório Detalhes de Custos, mas ainda não nas exportações. |
| meterCategory | MeterCategory | |
| meterId | MeterId | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| Número da encomenda | Não disponível. | |
| partNumber | PartNumber | |
| nome do plano | PlanName | |
| produto | ProductName | |
| publisherName | Nome do Editor | |
| resourceGroup | ResourceGroup | |
| resourceGuid | MeterId | Os valores variam. resourceGuid é um valor GUID. meterId é um número longo. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | Não disponível. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| nome_do_serviço | MeterCategory | |
| camada de serviço | MeterSubCategory | |
| storeServiceIdentifier | Não disponível. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| etiquetas | Etiquetas | O novo campo não tem o delimitação {} em torno dos pares chave-valor. |
| unitOfMeasure | UnitOfMeasure |
Próximos passos
- Leia o artigo de visão geral Migrar dos Relatórios EA para as APIs do Azure Resource Manager.