다음을 통해 공유

New-FinOpsCostExport 명령

New-FinOpsCostExport 명령은 지정된 범위에 대한 새 Cost Management 내보내기를 만듭니다.

이 명령은 다음 API 버전으로 테스트되었습니다.

  • 2023-07-01-preview(기본값) – FocusCost 및 기타 데이터 세트를 사용하도록 설정합니다.
  • 2023-08-01

구문

# Create a new daily/monthly export
New-FinOpsCostExport `
    [-Name] <string> `
    -Scope <string> `
    [-Dataset <string>] `
    [-DatasetVersion <string>] `
    [-DatasetFilters <hashtable>] `
    [-Monthly] `
    [-StartDate <DateTime>] `
    [-EndDate <DateTime>] `
    -StorageAccountId <string> `
    [-StorageContainer <string>] `
    [-StoragePath <string>] `
    [-Location] `
    [-DoNotPartition] `
    [-DoNotOverwrite] `
    [-Execute] `
    [-Backfill <int>] `
    [-ApiVersion <string>]

# Create a new one-time export
New-FinOpsCostExport `
    [-Name] <string> `
    -Scope <string> `
    [-Dataset <string>] `
    [-DatasetVersion <string>] `
    [-DatasetFilters <hashtable>] `
    -OneTime `
    -StartDate <DateTime> `
    -EndDate <DateTime> `
    -StorageAccountId <string> `
    [-StorageContainer <string>] `
    [-StoragePath <string>] `
    [-Location] `
    [-DoNotPartition] `
    [-ApiVersion <string>]

매개 변수

속성 설명
‑Name 필수입니다. 내보내기의 이름입니다.
‑Scope 필수입니다. 데이터를 내보낼 범위의 리소스 ID입니다.
‑Dataset 선택 사항. 내보낼 데이터 세트입니다. 허용되는 값 = "ActualCost", "AmortizedCost", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". 기본값 = "FocusCost".
‑DatasetVersion 선택 사항. 내보낼 데이터 세트의 스키마 버전입니다. 기본값 = "1.0"(FocusCost에만 적용됨).
‑DatasetFilters 선택 사항. 데이터 세트를 필터링할 키/값 쌍의 사전입니다. 2023-07-01-preview의 ReservationRecommendations 데이터 세트에만 적용됩니다. 유효한 필터는 reservationScope(공유 또는 단일), resourceType(예: VirtualMachines), lookBackPeriod(Last7Days, Last30Days, Last60Days)입니다.
‑CommitmentDiscountScope 선택 사항. 예약 권장 사항을 내보낼 때 사용할 예약 범위 필터입니다. 다른 내보내기 형식에 대해서는 무시됩니다. 허용되는 값: Shared, Single. 기본값: 공유.
‑CommitmentDiscountResourceType 선택 사항. 예약 권장 사항을 내보낼 때 사용할 예약 리소스 종류 필터입니다. 다른 내보내기 형식에 대해서는 무시됩니다. 기본값: VirtualMachines.
‑CommitmentDiscountLookback 선택 사항. 예약 권장 사항을 내보낼 때 사용할 예약 리소스 종류 필터입니다. 다른 내보내기 형식에 대해서는 무시됩니다. 허용되는 값: 7, 30, 60. 기본값: 30.
‑Monthly 선택 사항. 내보내기를 매일이 아닌 매월 실행해야 임을 나타냅니다. 가격, 예약 권장 사항 및 예약 트랜잭션에 대해서는 무시됩니다. 기본값은 False입니다.
‑OneTime 선택 사항. 내보내기를 한 번만 실행해야 했음을 나타냅니다. 설정되면 시작/종료 날짜는 데이터를 쿼리할 날짜입니다. -Monthly 옵션과 함께 사용할 수 없습니다.
‑StartDate 선택 사항. 내보내기 실행을 시작하는 날입니다. 기본값 = -OneTime이 설정된 경우 이전 달의 첫째 날입니다. 그렇지 않으면 내일(DateTime.Now.AddDays(1))입니다.
‑EndDate 선택 사항. 내보내기를 실행하기 위한 마지막 날입니다. 기본값 = -OneTime 설정된 경우 -StartDate 식별되는 월의 마지막 날입니다. 그렇지 않으면 -StartDate로부터 5년입니다.
‑StorageAccountId 필수입니다. 데이터를 내보낼 스토리지 계정의 리소스 ID입니다.
‑StorageContainer 선택 사항. 데이터를 내보낼 컨테이너의 이름입니다. 컨테이너가 없으면 만들어집니다. 기본값 = "cost-management".
‑StoragePath 선택 사항. 스토리지 컨테이너 내에서 데이터를 내보내는 경로입니다. 기본값 = (범위 ID).
‑DoNotPartition 선택 사항. 내보낸 데이터를 여러 파일로 분할할지 여부를 나타냅니다. 이 옵션은 분할을 사용하지 않도록 설정하는 것이므로 안정성을 위해 분할하는 것이 좋습니다. 기본값은 False입니다.
‑DoNotOverwrite 선택 사항. 현재 월에 대해 이전에 내보낸 데이터를 덮어쓸지 여부를 나타냅니다. 스토리지 크기 및 비용을 낮추려면 덮어쓰기를 사용하는 것이 좋습니다. 따라서 이 옵션은 덮어쓰기를 사용하지 않도록 설정하는 것입니다. FinOps 허브에 대한 내보내기를 만드는 경우 문제 해결을 개선하기 위해 -DoNotOverwrite 옵션을 지정하는 것이 좋습니다. 기본값은 False입니다.
‑SystemAssignedIdentity 선택 사항. 관리 ID를 사용하여 스토리지 계정에 데이터를 푸시해야 임을 나타냅니다. 방화벽 뒤에 있는 스토리지 계정을 사용하려면 관리 ID가 필요하지만 권한을 부여하려면 액세스 권한이 필요합니다(예: 소유자). 지정된 경우 관리 ID가 사용됩니다. 그렇지 않으면 관리 ID가 사용되지 않으며 내보내기가 방화벽 뒤에 있는 스토리지 계정에 데이터를 푸시할 수 없습니다. 기본값 = (비어 있음).
‑Location 선택 사항. 스토리지 계정에 데이터를 푸시하는 데 사용되는 관리 ID에 사용할 Azure 위치를 나타냅니다. 방화벽 뒤에 있는 스토리지 계정을 사용하려면 관리 ID가 필요하지만 권한을 부여하려면 액세스 권한이 필요합니다(예: 소유자). 지정된 경우 관리 ID가 사용됩니다. 그렇지 않으면 관리 ID가 사용되지 않으며 내보내기가 방화벽 뒤에 있는 스토리지 계정에 데이터를 푸시할 수 없습니다. 기본값 = (비어 있음).
‑Execute 선택 사항. 내보내기를 만든 직후 실행해야 임을 나타냅니다.
‑Backfill 선택 사항. 데이터를 내보낼 월 수입니다. 이 작업은 만들 때 한 번만 실행됩니다. 실패한 내보내기가 다시 시도되지 않습니다. -OneTime이 설정된 경우 지원되지 않습니다. 기본값 = 0.
‑ApiVersion 선택 사항. Cost Management Exports API를 호출할 때 사용할 API 버전입니다. 기본값 = 2023-07-01-preview.

예제

한 번 내보내기 만들기

New-FinopsCostExport -Name 'July2023OneTime' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet ActualCost `
    -OneTime `
    -StartDate "2023-07-01" `
    -EndDate "2023-07-31"

Dataset = Actual를 사용하여 2023-07-01에서 2023-07-31까지 'July2023OneTime'이라는 새 일회성 내보내기를 만들고 한 번 실행합니다.

매일 내보내기 만들기 및 실행

New-FinopsCostExport -Name 'DailyMTD' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet AmortizedCost `
    -EndDate "2024-12-31" `
    -Execute

StartDate = DateTime.Now 및 EndDate = 2024-12-31을 사용하여 Daily-MTD라는 예약된 새 내보내기를 만듭니다. 내보내기는 만든 직후 실행됩니다.

월별 내보내기 만들기

New-FinopsCostExport -Name 'Monthly-Report' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet AmortizedCost `
    -StartDate $(Get-Date).AddDays(5) `
    -EndDate "2024-08-15" `
    -Monthly `
    -Execute

DateTime.Now 및 EndDate 2024-08-15에서 StartDate = 1일을 사용하여 Monthly-Report라는 새 월별 내보내기를 만듭니다. 내보내기는 만든 직후 실행됩니다.

매일 내보내기 및 백필 4개월 만들기

New-FinopsCostExport -Name 'Daily--MTD' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet ActualCost `
    -StorageContainer "costreports" `
    -Backfill 4 `
    -Execute

StartDate = DateTime.Now 및 EndDate 5년 후 StartDate를 사용하여 Daily-MTD라는 새 일별 내보내기를 만듭니다. 또한 이전 4개월 동안의 비용 데이터를 내보내고 모든 결과를 지정된 스토리지 계정의 컨테이너에 costreports 저장합니다.


피드백 제공

빠른 검토를 통해 어떻게 하고 있는지 알려주세요. 이러한 검토를 사용하여 FinOps 도구 및 리소스를 개선하고 확장합니다.

피드백 제공

특정 항목을 찾고 있는 경우 기존 항목에 투표하거나 새 아이디어를 만듭니다. 다른 사용자와 아이디어를 공유하여 더 많은 표를 얻습니다. 우리는 가장 많은 표를 가진 아이디어에 초점을 맞추고 있습니다.

투표 또는 아이디어 제안


관련 콘텐츠

관련 제품:

관련 솔루션:


  • Last updated on