모든 Azure 사용 현황 분석 정보 가져오기

아티클
05/28/2024

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

고객을 위한 모든 Azure 사용 현황 분석 정보를 가져오는 방법입니다.

필수 구성 요소

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 사용자 자격 증명으로만 인증을 지원합니다.

REST 요청

요청 구문

방법	요청 URI
GET	{baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

URI 매개 변수

매개 변수	형식	Description
top	문자열	요청에서 반환할 데이터의 행의 수입니다. 지정되지 않은 경우 최대값 및 기본값은 10000입니다. 쿼리에 더 많은 행이 있는 경우 응답 본문에 데이터의 다음 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함되어 있습니다.
skip	int	쿼리에서 건너뛸 행의 수입니다. 이 매개 변수를 사용하여 큰 데이터 집합의 페이지를 탐색할 수 있습니다. 예를 들어 는 `top=10000 and skip=0` 데이터의 처음 10000개 행을 검색하고, `top=10000 and skip=10000` 다음 10,000개의 데이터 행을 검색하는 등의 작업을 합니다.
filter	문자열	요청의 filter 매개 변수에는 응답에서 행을 필터링하는 하나 이상의 문이 포함되어 있습니다. 각 문에는 또는 `ne` 연산자와 연결된 `eq` 필드와 값이 포함되며 또는 를 사용하여 `andor`문을 결합할 수 있습니다. 다음 문자열을 지정할 수 있습니다. `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` 예: `.../usage/azure?filter=meterCategory eq 'Data Management'` 예: `.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))`
aggregationLevel	문자열	집계 데이터를 검색할 시간 범위를 지정합니다. , `week`또는 `month`문자열 중 하나일 수 있습니다`day`. 지정하지 않으면 기본값은 `day`입니다. 매개 변수는 `aggregationLevel` 가 없으면 `groupby`지원되지 않습니다. 매개 변수는 `aggregationLevel` 에 있는 `groupby`모든 날짜 필드에 적용됩니다.
orderby	문자열	각 설치에 대한 결과 데이터 값의 순서를 지정하는 문입니다. 구문은 `...&orderby=field [order],field [order],...`입니다. 매개 변수는 `field` 다음 문자열 중 하나일 수 있습니다. `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` order 매개 변수는 선택 사항이며 각 필드에 대해 각각 오름차순 또는 내림차순을 지정하는 또는 `desc` 일 수 있습니다`asc`. 기본값은 `asc`입니다. 예: `...&orderby=meterCategory,meterUnit`
groupby	문자열	지정된 필드에 대한 데이터 집계에만 적용되는 문입니다. 다음 필드를 지정할 수 있습니다. `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` 반환된 데이터 행에는 매개 변수 및 Quantity에 `groupby` 지정된 필드가 포함됩니다. 매개 변수는 `groupby` 매개 변수와 함께 `aggregationLevel` 사용할 수 있습니다. 예: `...&groupby=meterCategory,meterUnit`

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

없음

요청 예제

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST 응답

성공하면 응답 본문에 Azure 사용량 리소스 컬렉션이 포함됩니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 오류 코드를 참조하세요.

응답 예제

{
  "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

추가 정보

파트너 센터 분석 - 리소스

다음을 통해 공유