Freigeben über

Erstellen von accessPackageResourceRequest

  • Artikel

Namespace: microsoft.graph

Erstellen Sie ein neues accessPackageResourceRequest-Objekt , um das Hinzufügen einer Ressource zu einem Zugriffspaketkatalog, das Aktualisieren einer Ressource oder das Entfernen einer Ressource aus einem Katalog anzufordern. Eine Ressource muss in einen Zugriffspaketkatalog aufgenommen werden, bevor eine Rolle dieser Ressource einem Zugriffspaket hinzugefügt werden kann.

  • Um einem Katalog eine Microsoft Entra Gruppe als Ressource hinzuzufügen, legen Sie den requestType auf adminAddfest, und legen Sie einen resource fest, der die Ressource darstellt. Der Wert der originSystem-Eigenschaft innerhalb der resource sollte sein AadGroup , und der Wert der originId ist der Bezeichner der Gruppe.
  • Um einem Katalog eine Microsoft Entra Anwendung als Ressource hinzuzufügen, legen Sie den requestType auf adminAddfest, und legen Sie eine resource fest, die die Ressource darstellt. Der Wert der originSystem-Eigenschaft innerhalb der resource sollte sein AadApplication , und der Wert der originId ist der Bezeichner von servicePrincipal.
  • Um eine SharePoint Online-Website als Ressource zu einem Katalog hinzuzufügen, legen Sie den requestType auf adminAddfest, und legen Sie eine resource fest, die die Ressource darstellt. Der Wert der originSystem-Eigenschaft innerhalb der resource sollte sein SharePointOnline , und der Wert der originId ist der URI der Website.
  • Um eine Ressource aus einem Katalog zu entfernen, legen Sie den requestType auf adminRemovefest, und legen Sie fest resource , dass der des id zu entfernenden Ressourcenobjekts enthalten ist. Das Ressourcenobjekt kann mithilfe von Listenressourcen abgerufen werden.

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) EntitlementManagement.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application EntitlementManagement.ReadWrite.All Nicht verfügbar.

Tipp

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer über eine der folgenden Optionen auch eine Administratorrolle mit unterstützten Rollenberechtigungen zugewiesen werden:

In reinen App-Szenarien kann der aufrufenden App anstelle EntitlementManagement.ReadWrite.All der Anwendungsberechtigung eine der oben genannten unterstützten Rollen zugewiesen werden. Die Rolle Katalogbesitzer ist weniger privilegiert als die EntitlementManagement.ReadWrite.All Anwendungsberechtigung.

Darüber hinaus müssen Sie über die folgenden Berechtigungen für die ressource verfügen, die hinzugefügt wird:

  • So fügen Sie einem Katalog eine Microsoft Entra Gruppe als Ressource hinzu:
    • Wenn Delegierte Berechtigungen verwendet werden, sollte der Benutzer, der das Hinzufügen einer Gruppe anfordert, Besitzer der Gruppe oder in einer Verzeichnisrolle sein, die es dem Benutzer ermöglicht, Gruppen zu ändern.
    • Wenn Sie Anwendungsberechtigungen verwenden, sollte der Anwendung, die das Hinzufügen der Gruppe anfordert, auch die Group.ReadWrite.All Berechtigung zugewiesen werden.
  • So fügen Sie einem Katalog eine Microsoft Entra Anwendung als Ressource hinzu:
    • Bei Verwendung delegierter Berechtigungen sollte der Benutzer, der das Hinzufügen einer Anwendung anfordert, Besitzer der Anwendung oder in einer Verzeichnisrolle sein, die es ihnen ermöglicht, Anwendungsrollenzuweisungen zu ändern.
    • Wenn Sie Anwendungsberechtigungen verwenden, sollte der Anwendung, die das Hinzufügen von servicePrincipal anfordert, auch die Berechtigung Application.ReadWrite.All zugewiesen werden.
  • So fügen Sie eine SharePoint Online-Website als Ressource zu einem Katalog hinzu:

HTTP-Anforderung

POST /identityGovernance/entitlementManagement/resourceRequests

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 eines accessPackageResourceRequest-Objekts an. Schließen Sie die resource Beziehung mit einem accessPackageResource-Objekt als Teil der Anforderung und einem catalog -Objekt ein, das seine identhält.

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein neues accessPackageResourceRequest-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Erstellen einer accessPackageResourceRequest zum Hinzufügen einer Gruppe als Ressource

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/resourceRequests
Content-type: application/json

{
  "requestType": "adminAdd",
  "resource": {
    "displayName": "Test group",
    "originId": "8ab659d0-3839-427d-8c54-5ae92f0b3e2e",
    "originSystem": "AadGroup"
  },
  "catalog": {
    "id": "beedadfe-01d5-4025-910b-84abb9369997"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "acc2294e-f37f-42d3-981d-4e83847ed0ce",
  "requestType": "adminAdd",
  "state": "delivered"
}

Beispiel 2: Erstellen einer accessPackageResourceRequest zum Hinzufügen einer Anwendung als Ressource

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/resourceRequests
Content-type: application/json

{
  "requestType": "adminAdd",
  "resource": {
    "originId": "e81d7f57-0840-45e1-894b-f505c1bdcc1f",
    "originSystem": "AadApplication"
  },
  "catalog": {
    "id": "beedadfe-01d5-4025-910b-84abb9369997"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "acc2294e-f37f-42d3-981d-4e83847ed0ce",
  "requestType": "adminAdd",
  "state": "delivered"
}

Beispiel 3: Erstellen einer accessPackageResourceRequest zum Hinzufügen einer SharePoint Online-Website als Ressource

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/resourceRequests
Content-type: application/json

{
  "requestType": "adminAdd",
  "resource": {
    "originId": "https://microsoft.sharepoint.com/sites/Example",
    "originSystem": "SharePointOnline"
  },
  "catalog": {
    "id": "beedadfe-01d5-4025-910b-84abb9369997"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "acc2294e-f37f-42d3-981d-4e83847ed0ce",
  "requestType": "adminAdd",
  "state": "delivered"
}

Beispiel 4: Erstellen einer accessPackageResourceRequest zum Entfernen einer Ressource

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/resourceRequests
Content-type: application/json

{
  "requestType": "adminRemove",
  "resource": {
    "id": "1d0bb962-5bb0-4b16-a488-fda7a788b9ec"
  },
  "catalog": {
    "id": "beedadfe-01d5-4025-910b-84abb9369997"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "acc2294e-f37f-42d3-981d-4e83847ed0ce",
  "requestType": "adminRemove",
  "state": "delivered"
}

Beispiel 5: Erstellen einer accessPackageResourceRequest zum Aktualisieren einer Anwendung als Ressource mit Attributen

Das folgende Beispiel zeigt eine Anforderung zum Aktualisieren einer Ressource in einem Katalog für eine Anwendung, die bereits als Ressource hinzugefügt wurde, mit zwei Attributen.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/resourceRequests
Content-type: application/json

{
  "requestType": "adminUpdate",
  "resource": {
    "originId": "e81d7f57-0840-45e1-894b-f505c1bdcc1f",
    "originSystem": "AadApplication",
    "attributes": [
      {
        "destination": {
          "@odata.type": "microsoft.graph.accessPackageUserDirectoryAttributeStore"
        },
        "name": "officeLocation",
        "source": {
          "@odata.type": "#microsoft.graph.accessPackageResourceAttributeQuestion",
          "question": {
            "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion",
            "sequence": 1,
            "isRequired": true,
            "isAnswerEditable": true,
            "text": "What office do you work at?",
            "isSingleLineQuestion": true,
            "regexPattern": "[a-zA-Z]+[a-zA-Z\\s]*"
          }
        }
      },
      {
        "destination": {
          "@odata.type": "microsoft.graph.accessPackageUserDirectoryAttributeStore"
        },
        "name": "extension_e409fedc08ab4807a9eb53ebc0d6cc9f_Expense_CostCenter",
        "source": {
          "@odata.type": "#microsoft.graph.accessPackageResourceAttributeQuestion",
          "question": {
            "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion",
            "isRequired": false,
            "text": "What is your cost center number?",
            "sequence": 0,
            "isSingleLineQuestion": true,
            "regexPattern": "[0-9]*"
          }
        }
      }
    ]
  },
  "catalog": {
    "id": "beedadfe-01d5-4025-910b-84abb9369997"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "acc2294e-f37f-42d3-981d-4e83847ed0ce",
  "requestType": "adminAdd",
  "state": "delivered"
}