Поделиться через

Команда New-FinOpsCostExport

  • Статья

Команда New-FinOpsCostExport создает новый экспорт управления затратами для указанной области.

Эта команда была протестирована со следующими версиями 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 Обязательный. Идентификатор ресурса области для экспорта данных.
‑Dataset Необязательно. Экспорт набора данных. Допустимые значения = "ActualCost", "AmortizedCost". Default = "ActualCost".
‑DatasetVersion Необязательно. Версия схемы для экспорта набора данных. Default = (последняя версия по состоянию на июнь 2024 г., например "1.0" для FocusCost).
‑DatasetFilters Необязательно. Словарь пар "ключ-значение" для фильтрации набора данных. Применяется только к набору данных ReservationRecommendations в 2023-07-01-preview. Допустимые фильтры : reservationScope (shared или Single), resourceType (например, VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly Необязательно. Указывает, что экспорт должен выполняться ежемесячно (вместо ежедневного). Значение по умолчанию — false.
‑OneTime Необязательно. Указывает, что экспорт должен выполняться только один раз. Если задано, даты начала и окончания — это даты для запроса данных. Невозможно использовать с параметром -Monthly.
‑StartDate Необязательно. День запуска экспорта. По умолчанию = первый день предыдущего месяца, если задано значение -OneTime; в противном случае — завтра (DateTime.Now.AddDays(1)).
‑EndDate Необязательно. Последний день для выполнения экспорта. По умолчанию = последний день месяца, определенный в -StartDate, если задано значение -OneTime; в противном случае — пять лет с -StartDate.
‑StorageAccountId Обязательный. Идентификатор ресурса учетной записи хранения для экспорта данных.
‑StorageContainer Необязательно. Имя контейнера для экспорта данных в. Контейнер создается, если он не существует. По умолчанию = "управление затратами".
‑StoragePath Необязательно. Путь к экспорту данных в контейнер хранилища. По умолчанию = (идентификатор области).
‑Location Необязательно. Указывает расположение Azure, используемое для управляемого удостоверения, используемого для отправки данных в учетную запись хранения. Управляемое удостоверение требуется для работы с учетными записями хранения за брандмауэром, но требуется доступ для предоставления разрешений (например, владельца). При указании используется управляемое удостоверение; В противном случае управляемое удостоверение не используется, а экспорт не отправляет данные в учетную запись хранения за брандмауэром. По умолчанию = (пусто).
‑DoNotPartition Необязательно. Указывает, следует ли секционировать экспортированные данные в несколько файлов. Секционирование рекомендуется для надежности, поэтому этот параметр — отключить секционирование. Значение по умолчанию — false.
‑DoNotOverwrite Необязательно. Указывает, следует ли перезаписать ранее экспортированные данные за текущий месяц. Рекомендуется сохранить размер хранилища и затраты на перезапись, чтобы отключить перезапись. Значение по умолчанию — false.
‑Execute Необязательно. Указывает, что экспорт должен выполняться сразу после создания.
‑Backfill Необязательно. Количество месяцев для экспорта данных. Он выполняется только один раз во время создания. Неудачные экспорты не презряются. Не поддерживается, если задано значение -OneTime. Значение по умолчанию: 0.
‑Execute Необязательно. Указывает, что экспорт должен выполняться сразу после создания.
‑Backfill Необязательно. Количество месяцев для экспорта данных. Он выполняется только один раз во время создания. Неудачные экспорты не презряются. Не поддерживается, если задано значение -OneTime. Значение по умолчанию: 0.
‑ApiVersion Необязательно. Версия API для использования при вызове API экспорта затрат. Default = 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"

Создает новый однократный экспорт с именем "July2023OneTime" с 2023-07-01 по 2023-07-31 с набором данных = фактический и выполнить его один раз.

Создание и выполнение ежедневного экспорта

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

Создает новый запланированный экспорт с именем Daily-MTD с startDate = DateTime.Now и EndDate = 2024-12-31. Экспорт выполняется сразу после создания.

Создание ежемесячного экспорта

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

Создает новый ежемесячный экспорт с именем Monthly-Report с startDate = 1 день с DateTime.Now и EndDate 2024-08-15. Экспорт выполняется сразу после создания.

Создание ежедневного экспорта и резервного заполнения четырех месяцев

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

Создает новый ежедневный экспорт с именем Daily-MTD с startDate = DateTime.Now и EndDate 5 лет от StartDate. Кроме того, экспортируйте данные о затратах за предыдущие четыре месяца и сохраните все результаты в costreports контейнере указанной учетной записи хранения.


Связанный контент

Связанные продукты:

Связанные решения: