API conformité de sécurité de l’Espace partenaires

Rôles appropriés : Administrateur de sécurité | Lecteur de sécurité | Agent d’administration

S’applique à : Partner Center

L’API de conformité de sécurité de l’Espace partenaires vous permet de récupérer les tâches de conformité de votre organisation partenaire, de passer en revue les évaluations du temps de réponse et de mettre à jour les états des tâches. Il prend en charge l’automatisation du modèle de tâche unifié utilisé dans l’espace de travail Sécurité repensé, où les exigences de sécurité et les alertes sont présentées comme des tâches actionnables.

Cet article décrit le modèle de tâche, les opérations prises en charge, les ressources JSON et les exemples de requête et de réponse REST. Les noms et valeurs des propriétés d’API conservent leur casse exacte, même lorsque l’espace de travail utilise différentes étiquettes d’affichage.

Concepts de l’expérience repensée

Les concepts suivants connectent l’expérience de l’espace de travail sécurité aux ressources d’API de cet article.

Cycle de vie et états des tâches

L’espace de travail appelle la valeur du cycle de vie un état ; l’API l’expose en tant que status. Utilisez les chaînes exactes et sensibles à la casse suivantes dans les requêtes et réponses d’API.

Pour utiliser une tâche par programmation :

1. Répertoriez les tâches de conformité et sélectionnez la tâche qui a besoin d’attention.
2. Obtenez les détails de la tâche pour passer en revue son état actuel, ses informations spécifiques au flux, ses notes et son activité récente.
3. Définir l’état sur In Progress lorsque le travail commence.
4. Corrigez la condition dans le système source approprié, par exemple Microsoft Entra, le portail Azure ou l’Espace partenaires.
5. Définissez l’état Ready for Review sur le moment où le travail est terminé, puis récupérez à nouveau la tâche après la vérification de la source pour vérifier son état et son actualisation des données.

Étendue de l’API pendant la transition

L’espace de travail repensé et l’API n’exposent pas nécessairement les mêmes actions. Utilisez les opérations et les schémas de cet article comme contrat pour cette API, plutôt que de supposer que chaque action d’espace de travail a un équivalent d’API.

Pendant la transition de l’espace de travail, distinguez ces points de terminaison de l’Espace partenaires des API bêta actuelles Microsoft Graph pour les alertes de sécurité, les exigences et le score de sécurité. Cet article ne définit pas de date de mise hors service, un mappage un-à-un des ID d’alerte existants aux ID de tâche ou un remplacement pour chaque opération existante. Obtenir des ID de tâche opaques à partir de cette API ; ne les construisez pas à partir d’identificateurs d’alerte ou d’abonnement existants.

Conventions de ressources

Les ressources suivantes décrivent les données JSON retournées ou acceptées par les opérations de cet article. Comme dans d’autres ressources REST de l’Espace partenaires, les tables de propriétés définissent les éléments de requête et de réponse.

Les noms de propriétés JSON et les valeurs d’état respectent la casse. Les horodatages sont des chaînes ISO 8601 UTC, par exemple 2026-10-01T12:00:00.000Z. Les champs nullables peuvent contenir null; ne supposent pas que chaque tâche possède des informations de client, d’abonnement, d’échéance ou de résolution.

Tâche de conformité

Décrit une tâche de conformité, y compris son état actuel, sa gravité, son échéance et son abonnement ou client associé. Les opérations de liste et de détail retournent ces propriétés.

Détails de la tâche de conformité

Décrit une tâche de conformité unique avec des détails, des notes et une activité récente spécifiques au flux. Inclut toutes les propriétés de tâche de conformité ainsi que les propriétés suivantes.

Activité des tâches de conformité

Décrit une modification enregistrée d’une tâche de conformité. Les valeurs facultatives peuvent être null.

Collection de tâches de conformité

Décrit une page des tâches de conformité.

La collection n’a aucune propriété total-count. Pour connaître le comportement de continuation et l’expiration, consultez Pagination.

Évaluation du temps de réponse

Décrit le temps moyen de votre organisation partenaire au premier changement d’état pour les tâches de conformité. Il s’agit d’une évaluation à l’échelle du partenaire, et non du temps écoulé, du temps de résolution finale ou de la latence de l’API HTTP.

Pour connaître les règles de mesure et les limitations des preuves, consultez Obtenir l’évaluation du temps de réponse.

Demande de mise à jour de l’état de la tâche

Décrit le corps de la demande pour la mise à jour de l’état du flux de travail d’une tâche de conformité.

Fournir uniquement status. Pour connaître les transitions et restrictions autorisées, consultez Mettre à jour l’état d’une tâche de conformité.

Résultat de la mise à jour de l’état de la tâche

Décrit une mise à jour d’état confirmée.

Error

Décrit une erreur d’API de conformité ordinaire. Les échecs d’authentification/MFA et les échecs front-door peuvent utiliser différents corps ; ne supposez pas que chaque erreur correspond à cette forme.

Pour obtenir des codes d’état HTTP et un exemple de corps d’erreur, consultez Les codes de réussite et d’erreur de réponse.

Operations

Utilisez les opérations REST suivantes avec ces ressources.

Prerequisites

• Configurez une application Microsoft Entra pour l’accès aux API de l’Espace partenaires. Pour obtenir des conseils d’installation, consultez Configurer l’accès à l’API dans l’Espace partenaires.
• Obtenez un jeton d’accès à l’aide de l’authentification App+Utilisateur, comme décrit dans l’authentification de l’Espace partenaires. L’authentification par application uniquement n’est pas prise en charge par ces opérations.
• L’utilisateur délégué doit satisfaire l’authentification multifacteur et disposer de l’autorisation d’afficher les informations de conformité/sécurité. La mise à jour de l’état nécessite l’autorisation de gestion ; L’autorisation en lecture seule est insuffisante.
• L’API doit être activée pour l’organisation partenaire. Les demandes fonctionnent sur le locataire du partenaire authentifié, et non sur un locataire sélectionné par le biais d’un paramètre de requête ou d’un en-tête.

Pour obtenir des conseils sur l’intégration de l’authentification multifacteur, consultez Activer le modèle d’application sécurisé.

Conventions de requête REST

L’URL de base de production est https://api.partnercenter.microsoft.com. Les exemples ci-dessous utilisent cette URL. Les exemples n’établissent pas de disponibilité pour une organisation partenaire particulière ; l’API doit être activée pour cette organisation.

En-têtes de requête

Les en-têtes suivants s’appliquent à ces opérations. Pour obtenir des définitions d’en-tête générales, consultez les en-têtes REST de l’Espace partenaires. Tous les en-têtes de l’Espace partenaires ne s’appliquent pas à chaque opération.

Répertorier les tâches de conformité

Récupérez une liste paginé des tâches de conformité pour votre organisation partenaire, notamment l’état, la gravité, l’échéance et les informations client ou abonnement disponibles. Utilisez des filtres pour affiner les résultats par état, groupe de tâches, exigence, locataire client ou abonnement. Utilisez les ID de tâche retournés pour récupérer les détails ou mettre à jour l’état d’une tâche.

Requête REST

Paramètres de la requête

Champs de filtre pris en charge : status, , taskGroupIdrequirementId, customerTenantIdet subscriptionId. Utiliser eq avec des valeurs de chaîne entre guillemets uniques et and entre les prédicats. Un groupe entre parenthèses or est pris en charge uniquement pour les valeurs d’état, par exemple :

requirementId eq 'UsageAnomalyDetection' and (status eq 'New' or status eq 'In Progress')

Les valeurs de filtre d’état prises en charge sont New, , In ProgressReady for Review, Completeet Ignore. Échappez une apostrophe littérale à l’intérieur d’une valeur sous la forme de deux apostrophes et des valeurs de requête encodées par URL. Ce point de terminaison prend en charge une syntaxe de style OData limitée, et non une syntaxe OData générale : $orderby, , $skip$selectet les paramètres de requête répétés ne sont pas pris en charge.

Corps de la demande

None.

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/compliance/tasks?$top=1&$filter=requirementId%20eq%20%27UsageAnomalyDetection%27%20and%20status%20eq%20%27New%27 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa
MS-RequestId: bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb

Réponse REST

Si elle réussit, cette méthode retourne 200 OK et une collection de tâches de conformité dans le corps de la réponse. Un résultat vide est {"value":[]}; il n’existe aucune propriété total-count.

Exemple de réponse

{
  "value": [
    {
      "taskId": "usage-anomaly-detection::11111111-1111-4111-8111-111111111111-22222222-2222-4222-8222-222222222222",
      "taskGroupId": "usage-anomaly-detection",
      "taskGroupTitle": "Usage Anomaly Detection",
      "taskGroupClassification": "Fraud",
      "isEligibilityRequirement": false,
      "requirementId": "UsageAnomalyDetection",
      "taskTitle": "Action Required: Subscription Usage Anomaly Detected",
      "status": "New",
      "isIgnorable": true,
      "customerTenantId": null,
      "customerName": "Contoso Customer",
      "subscriptionId": "11111111-1111-4111-8111-111111111111",
      "subscriptionName": null,
      "severity": "High",
      "deadlineDateTime": "2026-10-15T12:00:00.000Z",
      "createdDate": "2026-09-15T12:00:00.000Z",
      "lastModifiedDate": "2026-09-15T12:00:00.000Z",
      "lastRefreshDateTime": "2026-10-01T11:00:00.000Z",
      "resolvedDate": null,
      "version": "\"33333333-3333-4333-8333-333333333333\""
    }
  ],
  "@odata.nextLink": "https://api.partnercenter.microsoft.com/v1/compliance/tasks?$top=1&$filter=requirementId%20eq%20%27UsageAnomalyDetection%27%20and%20status%20eq%20%27New%27&$skiptoken=55555555-5555-4555-8555-555555555555"
}

Pagination

Suivez @odata.nextLink la même authentification jusqu’à ce que la propriété soit absente. Ne modifiez pas la taille ou le filtre de la page pendant une traversée. Les continuations expirent une heure après la première page ; la récupération d’une autre page n’étend pas cette expiration. Un jeton non valide, expiré ou incompatible retourne 400 ; redémarrez à partir de la demande de liste initiale. Les modifications apportées à la configuration de flux actif peuvent invalider une continuation. La pagination d’une liste de modifications n’est pas un instantané à un point dans le temps.

Obtenir une tâche de conformité

Récupérez une tâche de conformité unique à l’aide d’un ID de tâche retourné par le point de terminaison de liste. La réponse inclut les propriétés récapitulatives de la tâche ainsi que les détails spécifiques au flux, les notes existantes et l’historique des activités récentes. Utilisez cette opération pour examiner une tâche ou actualiser son état actuel avant de décider d’une mise à jour d’état.

Requête REST

Paramètres d’URI

Corps de la demande

None. Aucun paramètre de requête n’est pris en charge.

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/compliance/tasks/usage-anomaly-detection%3A%3A11111111-1111-4111-8111-111111111111-22222222-2222-4222-8222-222222222222 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa
MS-RequestId: bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb

Réponse REST

Si elle réussit, cette méthode retourne 200 détails de tâche ok et de conformité dans le corps de la réponse. L’en-tête ETag de réponse correspond version.

Exemple de réponse

{
  "details": {
    "alertId": "11111111-1111-4111-8111-111111111111-22222222-2222-4222-8222-222222222222",
    "alertDisplayName": "Action Required: Subscription Usage Anomaly Detected",
    "severity": "High",
    "subscriptionId": "11111111-1111-4111-8111-111111111111",
    "customerName": "Contoso Customer",
    "detectedTime": "2026-09-15T12:00:00.000Z",
    "description": "Unusual subscription usage was detected. Review the affected subscription."
  },
  "notes": null,
  "activityLog": [
    {
      "date": "2026-09-15T12:00:00.000Z",
      "action": "FeedCreated",
      "oldStatus": null,
      "newStatus": "New",
      "changeReason": null,
      "notes": null
    }
  ],
  "activityLogTruncated": false,
  "taskId": "usage-anomaly-detection::11111111-1111-4111-8111-111111111111-22222222-2222-4222-8222-222222222222",
  "taskGroupId": "usage-anomaly-detection",
  "taskGroupTitle": "Usage Anomaly Detection",
  "taskGroupClassification": "Fraud",
  "isEligibilityRequirement": false,
  "requirementId": "UsageAnomalyDetection",
  "taskTitle": "Action Required: Subscription Usage Anomaly Detected",
  "status": "New",
  "isIgnorable": true,
  "customerTenantId": null,
  "customerName": "Contoso Customer",
  "subscriptionId": "11111111-1111-4111-8111-111111111111",
  "subscriptionName": null,
  "severity": "High",
  "deadlineDateTime": "2026-10-15T12:00:00.000Z",
  "createdDate": "2026-09-15T12:00:00.000Z",
  "lastModifiedDate": "2026-09-15T12:00:00.000Z",
  "lastRefreshDateTime": "2026-10-01T11:00:00.000Z",
  "resolvedDate": null,
  "version": "\"33333333-3333-4333-8333-333333333333\""
}

Obtenir l’évaluation du temps de réponse

Récupérez l’évaluation de votre organisation partenaire de la rapidité avec laquelle les tâches de conformité reçoivent leur premier changement d’état, mesurée par rapport au seuil actuel de 24 heures. L’évaluation couvre les tâches ouvertes au cours des 30 jours précédents et inclut le temps écoulé pour les tâches mesurables qui n’ont pas encore changé d’état. Elle retourne la durée moyenne, le nombre d’échantillons, le résultat de l’évaluation et la disponibilité des preuves ; elle ne mesure pas le temps de résolution final ou la latence de l’API.

Requête REST

Aucun paramètre de requête n’est pris en charge.

Corps de la demande

None.

Exemple de requête

GET https://api.partnercenter.microsoft.com/v1/compliance/responseTime HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa
MS-RequestId: bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb

Réponse REST

Si elle réussit, cette méthode retourne 200 OK et une évaluation du temps de réponse dans le corps de la réponse.

Exemple de réponse

{
  "completion": "notComplete",
  "thresholdSeconds": 86400,
  "averageDurationSeconds": 108000,
  "sampleCount": 10,
  "availability": "available",
  "reason": null,
  "definitionVersion": 1,
  "activeFeedSetVersion": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "windowStart": "2026-09-01T12:00:00.000Z",
  "windowEnd": "2026-10-01T12:00:00.000Z",
  "calculatedAt": "2026-10-01T12:00:00.000Z",
  "expiresAt": "2026-10-01T12:10:00.000Z"
}

Règles d’évaluation

La définition actuelle considère les tâches ouvertes au cours des 30 jours précédents dans les flux actifs, à l’exclusion des tâches initialement terminées. Il mesure le temps entre l’événement d’ouverture enregistré et le premier changement d’état enregistré ; une tâche mesurable sans modification contribue au temps écoulé jusqu’au temps de calcul. L’historique manquant ou tronqué peut réduire la disponibilité. La moyenne n’est donc pas limitée aux tâches déjà effectuées et n’est pas le temps de résoudre la dernière résolution.

Avec des preuves mesurables, une moyenne d’au moins 86 400 secondes est évaluée à complete; au-dessus de celle-ci est évaluée .notComplete Un registre de flux partiel est évalué à unknown. Sans historique, l’implémentation actuelle peut retourner completion: "complete" avec availability: "unavailable" et une moyenne null ; n’interprètez pas cela comme un temps de réponse de zéro seconde mesuré. Les objets d’évaluation réussis peuvent représenter des preuves partielles/indisponibles ; les échecs de dépendance peuvent retourner 503 à la place.

Mettre à jour l’état d’une tâche de conformité

Mettez à jour l’état du flux de travail d’une tâche en cours, Prêt pour révision ou Ignorer, soumis à l’état actuel de la tâche et indique si son flux autorise Ignorer. Cette opération nécessite une autorisation de gestion et retourne l’état confirmé, l’heure de modification et la version. La modification de l’état enregistre la progression de votre flux de travail ; il ne corrige pas le problème sous-jacent ou vous permet de marquer la tâche Terminée.

Requête REST

Paramètres d’URI

Aucun paramètre de requête n’est pris en charge.

Corps de la demande

Utilisez une demande de mise à jour de l’état de la tâche contenant la propriété requise status .

Fournissez uniquementstatus. Des propriétés supplémentaires/dupliquées, un état manquant ou non chaîne et un JSON mal formé retournent 400.

• New et Complete ne peut pas être défini par cette opération ; Terminé est géré par le système.
• Une tâche complète ne peut pas être modifiée par cette opération.
• L’option Ignorer n’est autorisée que lorsque le flux l’autorise (isIgnorable).
• Une tâche ignorée peut rester ignorée ou être rouverte en cours, mais ne peut pas passer directement à Ready for Review.
• Le serveur vérifie l’accès concurrentiel en interne. Un en-tête client If-Match n’est pas requis par ce point de terminaison ; la version retournée n’est pas une condition préalable du client documentée.

Exemple de requête

PUT https://api.partnercenter.microsoft.com/v1/compliance/tasks/usage-anomaly-detection%3A%3A11111111-1111-4111-8111-111111111111-22222222-2222-4222-8222-222222222222/status HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
MS-CorrelationId: cccccccc-cccc-4ccc-8ccc-cccccccccccc
MS-RequestId: dddddddd-dddd-4ddd-8ddd-dddddddddddd

{
  "status": "In Progress"
}

Réponse REST

Si elle réussit, cette méthode retourne 200 OK et une mise à jour de l’état de la tâche entraîne le corps de la réponse. L’en-tête ETag de réponse correspond à la version retournée.

Exemple de réponse

{
  "taskId": "usage-anomaly-detection::11111111-1111-4111-8111-111111111111-22222222-2222-4222-8222-222222222222",
  "status": "In Progress",
  "lastModifiedDate": "2026-10-01T12:05:00.000Z",
  "version": "\"44444444-4444-4444-8444-444444444444\""
}

Réussite de la réponse et codes d’erreur

Consultez les codes d’erreur REST de l’Espace partenaires pour obtenir des conseils généraux. Les cas suivants sont spécifiques à ces opérations :

Exemple de corps non trouvé de la tâche :

{
  "code": 600026,
  "description": "Compliance task not found.",
  "source": "PCFraudEvents"
}

Les erreurs de conformité ordinaires utilisent la ressource d’erreur . Les échecs d’authentification/MFA et les échecs front-door peuvent utiliser différents corps. Réponses définies Cache-Control: no-store, private et Vary: Authorization.

Troubleshooting

Vérifiez l’URL de la requête, la version de l’API, les en-têtes et la mise en forme JSON en cas d’échec d’une requête. Utilisez ensemble le code d’état HTTP et le corps de la réponse pour déterminer l’action suivante. Pour obtenir des conseils généraux sur le débogage REST, consultez Test et débogage.

Enregistrez l’heure, l’opération, l’état HTTP et les ID de requête et de corrélation afin qu’un appel ayant échoué puisse être suivi. Protégez les jetons d’accès lors de la capture des journaux ou des traces réseau.

Pour les demandes de liste, utilisez le retour @odata.nextLink inchangé. Redémarrez à partir de la requête initiale si une continuation expire. Pour les mises à jour d’état avec un résultat incertain, récupérez l’état actuel de la tâche avant de réessayer.