Compartilhar via

Comando New-FinOpsCostExport

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", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". Padrão = "FocusCost".
‑DatasetVersion Opcional. Versão do esquema do conjunto de dados a ser exportado. Padrão = "1,0" (aplica-se somente ao 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).
‑CommitmentDiscountScope Opcional. Filtro de escopo de reserva a ser usado ao exportar recomendações de reserva. Ignorado para outros tipos de exportação. Valores permitidos: Compartilhado, Único. Padrão: Compartilhado.
‑CommitmentDiscountResourceType Opcional. Filtro de tipo de recurso de reserva a ser usado ao exportar recomendações de reserva. Ignorado para outros tipos de exportação. Padrão: VirtualMachines.
‑CommitmentDiscountLookback Opcional. Filtro de tipo de recurso de reserva a ser usado ao exportar recomendações de reserva. Ignorado para outros tipos de exportação. Valores permitidos: 7, 30, 60. Padrão: 30.
‑Monthly Opcional. Indica que a exportação deve ser executada mensalmente (em vez de diariamente). Ignorado para preços, recomendações de reserva e transações de reserva. 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 em conjunto 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, 5 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).
‑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. Se estiver criando uma exportação para hubs FinOps, recomendamos que você especifique a opção -DoNotOverwrite para melhorar a solução de problemas. Padrão = falso.
‑SystemAssignedIdentity Opcional. Indica que a identidade gerenciada deve ser 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 poderá enviar dados por push para uma conta de armazenamento por trás de um firewall. Padrão = (vazio).
‑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 poderá enviar dados por push para uma conta de armazenamento por trás de um firewall. Padrão = (vazio).
‑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. Isso só é executado uma vez no momento da criação. As exportações com falha não são tentadas novamente. 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.


Envie comentários

Informe-nos como estamos fazendo com uma revisão rápida. Usamos essas revisões para melhorar e expandir ferramentas e recursos do FinOps.

Envie comentários

Se você estiver procurando algo específico, vote em um existente ou crie uma ideia. Compartilhe ideias com outras pessoas para obter mais votos. Nos concentramos em ideias com a maioria dos votos.

votar ou sugerir ideias


Conteúdo relacionado

Produtos relacionados:

Soluções relacionadas:


  • Last updated on