Erstellen von accessPackageResourceRequest

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 einem Zugriffspaketkatalog enthalten sein, 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
Application EntitlementManagement.ReadWrite.All Nicht verfügbar.

Tipp

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

  • Eine Rolle im Berechtigungsverwaltungssystem , bei der die Rolle "Katalogbesitzer" die am wenigsten privilegierte Rolle ist. Dies ist die Option mit den geringsten Berechtigungen.
  • Weitere privilegierte Microsoft Entra-Rollen, die für diesen Vorgang unterstützt werden:
    • Identity Governance Administrator

In reinen App-Szenarien kann der aufrufenden App anstelle der EntitlementManagement.ReadWrite.All 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 benötigen Sie die folgenden Berechtigungen für die hinzuzufügende Ressource:

  • So fügen Sie eine Microsoft Entra-Gruppe als Ressource zu einem Katalog hinzu:
    • Wenn Sie delegierte Berechtigungen verwenden, sollte der Benutzer, der das Hinzufügen einer Gruppe anfordert, Besitzer der Gruppe sein oder einer Verzeichnisrolle angehören, die es ihm erlaubt, Gruppen zu ändern.
    • Wenn Anwendungsberechtigungen verwendet werden, sollte der Anwendung, die das Hinzufügen der Gruppe anfordert, die Group.ReadWrite.All Berechtigung ebenfalls zugewiesen werden.
  • So fügen Sie eine Microsoft Entra Rolle als Ressource zu einem Katalog hinzu:
    • Wenn Sie delegierte Berechtigungen verwenden, muss der Benutzer, der die Rolle zum Katalog hinzufügen möchte, ein globaler Administrator oder ein Administrator mit privilegierten Rollen und Berechtigungen des Katalogbesitzers sein.
    • Anwendungen mit der Berechtigung Entitlement Management.ReadWrite.All können Microsoft Entra-Rollen nicht zu Katalogen hinzufügen, es sei denn, sie verfügen auch über die Berechtigungen eines globalen Administrators oder eines Berechtigungsrollenadministrators.
  • So fügen Sie eine Microsoft Entra-Anwendung als Ressource zu einem Katalog hinzu:
    • Wenn Sie delegierte Berechtigungen verwenden, sollte der Benutzer, der das Hinzufügen einer Anwendung anfordert, Besitzer der Anwendung oder in einer Verzeichnisrolle sein, die es ihm ermöglicht, Anwendungsrollenzuweisungen zu ändern.
    • Wenn Anwendungsberechtigungen verwendet werden, 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 Sie delegierte Berechtigungen verwenden, muss dem Benutzer die SharePoint-Administratorrolle zugewiesen werden oder er muss ein Administrator der SharePoint-Website sein.
    • Wenn Anwendungsberechtigungen verwendet werden, sollte der Anwendung die Sites.FullControl.All Berechtigung ebenfalls zugewiesen werden.

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 eine Microsoft Entra-Gruppe als Ressource zu einem Katalog hinzuzufügen, legen Sie fest, dass catalogId der ID des Katalogs entspricht, requestType ist AdminAddund die accessPackageResource Ressource darstellt. Der Wert der originSystem-Eigenschaft innerhalb des accessPackageResource sollte AadGroup sein, und der Wert der originId ist der Bezeichner der Gruppe. Wenn Sie delegierte Berechtigungen verwenden, sollte der Benutzer, der das Hinzufügen einer Gruppe anfordert, Besitzer der Gruppe sein oder eine Verzeichnisrolle innehaben, die es ihm erlaubt, Gruppen zu ändern. Wenn Anwendungsberechtigungen verwendet werden, sollte der Anwendung, die das Hinzufügen der Gruppe anfordert, die Group.ReadWrite.All Berechtigung ebenfalls zugewiesen werden.

Um eine Microsoft Entra-Anwendung als Ressource zu einem Katalog hinzuzufügen, legen Sie fest, dass catalogId der ID des Katalogs entspricht, requestType ist AdminAddund die accessPackageResource Ressource darstellt. Der Wert der originSystem-Eigenschaft innerhalb des accessPackageResource sollte AadApplication sein, und der Wert der originId ist der Bezeichner des servicePrincipal. Wenn Sie delegierte Berechtigungen verwenden, sollte der Benutzer, der das Hinzufügen einer Anwendung anfordert, Besitzer der Anwendung sein oder einer Verzeichnisrolle angehören, die es ihm ermöglicht, Anwendungsrollenzuweisungen zu ändern.

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

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

Um eine Ressource aus einem Katalog zu entfernen, setzen Sie die catalogId auf die ID des Katalogs, requestType auf AdminRemovebe und das accessPackageResource zu entfernende Ressourcenobjekt. Das Ressourcenobjekt kann mit list accessPackageResources abgerufen werden.

Antwort

Bei erfolgreicher Ausführung gibt diese 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 Site als Ressource und Zuweisen einer accessPackageResourceEnvironment mithilfe von @odata.bind

Anforderung

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

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 Site als Ressource und Zuweisen einer accessPackageResourceEnvironment mithilfe von originId

Anforderung

Das folgende Beispiel zeigt eine Anfrage. In diesem Beispiel werden die Parameter von an 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"
}

Beispiel 7: Erstellen eines accessPackageResourceRequest zum Hinzufügen von SAP IAG-Zugriffsrechten als Ressource

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Hinzufügen eines externen Ursprungsressourcenconnectors zu einem Katalog, einschließlich der Angabe eines erforderlichen Attributs dieses Ressourcenconnectors.

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

{
  "catalogId": "bcb19bf7-cdf7-4a70-a106-f6543620b2a5",
  "accessPackageResource": {
    "id": "88eb460d-ca08-4eb9-afae-8d60a8b00377",
    "displayName": "SAP IAG Access Rights",
    "description": "This resource represents the business roles of SAP IAG",
    "resourceType": "Business role",
    "originId": "https://iagintgorg-iag-intg-space-java-rest-arqapi.cfapps.sap.hana.ondemand.com",
    "originSystem": "External",
    "accessPackageResourceScopes": [],
    "externalOriginResourceConnector": {
      "id": "1a53cea5-48bd-467c-af81-a24245b0df2b",
      "displayName": "SAP IAG 10.0",
      "description": "SAP IAG 10.0.0",
      "connectorType": "sapIag",
      "connectionInfo": {
        "@odata.type": "microsoft.graph.externalTokenBasedSapIagConnectionInfo",
        "url": "https://iagigorg-iag-intg-space-java-rest-arqapi.cfapps.sap.hana.ondemand.com",
        "subscriptionId": "8e072eb5-73f5-4ed2-9324-a734dcb9728",
        "resourceGroup": "SAPResourceGroup",
        "accessTokenUrl": "https://entra-docu-intg-mrrd3gv.authentication.sap.hana.ondemand.com/oauth/token",
        "clientId": "sb-72062308-a7ae-456f-b9a4-24302b8a4aa!b247012|iagapi-iag-intg-space!b11378",
        "keyVaultName": "SAPIAG-KV",
        "secretName": "ClientSecret"
      }
    },
    "accessPackageResourceEnvironment": null
  },
  "requestType": "AdminAdd",
  "history": [],
  "executeImmediately": true
}

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": "0e37f047-c6b9-4d5c-99cd-e3fab4007be4",
  "requestType": "AdminAdd",
  "requestState": "Delivered",
  "requestStatus": "Fulfilled"
}

Beispiel 8: Hinzufügen einer Verwaltungsgruppenressource zum Katalog

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Hinzufügen einer Verwaltungsgruppenressource zu einem Katalog.

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

{
    "catalogId": "e8368470-afaf-44da-ba86-13a7318f1995",
    "requestType": "AdminAdd",
    "justification": "",
    "accessPackageResource": {
        "id": "",
        "displayName": "test-mgmtgroup",
        "description": "test-mgmtgroup",
        "resourceType": "ManagementGroup",
        "originId": "/providers/Microsoft.Management/managementGroups/test-mgmtgroup",
        "originSystem": "AzureResources"
    }
}

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": "e8368470-afaf-44da-ba86-13a7318f1995",
    "id": "99e156fe-d152-4005-b019-6ba816f411ea",
    "justification": "",
    "requestState": "Delivered",
    "requestStatus": "Fulfilled",
    "requestType": "AdminAdd",
}

Beispiel 9: Hinzufügen einer Abonnementressource zum Katalog

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Hinzufügen einer Abonnementressource zu einem Katalog.

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

{
    "catalogId": "e8368470-afaf-44da-ba86-13a7318f1995",
    "requestType": "AdminAdd",
    "justification": "",
    "accessPackageResource": {
        "id": "",
        "displayName": "Dev",
        "description": "Dev",
        "resourceType": "Subscription",
        "originId": "/subscriptions/828b526f-c769-4b19-9797-734b4843b978",
        "originSystem": "AzureResources"
    }
}

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": "e8368470-afaf-44da-ba86-13a7318f1995",
    "id": "13ac6518-0597-452c-98ff-59c52b391dae",
    "justification": "",
    "requestState": "Delivered",
    "requestStatus": "Fulfilled",
    "requestType": "AdminAdd",
}
  • Last updated on