Einholen der Zustimmung des Kunden als Systemsteuerung Anbieter

  • Artikel

Als Systemsteuerung Vendor (CPV) können Sie REST-APIs verwenden, um die Zustimmung Ihrer CSP-Kunden zu erhalten und zu entfernen, um Berechtigungen für ihre Mandanten zu erhalten.

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

URI-Parameter

Name Geben Sie in Erforderlich Typ BESCHREIBUNG
customer_id path True Zeichenfolge ID des in Partner Center generierten Kunden

Anforderungsheader

Medientypen: application/json

Name Erforderlich Typ BESCHREIBUNG
Authorization True Zeichenfolge Zugriffstoken für Die Zielgruppe https://api.partnercenter.microsoft.com
Akzeptieren True Zeichenfolge Akzeptabler Inhaltstyp; Allgemein akzeptierte Typ application/json
ms-correlationid Zeichenfolge Wird für die interne Nachverfolgung von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue.
ms-requestid Zeichenfolge Wird für Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue.

Anforderungstext

Medientypen: application/json

Name Typ Beschreibung
applicationId Zeichenfolge Anwendungs-ID des CPV-Partners
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Liste der Anwendungszuweisungen, 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", "application/xml", "text/xml", "text/json"
201 – Erstellt Die Anwendungsgenehmigung wird erstellt. Medientypen: "application/json", "application/xml", "text/xml", "text/json"
400 – Ungültige Anforderung Es fehlte oder ungültige Eingabe. Der Antworttext enthält die Fehlerdetails. Medientypen: "application/json", "application/xml", "text/xml", "text/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", "application/xml", "text/xml", "text/json"
403 Verboten Die Anforderung wurde authentifiziert, aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Medientypen: "application/json", "application/xml", "text/xml", "text/json"
404 – Nicht gefunden Die Ressource ist mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Medientypen: "application/json", "application/xml", "text/xml", "text/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", "application/xml", "text/xml", "text/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 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

URI-Parameter

Name Geben Sie in Erforderlich Typ BESCHREIBUNG
customer_id path True Zeichenfolge ID des in Partner Center generierten Kunden
Application_id path True Zeichenfolge ID Ihrer CPV-Anwendung

Anforderungsheader

Medientypen: application/json

Name Erforderlich Typ BESCHREIBUNG
Authorization True Zeichenfolge Zugriffstoken für Zielgruppe https://api.partnercenter.microsoft.com
Akzeptieren True Zeichenfolge Zulässiger Inhaltstyp, in der Regel application/json
ms-correlationid Zeichenfolge Wird für die interne Nachverfolgung von Anforderungen verwendet. Wenn kein ms-correlationid bereitgestellt wird, generiert der Server für jede Anforderung eine neue.
ms-requestid Zeichenfolge Wird für Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue.

Antworten

Name Typ BESCHREIBUNG
200 – OK Die Anforderung war erfolgreich. Medientypen: "application/json", "application/xml", "text/xml", "text/json"
201 – Erstellt Die Einwilligung der Anwendung wird gelöscht. Medientypen: "application/json", "application/xml", "text/xml", "text/json"
400 – Ungültige Anforderung Es fehlte oder ungültige Eingaben. Der Antworttext enthält die Fehlerdetails. Medientypen: "application/json", "application/xml", "text/xml", "text/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", "application/xml", "text/xml", "text/json"
403 Verboten Die Anforderung wurde authentifiziert, aber abgelehnt, weil der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Medientypen: "application/json", "application/xml", "text/xml", "text/json"
404 – Nicht gefunden Die Ressource ist mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Medientypen: "application/json", "application/xml", "text/xml", "text/json"
500 Interner Serverfehler Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Aufrufer können die Anforderung wiederholen. Medientypen: "application/json", "application/xml", "text/xml", "text/json"

Nächste Schritte