테 넌 트 리소스 사용 API 참조Tenant resource usage API reference

테 넌 트는 테 넌 트 Api를 사용 하 여 테 넌 트의 고유한 리소스 사용 데이터를 볼 수 있습니다.A tenant can use the tenant APIs to view the tenant's own resource usage data. 이러한 Api는 Azure 사용량 Api와 일치 합니다.These APIs are consistent with the Azure usage APIs.

Azure에서와 마찬가지로 Windows PowerShell cmdlet UsageAggregates 를 사용 하 여 사용 데이터를 가져올 수 있습니다.You can use the Windows PowerShell cmdlet Get-UsageAggregates to get usage data, just like in Azure.

API 호출API call

요청Request

요청은 요청 된 구독 및 요청 된 시간 프레임에 대 한 사용량 세부 정보를 가져옵니다.The request gets consumption details for the requested subscriptions and for the requested time frame. 요청 본문은 없습니다.There is no request body.

방법Method 요청 URIRequest URI
GETGET https://{armendpoint}/subscription/{subId}/providers/usageAggregates? reportedStartTime = {reportedStartTime} &reportedEndTime = {reportedEndTime} &aggregationGranularity = {세분성} &api-version = 2015-06-01.txt-preview&continuationToken = {token-value}https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce/usageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&api-version=2015-06-01-preview&continuationToken={token-value}

매개 변수Parameters

매개 변수Parameter 설명Description
ArmendpointArmendpoint Azure Stack 허브 환경의 끝점을 Azure Resource Manager 합니다.Azure Resource Manager endpoint of your Azure Stack Hub environment. Azure Stack 허브 규칙은 Azure Resource Manager 끝점의 이름이 형식입니다 https://management.{domain-name} .The Azure Stack Hub convention is that the name of Azure Resource Manager endpoint is in the format https://management.{domain-name}. 예를 들어, 개발 키트의 경우 도메인 이름은 로컬 azurestack입니다. 외부에서 리소스 관리자 끝점은 https://management.local.azurestack.external 입니다.For example, for the development kit, the domain name is local.azurestack.external, then the Resource Manager endpoint is https://management.local.azurestack.external.
subIdsubId 호출을 수행 하는 사용자의 구독 ID입니다.Subscription ID of the user who is making the call. 이 API는 단일 구독의 사용량을 쿼리 하는 데만 사용할 수 있습니다.You can use this API only to query for a single subscription's usage. 공급자는 공급자 리소스 사용량 API를 사용 하 여 모든 테 넌 트의 사용을 쿼리할 수 있습니다.Providers can use the provider resource usage API to query usage for all tenants.
reportedStartTimereportedStartTime 쿼리의 시작 시간입니다.Start time of the query. DateTime 의 값은 UTC로 시작 하 고 시간 (분)의 시작 부분에 있어야 합니다. 예를 들면 13:00입니다.The value for DateTime should be in UTC and at the beginning of the hour; for example, 13:00. 매일 집계의 경우이 값을 UTC 자정으로 설정 합니다.For daily aggregation, set this value to UTC midnight. 형식은 이스케이프 된 ISO 8601입니다. 예를 들어 2015-06-16T18% 3a53% 3a53% 2b00% 3a00Z(여기서 콜론 은% 3a로 이스케이프 되 고 +는 URI를 알아보기 위해% 2b로 이스케이프 됨).The format is escaped ISO 8601; for example, 2015-06-16T18%3a53%3a11%2b00%3a00Z, where colon is escaped to %3a and plus is escaped to %2b so that it's URI friendly.
reportedEndTimereportedEndTime 쿼리의 종료 시간입니다.End time of the query. ReportedStartTime 에 적용 되는 제약 조건은이 매개 변수에도 적용 됩니다.The constraints that apply to reportedStartTime also apply to this parameter. ReportedEndTime 의 값은 미래 일 수 없습니다.The value for reportedEndTime can't be in the future.
aggregationGranularityaggregationGranularity 매일매시간 의 두 가지 불연속 가능한 값을 포함 하는 선택적 매개 변수입니다.Optional parameter that has two discrete potential values: daily and hourly. 값이 제안 하는 것 처럼, 하나는 일일 세분성으로 데이터를 반환 하 고 다른 하나는 시간별 해상도입니다.As the values suggest, one returns the data in daily granularity, and the other is an hourly resolution. 매일 옵션이 기본값입니다.The daily option is the default.
api-versionapi-version 이 요청을 수행 하는 데 사용 되는 프로토콜의 버전입니다.Version of the protocol that's used to make this request. 2015-06-01-미리 보기 를 사용 해야 합니다.You must use 2015-06-01-preview.
continuationTokencontinuationToken 사용 API 공급자에 대 한 마지막 호출에서 토큰을 검색 했습니다.Token retrieved from the last call to the usage API provider. 이 토큰은 응답이 1000 줄 보다 클 때 필요 합니다.This token is needed when a response is greater than 1,000 lines. 진행률에 대 한 책갈피 역할을 합니다.It acts as a bookmark for progress. 표시 되지 않는 경우에는 전달 된 세분성을 기준으로 날짜 또는 시간의 시작 부분에서 데이터를 검색 합니다.If not present, the data is retrieved from the beginning of the day or hour, based on the granularity passed in.

응답Response

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"

}
},

...

응답 세부 정보Response details

매개 변수Parameter 설명Description
idid 사용 집계의 고유 ID입니다.Unique ID of the usage aggregate.
namename 사용 현황 집계의 이름입니다.Name of the usage aggregate.
형식type 리소스 정의.Resource definition.
subscriptionIdsubscriptionId Azure 사용자의 구독 식별자입니다.Subscription identifier of the Azure user.
usageStartTimeusageStartTime 이 사용 집계가 속한 사용 버킷의 UTC 시작 시간입니다.UTC start time of the usage bucket to which this usage aggregate belongs.
usageEndTimeusageEndTime 이 사용 집계가 속한 사용 버킷의 UTC 종료 시간입니다.UTC end time of the usage bucket to which this usage aggregate belongs.
instanceDatainstanceData 인스턴스 정보의 키-값 쌍 (새 형식):Key-value pairs of instance details (in a new format):
resourceUri: 리소스 그룹 및 인스턴스 이름을 포함 하는 정규화 된 리소스 ID입니다.resourceUri: Fully qualified resource ID, including resource groups and instance name.
location:이 서비스가 실행 된 지역입니다.location: Region in which this service was run.
태그: 사용자가 지정 하는 리소스 태그입니다.tags: Resource tags that the user specifies.
additionalInfo: 사용 된 리소스에 대 한 자세한 내용입니다.additionalInfo: More details about the resource that was consumed. 예를 들어 OS 버전 또는 이미지 형식입니다.For example, OS version or image type.
quantityquantity 이 시간 프레임에서 발생 한 리소스 소비의 양입니다.Amount of resource consumption that occurred in this time frame.
meterIdmeterId 사용 된 리소스의 고유 ID ( ResourceID 라고도 함)입니다.Unique ID for the resource that was consumed (also called ResourceID).

다음 단계Next steps