로컬 사용량 미터를 사용하여 Azure Stack 사용량 분석 - MDC(모듈식 데이터 센터)

로컬 사용 데이터베이스에 저장되는 리소스를 사용하는 구독에 대한 정보입니다. 관리자는 이 데이터를 검색하여 리소스를 사용하는 사용자를 분석할 수 있습니다.

API 호출 참조

요청

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

이 사용량 API는 공급자 API이므로 공급자 구독에서 호출자에게 소유자, 기여자 또는 읽기 권한 자 역할을 할당해야 합니다.

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

인수

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

응답

GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0
{
"value": [
{

"id":
"/subscriptions/sub1.1/providers/Microsoft.Commerce.Admin/UsageAggregate/sub1.1-

meterID1",
"name": "sub1.1-meterID1",
"type": "Microsoft.Commerce.Admin/UsageAggregate",

"properties": {
"subscriptionId":"sub1.1",
"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 Stack 사용자의 구독 식별자입니다.
usageStartTime 이 사용량 집계가 속한 사용량 버킷의 UTC 시작 시간입니다.
usageEndTime 이 사용량 집계가 속한 사용량 버킷의 UTC 종료 시간입니다.
instanceData 인스턴스 세부 정보의 키-값 쌍(새 형식):
resourceUri: 리소스 그룹 및 인스턴스 이름을 포함하는 정규화된 리소스 ID입니다.
location: 이 서비스를 실행한 지역입니다.
tags: 사용자가 지정한 리소스 태그입니다.
additionalInfo: 사용된 리소스에 대한 자세한 정보(예: OS 버전 또는 이미지 형식)입니다.
quantity 이 시간 프레임에 사용된 리소스의 양입니다.
meterId 사용한 리소스의 고유 ID(ResourceID)입니다.

사용량 정보 검색

PowerShell

사용량 현황 데이터를 생성하려면 시스템을 실행하고 적극적으로 사용하는 리소스가 있어야 합니다. 예를 들어 활성 VM(가상 머신) 또는 일부 데이터가 포함된 스토리지 계정입니다. Azure Stack 마켓플레이스에서 실행되는 리소스가 있는지 확실하지 않은 경우 VM을 배포하고 VM 모니터링 블레이드를 확인하여 실행 중인지 확인합니다. 다음 PowerShell cmdlet을 사용하여 사용량 현황 데이터를 봅니다.

  1. Azure Stack용 PowerShell을 설치합니다.

  2. Azure Stack 사용자 또는 Azure Stack 운영자 PowerShell 환경을 구성합니다.

  3. 사용량 데이터를 검색하려면 Get-AzsSubscriberUsage PowerShell cmdlet을 호출합니다.

    Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
    

REST API

Microsoft.Commerce.Admin 서비스를 호출하여 삭제된 구독에 대한 사용 정보를 수집할 수 있습니다.

활성 사용자에 대해 삭제된 모든 테넌트 사용량 반환

방법 요청 URI
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview

삭제된 테넌트 또는 활성 테넌트에 대한 사용량 반환

방법 요청 URI
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview