Partager via

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

  • Article

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

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

Remarque

La limite de débit est de 50 requêtes par seconde (RPS) pour chaque ID d’application (ID d’application du partenaire CPV).

Paramètres d’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 Requise Type Description
Autorisation True string Jeton d’accès pour l’audience https://api.partnercenter.microsoft.com
Accept True string Type de contenu acceptable ; application de type largement acceptée/json
ms-correlationid string 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 requête
ms-requestid string Utilisé pour l’idempotency des requêtes. Si un ms-requestid n’est pas fourni, le serveur en génère un nouveau pour chaque demande

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 subventions d’application pour obtenir l’accès de 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éée Le consentement de l’application est créé. Types de supports : application/json, application/xml, text/xml, text/json
400 Demande incorrecte Une entrée est 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 transmettre un jeton d’accès valide pour un public 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 d’appeler. Types de supports : application/json, application/xml, text/xml, text/json
404 Not Found La ressource n’est pas trouvée ou n’est pas 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 requête. Types de supports : application/json, application/xml, text/xml, text/json

Définitions

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

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

Remarque

La limite de débit est de 50 requêtes par seconde (RPS) pour chaque ID d’application (ID d’application du partenaire CPV).

Paramètres d’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 Requise Type Description
Autorisation True string Jeton d’accès pour l’audience https://api.partnercenter.microsoft.com
Accept True string Type de contenu acceptable, généralement type d’application/json
ms-correlationid string Utilisé pour le suivi des demandes en interne. S’il ms-correlationid n’est pas fourni, le serveur en génère un nouveau pour chaque demande
ms-requestid string Utilisé pour l’idempotency des requêtes. Si un ms-requestid n’est pas fourni, le serveur en génère un nouveau pour chaque demande

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éée Le consentement de l’application est supprimé. Types de supports : application/json, application/xml, text/xml, text/json
400 Demande incorrecte Une entrée est 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 transmettre un jeton d’accès valide pour un public 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 d’appeler. Types de supports : application/json, application/xml, text/xml, text/json
404 Not Found La ressource n’est pas trouvée ou n’est pas 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 requête. Types de supports : application/json, application/xml, text/xml, text/json

Contenu connexe