Partager via

Commande New-FinOpsCostExport

La commande New-FinOpsCostExport crée une exportation Cost Management pour l’étendue spécifiée.

Cette commande a été testée avec les versions d’API suivantes :

  • 2023-07-01-preview (par défaut) : active FocusCost et d’autres jeux de données.
  • 2023-08-01

Syntaxe

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

Paramètres

Nom Descriptif
‑Name Obligatoire. Nom de l’exportation.
‑Scope Obligatoire. ID de ressource de l’étendue pour laquelle exporter des données.
‑Dataset facultatif. Jeu de données à exporter. Valeurs autorisées = « ActualCost », « AmortizedCost », « FocusCost », « PriceSheet », « ReservationDetails », « ReservationRecommendations », « ReservationTransactions ». Default = « FocusCost ».
‑DatasetVersion facultatif. Version de schéma du jeu de données à exporter. Default = « 1.0 » (s’applique uniquement à FocusCost).
‑DatasetFilters facultatif. Dictionnaire de paires clé/valeur avec lesquelles filtrer le jeu de données. S’applique uniquement au jeu de données ReservationRecommendations en 2023-07-01-preview. Les filtres valides sont reservationScope (partagé ou unique), resourceType (par exemple, VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑CommitmentDiscountScope facultatif. Filtre d’étendue de réservation à utiliser lors de l’exportation des recommandations de réservation. Ignoré pour d’autres types d’exportation. Valeurs autorisées : partagé, unique. Valeur par défaut : partagé.
‑CommitmentDiscountResourceType facultatif. Filtre de type de ressource de réservation à utiliser lors de l’exportation des recommandations de réservation. Ignoré pour d’autres types d’exportation. Valeur par défaut : VirtualMachines.
‑CommitmentDiscountLookback facultatif. Filtre de type de ressource de réservation à utiliser lors de l’exportation des recommandations de réservation. Ignoré pour d’autres types d’exportation. Valeurs autorisées : 7, 30, 60. Valeur par défaut : 30.
‑Monthly facultatif. Indique que l’exportation doit être exécutée mensuellement (au lieu de quotidienne). Ignoré pour les prix, les recommandations de réservation et les transactions de réservation. Valeur par défaut ; False.
‑OneTime facultatif. Indique que l’exportation ne doit être exécutée qu’une seule fois. Quand elle est définie, les dates de début/fin sont les dates pour laquelle interroger les données. Impossible d’utiliser conjointement avec l’option -Monthly.
‑StartDate facultatif. Jour pour commencer à exécuter des exportations. Valeur par défaut = Premier jour du mois précédent si -OneTime est défini ; sinon, demain (DateTime.Now.AddDays(1)).
‑EndDate facultatif. Dernier jour pour exécuter l’exportation. Valeur par défaut = Dernier jour du mois identifié dans -StartDate si -OneTime est définie ; sinon, 5 ans à partir de -StartDate.
‑StorageAccountId Obligatoire. ID de ressource du compte de stockage vers lequel exporter des données.
‑StorageContainer facultatif. Nom du conteneur vers lequel exporter des données. Le conteneur est créé s’il n’existe pas. Default = « cost-management ».
‑StoragePath facultatif. Chemin d’accès pour exporter des données dans le conteneur de stockage. Valeur par défaut = (ID d’étendue).
‑DoNotPartition facultatif. Indique s’il faut partitionner les données exportées dans plusieurs fichiers. Le partitionnement est recommandé pour la fiabilité. Cette option consiste donc à désactiver le partitionnement. Valeur par défaut ; False.
‑DoNotOverwrite facultatif. Indique s’il faut remplacer les données précédemment exportées pour le mois en cours. Le remplacement est recommandé pour réduire la taille du stockage et les coûts. Cette option consiste donc à désactiver le remplacement. Si vous créez une exportation pour les hubs FinOps, nous vous recommandons de spécifier l’option -DoNotOverwrite pour améliorer la résolution des problèmes. Valeur par défaut ; False.
‑SystemAssignedIdentity facultatif. Indique que l’identité managée doit être utilisée pour envoyer des données au compte de stockage. L’identité managée est requise pour travailler avec des comptes de stockage derrière un pare-feu, mais nécessite l’accès pour accorder des autorisations (par exemple, Propriétaire). Si elle est spécifiée, l’identité managée est utilisée ; sinon, l’identité managée ne sera pas utilisée et votre exportation ne pourra pas envoyer de données à un compte de stockage derrière un pare-feu. Default = (vide).
‑Location facultatif. Indique l’emplacement Azure à utiliser pour l’identité managée utilisée pour envoyer des données au compte de stockage. L’identité managée est requise pour travailler avec des comptes de stockage derrière un pare-feu, mais nécessite l’accès pour accorder des autorisations (par exemple, Propriétaire). Si elle est spécifiée, l’identité managée est utilisée ; sinon, l’identité managée ne sera pas utilisée et votre exportation ne pourra pas envoyer de données à un compte de stockage derrière un pare-feu. Default = (vide).
‑Execute facultatif. Indique que l’exportation doit être exécutée immédiatement après la création.
‑Backfill facultatif. Nombre de mois pour lequel exporter les données. Cette opération n’est exécutée qu’une seule fois au moment de la création. Les exportations ayant échoué ne sont pas re-tentées. Non pris en charge lorsque -OneTime est défini. Valeur par défaut = 0.
‑ApiVersion facultatif. Version de l’API à utiliser lors de l’appel de l’API Cost Management Exports. Valeur par défaut = 2023-07-01-preview.

Exemples

Créer une exportation à usage unique

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"

Crée une exportation unique appelée « juillet2023OneTime » de 2023-07-01 à 2023-07-31 avec Dataset = Réel et exécutez-la une seule fois.

Créer et exécuter une exportation quotidienne

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

Crée une exportation planifiée appelée Daily-MTD avec StartDate = DateTime.Now et EndDate = 2024-12-31. L’exportation est exécutée immédiatement après la création.

Créer une exportation mensuelle

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

Crée une exportation mensuelle appelée Rapport mensuel avec StartDate = 1 jour à partir de DateTime.Now et EndDate 2024-08-15. L’exportation est exécutée immédiatement après la création.

Créer une exportation quotidienne et remplir quatre mois

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

Crée une exportation quotidienne appelée Daily-MTD avec StartDate = DateTime.Now et EndDate 5 ans à partir de StartDate. En outre, exportez les données de coût des quatre mois précédents et enregistrez tous les résultats dans costreports le conteneur du compte de stockage spécifié.


Envoyer des commentaires

Faites-nous savoir comment nous faisons avec un examen rapide. Nous utilisons ces révisions pour améliorer et développer les outils et ressources FinOps.

Envoyer des commentaires

Si vous recherchez quelque chose de spécifique, votez pour une idée existante ou créez une nouvelle idée. Partagez des idées avec d’autres personnes pour obtenir plus de votes. Nous nous concentrons sur les idées avec le plus de votes.

voter ou suggérer des idées


Contenu connexe

Produits connexes :

Solutions connexes :