cloudPcReports : retrieveCloudPcTroubleshootReports

Article
02/22/2025

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Obtenez des rapports de résolution des problèmes pour les PC cloud. Vous pouvez obtenir un rapport régional de résolution des problèmes, un rapport avec des détails de résolution des problèmes, un rapport avec les tendances de résolution des problèmes ou un rapport sur le nombre de problèmes de résolution des problèmes.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation	Autorisation avec privilèges minimum	Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire)	CloudPC.ReadWrite.All	Non prise en charge.
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	CloudPC.ReadWrite.All	Non prise en charge.

Requête HTTP

POST /deviceManagement/virtualEndpoint/reports/retrieveCloudPcTroubleshootReports

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant répertorie les paramètres que vous pouvez utiliser avec cette action.

Paramètre	Type	Description
filtre	String	Syntaxe OData `$filter` . Les filtres pris en charge sont les suivants : `and`, `orgt` ,`ge` et `eq`. Facultatif.
orderBy	Collection de chaînes	Spécifie l’ordre par nom de colonne. Facultatif.
reportName	cloudPCTroubleshootReportType	Nom du rapport. Les valeurs possibles sont : `troubleshootDetailsReport`, `troubleshootTrendCountReport`, `troubleshootRegionalReport`, `unknownFutureValue`, `troubleshootIssueCountReport`. Utilisez l’en-tête `Prefer: include-unknown-enum-members` de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : `troubleshootIssueCountReport`. La valeur par défaut est `troubleshootDetailsReport`.
recherche	String	Chaîne de recherche. Facultatif.
select	String collection	Syntaxe OData `$select` . Colonnes sélectionnées des rapports. Facultatif.
skip	Int32	Nombre d’enregistrements à ignorer. Facultatif.
top	Int32	Nombre d’enregistrements principaux à retourner. Si elle n’est pas spécifiée, la limite par défaut est de 25, avec un maximum de 100. Facultatif.

Réponse

Si elle réussit, cette action renvoie un 200 OK code de réponse et un Stream dans le corps de la réponse.

Le tableau suivant décrit les colonnes du rapport retourné lorsque vous spécifiez troubleshootRegionalReport pour la propriété reportName dans votre appel d’API.

Member	Description
AvgBandwidthInMbps	Bande passante moyenne disponible en Mbits/s de certaines `HostRegion`-`GatewayRegion` paires.
AvgRoundTripTimeInMs	Durée moyenne d’aller-retour en millisecondes d’une paire donnée `HostRegion`-`GatewayRegion` .
BandwidthIssueCount	Nombre d’instances de PC cloud présentant des problèmes de bande passante disponible.
BandwidthStabilityIssueCount	Nombre d’instances de PC cloud présentant des problèmes de stabilité de bande passante.
ConnectErrorIssueCount	Nombre d’instances de PC cloud avec des problèmes d’erreur de connexion.
ConnectionErrorCount	Nombre d’erreurs de connexion dans une paire donnée `HostRegion`-`GatewayRegion` .
ConnectionQualityIssueCount	Nombre d’instances de PC cloud avec des problèmes de qualité de connexion.
GatewayRegion	Région où se trouve la passerelle.
HostRegion	Région où se trouve le provisionnement de PC cloud.
RTTIssueCount	Nombre d’instances de PC cloud avec des problèmes de temps aller-retour.
RTTStabilityIssueCount	Nombre d’instances de PC cloud présentant des problèmes de stabilité du temps aller-retour.
StabilityIssueCount	Nombre d’instances de PC cloud présentant des problèmes de stabilité.

Le tableau suivant décrit les colonnes du rapport retourné lorsque vous spécifiez troubleshootDetailsReport pour la propriété reportName dans votre appel d’API.

Member	Description
AvailableBandwidthInMbpsAvg	Bande passante moyenne disponible en Mbits/s.
ConnectionErrorCount	Nombre d’erreurs de connexion.
Processeur actuel	Utilisation actuelle du processeur de la ressource.
CurrentDiskInGB	Utilisation actuelle du disque en Go.
CurrentRamInGB	Utilisation actuelle de la RAM en Go.
CurrentSize	Taille actuelle de la ressource.
HasNetworkIssue	Indique un problème réseau.
HasPerformanceIssue	Indique un problème de performances.
HasReliabilityIssue	Indique un problème de fiabilité.
ProvisionPolicyName	Nom de la stratégie d’approvisionnement.
RecommendedRamInGB	Utilisation recommandée de la RAM en Go.
Processeur de configuration recommandé	Utilisation recommandée du processeur pour la ressource.
RecommendedDiskInGB	Utilisation recommandée du disque en Go.
RecommendedSize	Taille recommandée pour la ressource.
RoundTripTimeInMsAvg	Durée moyenne d’aller-retour en millisecondes.
UsageInsight	Insights sur l’utilisation actuelle de la ressource.

Le tableau suivant décrit les colonnes du rapport retourné lorsque vous spécifiez troubleshootTrendCountReport pour la propriété reportName dans votre appel d’API.

Member	Description
CpuIssueCloudPcCount	Nombre d’instances de PC cloud avec des problèmes de processeur.
CpuIssueTrend	Tendance dans le nombre hebdomadaire d’instances de PC cloud avec des problèmes de processeur.
ConnectionQualityIssueCloudPcCount	Nombre d’instances de PC cloud avec des problèmes de qualité de connexion.
ConnectionQualityIssueTrend	La tendance dans le nombre hebdomadaire d’instances de PC cloud avec des problèmes de qualité de connexion.
MemoryIssueCloudPcCount	Nombre d’instances de PC cloud avec des problèmes de mémoire.
MemoryIssueTrend	Tendance du nombre hebdomadaire d’instances de PC cloud présentant des problèmes de mémoire.
NetworkIssueCount	Nombre de problèmes réseau.
PerformanceIssueCount	Nombre de problèmes de performances.
ReliabilityIssueCount	Nombre de problèmes de fiabilité.
RTTIssueCloudPcCount	Nombre d’instances de PC cloud avec des problèmes de temps aller-retour.
RTTIssueTrend	Tendance dans le nombre hebdomadaire d’instances de PC cloud avec des problèmes de temps aller-retour.
StabilityIssueCloudPcCount	Nombre d’instances de PC cloud présentant des problèmes de stabilité.
StabilityIssueTrend	Tendance dans le nombre hebdomadaire d’instances de PC cloud avec des problèmes de stabilité.
TotalImpactedCloudPcCount	Nombre total de PC cloud impactés.

Le tableau suivant décrit les colonnes du rapport retourné lorsque vous spécifiez troubleshootIssueCountReport pour la propriété reportName dans votre appel d’API.

Member	Description
AsofDate	Date et heure d’enregistrement des données.
ConnectionQualityIssueCount	Nombre de problèmes de qualité de connexion.
CpuIssueCount	Nombre de problèmes de processeur.
MemoryIssueCount	Nombre de problèmes de mémoire.
NetworkIssueCount	Nombre de problèmes réseau.
PerformanceIssueCount	Nombre de problèmes de performances.
ReliabilityIssueCount	Nombre de problèmes de fiabilité.
RTTIssueCount	Nombre de problèmes de temps aller-retour.
StabilityIssueCount	Nombre de problèmes de stabilité.

Exemples

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/retrieveCloudPcTroubleshootReports
Content-Type: application/json

{
  "reportName": "troubleshootDetailsReport",
  "select": [
    "CloudPcId",
    "ManagedDeviceName",
    "UserPrincipalName",
    "UsageInsight",
    "CurrentSize",
    "CurrentCPU",
    "CurrentRamInGB",
    "CurrentDiskInGB",
    "RecommendedSize",
    "RecommendedCPU",
    "RecommendedRamInGB",
    "RecommendedDiskInGB",
    "ProvisionPolicyName",
    "RoundTripTimeInMsAvg",
    "AvailableBandwidthInMbpsAvg"
  ],
  "search": "",
  "skip": 0,
  "top": 50
}

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "TotalRowCount": 1,
  "Schema": [
    {
      "Column": "CloudPcId",
      "PropertyType": "String"
    },
    {
      "Column": "ManagedDeviceName",
      "PropertyType": "String"
    },
    {
      "Column": "UserPrincipalName",
      "PropertyType": "String"
    },
    {
      "Column": "UsageInsight",
      "PropertyType": "String"
    },
    {
      "Column": "CurrentSize",
      "PropertyType": "Int"
    },
    {
      "Column": "CurrentCPU",
      "PropertyType": "Int"
    },
    {
      "Column": "CurrentRamInGB",
      "PropertyType": "Int"
    },
    {
      "Column": "CurrentDiskInGB",
      "PropertyType": "Int"
    },
    {
      "Column": "RecommendedSize",
      "PropertyType": "String"
    },
    {
      "Column": "RecommendedCPU",
      "PropertyType": "Int"
    },
    {
      "Column": "RecommendedRamInGB",
      "PropertyType": "Int"
    },
    {
      "Column": "RecommendedDiskInGB",
      "PropertyType": "Int"
    },
    {
      "Column": "ProvisionPolicyName",
      "PropertyType": "String"
    },
    {
      "Column": "RoundTripTimeInMsAvg",
      "PropertyType": "Double"
    },
    {
      "Column": "AvailableBandwidthInMbpsAvg",
      "PropertyType": "Double"
    }
  ],
  "Values": [
    [
      "f5ff445f-7488-40f8-8ab9-ee784a9c1f33",
      "Cloud PC-Ana Bowman",
      "ana@contoso.com",
      "Performance",
      "2",
      "4",
      "64",
      "Undersized",
      "4",
      "8",
      "128",
      "policy1",
      "200.1",
      "50.65"
    ]
  ]
}

Partager via

cloudPcReports : retrieveCloudPcTroubleshootReports

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Demande

Réponse

Commentaires

Ressources supplémentaires