Partilhar via

Migrar da API de Planilha de Preços da EA

  • Artigo

Os clientes da EA que usavam anteriormente a API do Enterprise Reporting consumption.azure.com para obter sua planilha de preços precisam migrar para uma API substituta do Azure Resource Manager. As instruções a seguir ajudam você a migrar e também descrevem quaisquer diferenças contratuais entre a API antiga e a nova API.

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.

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

Antes de chamar a API, você precisa configurar 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 a APIs de gerenciamento de custos.

Chamar a API da Folha de Preços

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

Use os seguintes URIs de solicitação ao chamar a nova API de Planilha de Preços:

Pedidos suportados

Você pode chamar a API usando o seguinte escopo:

Inscrição: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Transferir por conta de faturação para o período de faturação 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 pesquisar o status de geração de relatório, conforme descrito na seguinte resposta:

Resposta da amostra

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 pedido para sondar o estado da geração do 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 ao 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 folha de preços são as seguintes:

Nome Tipo Descrição
basePrice string O preço unitário no momento em que o cliente assina ou o preço unitário no momento do lançamento do GA do medidor de serviço, se for após o início de sessão.

Aplica-se aos utilizadores do Enterprise Agreement
currencyCode string Moeda em que o Enterprise Agreement foi assinado
effectiveEndDate string Data de término efetiva do período de faturamento da Planilha de Preços
effectiveStartDate string Data de início efetiva do período de faturação da Folha de Preços
Número de inscrição string Identificador exclusivo da conta de faturação da EA.
includedQuantity string Quantidades de um serviço específico que um cliente EA tem direito a consumir sem encargos adicionais.
marketPrice string O preço de tabela atual para um determinado produto ou serviço. Este preço é sem qualquer negociação e baseia-se no seu tipo de Contrato Microsoft.

Para PriceType Consumption, o preço de mercado é refletido como o preço pré-pago.

Para o Plano de Poupança PriceType, o preço de mercado reflete o benefício do plano de poupança em cima do preço pré-pago 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.

Nota: 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 Cloud, Rede, etc.
meterId string Identificador único do contador
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 onde o medidor do serviço está disponível.
meterSubCategory string Nome da categoria de subclassificação do medidor.
meterType string Nome do tipo de contador
partNumber string Número da peça associado ao contador
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ços incluem ReservedInstance e Savings Plan.
produto string Nome do produto que acumula os encargos.
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 do SKU
vigência string Duração do Plano de Poupança 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 unitário no momento da faturação de um determinado produto ou serviço, incluindo quaisquer 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.

Nota: O preço unitário não é o mesmo que o preço efetivo nos downloads de detalhes de utilização quando os serviços têm preços diferenciados entre níveis.

Se os serviços forem preços multicamadas, o preço efetivo será uma taxa combinada entre os níveis e não mostrará um preço unitário específico do nível. O preço combinado ou o preço em vigor é o preço líquido para a quantidade consumida que abrange várias camadas (em que cada camada tem um preço por unidade específico).

Conteúdos relacionados