Migrar do Contrato Enterprise para as APIs de Contrato de Cliente da Microsoft
Este artigo ajuda você a entender a estrutura de dados, a API e outras diferenças de integração do sistema entre o EA (Contrato Enterprise) e as contas do MCA (Contrato de Cliente da Microsoft). O Gerenciamento de Custos dá suporte a APIs para os dois tipos de conta. Examine o artigo Configurar conta de cobrança para o Contrato de Cliente da Microsoft antes de continuar.
As organizações com uma conta de EA existente devem examinar este artigo, quando configurarem uma conta MCA. Anteriormente, renovar uma conta de EA exigia um mínimo de trabalho para mudar de um registro antigo para um novo. No entanto, migrar para uma conta de MCA requer esforço adicional. O esforço adicional é devido às alterações no subsistema de cobrança subjacente, que afetam todas as APIs e ofertas de serviço relacionadas ao custo.
Integração de APIs do MCA
As APIs do MCA e a nova integração permitem que você:
- Tenha disponibilidade de API completa por meio de APIs nativas do Azure.
- Configure várias faturas em uma conta de cobrança.
- Acesse uma API combinada com a utilização do serviço do Azure, a utilização do Marketplace de terceiros e compras no Marketplace.
- Veja os custos entre os perfis de cobrança (o mesmo que os registros) usando o Gerenciamento de Custos.
- acesse novas APIs para mostrar os custos, seja notificado quando os custos excederem os limites predefinidos e exporte dados brutos automaticamente.
Lista de verificação de migração
Os itens a seguir ajudam você a fazer a transição para APIs do MCA.
- Familiarize-se com a nova conta de cobrança de Contrato de Cliente da Microsoft.
- Determine quais APIs você usa e veja quais delas são substituídas na seção a seguir.
- Familiarize-se com as APIs REST do Azure Resource Manager.
- Se você ainda não estiver usando as APIs do Azure Resource Manager, registre seu aplicativo cliente com o Microsoft Entra ID.
- Ao aplicativo criado durante o registro de aplicativo do Microsoft Entra, conceda o 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 qualquer código de programação para substituir chamadas à API de EA por chamadas à API de MCA.
- Atualize o tratamento de erro para usar novos códigos de erro.
- Examine outras ofertas de integração, como Power BI, para ver outras ações necessárias.
APIs de EA substituídas por APIs de MCA
As APIs de EA usam uma chave de API para autenticação e autorização. As APIs do MCA usam a autenticação do Microsoft Entra.
Observação
Todas as APIs do Azure Enterprise Reporting foram descontinuadas. Você deve Migrar para APIs do Microsoft Cost Management o mais rápido possível.
| Finalidade | API de EA | API de MCA |
|---|---|---|
| Saldo e créditos | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Uso (JSON) | /usagedetails /usagedetailsbycustomdate |
Escolher uma solução de detalhes de custo |
| Uso (CSV) | /usagedetails/download /usagedetails/submit |
Escolher uma solução de detalhes de custo |
| Uso do Marketplace (CSV) | /marketplacecharges /marketplacechargesbycustomdate |
Escolher uma solução de detalhes de custo |
| Períodos de cobrança | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Tabela de preços | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json or csv Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json or csv Microsoft.Billing/billingAccounts/../billingProfiles/../providers/Microsoft.Consumption/pricesheets/download |
| Compras de reserva | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Recomendações de reserva | /SharedReservationRecommendations /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| Uso de reserva | /reservationdetails /reservationsummaries |
Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries |
¹ O serviço do Azure e o uso do Marketplace de terceiros estão disponíveis com a API de Detalhes de Uso.
As seguintes APIs estão disponíveis para contas de cobrança de MCA:
| Finalidade | API de MCA (Contrato de Cliente da Microsoft) |
|---|---|
| Contas de cobrança² | Microsoft.Billing/billingAccounts |
| Perfis de cobrança² | Microsoft.Billing/billingAccounts/billingProfiles |
| Seções da fatura² | Microsoft.Billing/billingAccounts/invoiceSections |
| Faturas | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Assinaturas para cobrança | {scope}/billingSubscriptions |
² APIs retornam listas de objetos, que são escopos nos quais as experiências de Gerenciamento de Custos no portal do Azure e nas APIs operam. Para obter mais informações sobre escopos do Gerenciamento de Custos, veja Entender e trabalhar com escopos.
Se você usar qualquer API EA existente, precisará atualizá-las para dar suporte a contas de cobrança de MCA. A seguinte tabela mostra outras alterações de integração:
| Finalidade | Oferta antiga | Nova oferta |
|---|---|---|
| Power BI | Pacote de conteúdo e conector do Microsoft Consumption Insights | Conector do Azure Consumption Insights |
APIs para obter saldo e créditos
A API Obter Resumo do Saldo foi usada para fornecer um resumo mensal de:
- Saldos
- Novas compras
- Encargos do serviço Azure Marketplace
- Ajustes
- Encargos excedentes do serviço
Todas as APIs de consumo são substituídas por APIs nativas do Azure que usam o Microsoft Entra ID para autenticação e autorização. Para obter mais informações sobre como chamar as APIs REST do Azure, veja Introdução ao REST.
A API Obter Resumo do Saldo é substituída pela API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.
Para obter os saldos disponíveis com a API de Saldo Disponível:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
APIs para obtenção de custo e uso
Obtenha, com as APIs a seguir, um detalhamento diário dos custos da utilização do serviço do Azure, do uso do Marketplace de terceiros e de outras compras do Marketplace. As APIs separadas a seguir foram mescladas para os serviços do Azure e o uso 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 ideal para você, confira Escolher uma solução de detalhes de custo. Ambas as soluções fornecem o mesmo arquivo de Detalhes de Custo e têm compras do marketplace nos dados, que anteriormente só eram mostradas no resumo do saldo até o momento.
As Exportações e a API de Detalhes de Uso, assim como todas as APIs de Gerenciamento de Custos, estão disponíveis em vários escopos. Para custos faturados, como você normalmente receberia em um nível de registro, use o escopo do perfil de cobrança. Para obter mais informações sobre escopos do Gerenciamento de Custos, veja Entender e trabalhar com escopos.
| Tipo | Formato de ID |
|---|---|
| Conta de cobrança | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Perfil de faturamento | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Subscription | /subscriptions/{subscriptionId} |
| Grupo de recursos | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Alguns nomes de propriedade foram alterados no novo conjunto de dados de Detalhes de Custo disponível por meio das Exportações e da API de Detalhes de Custo. A tabela a seguir mostra as propriedades correspondentes.
| Propriedade antiga | Nova propriedade | Observações |
|---|---|---|
| AccountId | N/D | O criador da assinatura não é acompanhado. Use invoiceSectionId (igual a departmentId). |
| AccountNameAccountOwnerId e AccountOwnerEmail | N/D | O criador da assinatura não é acompanhado. Use invoiceSectionName (igual a departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | As propriedades são opostas. Se isAzureCreditEnabled for verdadeiro, ChargesBilledSeparately será falso. |
| ConsumedQuantity | quantidade | |
| ConsumedService | consumedService | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| ConsumedServiceId | Nenhum | |
| CostCenter | costCenter | |
| Data e usageStartDate | date | |
| Dia | Nenhum | Analisa o dia com base na data. |
| DepartmentId | invoiceSectionId | Os valores exatos são diferentes. |
| DepartmentName | invoiceSectionName | Os valores exatos das cadeias de caracteres podem ser diferentes. Configure as seções da fatura para corresponderem aos departamentos, se necessário. |
| ExtendedCost e Custo | costInBillingCurrency | |
| InstanceId | resourceId | |
| É cobrança recorrente | Nenhum | |
| Localização | local | |
| MeterCategory | meterCategory | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| MeterId | meterId | Os valores exatos das cadeias de caracteres são diferentes. |
| MeterName | meterName | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| MeterRegion | meterRegion | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| MeterSubCategory | meterSubCategory | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| Mês | Nenhum | Analisa o mês com base na data. |
| Nome da oferta | Nenhum | Use publisherName e productOrderName. |
| OfferID | Nenhum | |
| Número do pedido | Nenhum | |
| PartNumber | Nenhum | Use meterId e productOrderName para identificar preços de maneira exclusiva. |
| Nome do Plano | productOrderName | |
| Produto | Produto | |
| ProductId | productId | Os valores exatos das cadeias de caracteres são diferentes. |
| Nome do editor | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | Os valores exatos das cadeias de caracteres são diferentes. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Nenhum | |
| ResourceName | Nenhum | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | N/D | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| ServiceTier | meterSubCategory | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| StoreServiceIdentifier | N/D | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Marcas | tags | A propriedade de marcas se aplica ao objeto raiz, não à propriedade aninhada de propriedades. |
| UnitOfMeasure | unitOfMeasure | Os valores exatos das cadeias de caracteres são diferentes. |
| usageEndDate | date | |
| Year | Nenhum | Analisa o ano com base na data. |
| (novo) | billingCurrency | A moeda usada para a cobrança. |
| (novo) | billingProfileId | ID exclusiva do perfil de cobrança (a mesma que a do registro). |
| (novo) | billingProfileName | Nome do perfil de cobrança (o mesmo que o do registro). |
| (novo) | chargeType | Use para diferenciar a utilização do serviço do Azure, o uso do Marketplace e as compras. |
| (novo) | invoiceId | A ID exclusiva da fatura. Vazio para o mês atual e em aberto. |
| (novo) | publisherType | Tipo de distribuidor para compras. Vazio para uso. |
| (novo) | serviceFamily | Tipo de compra. Vazio para uso. |
| (novo) | servicePeriodEndDate | Data de término do serviço comprado. |
| (novo) | servicePeriodStartDate | Data de início do serviço comprado. |
API de Períodos de Cobrança substituída por API de Faturas
As contas de cobrança de MCA não usam períodos de cobrança. Em vez disso, elas usam faturas para delimitar os custos para períodos de cobrança específicos. A API de Períodos de Cobrança é substituída pela API de Faturas. Todas as APIs de consumo são substituídas por APIs nativas do Azure que usam o Microsoft Entra ID para autenticação e autorização. Para obter mais informações sobre como chamar as APIs REST do Azure, veja Introdução ao REST.
Para obter faturas com a API de Faturas:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
APIs de Tabelas de Preços
Esta seção aborda as APIs de Tabelas de Preços existentes e fornece recomendações para migrar para a API de Tabelas de Preços para Contratos de Cliente da Microsoft. Ela também aborda a API de Tabelas de Preços para Contratos de Cliente da Microsoft e explica os campos nas tabelas de preços. As APIs de Obter tabelas de preços Enterprise e Obter períodos de cobrança Enterprise são substituídas pela API de Tabelas de Preços para Contrato de Cliente da Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). A nova API dá suporte aos formatos JSON e CSV, em formatos REST assíncronos. Todas as APIs de consumo são substituídas por APIs nativas do Azure que usam o Microsoft Entra ID para autenticação e autorização. Para obter mais informações sobre como chamar as APIs REST do Azure, veja Introdução ao REST.
APIs de Cobrança Enterprise
Você usou as APIs de Cobrança Enterprise com Registros Enterprise para obter informações sobre o preço e o período de cobrança. A autenticação e a autorização usaram tokens da Web do Microsoft Entra.
Para obter os preços aplicáveis para o Registro Enterprise especificado com as APIs de Tabelas de Preços e de Período de Cobrança:
| Método | URI da solicitação |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
API de Tabelas de Preços para Contratos de Cliente da Microsoft
Use a API de Tabelas de Preços para Contratos de Cliente da Microsoft para exibir os preços para todos os serviços de consumo do Marketplace e de consumo do Azure. Os preços mostrados para o perfil de cobrança se aplicam a todas as assinaturas que pertencem ao perfil de cobrança.
Use a API de Tabelas de Preços para exibir os dados da Tabela de Preços dos Serviços de Consumo do Azure no formato CSV:
| Método | URI da solicitação |
|---|---|
| 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 |
Use a API de Tabelas de Preços para exibir os dados da Tabela de Preços dos Serviços de Consumo do Azure no formato JSON:
| Método | URI da solicitação |
|---|---|
| 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 |
O uso da API retorna a tabela de preços da conta inteira. No entanto, você também pode obter uma versão condensada da tabela de preços no formato PDF. O resumo inclui os serviços de consumo do Marketplace e consumo do Azure que são cobrados por uma fatura específica. A fatura é identificada pelo {invoiceId}, que é igual ao número da fatura mostrado nos arquivos PDF de resumo da fatura. Veja um exemplo.
Para exibir informações de fatura com a API de Tabelas de Preços no formato CSV:
| Método | URI da solicitação |
|---|---|
| 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 exibir informações de fatura com a API de Tabelas de Preços no formato JSON:
| Método | URI da solicitação |
|---|---|
| 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 |
Você também pode ver os preços estimados para qualquer serviço de consumo do Marketplace ou de consumo do Azure no ciclo de serviço ou ciclo de cobrança aberto atual.
Para exibir os preços estimados dos serviços de consumo com a API de Tabelas de Preços no formato CSV:
| Método | URI da solicitação |
|---|---|
| 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 exibir os preços estimados dos serviços de consumo com a API de Tabelas de Preços no formato JSON:
| Método | URI da solicitação |
|---|---|
| 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 de Tabelas de Preços do Contrato de Cliente da Microsoft são APIs REST assíncronas. As respostas para as APIs foram alteradas em relação às APIs síncronas mais antigas. O corpo da resposta da API também foi alterado.
Corpo da resposta antigo
Aqui está um exemplo da 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"
},
{
]
Novo corpo da resposta
As APIs dão suporte ao formato assíncrono REST do Azure. Chame a API usando GET e você receberá a seguinte resposta:
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 para a chamada GET é a mesma até que a operação atinja um estado de conclusão ou de falha. Quando concluída, a resposta ao local da chamada GET retorna a URL de download como se a operação fosse executada ao mesmo tempo. Aqui está 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 o Azure-AsyncOperation. O ponto de extremidade retorna o status da operação.
A tabela a seguir mostra os campos da API Obter Tabelas de Preços Enterprise mais antiga. Ela inclui campos correspondentes na nova tabela de preços para Contrato de Cliente da Microsoft:
| Propriedade antiga | Nova propriedade | Observações |
|---|---|---|
| billingPeriodId | Não aplicável | Não aplicável. Para Contratos de Cliente da Microsoft, a fatura e a tabela de preços associada substituíram o conceito de billingPeriodId. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | Os valores exatos das cadeias de caracteres podem ser diferentes. |
| includedQuantity | includedQuantity | Não aplicável aos serviços nos Contratos de Cliente da Microsoft. |
| partNumber | Não aplicável | Em vez disso, use uma combinação de productOrderName (igual a offerID) e meterID. |
| unitPrice | unitPrice | O preço unitário é aplicável aos serviços consumidos em Contratos de Cliente da Microsoft. |
| currencyCode | pricingCurrency | Os Contratos de Cliente da Microsoft têm representações de preço na moeda de precificação e na moeda de cobrança. O currencyCode corresponde ao pricingCurrency nos Contratos de Cliente da Microsoft. |
| offerID | productOrderName | Em vez de OfferID, você pode usar productOrderName, mas isso não é o mesmo que OfferID. No entanto, productOrderName e meter determinam os preços nos Contratos de Cliente da Microsoft relacionados a meterId e OfferID em registros herdados. |
Operações de API de Tabelas de Preços de Consumo
Para Contratos Enterprise, você usou as operações Obter e Obter por Período de Cobrança da API de Tabelas de Preços de Consumo para um escopo por subscriptionId ou por um período de cobrança. A API usa a autenticação do Azure Resource Management.
Para obter as informações da tabela de preços para um escopo com a API de Tabelas de Preços:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Para obter informações da tabela de preços por período de cobrança com a API de Tabelas de Preços:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Para Contratos de Clientes da Microsoft, use os seguintes pontos de extremidade de API em vez daqueles mostrados acima:
API de Tabelas de Preços para Contratos de Cliente da Microsoft (API REST assíncrona)
Essa API é para Contratos de Cliente da Microsoft e fornece atributos adicionais.
Tabela de preços para um escopo de perfil de cobrança em uma conta de cobrança
Essa API é a API existente. Ela foi atualizada para fornecer a tabela de preços de um perfil de cobrança em uma conta de cobrança.
Tabela de preços para um escopo por conta de cobrança
Azure Resource Manager autenticação é usada quando você obtém a tabela de preços no escopo de registro em uma conta de cobrança.
Para obter a tabela de preços na conta de registro em uma conta de cobrança:
| Método | URI da solicitação |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Para um Contrato de Cliente da Microsoft, use as informações na seção a seguir. Elas fornecem as propriedades de campo usadas para Contratos de Cliente da Microsoft.
Tabela de preços para um escopo de perfil de cobrança em uma conta de cobrança
A tabela de preços atualizada por API de conta de cobrança obtém a tabela de preços no formato CSV. Para obter a tabela de preços no escopo do perfil de cobrança para um MCA:
| Método | URI da solicitação |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
No escopo de registro do EA, a resposta da API e as propriedades são idênticas. As propriedades correspondem às mesmas propriedades de MCA.
As propriedades mais antigas para APIs de Tabelas de Preços do Azure Resource Manager e as mesmas novas propriedades estão na tabela a seguir.
| Propriedade antiga de API de Tabelas de Preços do Azure Resource Manager | Nova propriedade da API de Tabelas de Preços do Contrato de Cliente da Microsoft | Descrição |
|---|---|---|
| ID de Medidor | meterId | Identificador exclusivo do medidor. Igual a meterID. |
| Nome do medidor | meterName | Nome do medidor. O medidor representa o recurso implantável de um serviço do Azure. |
| Categoria de medidor | service | Nome da categoria de classificação do medidor. Igual ao serviço na Tabela de Preços do Contrato de Cliente da Microsoft. Os valores exatos das cadeias de caracteres são diferentes. |
| Subcategoria de medidor | meterSubCategory | Nome da categoria de subclassificação do medidor. Com base na classificação de diferenciação do conjunto de recursos de alto nível no serviço. Por exemplo, BD SQL Básico versus BD SQL Standard. |
| Região do medidor | meterRegion | |
| Unidade | Não aplicável | Pode ser analisado segundo unitOfMeasure. |
| Unidade de medida | unitOfMeasure | |
| Número da peça | Não aplicável | Em vez do número de peça, use productOrderName e MeterID para identificar de maneira exclusiva o preço de um perfil de cobrança. Os campos são listados na fatura do MCA em vez do número da peça em faturas do MCA. |
| Preço unitário | unitPrice | Preço unitário do Contrato de Cliente da Microsoft. |
| Código de moeda | pricingCurrency | Os Contratos de Cliente da Microsoft representam preços na moeda de precificação e na moeda de cobrança. O código da moeda corresponde ao pricingCurrency nos Contratos de Cliente da Microsoft. |
| Quantidade incluída | includedQuantity | Não aplicável aos serviços nos Contratos de Cliente da Microsoft. Mostrar com valores de zero. |
| ID da oferta | productOrderName | Em vez de OfferID, use productOrderName. Não é o mesmo que OfferID, no entanto, o productOrderName e o medidor determinam os preços nos Contratos de Cliente da Microsoft. Relacionado a meterId e OfferID em registros herdados. |
O preço dos Contratos de Cliente da Microsoft é definido de maneira diferente dos Contratos Enterprise. O preço dos serviços no Registro Enterprise é exclusivo para o produto, o número de peça, o medidor e a oferta. O número da peça não é usado em Contratos de Cliente da Microsoft.
O preço do serviço de Consumo do Azure que faz parte de um Contrato de Cliente da Microsoft é exclusivo para productOrderName e meterID. Eles representam o medidor de serviço e o plano de produto.
Para reconciliar entre a planilha de preços e o uso na API de detalhes de uso, você pode usar o productOrderName e o meterID.
Os usuários que têm direitos de proprietário, colaborador, leitor e gerenciador de faturas do perfil de cobrança podem baixar a tabela de preços.
A tabela de preços inclui preços para serviços cujo preço é baseado no uso. Os serviços incluem consumo do Azure e consumo do Marketplace. O preço mais recente no final de cada período de serviço é bloqueado e aplicado ao uso em um período de serviço. Para os serviços de consumo do Azure, o período de serviço é geralmente de um mês civil.
Campos desativados da API de Tabelas de Preços
Os campos a seguir não estão disponíveis nas APIs de Tabelas de Preços do Contrato de Cliente da Microsoft ou então têm os mesmos campos.
| Campo desativado | Descrição |
|---|---|
| billingPeriodId | Não aplicável. Corresponde a InvoiceId para um MCA. |
| offerID | Não aplicável. Corresponde a productOrderName em um MCA. |
| meterCategory | Não aplicável. Corresponde a Serviço em um MCA. |
| unit | Não aplicável. Pode ser analisado segundo unitOfMeasure. |
| currencyCode | O mesmo que o pricingCurrency em um MCA. |
| meterLocation | O mesmo que a meterRegion em um MCA. |
| partNumber | Não aplicável porque o número de peça não está listado em faturas de MCA. Em vez de número de peça, use a combinação de meterId e productOrderName para identificar os preços com exclusividade. |
| totalIncludedQuantity | Não aplicável. |
| pretaxStandardRate | Não aplicável. |
API de Cobrança de Instância de Reserva substituída
Você pode obter transações de cobrança para compras de reserva com a API de Cobrança de Instância Reservada. A nova API inclui todas as compras, incluindo ofertas do Marketplace de terceiros. Todas as APIs de consumo são substituídas por APIs nativas do Azure que usam o Microsoft Entra ID para autenticação e autorização. Para obter mais informações sobre como chamar as APIs REST do Azure, veja Introdução ao REST. A API de Cobrança de Instância Reservada é substituída pela API de Transações.
Para obter transações de compra de reserva com a API de Transações:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
APIs de Recomendações substituídas
As APIs de Recomendações de Compra de Instância Reservada fornecem o uso da máquina virtual nos últimos 7, 30 ou 60 dias. As APIs também fornecem recomendações de compra de reserva. Entre elas estão:
- API Compartilhada de Recomendações de Instância Reservada
- API Individual de Recomendações de Instância Reservada
Todas as APIs de consumo são substituídas por APIs nativas do Azure que usam o Microsoft Entra ID para autenticação e autorização. Para obter mais informações sobre como chamar as APIs REST do Azure, veja Introdução ao REST. As APIs de recomendações de reserva listadas anteriormente são substituídas pela API Microsoft.Consumption/reservationRecommendations.
Para obter recomendações de reserva com a API de Recomendações de Reserva:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
APIs de Uso de Reserva substituídas
Você pode obter o uso de reserva em um registro com a API de Uso da Instância Reservada. Se houver mais de uma instância reservada em um registro, você também poderá obter o uso de todas as compras de instância reservada usando essa API.
Entre elas estão:
- Detalhes de Uso da Instância Reservada
- Resumo de Uso da Instância Reservada
Todas as APIs de consumo são substituídas por APIs nativas do Azure que usam o Microsoft Entra ID para autenticação e autorização. Para obter mais informações sobre como chamar as APIs REST do Azure, veja 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 detalhes de reserva com a API de Detalhes da Reserva:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Para obter resumos de reserva com a API de Resumos da Reserva:
| Método | URI da solicitação |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Integração com o Power BI
Você também pode usar o Power BI para preparar relatórios de custo. O conector do Gerenciamento de Custos para o Power BI Desktop pode ser usado para criar relatórios personalizados e avançados que ajudam você a entender melhor seus gastos com o Azure. Atualmente, o conector do Gerenciamento de Custos dá suporte a clientes com um Contrato de Cliente da Microsoft ou um EA (Contrato Enterprise).
Conteúdo relacionado
- Leia a documentação do Gerenciamento de Custos para saber como monitorar e controlar os gastos do Azure. Leia-a também caso você queira otimizar o uso de recursos com o Gerenciamento de Custos.