로컬 사용 미터를 사용 하 여 Azure Stack 사용 분석Analyze Azure Stack usage with local usage meters

로컬 사용 데이터베이스에 저장 된 리소스를 사용 하는 구독에 대 한 정보입니다.Information about which subscriptions use which resources is stored in a local usage database. 관리자는이 데이터를 검색 하 여 리소스를 소비 중인 사용자를 분석할 수 있습니다.Administrators can retrieve this data to analyze which users are consuming resources.

API 호출 참조API call reference

요청Request

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

이 사용 API는 공급자 API 이므로 공급자 구독에서 호출자에 게 소유자, 참가자 또는 읽기 권한자 역할이 할당 되어야 합니다.This usage API is a provider API, so the caller must be assigned an Owner, Contributor, or Reader role in the provider's subscription.

방법Method 요청 URIRequest URI
GETGET 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}

인수Arguments

인수Argument DescriptionDescription
armendpoint Azure Stack 환경의 끝점을 Azure Resource Manager 합니다.Azure Resource Manager endpoint of your Azure Stack environment. Azure Stack 규칙은 Azure Resource Manager 끝점의 이름이 형식입니다 https://adminmanagement.{domain-name} .The Azure Stack convention is that the name of the Azure Resource Manager endpoint is in the format https://adminmanagement.{domain-name}.
subId 호출을 수행 하는 사용자의 구독 ID입니다.Subscription ID of the user who makes the call.
reportedStartTime 쿼리의 시작 시간입니다.Start time of the query. 값은 DateTime utc (협정 세계시)와 시간의 시작 부분 (예: 13:00)에 있어야 합니다.The value for DateTime should be in Coordinated Universal Time (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%3a11%2b00%3a00Z 콜론을로 이스케이프 하 %3a 고 더하기를로 이스케이프 하 여 URI를 친근 하 게 됩니다 %2b .The format is escaped ISO 8601; for example, 2015-06-16T18%3a53%3a11%2b00%3a00Z, where the colon is escaped to %3a and the plus is escaped to %2b so that it's URI-friendly.
reportedEndTime 쿼리의 종료 시간입니다.End time of the query. 에 적용 되는 제약 조건도 reportedStartTime 이 인수에 적용 됩니다.The constraints that apply to reportedStartTime also apply to this argument. 의 값은 reportedEndTime 미래 또는 현재 날짜 중 하나일 수 없습니다.The value for reportedEndTime can't be either in the future, or the current date. 이 경우 결과는 "처리 완료 안 함"으로 설정 됩니다.If it is, the result is set to "processing not complete."
aggregationGranularity 매일매시간 의 두 가지 불연속 가능한 값을 포함 하는 선택적 매개 변수입니다.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.
subscriberId 구독 ID가 표시됩니다.Subscription ID. 필터링 된 데이터를 가져오려면 공급자의 직접 테 넌 트의 구독 ID가 필요 합니다.To get filtered data, the subscription ID of a direct tenant of the provider is required. 구독 ID 매개 변수가 지정 되지 않은 경우이 호출은 모든 공급자의 직접 테 넌 트에 대 한 사용 데이터를 반환 합니다.If no subscription ID parameter is specified, the call returns usage data for all the provider's direct tenants.
api-version 이 요청을 수행 하는 데 사용 되는 프로토콜의 버전입니다.Version of the protocol that's used to make this request. 이 값은 2015-06-01-preview으로 설정됩니다.This value is set to 2015-06-01-preview.
continuationToken 사용 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 the progress. 토큰이 없으면 전달 된 세분성을 기준으로 날짜 또는 시간의 시작 부분에서 데이터를 검색 합니다.If the token isn't 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.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"

}
},

. . .

응답 세부 정보Response details

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

사용 정보 검색Retrieve usage information

PowerShellPowerShell

사용 현황 데이터를 생성 하려면 시스템을 실행 중이 고 적극적으로 사용 하는 리소스가 있어야 합니다. 예를 들어 활성 VM (가상 머신) 또는 일부 데이터가 포함 된 저장소 계정입니다.To generate the usage data, you should have resources that are running and actively using the system; for example, an active virtual machine (VM), or a storage account containing some data. Azure Stack marketplace에서 실행 중인 리소스가 있는지 확실 하지 않은 경우 VM을 배포 하 고 VM 모니터링 블레이드를 확인 하 여 실행 중인지 확인 합니다.If you're not sure whether you have any resources running in the Azure Stack marketplace, deploy a VM, and verify the VM monitoring blade to make sure it's running. 다음 PowerShell cmdlet을 사용 하 여 사용 현황 데이터를 볼 수 있습니다.Use the following PowerShell cmdlets to view the usage data:

  1. Azure Stack에 대 한 PowerShell을 설치합니다.Install PowerShell for Azure Stack.

  2. Azure Stack 사용자 또는 Azure Stack Operator PowerShell 환경을 구성 합니다.Configure the Azure Stack user or the Azure Stack operator PowerShell environment.

  3. 사용 데이터를 검색 하려면 AzsSubscriberUsage PowerShell cmdlet을 호출 합니다.To retrieve the usage data, call the Get-AzsSubscriberUsage PowerShell cmdlet:

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

REST APIREST API

Microsoft. 상거래 서비스를 호출 하 여 삭제 된 구독의 사용 정보를 수집할 수 있습니다.You can collect usage information for deleted subscriptions by calling the Microsoft.Commerce.Admin service.

활성 사용자에 대해 삭제 된 모든 테 넌 트 사용량 반환Return all tenant usage for deleted for active users

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

삭제 된 테 넌 트 또는 활성 테 넌 트의 사용량 반환Return usage for deleted or active tenant

방법Method 요청 URIRequest URI
GETGET 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