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.
Namespace: microsoft.graph
Erstellen Sie ein neues delegatedAdminRelationshipRequest-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
|---|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | DelegatedAdminRelationship.ReadWrite.All | Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
| Application | DelegatedAdminRelationship.ReadWrite.All | Nicht verfügbar. |
HTTP-Anforderung
POST /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationshipId}/requests
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des delegatedAdminRelationshipRequest-Objekts an.
Sie können die folgenden Eigenschaften angeben, wenn Sie eine delegatedAdminRelationshipRequest erstellen.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Aktion | delegatedAdminRelationshipRequestAction | Die Aktion, die für die delegierte Administratorbeziehung ausgeführt werden soll. Erforderlich. Mögliche Werte sind: lockForApproval, approve, terminate, unknownFutureValue, reject. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Member in dieser verteilbaren Enumeration abzurufen: reject. Damit ein Partner eine Beziehung im createdstatus abschließen kann, legen Sie die Aktion auf festlockForApproval. Damit ein Partner eine Beziehung im activestatus beenden kann, legen Sie die Aktion auf festterminate. Damit ein indirekter Vertriebspartner eine von einem indirekten Anbieter im approvalPendingstatus erstellte Beziehung genehmigt, legen Sie die Aktion auf festapprove. Damit ein indirekter Wiederverkäufer eine von einem indirekten Anbieter im approvalPendingstatus erstellte Beziehung ablehnt, legen Sie die Aktion auf festreject. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein delegatedAdminRelationshipRequest-Objekt im Antworttext zurück. Die Antwort enthält einen Location-Header , der eine URL zur erstellten Delegierten Administratorbeziehungsanforderung enthält.
Beispiele
Anforderung
POST https://graph.microsoft.com/v1.0/tenantRelationships/delegatedAdminRelationships/5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836/requests
Content-Type: application/json
{
"action": "lockForApproval"
}
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-Type: application/json
Location: https://graph.microsoft.com/v1.0/tenantRelationships/delegatedAdminRelationships/c45e5ffb-3de2-4938-a214-b7eed802db66-4be56058-bb48-4a8e-8282-6cf0e98e6c9d/requests/5a6666c9-7282-0a41-67aa-25a5a3fbf339
{
"@odata.type": "#microsoft.graph.delegatedAdminRelationshipRequest",
"@odata.context": "https://graph.microsoft.com/v1.0/tenantRelationships/$metadata#requests",
"id": "5a6666c9-7282-0a41-67aa-25a5a3fbf339",
"action": "lockForApproval",
"status": "created",
"createdDateTime": "2022-02-10T10:55:47.1180588Z",
"lastModifiedDateTime": "2022-02-10T10:55:47.1180588Z"
}