Obtenir le consentement du client en tant que fournisseur Panneau de configuration
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).
Acquérir le consentement
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 |
Supprimer le consentement
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 |