Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |