공급자 리소스 사용 API
용어 공급자 는 서비스 관리자 및 위임된 공급자에 적용됩니다. Azure Stack Hub 운영자 및 위임된 공급자는 공급자 사용량 API를 사용하여 직접 테넌트 사용량을 볼 수 있습니다. 예를 들어, 다음 다이어그램에 표시된 것처럼 P0는 공급자 API를 호출하여 P1 및 P2에 대한 직접 사용량 정보를 가져올 수 있고, P1은 P3 및 P4에 대한 사용량 정보를 요청할 수 있습니다.
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} |
인수
| 인수 | Description |
|---|---|
armendpoint |
Azure Stack Hub 환경의 Azure Resource Manager 엔드포인트입니다. Azure Stack Hub 규칙은 Azure Resource Manager 엔드포인트의 이름이 https://adminmanagement.{domain-name} 형식을 따르도록 지정합니다. 예를 들어 ASDK(Azure Stack Development Kit)의 경우 도메인 이름이 local.azurestack.external이면 Resource Manager 엔드포인트는 입니다https://adminmanagement.local.azurestack.external. |
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"
}
},
. . .
응답 세부 정보
| 인수 | Description |
|---|---|
id |
사용량 집계의 고유 ID입니다. |
name |
사용 현황 집계의 이름입니다. |
type |
리소스 정의입니다. |
subscriptionId |
Azure Stack Hub 사용자의 구독 식별자입니다. |
usageStartTime |
이 사용량 집계가 속한 사용량 버킷의 UTC 시작 시간입니다. |
usageEndTime |
이 사용량 집계가 속한 사용량 버킷의 UTC 종료 시간입니다. |
instanceData |
instance 세부 정보의 키-값 쌍(새 형식):resourceUri: 리소스 그룹 및 instance 이름을 포함하는 정규화된 리소스 ID입니다. location: 이 서비스를 실행한 지역입니다. tags: 사용자가 지정한 리소스 태그입니다. additionalInfo: 사용된 리소스에 대한 자세한 정보(예: OS 버전 또는 이미지 형식)입니다. |
quantity |
이 시간 프레임에 사용된 리소스의 양입니다. |
meterId |
사용한 리소스의 고유 ID(ResourceID)입니다. |
사용량 정보 검색
PowerShell
사용량 현황 데이터를 생성하려면 시스템을 실행하고 적극적으로 사용하는 리소스가 있어야 합니다. 예를 들어 활성 VM(가상 머신) 또는 일부 데이터가 포함된 스토리지 계정입니다. Azure Stack Hub Marketplace에서 실행되는 리소스가 있는지 확실하지 않은 경우 VM을 배포하고 VM 모니터링 블레이드를 확인하여 실행 중인지 확인합니다. 다음 PowerShell cmdlet을 사용하여 사용량 현황 데이터를 볼 수 있습니다.
Azure Stack Hub 사용자 또는 Azure Stack Hub 운영자 PowerShell 환경을 구성합니다.
사용량 데이터를 검색하려면 Get-AzsSubscriberUsage PowerShell cmdlet을 호출합니다.
Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
REST API
Microsoft.Commerce.관리 서비스를 호출하여 삭제된 구독에 대한 사용 정보를 수집할 수 있습니다.
활성 사용자에 대해 삭제된 에 대한 모든 테넌트 사용량 반환
| 메서드 | 요청 URI |
|---|---|
| GET | https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview |
삭제된 테넌트 또는 활성 테넌트 사용량 반환
| 메서드 | 요청 URI |
|---|---|
| GET | https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview |