Freigeben über


Anforderungen erstellen

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"
}