Obtenir le consentement du client en tant que fournisseur Panneau de configuration

  • Article

En tant que fournisseur Panneau de configuration (CPV), vous pouvez utiliser des API REST pour obtenir et supprimer le consentement de vos clients CSP pour obtenir des autorisations sur leurs locataires.

POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents

Paramètres URI

Nom Dans Obligatoire Type Description
customer_id path True string ID du client généré dans l’Espace partenaires

En-tête de requête

Types de supports : application/json

Nom Obligatoire Type Description
Autorisation True string Jeton d’accès pour l’audience https://api.partnercenter.microsoft.com
Accepter True string Type de contenu acceptable ; application/json de type largement acceptée
ms-correlationid string Utilisé pour le suivi des demandes en interne. Si aucun ms-correlationid n’est fourni, le serveur en génère un pour chaque demande
ms-requestid chaîne Utilisé pour l’idempotence des requêtes. Si aucun ms-requestid n’est fourni, le serveur en génère un nouveau pour chaque requête

Corps de la demande

Types de supports : application/json

Nom Type Description
applicationId string ID d’application du partenaire CPV
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Liste des octrois d’applications pour obtenir l’accès pour vos clients dans leur locataire

Réponses

Nom Type Description
200 OK La requête a réussi. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
201 Créé Le consentement de l’application est créé. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
400 Demande incorrecte Une entrée était manquante ou non valide. Le corps de la réponse contient les détails de l’erreur. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
401 Non autorisé La demande n’a pas été authentifiée. Le client doit passer un jeton d’accès valide pour une audience valide. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
403 Interdit La demande a été authentifiée, mais a été refusée, car l’appelant n’a pas les droits nécessaires pour l’appeler. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
404 Introuvable La ressource est introuvable ou non disponible avec les paramètres d’entrée donnés. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
500 Erreur interne du serveur Le service d’API partenaire ou l’une de ses dépendances n’a pas pu répondre à la demande. Les appelants peuvent réessayer la demande. Types de supports : « application/json », « application/xml », « text/xml », « text/json »

Définitions

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Nom Type Description
enterpriseApplicationId chaîne Représentation GUID de la ressource qui obtient l’accès
scope string Valeurs séparées par des virgules de l’étendue pour l’obtention de l’accès 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

Paramètres URI

Nom Dans Obligatoire Type Description
customer_id path True string ID du client généré dans l’Espace partenaires
Application_id path True string ID de votre application CPV

En-tête de requête

Types de supports : application/json

Nom Obligatoire Type Description
Autorisation True string Jeton d’accès pour l’audience https://api.partnercenter.microsoft.com
Accepter True string Type de contenu acceptable, généralement type application/json
ms-correlationid chaîne Utilisé pour le suivi des demandes en interne. Si un ms-correlationid n’est pas fourni, le serveur en génère un nouveau pour chaque demande
ms-requestid chaîne Utilisé pour l’idempotence des requêtes. Si aucun ms-requestid n’est fourni, le serveur en génère un nouveau pour chaque requête

Réponses

Nom Type Description
200 OK La requête a réussi. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
201 Créé Le consentement de l’application est supprimé. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
400 Demande incorrecte Une entrée était manquante ou non valide. Le corps de la réponse contient les détails de l’erreur. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
401 Non autorisé La demande n’a pas été authentifiée. Le client doit passer un jeton d’accès valide pour une audience valide. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
403 Interdit La demande a été authentifiée, mais a été refusée, car l’appelant n’a pas les droits nécessaires pour l’appeler. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
404 Introuvable La ressource est introuvable ou non disponible avec les paramètres d’entrée donnés. Types de supports : « application/json », « application/xml », « text/xml », « text/json »
500 Erreur interne du serveur Le service d’API partenaire ou l’une de ses dépendances n’a pas pu répondre à la demande. Les appelants peuvent réessayer la demande. Types de supports : « application/json », « application/xml », « text/xml », « text/json »

Étapes suivantes