Query Billing Account - Query Billing Account

서비스:: Cost Management

API 버전:: 2018-05-31

청구 계정의 사용량 현황 데이터를 나열합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingAccountId	path	True	string	청구 계정 ID
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2018-05-31입니다.

요청 본문

Name	필수	형식	Description
timeframe	True	TimeframeType	보고서의 데이터를 끌어당기는 데 걸리는 시간 프레임입니다. 사용자 지정인 경우 특정 기간을 제공해야 합니다.
type	True	ReportType	보고서의 형식입니다.
dataset		ReportConfigDataset	이 보고서 구성의 데이터에 대한 정의가 있습니다.
timePeriod		ReportConfigTimePeriod	보고서의 데이터를 끌어당기는 기간이 있습니다.

응답

Name	형식	Description
200 OK	QueryResult	그래. 요청이 성공했습니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

BillingAccountQuery

샘플 요청

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"
            ]
          }
        }
      ]
    }
  }
}

샘플 응답

상태 코드:: 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
          ]
        ]
      }
    }
  ]
}

정의

Name	Description
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.
FunctionType	사용할 집계 함수의 이름입니다.
GranularityType	보고서의 행 세분성입니다.
OperatorType	비교에 사용할 연산자입니다.
Query
QueryColumn
QueryResult	쿼리의 결과입니다. 그룹화 및 집계 아래에 나열된 모든 열이 포함됩니다.
ReportConfigAggregation	보고서에 사용할 집계 식입니다.
ReportConfigColumnType	보고서에 있는 열의 형식입니다.
ReportConfigComparisonExpression	보고서에 사용할 비교 식입니다.
ReportConfigDataset	보고서에 있는 데이터의 정의입니다.
ReportConfigDatasetConfiguration	보고서의 데이터 세트 구성입니다.
ReportConfigDefinition	보고서 구성의 정의입니다.
ReportConfigFilter	보고서에 사용할 필터 식입니다.
ReportConfigGrouping	보고서에 사용할 식별 그룹입니다.
ReportConfigTimePeriod	보고서의 데이터를 끌어서 가져오기 위한 시작 및 종료 날짜입니다.
ReportType	보고서의 형식입니다.
TimeframeType	보고서의 데이터를 끌어당기는 데 걸리는 시간 프레임입니다. 사용자 지정인 경우 특정 기간을 제공해야 합니다.

ErrorDetails

Object

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

ErrorResponse

Object

오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

Name	형식	Description
error	ErrorDetails	오류의 세부 정보입니다.

FunctionType

열거형

사용할 집계 함수의 이름입니다.

값	Description
Sum

GranularityType

열거형

보고서의 행 세분성입니다.

값	Description
Daily

OperatorType

열거형

비교에 사용할 연산자입니다.

값	Description
In

Query

Object

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.columns	QueryColumn[]	열 배열
properties.nextLink	string
properties.rows	Rows[]
tags	object	리소스 태그.
type	string	리소스 종류입니다.

QueryColumn

Object

Name	형식	Description
name	string
type	string

QueryResult

Object

쿼리의 결과입니다. 그룹화 및 집계 아래에 나열된 모든 열이 포함됩니다.

Name	형식	Description
value	Query[]	사용량 현황 데이터 목록입니다.

ReportConfigAggregation

Object

보고서에 사용할 집계 식입니다.

Name	형식	Description
function	FunctionType	사용할 집계 함수의 이름입니다.
name	string	집계할 열의 이름입니다.

ReportConfigColumnType

열거형

보고서에 있는 열의 형식입니다.

값	Description
Tag
Dimension

ReportConfigComparisonExpression

Object

보고서에 사용할 비교 식입니다.

Name	형식	Description
name	string	비교할 열의 이름입니다.
operator	OperatorType	비교에 사용할 연산자입니다.
values	string[]	비교에 사용할 값 배열

ReportConfigDataset

Object

보고서에 있는 데이터의 정의입니다.

Name	형식	Description
aggregation	<string, ReportConfigAggregation>	보고서에서 사용할 집계 식의 사전입니다. 사전에 있는 각 항목의 키는 집계된 열의 별칭입니다. 보고서에는 최대 2개의 집계 절이 있을 수 있습니다.
configuration	ReportConfigDatasetConfiguration	보고서의 데이터에 대한 구성 정보가 있습니다. 집계 및 그룹화가 제공되면 구성이 무시됩니다.
filter	ReportConfigFilter	보고서에 사용할 필터 식이 있습니다.
granularity	GranularityType	보고서의 행 세분성입니다.
grouping	ReportConfigGrouping[]	보고서에 사용할 식별 그룹 배열입니다. 보고서에는 절별로 최대 2개의 그룹화가 있을 수 있습니다.

ReportConfigDatasetConfiguration

Object

보고서의 데이터 세트 구성입니다.

Name	형식	Description
columns	string[]	보고서에 포함할 열 이름의 배열입니다. 유효한 보고서 열 이름은 허용됩니다. 제공되지 않으면 보고서에 모든 열이 포함됩니다.

ReportConfigDefinition

Object

보고서 구성의 정의입니다.

Name	형식	Description
dataset	ReportConfigDataset	이 보고서 구성의 데이터에 대한 정의가 있습니다.
timePeriod	ReportConfigTimePeriod	보고서의 데이터를 끌어당기는 기간이 있습니다.
timeframe	TimeframeType	보고서의 데이터를 끌어당기는 데 걸리는 시간 프레임입니다. 사용자 지정인 경우 특정 기간을 제공해야 합니다.
type	ReportType	보고서의 형식입니다.

ReportConfigFilter

Object

보고서에 사용할 필터 식입니다.

Name	형식	Description
and	ReportConfigFilter[]	논리적 "AND" 식입니다. 항목이 2개 이상 있어야 합니다.
dimension	ReportConfigComparisonExpression	차원에 대한 비교 식이 있습니다.
not	ReportConfigFilter	논리적 "NOT" 식입니다.
or	ReportConfigFilter[]	논리적 "OR" 식입니다. 항목이 2개 이상 있어야 합니다.
tag	ReportConfigComparisonExpression	태그에 대한 비교 식이 있습니다.

ReportConfigGrouping

Object

보고서에 사용할 식별 그룹입니다.

Name	형식	Description
columnType	ReportConfigColumnType	그룹화할 열의 형식이 있습니다.
name	string	그룹화할 열의 이름입니다.

ReportConfigTimePeriod

Object

보고서의 데이터를 끌어서 가져오기 위한 시작 및 종료 날짜입니다.

Name	형식	Description
from	string (date-time)	데이터를 끌어올 시작 날짜입니다.
to	string (date-time)	데이터를 끌어올 종료 날짜입니다.

ReportType

열거형

보고서의 형식입니다.

값	Description
Usage

TimeframeType

열거형

보고서의 데이터를 끌어당기는 데 걸리는 시간 프레임입니다. 사용자 지정인 경우 특정 기간을 제공해야 합니다.

값	Description
WeekToDate
MonthToDate
YearToDate
Custom

다음을 통해 공유

Query Billing Account - Query Billing Account

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

BillingAccountQuery

샘플 요청

샘플 응답

정의

ErrorDetails

ErrorResponse

FunctionType

GranularityType

OperatorType

Query

QueryColumn

QueryResult

ReportConfigAggregation

ReportConfigColumnType

ReportConfigComparisonExpression

ReportConfigDataset

ReportConfigDatasetConfiguration

ReportConfigDefinition

ReportConfigFilter

ReportConfigGrouping

ReportConfigTimePeriod

ReportType

TimeframeType