Migrar das APIs do Contrato Enterprise para as APIs do Contrato de Cliente Microsoft
Este artigo ajuda-o a compreender a estrutura de dados, a API e outras diferenças de integração do sistema entre as contas do Contrato Enterprise (EA) e do Contrato de Cliente Microsoft (MCA). O Gerenciamento de Custos oferece suporte a APIs para ambos os tipos de conta. Antes de continuar, veja o artigo Configurar a conta de faturação para um Contrato de Cliente Microsoft.
As organizações com uma conta EA existente devem rever este artigo quando configurarem uma conta MCA. Anteriormente, a renovação de uma conta EA exigia um mínimo de trabalho para passar de uma inscrição antiga para uma nova. No entanto, migrar para uma conta MCA requer um esforço extra. O esforço extra é devido a alterações no subsistema de faturamento subjacente, que afetam todas as APIs e ofertas de serviços relacionadas a custos.
APIs do MCA e integração
As APIs do MCA e a nova integração permitem-lhe:
- Ter disponibilidade completa das APIs através das APIs nativas do Azure.
- Configurar várias faturas numa conta de faturação única.
- Aceder a uma API combinada com a utilização dos serviços do Azure, a utilização do Marketplace de terceiros e as compras do Marketplace.
- Visualize os custos em todos os perfis de faturamento (o mesmo que as inscrições) usando o Gerenciamento de custos.
- Aceder às novas APIs para mostrar os custos, obter notificações quando os custos ultrapassarem os limiares predefinidos e exportar automaticamente os dados não processados.
Lista de verificação da migração
Os itens seguintes ajudam-no a fazer a transição para as APIs do MCA.
- Familiarize-se com a nova conta de faturação do Contrato de Cliente Microsoft.
- Determine quais as APIs que utiliza e veja quais são substituídas na secção seguinte.
- Familiarize-se com as Azure Resource Manager REST APIs (APIs REST do Azure Resource Manager).
- Se você ainda não estiver usando as APIs do Azure Resource Manager, registre seu aplicativo cliente com a ID do Microsoft Entra.
- Conceda ao aplicativo que foi criado durante o registro do aplicativo Microsoft Entra acesso de leitura à conta de cobrança usando o controle de acesso (IAM).
- Atualize qualquer código de programação para usar a autenticação do Microsoft Entra.
- Atualize o código de programação para substituir as chamadas às APIs do EA por chamadas às APIs do MCA.
- Atualize o processamento de erros para utilizar os novos códigos de erro.
- Analise outras ofertas de integração, como o Power BI, para obter outras ações necessárias.
APIs do EA substituídas pelas APIs do MCA
As APIs do EA utilizam uma chave de API para autenticação e autorização. As APIs MCA usam a autenticação do Microsoft Entra.
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.
| Propósito | API do EA | API do MCA |
|---|---|---|
| Saldo e créditos | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Utilização (JSON) | /usagedetails /usagedetailsbycustomdate |
Escolha uma solução de detalhes de custo |
| Utilização (JSON) | /usagedetails/download /usagedetails/enviar |
Escolha uma solução de detalhes de custo |
| Utilização do Marketplace (CSV) | /taxas de mercado /marketplacechargesbycustomdate |
Escolha uma solução de detalhes de custo |
| Períodos de faturação | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Folha de preços | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json ou csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../faturas/... /pricesheet/default/download format=json ou csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumo/planilhas de preços/download |
| Compras de reservas | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Recomendações da reserva | /SharedReservationRecomendações /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| Utilização da reserva | /reservationdetails /reservationsummaries |
Microsoft.Consumo/reservaDetalhes Microsoft.Consumption/reservationSummaries |
¹ O serviço do Azure e a utilização do Marketplace de terceiros estão disponíveis com a API de Detalhes de Utilização.
As seguintes APIs estão disponíveis para as contas de faturação MCA:
| Propósito | API do Contrato de Cliente Microsoft (MCA) |
|---|---|
| Contas de faturamento² | Microsoft.Billing/billingAccounts |
| Perfis de faturação² | Microsoft.Billing/billingAccounts/billingProfiles |
| Seções de faturas² | Microsoft.Billing/billingAccounts/invoiceSections |
| Faturas | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Subscrições de faturação | {scope}/billingSubscriptions |
² As APIs retornam listas de objetos, que são escopos, onde as experiências de Gerenciamento de Custos no portal do Azure e as APIs operam. Para obter mais informações sobre os âmbitos do Cost Management, veja Compreender e trabalhar com âmbitos.
Se utilizar algumas APIs do EA existentes, precisará de as atualizar para suportar as contas de faturação MCA. A tabela seguinte mostra as outras alterações da integração:
| Propósito | Oferta antiga | Oferta nova |
|---|---|---|
| Power BI | Conector e pacote de conteúdos do Microsoft Consumption Insights | Conector do Azure Consumption Insights |
APIs para obter o saldo e créditos
O Get Balance Summary foi usado para fornecer um resumo mensal de:
- Saldos
- Novas compras
- Custos dos serviços do Azure Marketplace
- Ajustes
- Custos de utilização excedida de serviço
Todas as APIs de Consumo são substituídas por APIs nativas do Azure que usam a ID do Microsoft Entra para autenticação e autorização. Para obter mais informações sobre as chamadas de APIs REST do Azure, veja Getting started with REST (Introdução ao REST).
A API Get Balance Summary (Obter Resumo do Saldo) é substituída pela API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.
Para obter os saldos disponíveis com a API Available Balance (Saldo Disponível):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
APIs para obter os custos e a utilização
Obtenha uma discriminação diária dos custos da utilização dos serviços do Azure, da utilização do Marketplace de terceiros e de outras compras do Marketplace com as seguintes APIs. As seguintes APIs foram unidas para a utilização dos serviços do Azure e do Marketplace de terceiros. As APIs antigas são substituídas por Exportações ou pela API de Detalhes de Custo. Para escolher a solução certa para você, consulte Escolher uma solução de detalhes de custo. Ambas as soluções fornecem o mesmo arquivo de Detalhes de Custo e têm compras no marketplace nos dados, que anteriormente eram mostrados apenas no resumo do saldo até o momento.
As exportações e a API de detalhes de custo, como todas as APIs de gerenciamento de custos, estão disponíveis em vários escopos. Para obter os custos faturados, como tradicionalmente receberia ao nível da inscrição, utilize o âmbito do perfil de faturação. Para obter mais informações sobre os âmbitos do Cost Management, veja Compreender e trabalhar com âmbitos.
| Tipo | Formato ID |
|---|---|
| Conta de faturação | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Perfil de faturação | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Subscrição | /subscriptions/{subscriptionId} |
| Grupo de recursos | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Alguns nomes de propriedade foram alterados no novo conjunto de dados Detalhes de custo disponível por meio da API de Exportações e Detalhes de custo. A tabela seguinte mostra as propriedades correspondentes.
| Propriedade antiga | Nova propriedade | Notas |
|---|---|---|
| AccountId | N/A | O criador da subscrição não é controlado. Utilize invoiceSectionId (idêntico a departmentId). |
| AccountNameAccountOwnerId e AccountOwnerEmail | N/A | O criador da subscrição não é controlado. Utilize invoiceSectionName (idêntico a departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | As propriedades são opostas. Se isAzureCreditEnabled for verdadeiro, ChargesBilledSeparately dever ser falso. |
| ConsumedQuantity | quantidade | |
| ConsumedService | consumedService | Os valores exatos da cadeia podem ser diferentes. |
| ConsumedServiceId | Nenhuma | |
| CostCenter | costCenter | |
| Date e usageStartDate | data | |
| Dia | Nenhuma | Analisa o dia a partir da data. |
| DepartmentId | invoiceSectionId | Os valores exatos diferem. |
| DepartmentName | invoiceSectionName | Os valores exatos da cadeia podem ser diferentes. Configure as secções da fatura para corresponderem aos departamentos, se necessário. |
| ExtendedCost e Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| Is Recurring Charge | Nenhuma | |
| Location | localização | |
| MeterCategory | meterCategory | Os valores exatos da cadeia podem ser diferentes. |
| MeterId | meterId | Os valores exatos da cadeia são diferentes. |
| MeterName | meterName | Os valores exatos da cadeia podem ser diferentes. |
| MeterRegion | meterRegion | Os valores exatos da cadeia podem ser diferentes. |
| MeterSubCategory | meterSubCategory | Os valores exatos da cadeia podem ser diferentes. |
| Month | Nenhuma | Analisa o mês a partir da data. |
| Nome da Oferta | Nenhuma | Utilize publisherName e productOrderName. |
| OfferId | Nenhuma | |
| Número da Encomenda | Nenhuma | |
| PartNumber | Nenhuma | Utilize meterId e productOrderName para identificar exclusivamente os preços. |
| Planejar Nome | productOrderName | |
| Produto | Produto | |
| ProductId | productId | Os valores exatos da cadeia são diferentes. |
| Nome do Editor | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | Os valores exatos da cadeia são diferentes. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Nenhuma | |
| ResourceName | Nenhuma | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | N/A | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | Os valores exatos da cadeia podem ser diferentes. |
| ServiceTier | meterSubCategory | Os valores exatos da cadeia podem ser diferentes. |
| StoreServiceIdentifier | N/A | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Etiquetas | etiquetas | A propriedade tags se aplica ao objeto raiz, não à propriedade aninhada de propriedades. |
| UnitOfMeasure | unitOfMeasure | Os valores exatos da cadeia são diferentes. |
| usageEndDate | data | |
| Anual | Nenhuma | Analisa o ano a partir da data. |
| (nova) | billingCurrency | Moeda utilizada para a cobrança. |
| (nova) | billingProfileId | ID único do perfil de faturação (idêntico à inscrição). |
| (nova) | billingProfileName | Nome do perfil de faturação (idêntico à inscrição). |
| (nova) | chargeType | Permite diferenciar a utilização dos serviços do Azure, a utilização do Marketplace e as compras. |
| (nova) | invoiceId | ID exclusivo da fatura. Vazio para o mês atual aberto. |
| (nova) | publisherType | Tipo de editor das compras. Vazio para utilização. |
| (nova) | serviceFamily | Tipo de compra. Vazio para utilização. |
| (nova) | servicePeriodEndDate | Data de fim do serviço comprado. |
| (nova) | servicePeriodStartDate | Data de início do serviço comprado. |
API Billing Periods (Períodos de Faturação) substituído pela API Invoices (Faturas)
As contas de faturação MCA não utilizam períodos de faturação. Em vez disso, utilizam as faturas para associar os custos a períodos específicos de faturação. A API Billing Periods API (Períodos de Faturação) é substituída pela API Invoices (Faturas). Todas as APIs de Consumo são substituídas por APIs nativas do Azure que usam a ID do Microsoft Entra para autenticação e autorização. Para obter mais informações sobre as chamadas de APIs REST do Azure, veja Getting started with REST (Introdução ao REST).
Para obter as faturas com a API Invoices (Faturas):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
APIs Price Sheet (Folha de Preços)
Esta secção explica as APIs Price Sheet (Folha de Preços) existentes e apresenta recomendações para mover para a API Price Sheet (Folha de Preços) para Contratos de Cliente Microsoft. Também explica a API Price Sheet (Folha de Preços) para os Contratos de Cliente Microsoft e explica os campos nas folhas de preços. As APIs Enterprise Get price sheet (Obter folha de preços do Enterprise) e Enterprise Get billing periods (Obter períodos de faturação do Enterprise) são substituídos pela API Price Sheet (Folha de Preços) para os Contratos de Cliente Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). A nova API suporta os formatos JSON e CSV, nos formatos REST assíncronos. Todas as APIs de Consumo são substituídas por APIs nativas do Azure que usam a ID do Microsoft Entra para autenticação e autorização. Para obter mais informações sobre as chamadas de APIs REST do Azure, veja Getting started with REST (Introdução ao REST).
APIs Billing Enterprise (Faturação do Enterprise)
Utilizava as APIs Billing Enterprise (Faturação do Enterprise) com as inscrições Enterprise para obter as informações sobre os preços e o período de faturação. Autenticação e autorização usadas de tokens da Web Microsoft Entra.
Para obter os preços aplicáveis da Inscrição Enterprise especificada com as APIs de Price Sheet (Folha de Preços) e Billing Period (Período de Faturação):
| Método | URI do pedido |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
API Price Sheet (Folha de Preços) para Contratos de Cliente Microsoft
Utilize a API Price Sheet (Folha de Preços) para os Contratos de Cliente Microsoft para ver os preços de todos os serviços de consumo do Azure Consumption e do Marketplace. Os preços apresentados para o perfil de faturação aplicam-se a todas as subscrições que pertencem ao perfil de faturação.
Utilize a API Price Sheet (Folha de Preços) para ver todos os dados da Folha de Preços dos serviços do Azure Consumption no formato CSV:
| Método | URI do pedido |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Utilize a API Price Sheet (Folha de Preços) para ver todos os dados da Folha de Preços dos serviços do Azure Consumption no formato JSON:
| Método | URI do pedido |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
Utilize a API para apresentar a folha de preços de toda a conta. No entanto, também pode obter uma versão condensada da folha de preços no formato PDF. O resumo inclui os serviços de consumo do Azure Consumption e do Marketplace que são faturados para uma fatura específica. A fatura é identificada pelo {invoiceId}, que é idêntico ao Número da Fatura apresentado nos ficheiros PDF de Resumo da Fatura. Eis um exemplo.
Para ver as informações da fatura com a API Price Sheet (Folha de Preços) no formato CSV:
| Método | URI do pedido |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Para ver as informações da fatura com a API Price Sheet (Folha de Preços) no formato JSON:
| Método | URI do pedido |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Também pode ver a estimativa de preços de qualquer serviço de consumo do Azure Consumption ou do Marketplace no atual período de serviço ou ciclo de faturação aberto.
Para ver os preços estimados dos serviços de consumo com a API Price Sheet (Folha de Preços) no formato CSV:
| Método | URI do pedido |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Para ver os preços estimados dos serviços de consumo com a API Price Sheet (Folha de Preços) no formato JSON:
| Método | URI do pedido |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
As APIs Price Sheet (Folha de Preços) do Contrato de Cliente Microsoft são APIs REST assíncronas. As respostas das APIs foram alteradas comparativamente às APIs síncronas mais antigas. O corpo da resposta das APIs também foi alterado.
Corpo da resposta antigo
Veja a seguir um exemplo de resposta da API REST síncrona:
[
{
"id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
]
Corpo da resposta novo
As APIs suportam o formato assíncrono REST do Azure. Se chamar a API com GET, receberá a resposta seguinte:
No Response Body
HTTP Status 202 Accepted
Os seguintes cabeçalhos são enviados com a localização da saída:
Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Retry-After: 10
OData-EntityId: {operationId}
Faça outra chamada GET para a localização. A resposta à chamada GET é idêntica até que a operação atinja um estado de falha ou de conclusão. Quando concluída, a resposta ao local da chamada GET retorna a URL de download como se a operação tivesse sido executada ao mesmo tempo. Eis um exemplo:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
O cliente também pode fazer uma chamada GET para Azure-AsyncOperation. O ponto final devolve o estado da operação.
A tabela seguinte mostra os campos na API Enterprise Get price sheet (Obter folha de preços do Enterprise) mais antiga. Inclui os campos correspondentes na nova folha de preços para os Contratos de Cliente Microsoft:
| Propriedade antiga | Nova propriedade | Notas |
|---|---|---|
| billingPeriodId | Não aplicável | Não aplicável. Para os Contratos de Cliente Microsoft, a fatura e a folha de preços associada substituíram o conceito de billingPeriodId. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | Os valores exatos da cadeia podem ser diferentes. |
| includedQuantity | includedQuantity | Não aplicável aos serviços nos Contratos de Cliente Microsoft. |
| partNumber | Não aplicável | Em vez disso, utilize uma combinação de productOrderName (idêntico a offerID) e meterID. |
| unitPrice | unitPrice | O preço unitário é aplicável aos serviços consumidos no Contrato de Cliente Microsoft. |
| currencyCode | pricingCurrency | Os Contratos de Cliente Microsoft possuem representações na moeda do preço e moeda da fatura. O currencyCode corresponde a pricingCurrency nos Contratos de Cliente Microsoft. |
| offerID | productOrderName | Em vez de OfferID, pode utilizar productOrderName, mas não é idêntico a OfferID. No entanto, a propriedade productOrderName e o medidor determinam os preços nos Contratos de Cliente Microsoft relacionados com meterId e OfferID em inscrições legadas. |
Operações da API Consumption Price Sheet (Folha de Preços de Consumo)
Nos Contratos Enterprise, utilizou a API Consumption Price Sheet (Folha de Preços de Consumo) nas operações Get (Obter) e Get By Billing Period (Obter por Período de Faturação) para um âmbito por subscriptionId ou por período de faturação. A API utiliza a autenticação da Gestão de Recursos do Azure.
Para obter as informações da Folha de Preços para um âmbito com a API Price Sheet (Folha de Preços):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Para obter as informações da Folha de Preços por período de faturação com a API Price Sheet (Folha de Preços):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Em vez dos pontos finais da API acima indicados, utilize os que se seguem para os Contratos de Cliente Microsoft:
API Price Sheet (Folha de Preços) para Contratos de Cliente Microsoft (API REST assíncrona)
Esta API destina-se a Contratos de Cliente Microsoft e fornece atributos adicionais.
Folha de Preços para um âmbito de Perfil de Faturação numa Conta de Faturação
Esta é a API existente. Foi atualizada para apresentar a folha de preços de um perfil de faturação numa conta de faturação.
Folha de Preços para um âmbito por conta de faturação
A autenticação do Azure Resource Manager é utilizada quando obtém a Folha de Preços no âmbito da inscrição numa conta de faturação.
Para obter a Folha de Preços da conta de inscrição numa conta de faturação:
| Método | URI do pedido |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Para um Contrato de Cliente Microsoft, utilize as informações da seguinte secção. Apresenta as propriedades dos campos utilizadas para os Contratos de Cliente Microsoft.
Folha de Preços para um âmbito de perfil de faturação numa conta de faturação
A API Price Sheet by billing account (Folha de Preços por conta de faturação) atualizada obtém a Folha de Preços no formato CSV. Para obter a Folha de Preços no âmbito do perfil de faturação para um MCA:
| Método | URI do pedido |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
No âmbito da inscrição do EA, a resposta e as propriedades da API são idênticas. As propriedades correspondem às mesmas propriedades do MCA.
A tabela seguinte apresenta as propriedades mais antigas das Azure Resource Manager Price Sheet APIs (APIs de Folha de Preços do Azure Resource Manager) e as propriedades novas equivalentes.
| Antiga Propriedade da API Azure Resource Manager Price Sheet (Folha de Preços do Azure Resource Manager) | Nova Propriedade da API Azure Resource Manager Price Sheet (Folha de Preços do Contrato de Cliente Microsoft) | Description |
|---|---|---|
| ID do Medidor | meterId | Identificador exclusivo do medidor. Idêntico a meterID. |
| Nome do medidor | meterName | Nome do medidor. O medidor representa o recurso implementável dos serviços do Azure. |
| Categoria do medidor | service | Nome da categoria de classificação do medidor. Idêntico ao do serviço na Folha de Preços do Contrato de Cliente Microsoft. Os valores exatos da cadeia são diferentes. |
| Subcategoria do medidor | meterSubCategory | Nome da categoria de subclassificação do medidor. Com base na classificação da diferenciação das definições de funcionalidades de alto nível no serviço. Por exemplo, Base de Dados SQL Básica vs. Base de Dados SQL Standard. |
| Região do medidor | meterRegion | |
| Unit | Não aplicável | Pode ser analisada em unitOfMeasure. |
| Unidade de medida | unitOfMeasure | |
| Número de peça | Não aplicável | Em vez do número de peça, utilize productOrderName e MeterID para identificar de forma exclusiva o preço num perfil de faturação. Os campos são listados na fatura do MCA em vez do número de peça nas faturas do MCA. |
| Preço unitário | unitPrice | Preço unitário do Contrato de Cliente Microsoft. |
| Código de moeda | pricingCurrency | Os Contratos de Cliente Microsoft representam os preços na moeda do preço e na moeda da fatura. O código de moeda é idêntico a pricingCurrency nos Contratos de Cliente Microsoft. |
| Quantidade incluída | includedQuantity | Não é aplicável aos serviços nos Contratos de Cliente Microsoft. Apresentada com valores iguais a zero. |
| ID da oferta | productOrderName | Em vez de OfferID, utilize productOrderName. Não é idêntico a OfferID. No entanto, productOrderName e o medidor determinam os preços nos Contratos de Cliente Microsoft. Relacionado com meterId e OfferID nas inscrições legadas. |
O preço dos Contratos de Cliente Microsoft é definido de forma diferente do preço dos contratos Enterprise. O preço dos serviços na inscrição Enterprise é exclusivo do produto, do número de peça, do medidor e da oferta. O número de peça não é utilizado nos Contratos de Cliente Microsoft.
O preço dos serviços do Azure Consumption, que faz parte de um Contrato de Cliente Microsoft, é exclusivo de productOrderName e de meterID. Representam o medidor dos serviços e o plano do produto.
Para obter a reconciliação entre a folha de preços e a utilização na API Usage Details (Detalhes da Utilização), pode utilizar productOrderName e meterID.
Os utilizadores que tenham direitos de gestor de faturas, leitor, contribuidor e proprietário do perfil de faturação podem transferir a folha de preços.
As folhas de preço incluem preços para serviços cujo preço é baseado na utilização. Os serviços incluem o consumo do Azure e o consumo do Marketplace. O preço mais recente no final de cada período de serviço é bloqueado e aplicado à utilização num único período de serviço. Para os serviços de consumo do Azure, o período de serviço corresponde normalmente a um mês de calendário.
Campos retirados da API Price Sheet (Folha de Preços)
Os seguintes campos não estão disponíveis nas APIs Price Sheet (Folha de Preços) do Contrato de Cliente Microsoft ou correspondem a campos idênticos.
| Campo retirado | Description |
|---|---|
| billingPeriodId | Não aplicável. Corresponde a InvoiceId no MCA. |
| offerID | Não aplicável. Corresponde a productOrderName no MCA. |
| meterCategory | Não aplicável. Corresponde a Serviço no MCA. |
| unit | Não aplicável. Pode ser analisada em unitOfMeasure. |
| currencyCode | Idêntico a pricingCurrency no MCA. |
| meterLocation | Idêntico a meterRegion no MCA. |
| partNumber | Não aplicável porque o número de peça não está listado nas faturas do MCA. Em vez do número de peça, utilize a combinação meterId e productOrderName para identificar de forma exclusiva os preços. |
| totalIncludedQuantity | Não aplicável. |
| pretaxStandardRate | Não aplicável. |
Substituição da API Reservation Instance Charge (Custo de Instância Reservada)
Pode obter as transações de faturação das compras de reservas com a API Reserved Instance Charge (Custo de Instância Reservada). A nova API inclui todas as compras, incluindo as ofertas do Marketplace de terceiros. Todas as APIs de Consumo são substituídas por APIs nativas do Azure que usam a ID do Microsoft Entra para autenticação e autorização. Para obter mais informações sobre as chamadas de APIs REST do Azure, veja Getting started with REST (Introdução ao REST). A API Reserved Instance Charge (Custo de Instância Reservada) é substituída pela API Transactions (Transações).
Para obter as transações das compras de reservas com a API Transactions (Transações):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
Substituição das APIs Recommendations (Recomendações)
As APIs Reserved Instance Purchase Recommendations (Recomendações de Compras de Instância Reservada) apresentam a utilização das máquinas virtuais ao longo dos últimos 7, 30 ou 60 dias. As APIs também apresentam recomendações de compras de reservas. Estas incluem:
- API Shared Reserved Instance Recommendation (Recomendação de Instância Reservada Partilhada)
- API Single Reserved Instance Recommendations (Recomendação de Instância Reservada Única)
Todas as APIs de Consumo são substituídas por APIs nativas do Azure que usam a ID do Microsoft Entra para autenticação e autorização. Para obter mais informações sobre as chamadas de APIs REST do Azure, veja Getting started with REST (Introdução ao REST). As APIs de recomendações de reserva listadas anteriormente são substituídas pela API Microsoft.Consumption/reservationRecommendations.
Para obter as recomendações de reserva com a API Reservation Recommendations (Recomendações de Reserva):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
Substituição das APIs Reservation Usage (Utilização de Reservas)
Pode obter a utilização da reserva numa inscrição com a API Reserved Instance Usage (Utilização de Instâncias Reservadas). Se existir mais de uma instância reservada numa inscrição, também poderá obter a utilização de todas as compras de instâncias reservadas com esta API.
Estas incluem:
- Reserved Instance Usage Details (Detalhes da Utilização de Instâncias Reservadas)
- Reserved Instance Usage Summary (Resumo da Utilização de Instâncias Reservadas)
Todas as APIs de Consumo são substituídas por APIs nativas do Azure que usam a ID do Microsoft Entra para autenticação e autorização. Para obter mais informações sobre as chamadas de APIs REST do Azure, veja Getting started with REST (Introdução ao REST). As APIs de recomendações de reserva listadas anteriormente são substituídas pelas APIs Microsoft.Consumption/reservationDetails e Microsoft.Consumption/reservationSummaries.
Para obter os detalhes da reserva com a API Reservation Details (Detalhes da Reserva):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Para obter os resumos da reserva com a API Reservation Summaries (Resumos da Reserva):
| Método | URI do pedido |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Integração do Power BI
Também pode utilizar o Power BI para a criação de relatórios de custos. O conector de Gerenciamento de Custos para Power BI Desktop pode ser usado para criar relatórios poderosos e personalizados que ajudam você a entender melhor seus gastos do Azure. Atualmente, o conector de Gerenciamento de Custos oferece suporte aos clientes com um Contrato de Cliente Microsoft ou um Enterprise Agreement (EA).
Conteúdos relacionados
- Leia a Documentação do Cost Management para saber como monitorizar e controlar as despesas do Azure. Ou, se quiser otimizar a utilização dos recursos com o Cost Management.