Query Billing Account - Query Billing Account

Hizmet:: Cost Management

API Sürümü:: 2018-05-31

Ödeme hesabının kullanım verilerini listeler.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/Query?api-version=2018-05-31

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
billingAccountId	path	True	string	FaturalamaHesap Kimliği
api-version	query	True	string	İstemci isteğiyle kullanılacak API'nin sürümü. Geçerli sürüm 2018-05-31'dir.

İstek Gövdesi

Name	Gerekli	Tür	Description
timeframe	True	TimeframeType	Rapor için veri çekme zaman çerçevesi. Özelse, belirli bir zaman aralığı sağlanmalıdır.
type	True	ReportType	Raporun türü.
dataset		ReportConfigDataset	Bu rapor yapılandırmasındaki verilerin tanımına sahiptir.
timePeriod		ReportConfigTimePeriod	Raporun verilerini çekmek için zaman aralığı vardır.

Yanıtlar

Name	Tür	Description
200 OK	QueryResult	TAMAM. İstek başarılı oldu.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

BillingAccountQuery

Örnek isteği

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/Query?api-version=2018-05-31

{
  "type": "Usage",
  "timeframe": "MonthToDate",
  "dataset": {
    "granularity": "Daily",
    "configuration": {
      "columns": [
        "PreTaxCost",
        "ResourceGroup",
        "UsageDate"
      ]
    },
    "filter": {
      "and": [
        {
          "or": [
            {
              "dimension": {
                "name": "ResourceLocation",
                "operator": "In",
                "values": [
                  "East US",
                  "West Europe"
                ]
              }
            },
            {
              "tag": {
                "name": "Environment",
                "operator": "In",
                "values": [
                  "UAT",
                  "Prod"
                ]
              }
            }
          ]
        },
        {
          "dimension": {
            "name": "ResourceGroup",
            "operator": "In",
            "values": [
              "API"
            ]
          }
        }
      ]
    }
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/Query/ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "name": "ad67fd91-c131-4bda-9ba9-7187ecb1cebd",
      "type": "microsoft.costmanagement/Query",
      "properties": {
        "nextLink": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/70664866/providers/Microsoft.CostManagement/Query?api-version=2018-05-31&$skiptoken=AQAAAA%3D%3D",
        "columns": [
          {
            "name": "PreTaxCost",
            "type": "Number"
          },
          {
            "name": "ResourceGroup",
            "type": "String"
          },
          {
            "name": "UsageDate",
            "type": "Number"
          }
        ],
        "rows": [
          [
            19.545363672276512,
            "JapanUnifia-Trial",
            20180331
          ],
          [
            173.41979241290323,
            "RVIIOT-TRIAL",
            20180331
          ],
          [
            20.35941656262545,
            "VSTSHOL-1595322048000",
            20180331
          ],
          [
            0.16677720329728665,
            "gs-stms-dev",
            20180331
          ]
        ]
      }
    }
  ]
}

Tanımlar

Name	Description
ErrorDetails	Hatanın ayrıntıları.
ErrorResponse	Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde sağlanır.
FunctionType	Kullanılacak toplama işlevinin adı.
GranularityType	Rapordaki satırların ayrıntı düzeyi.
OperatorType	Karşılaştırma için kullanılacak işleç.
Query
QueryColumn
QueryResult	Sorgunun sonucu. Gruplandırmalar ve toplama altında listelenen tüm sütunları içerir.
ReportConfigAggregation	Raporda kullanılacak toplama ifadesi.
ReportConfigColumnType	Rapordaki sütunun türü.
ReportConfigComparisonExpression	Raporda kullanılacak karşılaştırma ifadesi.
ReportConfigDataset	Raporda bulunan verilerin tanımı.
ReportConfigDatasetConfiguration	Rapordaki veri kümesinin yapılandırması.
ReportConfigDefinition	Rapor yapılandırmasının tanımı.
ReportConfigFilter	Raporda kullanılacak filtre ifadesi.
ReportConfigGrouping	Raporda kullanılacak ifadeye göre gruplandırma.
ReportConfigTimePeriod	Raporun verilerini çekmek için başlangıç ve bitiş tarihi.
ReportType	Raporun türü.
TimeframeType	Rapor için veri çekme zaman çerçevesi. Özelse, belirli bir zaman aralığı sağlanmalıdır.

ErrorDetails

Object

Hatanın ayrıntıları.

Name	Tür	Description
code	string	Hata kodu.
message	string	İşlemin neden başarısız olduğunu gösteren hata iletisi.

ErrorResponse

Object

Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde sağlanır.

Name	Tür	Description
error	ErrorDetails	Hatanın ayrıntıları.

FunctionType

Listeleme

Kullanılacak toplama işlevinin adı.

Değer	Description
Sum

GranularityType

Listeleme

Rapordaki satırların ayrıntı düzeyi.

Değer	Description
Daily

OperatorType

Listeleme

Karşılaştırma için kullanılacak işleç.

Değer	Description
In

Query

Object

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.columns	QueryColumn[]	Sütun dizisi
properties.nextLink	string
properties.rows	Rows[]
tags	object	Kaynak etiketleri.
type	string	Kaynak türü.

QueryColumn

Object

Name	Tür	Description
name	string
type	string

QueryResult

Object

Sorgunun sonucu. Gruplandırmalar ve toplama altında listelenen tüm sütunları içerir.

Name	Tür	Description
value	Query[]	Kullanım verilerinin listesi.

ReportConfigAggregation

Object

Raporda kullanılacak toplama ifadesi.

Name	Tür	Description
function	FunctionType	Kullanılacak toplama işlevinin adı.
name	string	Toplanmış sütunun adı.

ReportConfigColumnType

Listeleme

Rapordaki sütunun türü.

Değer	Description
Tag
Dimension

ReportConfigComparisonExpression

Object

Raporda kullanılacak karşılaştırma ifadesi.

Name	Tür	Description
name	string	Karşılaştırmada kullanılacak sütunun adı.
operator	OperatorType	Karşılaştırma için kullanılacak işleç.
values	string[]	Karşılaştırma için kullanılacak değer dizisi

ReportConfigDataset

Object

Raporda bulunan verilerin tanımı.

Name	Tür	Description
aggregation	<string, ReportConfigAggregation>	Raporda kullanılacak toplama ifadesinin sözlüğü. Sözlükteki her öğenin anahtarı, toplanan sütunun diğer adıdır. Raporda en fazla 2 toplama yan tümcesi olabilir.
configuration	ReportConfigDatasetConfiguration	Rapordaki veriler için yapılandırma bilgilerine sahiptir. Toplama ve gruplandırma sağlanırsa yapılandırma yoksayılır.
filter	ReportConfigFilter	Raporda kullanılacak filtre ifadesi vardır.
granularity	GranularityType	Rapordaki satırların ayrıntı düzeyi.
grouping	ReportConfigGrouping[]	Raporda kullanılacak ifadeye göre gruplandırma dizisi. Raporda en fazla 2 gruplandırma ölçütü yan tümcesi olabilir.

ReportConfigDatasetConfiguration

Object

Rapordaki veri kümesinin yapılandırması.

Name	Tür	Description
columns	string[]	Rapora eklenecek sütun adları dizisi. Geçerli bir rapor sütun adına izin verilir. Sağlanmadıysa, rapor tüm sütunları içerir.

ReportConfigDefinition

Object

Rapor yapılandırmasının tanımı.

Name	Tür	Description
dataset	ReportConfigDataset	Bu rapor yapılandırmasındaki verilerin tanımına sahiptir.
timePeriod	ReportConfigTimePeriod	Raporun verilerini çekmek için zaman aralığı vardır.
timeframe	TimeframeType	Rapor için veri çekme zaman çerçevesi. Özelse, belirli bir zaman aralığı sağlanmalıdır.
type	ReportType	Raporun türü.

ReportConfigFilter

Object

Raporda kullanılacak filtre ifadesi.

Name	Tür	Description
and	ReportConfigFilter[]	Mantıksal "AND" ifadesi. En az 2 öğe olmalıdır.
dimension	ReportConfigComparisonExpression	Boyut için karşılaştırma ifadesi var
not	ReportConfigFilter	Mantıksal "DEĞİl" ifadesi.
or	ReportConfigFilter[]	Mantıksal "OR" ifadesi. En az 2 öğe olmalıdır.
tag	ReportConfigComparisonExpression	Etiket için karşılaştırma ifadesi var

ReportConfigGrouping

Object

Raporda kullanılacak ifadeye göre gruplandırma.

Name	Tür	Description
columnType	ReportConfigColumnType	Gruplandıracak sütunun türüne sahiptir.
name	string	Gruplandıracak sütunun adı.

ReportConfigTimePeriod

Object

Raporun verilerini çekmek için başlangıç ve bitiş tarihi.

Name	Tür	Description
from	string (date-time)	Verileri çekmek için başlangıç tarihi.
to	string (date-time)	Verileri çekmek için bitiş tarihi.

ReportType

Listeleme

Raporun türü.

Değer	Description
Usage

TimeframeType

Listeleme

Rapor için veri çekme zaman çerçevesi. Özelse, belirli bir zaman aralığı sağlanmalıdır.

Değer	Description
WeekToDate
MonthToDate
YearToDate
Custom

Aracılığıyla paylaş

Query Billing Account - Query Billing Account

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

BillingAccountQuery

Örnek isteği

Örnek yanıt

Tanımlar

ErrorDetails

ErrorResponse

FunctionType

GranularityType

OperatorType

Query

QueryColumn

QueryResult

ReportConfigAggregation

ReportConfigColumnType

ReportConfigComparisonExpression

ReportConfigDataset

ReportConfigDatasetConfiguration

ReportConfigDefinition

ReportConfigFilter

ReportConfigGrouping

ReportConfigTimePeriod

ReportType

TimeframeType