Udostępnij przez

Polecenie New-FinOpsCostExport

Polecenie New-FinOpsCostExport tworzy nowy eksport usługi Cost Management dla określonego zakresu.

To polecenie zostało przetestowane przy użyciu następujących wersji interfejsu API:

  • 2023-07-01-preview (ustawienie domyślne) — włącza fokusCost i inne zestawy danych.
  • 2023-08-01

Składnia

# 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>]

Parametry

Nazwa/nazwisko opis
‑Name Wymagane. Nazwa eksportu.
‑Scope Wymagane. Identyfikator zasobu zakresu do wyeksportowania danych.
‑Dataset Opcjonalny. Zestaw danych do wyeksportowania. Dozwolone wartości = "ActualCost", "AmortizedCost", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". Default = "FocusCost".
‑DatasetVersion Opcjonalny. Wersja schematu zestawu danych do wyeksportowania. Wartość domyślna = "1.0" (dotyczy tylko fokusu).
‑DatasetFilters Opcjonalny. Słownik par klucz/wartość do filtrowania zestawu danych za pomocą. Dotyczy tylko zestawu danych ReservationRecommendations w wersji 2023-07-01-preview. Prawidłowe filtry to reservationScope (udostępnione lub pojedyncze), resourceType (na przykład VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑CommitmentDiscountScope Opcjonalny. Filtr zakresu rezerwacji do użycia podczas eksportowania zaleceń dotyczących rezerwacji. Ignorowane dla innych typów eksportu. Dozwolone wartości: Współdzielona, Pojedyncza. Ustawienie domyślne: Udostępnione.
‑CommitmentDiscountResourceType Opcjonalny. Filtr typu zasobu rezerwacji do użycia podczas eksportowania zaleceń dotyczących rezerwacji. Ignorowane dla innych typów eksportu. Ustawienie domyślne: VirtualMachines.
‑CommitmentDiscountLookback Opcjonalny. Filtr typu zasobu rezerwacji do użycia podczas eksportowania zaleceń dotyczących rezerwacji. Ignorowane dla innych typów eksportu. Dozwolone wartości: 7, 30, 60. Wartość domyślna: 30.
‑Monthly Opcjonalny. Wskazuje, że eksport powinien być wykonywany co miesiąc (zamiast codziennie). Ignorowane w przypadku cen, zaleceń dotyczących rezerwacji i transakcji rezerwacji. Wartość domyślna : false.
‑OneTime Opcjonalny. Wskazuje, że eksport powinien być wykonywany tylko raz. Po ustawieniu daty rozpoczęcia/zakończenia to daty zapytania o dane. Nie można używać w połączeniu z opcją -Monthly.
‑StartDate Opcjonalny. Dzień rozpoczęcia uruchamiania eksportów. Wartość domyślna : pierwszy dzień poprzedniego miesiąca, jeśli ustawiono parametr -OneTime; w przeciwnym razie jutro (DateTime.Now.AddDays(1)).
‑EndDate Opcjonalny. Ostatni dzień uruchomienia eksportu. Ustawienie domyślne = ostatni dzień miesiąca zidentyfikowanego w -StartDate, jeśli -OneTime jest ustawiona; w przeciwnym razie 5 lat od -StartDate.
‑StorageAccountId Wymagane. Identyfikator zasobu konta magazynu do wyeksportowania danych.
‑StorageContainer Opcjonalny. Nazwa kontenera do wyeksportowania danych. Kontener zostanie utworzony, jeśli nie istnieje. Ustawienie domyślne = "cost-management".
‑StoragePath Opcjonalny. Ścieżka do eksportowania danych do kontenera magazynu. Default = (identyfikator zakresu).
‑DoNotPartition Opcjonalny. Wskazuje, czy chcesz podzielić wyeksportowane dane na wiele plików. Partycjonowanie jest zalecane w celu uzyskania niezawodności, więc ta opcja polega na wyłączeniu partycjonowania. Wartość domyślna : false.
‑DoNotOverwrite Opcjonalny. Wskazuje, czy zastąpić wcześniej wyeksportowane dane w bieżącym miesiącu. Zastępowanie jest zalecane, aby zachować rozmiar magazynu i koszty w dół, aby ta opcja polegała na wyłączeniu zastępowania. Jeśli tworzysz eksport dla centrów FinOps, zalecamy określenie opcji -DoNotOverwrite w celu ulepszenia rozwiązywania problemów. Wartość domyślna : false.
‑SystemAssignedIdentity Opcjonalny. Wskazuje, że tożsamość zarządzana powinna być używana do wypychania danych do konta magazynu. Tożsamość zarządzana jest wymagana do pracy z kontami magazynu za zaporą, ale wymagają dostępu do udzielania uprawnień (na przykład Właściciel). Jeśli zostanie określona, zostanie użyta tożsamość zarządzana; W przeciwnym razie tożsamość zarządzana nie zostanie użyta, a eksport nie będzie mógł wypychać danych do konta magazynu za zaporą. Wartość domyślna = (pusta).
‑Location Opcjonalny. Wskazuje lokalizację platformy Azure do użycia dla tożsamości zarządzanej używanej do wypychania danych do konta magazynu. Tożsamość zarządzana jest wymagana do pracy z kontami magazynu za zaporą, ale wymagają dostępu do udzielania uprawnień (na przykład Właściciel). Jeśli zostanie określona, zostanie użyta tożsamość zarządzana; W przeciwnym razie tożsamość zarządzana nie zostanie użyta, a eksport nie będzie mógł wypychać danych do konta magazynu za zaporą. Wartość domyślna = (pusta).
‑Execute Opcjonalny. Wskazuje, że eksport powinien być uruchamiany natychmiast po utworzeniu.
‑Backfill Opcjonalny. Liczba miesięcy, dla których mają być eksportowane dane. Jest to uruchamiane tylko raz w czasie tworzenia. Eksporty, które zakończyły się niepowodzeniem, nie są ponownie podejmowane. Nieobsługiwane, gdy ustawiono parametr -OneTime. Wartość domyślna : 0.
‑ApiVersion Opcjonalny. Wersja interfejsu API do użycia podczas wywoływania interfejsu API eksportów usługi Cost Management. Ustawienie domyślne = 2023-07-01-preview.

Przykłady

Tworzenie jednorazowego eksportu

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"

Tworzy nowy jednorazowy eksport o nazwie "July2023OneTime" z 2023-07-01 do 2023-07-31 z zestawem danych = actual i wykonaj go raz.

Tworzenie i uruchamianie codziennego eksportu

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

Tworzy nowy zaplanowany eksport o nazwie Daily-MTD z wartością StartDate = DateTime.Now i EndDate = 2024-12-31. Eksport jest uruchamiany natychmiast po utworzeniu.

Tworzenie eksportu miesięcznego

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

Tworzy nowy miesięczny eksport o nazwie Monthly-Report with StartDate = 1 day from DateTime.Now i EndDate 2024-08-15. Eksport jest uruchamiany natychmiast po utworzeniu.

Tworzenie codziennego eksportu i wypełniania kopii zapasowych przez cztery miesiące

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

Tworzy nowy codzienny eksport o nazwie Daily-MTD z wartością StartDate = DateTime.Now i EndDate 5 lat od daty rozpoczęcia. Ponadto wyeksportuj dane kosztów z poprzednich czterech miesięcy i zapisz wszystkie wyniki w costreports kontenerze określonego konta magazynu.


Prześlij opinię

Daj nam znać, w jaki sposób przeprowadzamy szybką recenzję. Te recenzje służą do ulepszania i rozszerzania narzędzi i zasobów FinOps.

Prześlij opinię

Jeśli szukasz czegoś konkretnego, zagłosuj na istniejący lub utwórz nowy pomysł. Podziel się pomysłami z innymi osobami, aby uzyskać więcej głosów. Skupiamy się na pomysłach z największą większością głosów.

głosuj lub sugerują pomysły


Powiązana zawartość

Powiązane produkty:

Powiązane rozwiązania:


  • Last updated on