Freigeben über

Aktualisieren von delegatedAdminRelationship

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktualisieren sie die Eigenschaften eines delegatedAdminRelationship-Objekts .

Es gelten die folgenden Einschränkungen:

  • Sie können diese Beziehung aktualisieren, wenn die status -Eigenschaft istcreated.
  • Sie können die autoExtendDuration-Eigenschaft aktualisieren, wenn status entweder created oder activeist.
  • Sie können die Rolle Microsoft Entra globalen Administrator nur entfernen, wenn die eigenschaft status istactive, was auf einen vorgang mit langer Ausführungsdauer hinweist.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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
Anwendung DelegatedAdminRelationship.ReadWrite.All Nicht verfügbar.

Um diese API mithilfe von Anwendungsberechtigungen aufzurufen, müssen Sie den Dienstprinzipal bereitstellen, der durch appId2832473f-ec63-45fb-976f-5d45a7d4bb91 und delegierte Partnerkundenverwaltung im Partnermandanten identifiziert wird. Um den Dienstprinzipal im Partnermandanten bereitzustellen, rufen Sie die Create servicePrincipal-API auf.

HTTP-Anforderung

PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationshipId}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
If-Match If-match: {etag}. Letzter bekannter ETag-Wert für die zu aktualisierende delegierteAdminRelationship . Rufen Sie den ETag-Wert aus einem LIST- oder GET-Vorgang ab. Erforderlich.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft Typ Beschreibung
accessDetails delegatedAdminAccessDetails Die Bezeichner der Administratorrollen, auf die der Partner im Kundenmandanten Zugriff anfordert oder hat.
autoExtendDuration Dauer Die Dauer, um die die Gültigkeit der Beziehung automatisch verlängert wird, angegeben im ISO 8601-Format. Unterstützte Werte sind: P0D, PT0S, P180D. Der Standardwert ist PT0S. PT0S gibt an, dass die Beziehung abläuft, wenn endDateTime erreicht ist und nicht automatisch verlängert wird.
Kunde delegatedAdminRelationshipCustomerParticipant Der Anzeigename und der eindeutige Bezeichner des Kunden der Beziehung.
displayName String Der Anzeigename der Beziehung, die zur einfachen Identifizierung verwendet wird. Muss für alle delegierten Administratorbeziehungen des Partners eindeutig sein. Die maximale Länge beträgt 50 Zeichen.
Dauer Dauer Die Dauer der Beziehung im ISO 8601-Format. Muss ein Wert zwischen P1D und P2Y inklusiv sein.

Antwort

Bei erfolgreicher Ausführung gibt die Methode entweder einen 200 OK oder einen Antwortcode zurück 202 Accepted . Der Antworttext enthält ein delegatedAdminRelationship-Objekt , wenn die Antwort ist 200 OK.

Antwortheader

Name Beschreibung
Content-Type application/json.
Standort Der Speicherort des zeitintensiven Vorgangs.
Retry-After Die Zeit, nach der ein nachfolgender API-Aufruf an die Standort-URL erfolgen kann, um die status des zeitintensiven Vorgangs zu überprüfen.

Diese Methode gibt eine 202 Accepted Antwort zurück, wenn Sie die Rolle Microsoft Entra globalen Administrator aus der Beziehung entfernen, während die status -Eigenschaft istactive. Die Antwort enthält eine URL im Header Location, mit der Sie den Fortschritt des Vorgangs überwachen können.

Wenn Sie nicht die Vorlagen-ID angeben, die der Rolle Microsoft Entra Globaler Administrator im Array in der unifiedRolesaccessDetails -Eigenschaft des Anforderungstexts entspricht, gibt die API und das ursprüngliche delegatedAdminRelationship-Objekt im Antworttext zurück200 OK.

Beispiele

Anforderung

Das folgende Beispiel zeigt die Antwort.

PATCH https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836
If-Match: W/"JyI0NzAwNjg0NS0wMDAwLTE5MDAtMDAwMC02MGY0Yjg4MzAwMDAiJw=="
Content-Type: application/json

{
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.delegatedAdminRelationship",
  "@odata.context": "https://graph.microsoft.com/beta/tenantRelationships/$metadata#delegatedAdminRelationships/$entity",
  "@odata.etag": "W/\"JyIwMzAwZTM0ZS0wMDAwLTAyMDAtMDAwMC02MTRjZjI1YzAwMDAiJw==\"",
  "id": "5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836",
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "status": "created",
  "createdDateTime": "2022-02-10T11:24:42.3148266Z",
  "lastModifiedDateTime": "2022-02-10T11:26:44.9941884Z",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

Es folgt eine Beispielantwort, die einen 202 Accepted Antwortcode zusammen mit den Headern Location und Retry-After zurückgibt.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5e5594d3-6f82-458b-b567-77db4811f0cd-00000000-0000-0000-0000-000000001234/operations/d8dbb27b-7fe7-4523-a3df-f766355fe0f2
Retry-After: 10
Content-Type: application/json

{
}