New-AzCostManagementDetailReport
Cette API est le remplacement de toutes les API Détails de l’utilisation précédemment mises en production. Demandez de générer un rapport de détails sur les coûts pour la plage de dates, la période de facturation (seuls les clients d’entreprise) ou l’ID de facture de manière asynchrone dans une certaine étendue. L’appel initial pour demander un rapport retourne un 202 avec un en-tête « Location » et « Retry-After ». L’en-tête « Emplacement » fournit le point de terminaison à interroger pour obtenir le résultat de la génération de rapport. « Réessayer-After » fournit la durée d’attente avant l’interrogation du rapport généré. Un appel pour interroger l’opération de rapport fournit une réponse 202 avec un en-tête « Location » si l’opération est toujours en cours. Une fois l’opération de génération de rapports terminée, le point de terminaison d’interrogation fournit une réponse de 200, ainsi que des détails sur les objets blob de rapport disponibles en téléchargement. Les détails sur le ou les fichiers disponibles pour le téléchargement seront disponibles dans le corps de la réponse d’interrogation.
Syntaxe
New-AzCostManagementDetailReport
-Scope <String>
[-BillingPeriod <String>]
[-InvoiceId <String>]
[-Metric <CostDetailsMetricType>]
[-TimePeriodEnd <String>]
[-TimePeriodStart <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cette API est le remplacement de toutes les API Détails de l’utilisation précédemment mises en production. Demandez de générer un rapport de détails sur les coûts pour la plage de dates, la période de facturation (seuls les clients d’entreprise) ou l’ID de facture de manière asynchrone dans une certaine étendue. L’appel initial pour demander un rapport retourne un 202 avec un en-tête « Location » et « Retry-After ». L’en-tête « Emplacement » fournit le point de terminaison à interroger pour obtenir le résultat de la génération de rapport. « Réessayer-After » fournit la durée d’attente avant l’interrogation du rapport généré. Un appel pour interroger l’opération de rapport fournit une réponse 202 avec un en-tête « Location » si l’opération est toujours en cours. Une fois l’opération de génération de rapports terminée, le point de terminaison d’interrogation fournit une réponse de 200, ainsi que des détails sur les objets blob de rapport disponibles en téléchargement. Les détails sur le ou les fichiers disponibles pour le téléchargement seront disponibles dans le corps de la réponse d’interrogation.
Exemples
Exemple 1 : Demander de générer un rapport de détails sur les coûts pour la plage de dates, la période de facturation (seuls les clients d’entreprise) ou l’ID de facture de manière asynchrone dans une certaine étendue
New-AzCostManagementDetailReport -Scope "/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f" -Metric 'ActualCost' -TimePeriodStart "2022-10-01" -TimePeriodEnd "2022-10-20"
Cette commande demande de générer un rapport de détails sur les coûts pour la plage de dates, la période de facturation (seuls les clients d’entreprise) ou l’ID de facture de manière asynchrone dans une certaine étendue.
Paramètres
-AsJob
Exécuter la commande en tant que travail
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-BillingPeriod
Ce paramètre est réservé aux clients doté d’un Contrat Entreprise. Utilisez le format YearMonth(par exemple, 202008). Ce paramètre ne peut pas être utilisé avec les paramètres invoiceId ou timePeriod. Si un paramètre timePeriod, invoiceId ou billingPeriod n’est pas fourni dans le corps de la demande, l’API retourne le coût du mois actuel.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation avant d’exécuter la commande cmdlet.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DefaultProfile
Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.
Type: | PSObject |
Alias: | AzureRMContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-InvoiceId
Ce paramètre est réservé aux clients dotés d’un Contrat client Microsoft. En outre, il ne peut être utilisé qu’au niveau du profil de facturation ou de l’étendue client. Ce paramètre ne peut pas être utilisé avec les paramètres billingPeriod ou timePeriod. Si un paramètre timePeriod, invoiceId ou billingPeriod n’est pas fourni dans le corps de la demande, l’API retourne le coût du mois actuel.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Metric
Type du rapport détaillé. Par défaut, ActualCost est fourni
Type: | CostDetailsMetricType |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-NoWait
Exécuter la commande de manière asynchrone
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Scope
Étendue associée aux opérations de détails d’utilisation. Cela inclut « /subscriptions/{subscriptionId} / » pour l’étendue de l’abonnement, « /providers/Microsoft.Billing/billingAccounts/{billingAccountId} » pour l’étendue du compte de facturation, « /providers/Microsoft.Billing/departmentId} » pour l’étendue du service, « /providers/Microsoft.Billing/enrollmentAccounts/{enrollmentAccountId} » pour l’étendue EnrollmentAccount. En outre, les étendues de compte de commerce moderne sont « /providers/Microsoft.Billing/billingAccounts/{billingAccountId} » pour l’étendue billingAccount, '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' pour l’étendue billingProfile, « providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId} » pour l’étendue invoiceSection et « providers/Microsoft ». Billing/billingAccounts/{billingAccountId}/customers/{customerId}' spécifique aux partenaires.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-TimePeriodEnd
Date de fin vers laquelle extraire des données. exemple de format 2020-03-15
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-TimePeriodStart
Date de début à partir de laquelle extraire des données. exemple de format 2020-03-15
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |