Compartilhar via

Comando New-FinOpsCostExport

  • Artigo

O comando New-FinOpsCostExport cria uma nova exportação do Gerenciamento de Custos para o escopo especificado.

Este comando foi testado com as seguintes versões de API:

  • 2023-07-01-preview (padrão) – Habilita FocusCost e outros conjuntos de dados.
  • 2023-08-01

Sintaxe

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

Parâmetros

Nome Descrição
‑Name Obrigatória. Nome da exportação.
‑Scope Obrigatória. ID do recurso do escopo para o qual exportar dados.
‑Dataset Opcional. Conjunto de dados a ser exportado. Valores permitidos = "ActualCost", "AmortizedCost". Padrão = "Custo Real".
‑DatasetVersion Opcional. Versão do esquema do conjunto de dados a ser exportado. Padrão = (versão mais recente em junho de 2024; por exemplo, "1.0" para FocusCost).
‑DatasetFilters Opcional. Dicionário de pares chave/valor para filtrar o conjunto de dados. Aplica-se apenas ao conjunto de dados ReservationRecommendations em 2023-07-01-preview. Os filtros válidos são reservationScope (Shared ou Single), resourceType (por exemplo, VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly Opcional. Indica que a exportação deve ser executada mensalmente (em vez de diariamente). Padrão = falso.
‑OneTime Opcional. Indica que a exportação deve ser executada apenas uma vez. Quando definidas, as datas de início/término são as datas para consultar os dados. Não pode ser usado com a opção -Monthly.
‑StartDate Opcional. Dia para começar a executar exportações. Padrão = Primeiro dia do mês anterior se -OneTime estiver definido; caso contrário, amanhã (DateTime.Now.AddDays(1)).
‑EndDate Opcional. Último dia para executar a exportação. Padrão = Último dia do mês identificado em -StartDate se -OneTime estiver definido; caso contrário, cinco anos a partir de -StartDate.
‑StorageAccountId Obrigatória. ID do recurso da conta de armazenamento para a qual exportar dados.
‑StorageContainer Opcional. Nome do contêiner para o qual exportar dados. O contêiner será criado se não existir. Padrão = "gerenciamento de custos".
‑StoragePath Opcional. Caminho para exportar dados dentro do contêiner de armazenamento. Padrão = (ID do escopo).
‑Location Opcional. Indica o local do Azure a ser usado para a identidade gerenciada usada para enviar dados por push para a conta de armazenamento. A identidade gerenciada é necessária para trabalhar com contas de armazenamento protegidas por um firewall, mas requer acesso para conceder permissões (por exemplo, Proprietário). Se especificado, a identidade gerenciada será usada; Caso contrário, a identidade gerenciada não será usada e sua exportação não enviará dados por push para uma conta de armazenamento protegida por um firewall. Padrão = (vazio).
‑DoNotPartition Opcional. Indica se os dados exportados devem ser particionados em vários arquivos. O particionamento é recomendado para confiabilidade, portanto, essa opção é para desabilitar o particionamento. Padrão = falso.
‑DoNotOverwrite Opcional. Indica se os dados exportados anteriormente devem ser substituídos para o mês atual. A substituição é recomendada para manter o tamanho e os custos de armazenamento baixos, portanto, essa opção é desabilitar a substituição. Padrão = falso.
‑Execute Opcional. Indica que a exportação deve ser executada imediatamente após a criação.
‑Backfill Opcional. Número de meses para exportar os dados. Ele só é executado uma vez no momento da criação. As exportações com falha não são repetidas. Não há suporte quando -OneTime está definido. Padrão = 0.
‑Execute Opcional. Indica que a exportação deve ser executada imediatamente após a criação.
‑Backfill Opcional. Número de meses para exportar os dados. Ele só é executado uma vez no momento da criação. As exportações com falha não são repetidas. Não há suporte quando -OneTime está definido. Padrão = 0.
‑ApiVersion Opcional. Versão da API a ser usada ao chamar a API de Exportações do Gerenciamento de Custos. Padrão = 2023-07-01-preview.

Exemplos

Criar exportação única

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"

Cria uma nova exportação única chamada 'July2023OneTime' de 01 /07/2023 a 31 /07/2023 com Conjunto de Dados = Real e a executa uma vez.

Criar e executar uma exportação diária

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

Cria uma nova exportação agendada chamada Daily-MTD com StartDate = DateTime.Now e EndDate = 2024-12-31. A exportação é executada imediatamente após a criação.

Criar uma exportação mensal

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

Cria uma nova exportação mensal chamada Monthly-Report com StartDate = 1 dia de DateTime.Now e EndDate 2024-08-15. A exportação é executada imediatamente após a criação.

Criar exportação diária e preenchimento de quatro meses

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

Cria uma nova exportação diária chamada Daily-MTD com StartDate = DateTime.Now e EndDate 5 anos a partir de StartDate. Além disso, exporte os dados de custo dos quatro meses anteriores e salve todos os resultados no costreports contêiner da conta de armazenamento especificada.


Conteúdo relacionado

Produtos relacionados:

Soluções relacionadas: