Compartilhar via

Migrar da API da Tabela de Preços do EA

  • Artigo

Os clientes de EA que anteriormente usavam a API consumption.azure.com dos Relatórios do Enterprise para obter a tabela de preços precisam migrar para API de substituição do Azure Resource Manager. As instruções a seguir ajudam você a migrar e também descrevem as diferenças contratuais entre a API antiga e a nova API.

Observação

Todas as APIs do Azure Enterprise Reporting foram descontinuadas. Você deve Migrar para as APIs de Gerenciamento de Custos da Microsoft o mais rápido possível.

Atribuir permissões a uma entidade de serviço para chamar a API

Antes de chamar a API, configure uma entidade de serviço (SPN) com a permissão correta. Use a entidade de serviço para chamar a API. Para obter mais informações, consulte Atribuir permissões às APIs de Gerenciamento de Custos.

Chamar a API de Tabela de Preços

A API da Tabela de Preços gera a planilha de preços de forma assíncrona e produz um arquivo que você baixa.

Use os URIs de solicitação a seguir quando chamar a nova API de Tabela de Preços:

Solicitações com suporte

Você pode chamar a API usando o seguinte escopo:

Registro: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Baixar por conta de cobrança para o período de cobrança especificado

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

A solicitação POST retorna um local para sondar o status de geração de relatório, conforme descrito na resposta a seguir:

Resposta de exemplo

Código de status: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Retry-After: 60

Código de status: 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Exemplo de solicitação para sondar o status de geração de relatório

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01

Alterações do corpo da resposta

[
        {
              "id": "enrollments/57354989/billingperiods/201601/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"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Novas alterações de resposta

As propriedades da tabela de preços são as seguintes:

Nome Tipo Descrição
basePrice string O preço unitário no momento em que o cliente se conecta ou o preço unitário no momento em que o medidor de serviço de disponibilidade geral é iniciado, caso seja após a entrada.

Aplica-se aos usuários do Contrato Enterprise
currencyCode string Moeda na qual o Contrato Enterprise foi assinado
effectiveEndDate string Data de término efetiva do período de cobrança da Tabela de Preços
effectiveStartDate string Data de início efetiva do período de cobrança da Tabela de Preços
enrollmentNumber string Identificador exclusivo da conta de cobrança do EA.
includedQuantity string Quantidades de um serviço específico ao qual um cliente EA tem direito de consumir sem encargos incrementais.
marketPrice string O preço de lista atual de um determinado produto ou serviço. Esse preço é sem negociação e se baseia no tipo de Contrato da Microsoft.

Para o Consumo PriceType, o preço de mercado é refletido como o preço de pagamento conforme o uso.

Para o plano de economia PriceType, o preço de mercado reflete o benefício do plano de economia em cima do preço de pagamento conforme o uso para o prazo de compromisso correspondente.

Para PriceType ReservedInstance, o preço de mercado reflete o preço total do compromisso de um ou três anos.

Observação: para clientes EA sem negociações, o preço de mercado pode parecer arredondado para uma precisão decimal diferente do preço unitário.
meterCategory string Nome da categoria de classificação do medidor. Por exemplo, Serviços de Nuvem, Rede etc.
meterId string Identificador exclusivo do medidor
meterName string Nome do medidor. O medidor representa o recurso implantável de um serviço do Azure.
meterRegion string Nome da região do Azure em que o medidor do serviço está disponível.
meterSubCategory string Nome da categoria de subclassificação do medidor.
meterType string Nome do tipo de medidor
partNumber string Número de peça associado ao medidor
priceType string Tipo de preço para um produto. Por exemplo, um recurso do Azure com uma taxa de pagamento conforme o uso com priceType como Consumo. Outros tipos de preço incluem ReservedInstance e Plano de economia.
produto string Nome do produto que acumula os preços.
productId string Identificador exclusivo do produto cujo medidor é consumido.
serviceFamily número Tipo de serviço do Azure. Por exemplo, Computação, Análise e Segurança.
skuId string Identificador exclusivo da SKU
term string Duração do prazo do Plano de economia do Azure ou prazo de reserva – um ano ou três anos (P1Y ou P3Y)
unitOfMeasure string Como o uso é medido para o serviço
unitPrice string O preço por unidade no momento de cobrança de um determinado produto ou serviço, incluindo descontos negociados em cima do preço de mercado.

Para PriceType ReservedInstance, o preço unitário reflete o custo total do compromisso de um ou três anos, incluindo descontos.

Observação: o preço unitário não é o mesmo que o preço efetivo em downloads de detalhes de uso, no caso de serviços que têm preços diferenciais entre camadas.

Se os serviços tiverem preços de várias camadas, o preço efetivo é uma taxa combinada entre as camadas e não mostra um preço unitário específico da camada. O preço combinado ou o preço efetivo é o preço líquido para a quantidade consumida que abrange várias camadas (em que cada camada tem um preço unitário específico).

Conteúdo relacionado