Freigeben über

Erstellen von accessPackageResourceRequest

  • 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.

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.

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
Anwendung 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/accessPackageResourceRequests

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 accessPackageResource Beziehung mit einem accessPackageResource-Objekt als Teil der Anforderung ein.

Um einem Katalog eine Microsoft Entra Gruppe als Ressource hinzuzufügen, legen Sie die catalogId auf die ID des Katalogs, requestType auf AdminAddund eine accessPackageResource , die die Ressource darstellt, fest. Der Wert der originSystem-Eigenschaft innerhalb der accessPackageResource sollte sein AadGroup , und der Wert der originId ist der Bezeichner der Gruppe. 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.

Um einem Katalog eine Microsoft Entra Anwendung als Ressource hinzuzufügen, legen Sie die catalogId auf die ID des Katalogs, requestType auf AdminAddund eine accessPackageResource , die die Ressource darstellt, fest. Der Wert der originSystem-Eigenschaft innerhalb der accessPackageResource sollte sein AadApplication , und der Wert der originId ist der Bezeichner von servicePrincipal. 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.

Um eine SharePoint Online-Website als Ressource zu einem Katalog hinzuzufügen, legen Sie die catalogId auf die ID des Katalogs, requestType auf AdminAddund eine accessPackageResource , die die Ressource darstellt, fest. Der Wert der originSystem-Eigenschaft innerhalb der accessPackageResource sollte sein SharePointOnline , und der Wert der originId ist der URI der Website. Wenn Sie delegierte Berechtigungen verwenden, sollte der Benutzer die SharePoint-Administratorrolle verwenden. Wenn Sie Anwendungsberechtigungen verwenden, sollte der Anwendung, die das Hinzufügen der Website anfordert, auch die Sites.FullControl.All Berechtigung zugewiesen werden. Um die Geolocation-Umgebung für eine Sharepoint Online-Ressource mit mehreren Geolocations zuzuweisen, schließen Sie die accessPackageResourceEnvironment-Beziehung in das accessPackageResource Objekt ein. Dies kann auf zwei Arten erfolgen:

  • Verwenden Sie @odata.bind die -Anmerkung, um die id von accessPackageResourceEnvironment einem accessPackageResourceEnvironment -Objekt zuzuweisen.
  • Geben Sie den originId Parameter von accessPackageResourceEnvironment in einem -Objekt an accessPackageResourceEnvironment .

Um eine Ressource aus einem Katalog zu entfernen, legen Sie die catalogId auf die ID des Katalogs, requestType auf AdminRemoveund das accessPackageResource zu entfernende Ressourcenobjekt fest. Das Ressourcenobjekt kann mithilfe von list accessPackageResources abgerufen werden.

Antwort

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 Website als Ressource

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
Content-type: application/json

{
  "catalogId":"26ac0c0a-08bc-4a7b-a313-839f58044ba5",
  "requestType": "AdminAdd",
  "justification": "",
  "accessPackageResource": {
     "displayName": "Sales",
     "description": "https://contoso.sharepoint.com/sites/Sales",
     "url": "https://contoso.sharepoint.com/sites/Sales",
     "resourceType": "SharePoint Online Site",
     "originId": "https://contoso.sharepoint.com/sites/Sales",
     "originSystem": "SharePointOnline"
  }
}

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

{
  "catalogId": "26ac0c0a-08bc-4a7b-a313-839f58044ba5",
  "id": "1fe272f0-d463-42aa-a9a8-b07ab50a1c4d",
  "isValidationOnly": false,
  "justification": "",
  "requestState": "Delivered",
  "requestStatus": "Fulfilled",
  "requestType": "AdminAdd"
}

Beispiel 2: Erstellen einer accessPackageResourceRequest zum Hinzufügen einer Website als Ressource und Zuweisen eines accessPackageResourceEnvironment mit @odata.bind

Anforderung

Das folgende Beispiel zeigt eine Anfrage. In diesem Beispiel wird die @odata.bind -Anmerkung verwendet, um die id von accessPackageResourceEnvironment einem accessPackageResourceEnvironment -Objekt zuzuweisen.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
Content-type: application/json

{
    "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
    "accessPackageResource": {
        "displayName": "Community Outreach",
        "description": "https://contoso.sharepoint.com/sites/CSR",
        "resourceType": "SharePoint Online Site",
        "originId": "https://contoso.sharepoint.com/sites/CSR",
        "originSystem": "SharePointOnline",
        "accessPackageResourceEnvironment@odata.bind": "accessPackageResourceEnvironments/615f2218-678f-471f-a60a-02c2f4f80c57"
    },
    "requestType": "AdminAdd"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageResourceRequests/$entity",
    "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
    "executeImmediately": false,
    "id": "d3f800d5-0dd6-47f3-9e90-ef562c7551dc",
    "requestType": "AdminAdd",
    "requestState": "Delivered",
    "requestStatus": "Fulfilled",
    "isValidationOnly": false,
    "expirationDateTime": null,
    "justification": null
}

Beispiel 3: Erstellen einer accessPackageResourceRequest zum Hinzufügen einer Website als Ressource und Zuweisen eines accessPackageResourceEnvironment mithilfe von originId

Anforderung

Das folgende Beispiel zeigt eine Anfrage. In diesem Beispiel werden die Parameter eines accessPackageResourceEnvironment in einem accessPackageResourceEnvironment -Objekt angegeben.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
Content-type: application/json

{
    "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
    "accessPackageResource": {
        "displayName": "Community Outreach",
        "description": "https://contoso.sharepoint.com/sites/CSR",
        "resourceType": "SharePoint Online Site",
        "originId": "https://contoso.sharepoint.com/sites/CSR",
        "originSystem": "SharePointOnline",
        "accessPackageResourceEnvironment": {
            "originId": "https://contoso-admin.sharepoint.com/"
        }
    },
    "requestType": "AdminAdd"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/entitlementManagement/accessPackageResourceRequests/$entity",
    "catalogId": "de9315c1-272b-4905-924b-cc112ca180c7",
    "executeImmediately": false,
    "id": "eadf3fbb-668c-4c3a-8d84-7c8bd73dc3e4",
    "requestType": "AdminAdd",
    "requestState": "Delivered",
    "requestStatus": "Fulfilled",
    "isValidationOnly": false,
    "expirationDateTime": null,
    "justification": null
}

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

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
Content-type: application/json

{

  "catalogId":"beedadfe-01d5-4025-910b-84abb9369997",
  "requestType": "AdminAdd",
  "accessPackageResource": {
     "originId": "c6294667-7348-4f5a-be73-9d2c65f574f3",
     "originSystem": "AadGroup"
  }
}

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

{
  "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
  "id": "acc2294e-f37f-42d3-981d-4e83847ed0ce",
  "requestType": "AdminAdd",
  "requestState": "Delivered",
  "requestStatus": "Fulfilled"
}

Beispiel 5: Erstellen einer accessPackageResourceRequest zum Entfernen einer Ressource

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
Content-type: application/json

{
  "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
  "requestType": "AdminRemove",
  "accessPackageResource": {
    "id": "354078e5-dbce-4894-8af4-0ab274d41662"
  }
}

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

{
  "catalogId": "beedadfe-01d5-4025-910b-84abb9369997",
  "id": "65c3340d-defb-49a9-8930-63841fda0e68",
  "requestType": "AdminRemove",
  "requestState": "Delivered",
  "requestStatus": "Fulfilled"
}

Beispiel 6: Erstellen einer accessPackageResourceRequest zum Hinzufügen einer Anwendung

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Hinzufügen einer Anwendung zu einem Katalog, einschließlich der Angabe eines erforderlichen Attributs dieser Anwendung.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageResourceRequests
Content-type: application/json

{
  "catalogId": "26ac0c0a-08bc-4a7b-a313-839f58044ba5",
  "requestType": "AdminAdd",
  "justification": "",
  "accessPackageResource": {
      "displayName": "Faculty cafeteria ordering",
      "description": "Example application",
      "url": "https://myapps.microsoft.com/example.com/signin/Faculty%20cafeteria%20ordering/f1e3b407-942d-4934-9a3f-cef1975cb988/",
      "resourceType": "Application",
      "originId": "2f1099a6-d4fc-4cc9-a0ef-ddd3f1bf0b7e",
      "originSystem": "AadApplication",
      "attributes": [
        {
          "attributeName": "extension_2b676109c7c74ae2b41549205f1947ed_personalTitle",
          "isEditable": true,
          "isPersistedOnAssignmentRemoval": true,
          "attributeSource": {
              "@odata.type": "#microsoft.graph.accessPackageResourceAttributeQuestion",
              "question": {
                  "@odata.type": "#microsoft.graph.accessPackageTextInputQuestion",
                  "isRequired": false,
                  "sequence": 0,
                  "isSingleLineQuestion": true,
                  "text": {
                      "defaultText": "Title",
                      "localizedTexts": []
                  }
              }
          },
          "attributeDestination": {
              "@odata.type": "#microsoft.graph.accessPackageUserDirectoryAttributeStore"
          }
        }
      ]
  }
}

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": "f0e632ed-afd2-41d3-8d6e-ccefda457e5e",
  "requestType": "AdminAdd",
  "requestState": "Delivered",
  "requestStatus": "Fulfilled"
}