Kundenzustimmung als Systemsteuerung Anbieter erhalten
Als Systemsteuerung Anbieter (CPV) können Sie REST-APIs verwenden, um die Zustimmung Ihrer CSP-Kunden zu erwerben und zu entfernen, um Berechtigungen für ihre Mandanten zu erhalten.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Hinweis
Der Satzgrenzwert beträgt 50 Anforderungen pro Sekunde (RPS) für jede ApplicationId (Anwendungs-ID des CPV-Partners).
Zustimmung erwerben
URI-Parameter
| Name | Geben Sie in | Erforderlich | Type | Beschreibung |
|---|---|---|---|---|
| customer_id | path | True | Zeichenfolge | ID des kunden, der im Partner Center generiert wurde |
Anforderungsheader
Medientypen: application/json
| Name | Erforderlich | Type | Beschreibung |
|---|---|---|---|
| Autorisierung | True | Zeichenfolge | Zugriffstoken für Zielgruppe https://api.partnercenter.microsoft.com |
| Accept | True | Zeichenfolge | Zulässiger Inhaltstyp; weit akzeptierte Typanwendung/json |
| ms-correlationid | Zeichenfolge | Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue. | |
| ms-requestid | Zeichenfolge | Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung einen neuen. |
Anforderungstext
Medientypen: application/json
| Name | Typ | Beschreibung |
|---|---|---|
| applicationId | Zeichenfolge | Anwendungs-ID des CPV-Partners |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Liste der Anwendungserteilungen, um den Zugriff für Ihre Kunden in ihrem Mandanten zu erhalten |
Antworten
| Name | Typ | BESCHREIBUNG |
|---|---|---|
| 200 OK | Die Anforderung war erfolgreich. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 201 (Erstellt) | Die Anwendungsgenehmigung wird erstellt. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 400 – Ungültige Anforderung | Fehlende oder ungültige Eingaben. Der Antworttext enthält die Fehlerdetails. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 401 – Nicht autorisiert | Die Anforderung wurde nicht authentifiziert. Der Client muss ein gültiges Zugriffstoken für eine gültige Zielgruppe übergeben. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 403 Verboten | Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 404 Nicht gefunden | Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 500: Interner Serverfehler | Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer können die Anforderung wiederholen. Medientypen: application/json, , text/xmlapplication/xmltext/json |
Definitionen
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Name | Typ | Beschreibung |
|---|---|---|
| enterpriseApplicationId | Zeichenfolge | Die GUID-Darstellung der Ressource, die Zugriff erhält |
| scope | Zeichenfolge | Durch Trennzeichen getrennte Werte des Bereichs für den Zugriff |
Zustimmung entfernen
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Hinweis
Der Satzgrenzwert beträgt 50 Anforderungen pro Sekunde (RPS) für jede ApplicationId (Anwendungs-ID des CPV-Partners).
URI-Parameter
| Name | Geben Sie in | Erforderlich | Type | Beschreibung |
|---|---|---|---|---|
| customer_id | path | True | Zeichenfolge | ID des kunden, der im Partner Center generiert wurde |
| Application_id | path | True | Zeichenfolge | ID Ihrer CPV-Anwendung |
Anforderungsheader
Medientypen: application/json
| Name | Erforderlich | Type | Beschreibung |
|---|---|---|---|
| Autorisierung | True | Zeichenfolge | Zugriffstoken für Zielgruppe https://api.partnercenter.microsoft.com |
| Accept | True | Zeichenfolge | Akzeptabler Inhaltstyp, in der Regel typ application/json |
| ms-correlationid | Zeichenfolge | Wird intern zum Nachverfolgen von Anforderungen verwendet. ms-correlationid Wenn kein Server bereitgestellt wird, generiert der Server für jede Anforderung einen neuen. |
|
| ms-requestid | Zeichenfolge | Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung einen neuen. |
Antworten
| Name | Typ | BESCHREIBUNG |
|---|---|---|
| 200 OK | Die Anforderung war erfolgreich. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 201 (Erstellt) | Die Zustimmung der Anwendung wird gelöscht. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 400 – Ungültige Anforderung | Fehlende oder ungültige Eingaben. Der Antworttext enthält die Fehlerdetails. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 401 – Nicht autorisiert | Die Anforderung wurde nicht authentifiziert. Der Client muss ein gültiges Zugriffstoken für eine gültige Zielgruppe übergeben. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 403 Verboten | Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 404 Nicht gefunden | Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Medientypen: application/json, , text/xmlapplication/xmltext/json |
|
| 500: Interner Serverfehler | Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer können die Anforderung wiederholen. Medientypen: application/json, , text/xmlapplication/xmltext/json |