Partager via


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 l’applet de commande.

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

Sorties

ICostDetailsOperationResults