Price Sheet - Get By Billing Period

참조

서비스:: Consumption

API 버전:: 2024-08-01

subscriptionId 및 청구 기간별로 범위에 대한 가격표를 가져옵니다. 가격표는 이 API를 통해 2014년 5월 1일 이상에만 사용할 수 있습니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

선택적 매개 변수:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}&api-version=2024-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
billingPeriodName	path	True	string	청구 기간 이름입니다.
subscriptionId	path	True	string	Azure 구독 ID입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다. 현재 버전은 2023-03-01입니다.
$expand	query		string	가격표 내에서 properties/meterDetails를 확장하는 데 사용할 수 있습니다. 기본적으로 이러한 필드는 가격표를 반환할 때 포함되지 않습니다.
$skiptoken	query		string	Skiptoken은 이전 작업에서 부분 결과를 반환한 경우에만 사용됩니다. 이전 응답에 nextLink 요소가 포함된 경우 nextLink 요소의 값에는 후속 호출에 사용할 시작점을 지정하는 skiptoken 매개 변수가 포함됩니다.
$top	query		integer (int32) minimum: 1 maximum: 1000	결과 수를 상위 N개 결과로 제한하는 데 사용할 수 있습니다.

응답

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

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

PriceSheetExpand

PriceSheetForBillingPeriod

PriceSheetExpand

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201801/providers/Microsoft.Consumption/pricesheets/default?$expand=meterDetails&api-version=2024-08-01

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31&$skiptoken=AQAAAA%3D%3D&$expand=properties/pricesheets/meterDetails",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1",
        "meterDetails": {
          "meterName": "Data Transfer Out (GB)",
          "meterCategory": "Networking",
          "unit": "GB",
          "meterLocation": "Zone 2",
          "totalIncludedQuantity": 0,
          "pretaxStandardRate": 0.138
        }
      }
    ]
  }
}

PriceSheetForBillingPeriod

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201801/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1"
      }
    ]
  }
}

정의

Name	Description
ErrorDetails	오류의 세부 정보입니다.
ErrorResponse	오류 응답은 서비스에서 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다. 일부 오류 응답: 429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다. 504 게이트웨이 시간 제한 - 요청을 처리하는 동안 서비스가 시간 초과되었습니다. 가능한 경우 요청의 날짜 범위를 줄입니다.
MeterDetails	미터 세부 정보의 속성입니다.
PriceSheetProperties	가격표의 속성입니다.
PriceSheetResult	가격표 리소스입니다.
SavingsPlan	SavingsPlan의 속성입니다.

ErrorDetails

Object

오류의 세부 정보입니다.

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

ErrorResponse

Object

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

일부 오류 응답:

429 TooManyRequests - 요청이 제한됩니다. "x-ms-ratelimit-microsoft.consumption-retry-after" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
503 ServiceUnavailable - 서비스를 일시적으로 사용할 수 없습니다. "Retry-After" 헤더에 지정된 시간을 기다린 후 다시 시도합니다.
504 게이트웨이 시간 제한 - 요청을 처리하는 동안 서비스가 시간 초과되었습니다. 가능한 경우 요청의 날짜 범위를 줄입니다.

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

MeterDetails

Object

미터 세부 정보의 속성입니다.

Name	형식	Description
meterCategory	string	미터의 범주(예: '클라우드 서비스', '네트워킹' 등)입니다.
meterLocation	string	Azure 서비스를 사용할 수 있는 위치입니다.
meterName	string	지정된 미터 범주 내의 미터 이름입니다.
meterSubCategory	string	미터의 하위 범주(예: 'A6 클라우드 서비스', 'ExpressRoute(IXP)' 등)입니다.
pretaxStandardRate	number (decimal)	세전 목록 가격입니다.
serviceName	string	서비스의 이름입니다.
serviceTier	string	서비스 계층입니다.
totalIncludedQuantity	number (decimal)	제품과 연결된 총 포함된 수량입니다.
unit	string	미터 사용량이 청구되는 단위(예: '시간', 'GB' 등)입니다.

PriceSheetProperties

Object

가격표의 속성입니다.

Name	형식	Description
billingPeriodId	string	사용량이 속한 청구 기간 리소스의 ID입니다.
currencyCode	string	통화 코드
includedQuantity	number (decimal)	제품에 대한 포함된 품질
meterDetails	MeterDetails	미터에 대한 세부 정보입니다. $expand 지정하지 않는 한 기본적으로 채워지지 않습니다.
meterId	string (uuid)	미터 ID(GUID)
offerId	string	제품 ID
partNumber	string	부품 번호
savingsPlan	SavingsPlan	SavingsPlan 세부 정보
unitOfMeasure	string	측정 단위
unitPrice	number (decimal)	단가

PriceSheetResult

Object

가격표 리소스입니다.

Name	형식	Description
etag	string	리소스의 etag입니다.
id	string	이벤트의 정규화된 ARM ID입니다.
name	string	이벤트를 고유하게 식별하는 ID입니다.
properties.download	MeterDetails	가격표 다운로드 세부 정보입니다.
properties.nextLink	string	결과의 다음 페이지에 대한 링크(URL)입니다.
properties.pricesheets	PriceSheetProperties[]	가격표
tags	object	리소스 태그.
type	string	리소스 종류입니다.

SavingsPlan

Object

SavingsPlan의 속성입니다.

Name	형식	Description
effectivePrice	number (decimal)	SavingsPlan 유효 가격
marketPrice	number (decimal)	SavingsPlan Market Price
term	string	SavingsPlan 용어

다음을 통해 공유

Price Sheet - Get By Billing Period

URI 매개 변수

응답

보안

azure_auth

범위

예제

PriceSheetExpand

샘플 요청

샘플 응답

PriceSheetForBillingPeriod

샘플 요청

샘플 응답

정의

ErrorDetails

ErrorResponse

MeterDetails

PriceSheetProperties

PriceSheetResult

SavingsPlan

추가 리소스