New-AzCostManagementDetailReport
이 API는 이전에 릴리스된 모든 사용량 세부 정보 API를 대체합니다. 특정 범위에서 제공된 날짜 범위, 청구 기간(기업 고객만 해당) 또는 청구서 ID에 대한 비용 세부 정보 보고서를 비동기적으로 생성하도록 요청합니다. 보고서를 요청하는 초기 호출은 '위치' 및 'Retry-After' 헤더가 있는 202를 반환합니다. '위치' 헤더는 폴링할 엔드포인트를 제공하여 보고서 생성 결과를 가져옵니다. 'Retry-After'는 생성된 보고서를 폴링하기 전에 대기하는 기간을 제공합니다. 보고서 작업을 폴링하는 호출은 작업이 아직 진행 중인 경우 '위치' 헤더와 함께 202 응답을 제공합니다. 보고서 생성 작업이 완료되면 폴링 엔드포인트는 다운로드할 수 있는 보고서 Blob에 대한 세부 정보와 함께 200개 응답을 제공합니다. 다운로드할 수 있는 파일에 대한 세부 정보는 폴링 응답 본문에서 확인할 수 있습니다.
구문
New-AzCostManagementDetailReport
-Scope <String>
[-BillingPeriod <String>]
[-InvoiceId <String>]
[-Metric <CostDetailsMetricType>]
[-TimePeriodEnd <String>]
[-TimePeriodStart <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 API는 이전에 릴리스된 모든 사용량 세부 정보 API를 대체합니다. 특정 범위에서 제공된 날짜 범위, 청구 기간(기업 고객만 해당) 또는 청구서 ID에 대한 비용 세부 정보 보고서를 비동기적으로 생성하도록 요청합니다. 보고서를 요청하는 초기 호출은 '위치' 및 'Retry-After' 헤더가 있는 202를 반환합니다. '위치' 헤더는 폴링할 엔드포인트를 제공하여 보고서 생성 결과를 가져옵니다. 'Retry-After'는 생성된 보고서를 폴링하기 전에 대기하는 기간을 제공합니다. 보고서 작업을 폴링하는 호출은 작업이 아직 진행 중인 경우 '위치' 헤더와 함께 202 응답을 제공합니다. 보고서 생성 작업이 완료되면 폴링 엔드포인트는 다운로드할 수 있는 보고서 Blob에 대한 세부 정보와 함께 200개 응답을 제공합니다. 다운로드할 수 있는 파일에 대한 세부 정보는 폴링 응답 본문에서 확인할 수 있습니다.
예제
예제 1: 특정 범위에서 제공된 날짜 범위, 청구 기간(기업 고객만 해당) 또는 청구서 ID에 대한 비용 세부 정보 보고서를 비동기적으로 생성하도록 요청
New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"이 명령은 특정 범위에서 제공된 날짜 범위, 청구 기간(기업 고객만 해당) 또는 청구서 ID에 대한 비용 세부 정보 보고서를 비동기적으로 생성하도록 요청합니다.
매개 변수
-AsJob
작업으로 명령 실행
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-BillingPeriod
이 매개 변수는 기업계약 고객만 사용할 수 있습니다. YearMonth(예: 202008) 형식을 사용합니다. 이 매개 변수는 invoiceId 또는 timePeriod 매개 변수와 함께 사용할 수 없습니다. timePeriod, invoiceId 또는 billingPeriod 매개 변수가 요청 본문에 제공되지 않으면 API는 현재 월의 비용을 반환합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultProfile
DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.
| 형식: | PSObject |
| 별칭: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InvoiceId
이 매개 변수는 Microsoft 고객 계약 고객만 사용할 수 있습니다. 또한 청구 프로필 또는 고객 범위에서만 사용할 수 있습니다. 이 매개 변수는 billingPeriod 또는 timePeriod 매개 변수와 함께 사용할 수 없습니다. timePeriod, invoiceId 또는 billingPeriod 매개 변수가 요청 본문에 제공되지 않으면 API는 현재 월의 비용을 반환합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Metric
자세한 보고서의 형식입니다. 기본적으로 ActualCost가 제공됩니다.
| 형식: | CostDetailsMetricType |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NoWait
명령을 비동기적으로 실행
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Scope
사용량 세부 정보 작업과 관련된 범위입니다. 여기에는 구독 범위에 대한 '/subscriptions/{subscriptionId}/', 청구 계정 범위의 경우 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}', 부서 범위의 경우 '/providers/Microsoft.Billing/departments/{departmentId}', EnrollmentAccount 범위의 경우 '/providers/Microsoft.Billing/enrollmentAccountId}'가 포함됩니다. 또한 최신 상거래 계정 범위는 billingAccount 범위에 대한 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}', billingProfile 범위의 경우 '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfileId}'입니다. invoiceSection 범위에 대한 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' 및 'providers/Microsoft. 파트너에 대한 청구/billingAccounts/{billingAccountId}/customers/{customerId}'
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimePeriodEnd
데이터를 끌어올 종료 날짜입니다. 예제 형식 2020-03-15
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimePeriodStart
데이터를 끌어올 시작 날짜입니다. 예제 형식 2020-03-15
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
출력
Azure PowerShell