Partilhar via

Comando New-FinOpsCostExport

  • Artigo

O comando New-FinOpsCostExport cria uma nova exportação de 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 o 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ório. Nome da exportação.
‑Scope Obrigatório. ID do recurso do escopo para o qual exportar dados.
‑Dataset Opcional. Conjunto de dados a exportar. Valores permitidos = "ActualCost", "AmortizedCost". Padrão = "ActualCost".
‑DatasetVersion Opcional. Versão do esquema do conjunto de dados a ser exportado. Default = (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 = false.
‑OneTime Opcional. Indica que a exportação só deve ser executada uma vez. Quando definidas, as datas de início/término são as datas para consultar 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ório. 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 é criado se ele não existir. Default = "gestão 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 atrás de um firewall, mas requer acesso para conceder permissões (por exemplo, Proprietário). Se especificado, a identidade gerenciada é usada; Caso contrário, a identidade gerenciada não será usada e sua exportação não enviará dados para uma conta de armazenamento atrás de 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, esta opção é desativar o particionamento. Padrão = false.
‑DoNotOverwrite Opcional. Indica se os dados exportados anteriormente para o mês atual devem ser substituídos. A substituição é recomendada para manter o tamanho e os custos de armazenamento baixos, portanto, essa opção é desabilitar a substituição. Padrão = false.
‑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 suportado 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 suportado quando -OneTime está definido. Padrão = 0.
‑ApiVersion Opcional. Versão da API a ser usada ao chamar a API de Exportações de 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 2023-07-01 a 2023-07-31 com Dataset = Atual e executa-a 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.

Crie exportação diária e enchimento 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údos relacionados

Produtos relacionados:

Soluções relacionadas: