Erstellen von accessPackageResourceRequest

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.

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) EntitlementManagement.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung EntitlementManagement.ReadWrite.All Nicht verfügbar.
  • 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:
    • Wenn delegierte Berechtigungen verwendet werden, sollte der Benutzer, der die Website hinzufügen möchte, eine Rolle besitzen, die es ihnen ermöglicht, die SharePoint-Websiterollen zu ändern, z. B. die SharePoint-Administratorrolle .
    • Wenn Sie Anwendungsberechtigungen verwenden, sollte der Anwendung auch die Sites.FullControl.All Berechtigung zugewiesen werden.

HTTP-Anforderung

POST /identityGovernance/entitlementManagement/resourceRequests

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die 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"
}