다음을 통해 공유

테넌트 리소스 사용 API 참조

  • 아티클

테넌트는 테넌트 API를 사용하여 테넌트의 리소스 사용량 현황 데이터를 볼 수 있습니다. 이러한 API는 Azure 사용량 API와 일치합니다.

Azure와 마찬가지로 Windows PowerShell cmdlet Get-UsageAggregates 를 사용하여 사용량 현황 데이터를 가져올 수 있습니다.

API 호출

요청

요청은 요청된 구독 및 요청된 시간 프레임에 대한 사용량 세부 정보를 가져옵니다. 요청 본문이 없습니다.

방법 요청 URI
GET https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce/usageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&agregationGranularity={granularity}&api-version=2015-06-01-preview&continuationToken={token-value}

매개 변수

매개 변수 설명
Armendpoint Azure Stack Hub 환경의 Azure Resource Manager 엔드포인트입니다. Azure Stack Hub 규칙은 Azure Resource Manager 엔드포인트의 이름이 형식 https://management.{domain-name}입니다. 예를 들어 개발 키트의 경우 도메인 이름은 local.azurestack.external이고 Resource Manager 엔드포인트는 다음과 같습니다 https://management.local.azurestack.external.
subId 호출하는 사용자의 구독 ID입니다. 이 API를 사용하여 단일 구독의 사용량을 쿼리할 수 있습니다. 공급자는 공급자 리소스 사용량 API를 사용하여 모든 테넌트에 대한 사용량을 쿼리할 수 있습니다.
reportedStartTime 쿼리의 시작 시간입니다. DateTime의 값은 UTC 및 시간 시작 부분(예: 13:00)이어야 합니다. 일별 집계의 경우 이 값을 UTC 자정으로 설정합니다. 이 형식은 ISO 8601에서 이스케이프됩니다. 예를 들어 2015-06-16T18%3a53%3a11%2b00%3a00Z입니다. 여기서 콜론은 %3a로 이스케이프되고 더하기는 %2b로 이스케이프되어 URI에 친숙합니다.
reportedEndTime 쿼리의 종료 시간입니다. reportedStartTime에 적용되는 제약 조건도 이 매개 변수에 적용됩니다. reportedEndTime의 값은 나중에 사용할 수 없습니다.
aggregationGranularity 두 개의 불연속 잠재적인 값이 있는 선택적 매개 변수: 매일 및 매시간. 값이 제안하는 것처럼, 하나는 일별 세분성으로 데이터를 반환하고 다른 하나는 시간 단위 해상도입니다. 일별 옵션이 기본값입니다.
api-version 이 요청을 수행하는 데 사용되는 프로토콜의 버전입니다. 2015-06-01-preview를 사용해야 합니다.
continuationToken 사용량 API 공급자에 대한 마지막 호출에서 검색된 토큰입니다. 이 토큰은 응답이 1000줄보다 클 때 필요합니다. 진행을 위한 책갈피 역할을 합니다. 데이터가 없으면 전달된 세분성에 따라 하루 또는 시간 시작부터 데이터가 검색됩니다.

응답

GET
/subscriptions/sub1/providers/Microsoft.Commerce/UsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&api-version=1.0

{
"value": [
{

"id":
"/subscriptions/sub1/providers/Microsoft.Commerce/UsageAggregate/sub1-meterID1",
"name": "sub1-meterID1",
"type": "Microsoft.Commerce/UsageAggregate",

"properties": {
"subscriptionId":"sub1",
"usageStartTime": "2015-03-03T00:00:00+00:00",
"usageEndTime": "2015-03-04T00:00:00+00:00",
"instanceData":"{\"Microsoft.Resources\":{\"resourceUri\":\"resourceUri1\",\"location\":\"Alaska\",\"tags\":null,\"additionalInfo\":null}}",
"quantity":2.4000000000,
"meterId":"meterID1"

}
},

...

응답 정보

매개 변수 설명
id 사용량 집계의 고유 ID입니다.
name 사용 현황 집계의 이름입니다.
type 리소스 정의입니다.
subscriptionId Azure 사용자의 구독 식별자입니다.
usageStartTime 이 사용량 집계가 속한 사용량 버킷의 UTC 시작 시간입니다.
usageEndTime 이 사용량 집계가 속한 사용량 버킷의 UTC 종료 시간입니다.
instanceData 인스턴스 세부 정보의 키-값 쌍(새 형식):
resourceUri: 리소스 그룹 및 인스턴스 이름을 포함하여 정규화된 리소스 ID입니다.
location: 이 서비스가 실행된 지역입니다.
태그: 사용자가 지정하는 리소스 태그입니다.
additionalInfo: 사용된 리소스에 대한 자세한 정보입니다. 예를 들어 OS 버전 또는 이미지 유형입니다.
quantity 이 시간 프레임에 사용된 리소스의 양입니다.
meterId 사용된 리소스의 고유 ID입니다(ResourceID라고도 함).

다음 단계