다음을 통해 공유


TopItemsSummaryReportQueryFilter interface

쿼리 필터 매개 변수를 사용하여 TopItemsSummaryReport 쿼리를 구성합니다.

Extends

속성

categoryType

상위 내보내기 항목을 검색할 범주 유형을 지정합니다. CategoryTypeEnum에 정의된 지원되는 값을 참조하세요.

reportType

보고서 유형이 범주 유형별로 집계된 탄소 배출 데이터에 대한 상위 항목 요약 보고서임을 지정합니다.

topItems

배출량을 기준으로 반환할 상위 항목의 수입니다. 이 값은 1에서 10 사이여야 합니다.

상속된 속성

carbonScopeList

탄소 배출 범위 목록입니다. 필수 사항입니다. 목록 형식의 EmissionScopeEnum(예: Scope1, Scope2, Scope3)에서 하나 이상의 값을 허용합니다. 출력에는 지정된 범위에 대한 총 배출량이 포함됩니다.

dateRange

탄소 배출 데이터의 시작 및 종료 날짜입니다. 필수 사항입니다. ItemDetailsReport 및 TopItemsSummaryReport의 경우 한 번에 한 달의 데이터만 지원되므로 시작 및 종료 날짜는 DateRange 내에서 동일해야 합니다(예: 시작: 2024-06-01 및 끝: 2024-06-01).

locationList

각 위치가 소문자로 지정된 탄소 배출 데이터의 위치(Azure 지역 표시 이름) 목록입니다(예: 'east us'). 선택 사항입니다. 'az account list-locations -o table' 명령을 사용하여 Azure 지역 표시 이름을 찾을 수 있습니다.

resourceGroupUrlList

탄소 배출 데이터에 대한 리소스 그룹 URL 목록입니다. 선택 사항입니다. 각 URL은 '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}' 형식을 따라야 하며 모든 소문자여야 합니다.

resourceTypeList

탄소 배출 데이터에 대한 리소스 종류 목록입니다. 선택 사항입니다. 각 리소스 종류는 'microsoft' 형식에 따라 소문자로 지정해야 합니다. {service}/{resourceType}'( 예: 'microsoft.storage/storageaccounts')

subscriptionList

탄소 배출 데이터가 요청되는 구독 ID 목록입니다. 필수 사항입니다. 각 구독 ID는 소문자 형식이어야 합니다. 목록의 최대 길이는 100입니다.

속성 세부 정보

categoryType

상위 내보내기 항목을 검색할 범주 유형을 지정합니다. CategoryTypeEnum에 정의된 지원되는 값을 참조하세요.

categoryType: string

속성 값

string

reportType

보고서 유형이 범주 유형별로 집계된 탄소 배출 데이터에 대한 상위 항목 요약 보고서임을 지정합니다.

reportType: "TopItemsSummaryReport"

속성 값

"TopItemsSummaryReport"

topItems

배출량을 기준으로 반환할 상위 항목의 수입니다. 이 값은 1에서 10 사이여야 합니다.

topItems: number

속성 값

number

상속된 속성 세부 정보

carbonScopeList

탄소 배출 범위 목록입니다. 필수 사항입니다. 목록 형식의 EmissionScopeEnum(예: Scope1, Scope2, Scope3)에서 하나 이상의 값을 허용합니다. 출력에는 지정된 범위에 대한 총 배출량이 포함됩니다.

carbonScopeList: string[]

속성 값

string[]

다음에서 상속됨QueryFilter.carbonScopeList

dateRange

탄소 배출 데이터의 시작 및 종료 날짜입니다. 필수 사항입니다. ItemDetailsReport 및 TopItemsSummaryReport의 경우 한 번에 한 달의 데이터만 지원되므로 시작 및 종료 날짜는 DateRange 내에서 동일해야 합니다(예: 시작: 2024-06-01 및 끝: 2024-06-01).

dateRange: DateRange

속성 값

다음에서 상속됨QueryFilter.dateRange

locationList

각 위치가 소문자로 지정된 탄소 배출 데이터의 위치(Azure 지역 표시 이름) 목록입니다(예: 'east us'). 선택 사항입니다. 'az account list-locations -o table' 명령을 사용하여 Azure 지역 표시 이름을 찾을 수 있습니다.

locationList?: string[]

속성 값

string[]

다음에서 상속됨QueryFilter.locationList

resourceGroupUrlList

탄소 배출 데이터에 대한 리소스 그룹 URL 목록입니다. 선택 사항입니다. 각 URL은 '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}' 형식을 따라야 하며 모든 소문자여야 합니다.

resourceGroupUrlList?: string[]

속성 값

string[]

다음에서 상속됨QueryFilter.resourceGroupUrlList

resourceTypeList

탄소 배출 데이터에 대한 리소스 종류 목록입니다. 선택 사항입니다. 각 리소스 종류는 'microsoft' 형식에 따라 소문자로 지정해야 합니다. {service}/{resourceType}'( 예: 'microsoft.storage/storageaccounts')

resourceTypeList?: string[]

속성 값

string[]

다음에서 상속됨QueryFilter.resourceTypeList

subscriptionList

탄소 배출 데이터가 요청되는 구독 ID 목록입니다. 필수 사항입니다. 각 구독 ID는 소문자 형식이어야 합니다. 목록의 최대 길이는 100입니다.

subscriptionList: string[]

속성 값

string[]

다음에서 상속됨QueryFilter.subscriptionList