Compartilhar via


Consultas de exemplo para análise programática para o Microsoft Marketplace

Este artigo fornece consultas de exemplo para os relatórios de pedidos, uso e clientes do Microsoft Marketplace. Você pode consultar essas consultas e criar mais consultas de acordo com seu caso de uso chamando o ponto de extremidade da API criar consulta de relatório .

Para obter mais informações sobre nomes de coluna, atributos e descrições, consulte estes artigos:

Clientes relatam consultas

Essas consultas de exemplo se aplicam ao relatório Clientes.

Descrição da consulta Consulta de exemplo
Listar detalhes do cliente com clientes ativos do parceiro até a data escolhida SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 1
Listar detalhes do cliente com clientes rotatividade do parceiro até a data escolhida SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE IsActive = 0
Lista de novos clientes de uma geografia específica nos últimos seis meses SELECT DateAcquired,CustomerCompanyName,CustomerId FROM ISVCustomer WHERE DateAcquired <= ‘2020-06-30’ AND CustomerCountryRegion = ‘United States’

Consultas de relatório de uso

Essas consultas de exemplo se aplicam ao relatório uso.

Descrição da consulta Consulta de exemplo
Listar detalhes de uso com uso normalizado de VM (Máquina Virtual) para o tipo de Licença do Marketplace "Cobrado por meio do Azure" para os últimos 6M SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS
Listar detalhes de uso com uso bruto da VM para o tipo de Licença do Marketplace "Cobrado por meio do Azure" para os últimos 12M SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_1_YEAR
Listar detalhes de uso com uso normalizado de VM para o tipo de licença do Marketplace "Traga sua própria licença" para as últimas 6M SELECT MonthStartDate, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS
Listar detalhes de uso com uso bruto da VM para o tipo de licença do Marketplace "Traga sua própria licença" para os últimos 6M SELECT MonthStartDate, RawUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Bring Your Own License’ AND OfferType NOT IN (‘Azure Applications’, ‘SaaS’) TIMESPAN LAST_6_MONTHS
Listar detalhes de uso com a Data de Uso, uso total normalizado diário e "Encargos Estendidos Estimados (PC/CC)" para planos pagos do último mês SELECT UsageDate, NormalizedUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST_MONTH
Listar detalhes de uso com a Data de Uso, uso bruto total diário e "Encargos Estendidos Estimados (PC/CC)" para planos pagos do último mês SELECT UsageDate, RawUsage, EstimatedExtendedChargePC FROM ISVUsage WHERE SKUBillingType = ‘Paid’ ORDER BY UsageDate DESC TIMESPAN LAST\_MONTH
Listar detalhes de uso com Nome da Oferta, uso normalizado de VM para o tipo de Licença do Marketplace "Cobrado por meio do Azure" para os últimos 6M SELECT OfferName, NormalizedUsage FROM ISVUsage WHERE MarketplaceLicenseType = ‘Billed Through Azure’ AND OfferName = ‘Example Offer Name’ TIMESPAN LAST_6_MONTHS
Listar detalhes de uso com Nome da Oferta, uso limitado para os últimos 6M SELECT OfferName, MeteredUsage FROM ISVUsage WHERE OfferName = ‘Example Offer Name’ AND OfferType IN (‘SaaS’, ‘Azure Applications’) TIMESPAN LAST_6_MONTHS
Listar todos os detalhes de uso da oferta de todas as ofertas para os últimos 6M SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage ORDER BY UsageDate DESC TIMESPAN LAST_MONTH
Listar todos os detalhes de uso da oferta de ofertas privadas para os últimos 6M SELECT OfferType, OfferName, SKU, IsPrivateOffer, UsageReference, UsageDate, RawUsage, EstimatedPricePC FROM ISVUsage WHERE IsPrivateOffer = '1' ORDER BY UsageDate DESC TIMESPAN LAST_MONTH

Consultas de relatório de pedidos

Essas consultas de exemplo se aplicam ao relatório Pedidos.

Descrição da consulta Consulta de exemplo
Listar detalhes do pedido para o tipo de licença do Azure como "Enterprise" para os últimos 6M SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE AzureLicenseType = 'Enterprise' TIMESPAN LAST_6_MONTHS
Listar detalhes do pedido para o tipo de licença do Azure como "Pagar como Você Vai" para os últimos 6M SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, OrderStatus, OrderCancelDate FROM ISVOrder WHERE AzureLicenseType = 'Pay as You Go' TIMESPAN LAST_6_MONTHS
Detalhes do Pedido de Lista para o nome da oferta específica para os últimos 6M SELECT AssetId, PurchaseRecordId, PurchaseRecordLineItemId , OrderPurchaseDate FROM ISVOrder WHERE OfferName = Contoso test Services' TIMESPAN LAST_6_MONTHS
Listar detalhes do Pedido para pedidos ativos para os últimos 6M SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS
Listar detalhes do Pedido para pedidos cancelados para os últimos 6M SELECT OfferName, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate FROM ISVOrder WHERE OrderStatus = 'Cancelled' TIMESPAN LAST_6_MONTHS
Detalhes do Pedido de Lista com quantidade, início do termo, data de término do prazo e gráficos estimados, moeda para os últimos 6M SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId, TermStartDate, TermEndDate, BilledRevenue, Currency from ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS
Listar detalhes do Pedido para pedidos de avaliação ativos para os últimos 6M SELECT AssetId, Quantity, PurchaseRecordId, PurchaseRecordLineItemId from ISVOrder WHERE OrderStatus = 'Active' and IsTrial = 'True' TIMESPAN LAST_6_MONTHS
Listar detalhes do Pedido para todas as ofertas que estão ativas para os últimos 6M SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS
Listar detalhes do Pedido para ofertas privadas ativas para os últimos 6M SELECT OfferName, SKU, IsPrivateOffer, AssetId, PurchaseRecordId, PurchaseRecordLineItemId, OrderPurchaseDate, BilledRevenue FROM ISVOrder WHERE IsPrivateOffer = '1' and OrderStatus = 'Active' TIMESPAN LAST_6_MONTHS

Consultas de relatório de receita

Essas consultas de exemplo se aplicam ao relatório receita.

Descrição da consulta Consulta de exemplo
Listar a receita cobrada do parceiro no último mês SELECT BillingAccountId, OfferName, OfferType, Revenue, EarningAmountCC, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId,TransactionAmountCC,TransactionAmountUSD, Quantity,Units FROM ISVRevenue TIMESPAN LAST_MONTH
Listar a receita estimada em USD de todas as transações com status enviado nos últimos 3 meses SELECT BillingAccountId, OfferName, OfferType, EstimatedRevenueUSD, EarningAmountUSD, PayoutStatus, PurchaseRecordId, LineItemId, TransactionAmountUSD FROM ISVRevenue where PayoutStatus='Sent' TIMESPAN LAST_3_MONTHS
Lista de transações sem avaliação para o modelo de cobrança baseado em assinatura SELECT BillingAccountId, OfferName,OfferType, TrialDeployment EstimatedRevenueUSD, EarningAmountUSD FROM ISVRevenue WHERE TrialDeployment=’False’ and BillingModel=’SubscriptionBased’

Consultas de relatório de qualidade do serviço

Esta consulta de exemplo se aplica ao relatório qualidade do serviço.

Descrição da consulta Consulta de exemplo
Listar o status de implantação de ofertas dos últimos 6 meses SELECT OfferId, Sku, DeploymentStatus, DeploymentCorrelationId, SubscriptionId, CustomerTenantId, CustomerName, TemplateType, StartTime, EndTime, DeploymentDurationInMilliSeconds, DeploymentRegion FROM ISVQualityOfService TIMESPAN LAST_6_MONTHS

Consultas de relatório de retenção do cliente

Esta consulta de exemplo se aplica ao relatório de retenção do cliente.

Descrição da consulta Consulta de exemplo
Listar detalhes de retenção do cliente para os últimos 6 meses SELECT OfferCategory, OfferName, ProductId, DeploymentMethod, ServicePlanName, Sku, SkuBillingType, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode, FirstUsageDate, AzureLicenseType, OfferType, Offset FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS
Listar a atividade de uso e os detalhes de receita de todos os clientes nos últimos 6 meses SELECT OfferCategory, OfferName, Sku, ProductId, OfferType, FirstUsageDate, Offset, CustomerId, CustomerName, CustomerCompanyName, CustomerCountryName, CustomerCountryCode, CustomerCurrencyCode FROM ISVOfferRetention TIMESPAN LAST_6_MONTHS