フィードバック 編集

AccessPackageResourceRequest の作成

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

新しい accessPackageResourceRequest オブジェクトを作成して、アクセス パッケージ カタログへのリソースの追加、またはカタログからのリソースの削除を要求します。 アクセス パッケージにリソースの役割を追加するには、そのリソースをアクセス パッケージ カタログに含める必要があります。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) EntitlementManagement.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション EntitlementManagement.ReadWrite.All

HTTP 要求

POST /identityGovernance/entitlementManagement/accessPackageResourceRequests

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。
Content-Type application/json. Required.

要求本文

要求本文で、 accessPackageResourceRequest オブジェクトの JSON 表記を指定 します。 要求の accessPackageResource 一部として accessPackageResource オブジェクトとの関係を含める。

リソースとして Azure ADグループをカタログに追加するには、catalogId をカタログの ID、requestType AdminAdd``accessPackageResource を指定し、リソースを表す値に設定します。 内の originSystem プロパティaccessPackageResourceの値は be でAadGroup、originId の値はグループの識別子です。 委任されたアクセス許可を使用する場合、グループの追加を要求するユーザーは、グループの所有者またはグループを変更できるディレクトリ ロールである必要があります。 アプリケーションのアクセス許可を使用する場合は、グループの追加を要求するアプリケーションにもアクセス許可が割り当てられている必要 Group.ReadWrite.All があります。

リソースとして Azure ADアプリケーションをカタログに追加するには、catalogId をカタログの ID、requestType AdminAdd``accessPackageResource に設定し、リソースを表します。 内の originSystem プロパティaccessPackageResource``AadApplicationの値を指定し、originId の値は servicePrincipal の識別子です。 委任されたアクセス許可を使用する場合、アプリケーションの追加を要求するユーザーは、アプリケーションの所有者か、アプリケーションの役割の割り当てを変更できるディレクトリ ロールである必要があります。

リソースとして SharePoint Online サイトをカタログに追加するには、catalogId をカタログの ID、requestType AdminAdd``accessPackageResource を指定し、リソースを表す値に設定します。 originSystem accessPackageResource プロパティ 内の値 を指定する必要がありますSharePointOnline。originId の値はサイトの URI です。 委任されたアクセス許可を使用する場合、ユーザーは管理者ロールSharePoint必要があります。 アプリケーションのアクセス許可を使用する場合は、サイトの追加を要求するアプリケーションにもアクセス許可を割り当てる必要 Sites.FullControl.All があります。 複数の位置情報 Sharepoint Online リソースに地理位置情報環境を割り当てるには、 オブジェクトに accessPackageResourceEnvironment リレーションシップを含 accessPackageResource めます。 これは、次の 2 つの方法で実行できます。

  • オブジェクト @odata.bind に注釈を割り当 id てるには、 accessPackageResourceEnvironment 注釈を使用 accessPackageResourceEnvironment します。
  • オブジェクト内 originId のパラメーターを accessPackageResourceEnvironment 指定 accessPackageResourceEnvironment します。

カタログからリソースを削除するには、catalogId をカタログの ID、requestType AdminRemove``accessPackageResource を指定し、削除するリソース オブジェクトに設定します。 リソース オブジェクトは、リスト accessPackageResources を使用して取得できます。

応答

成功した場合、このメソッドは応答 201 Created コードと、応答本文の 新しい accessPackageResourceRequest オブジェクトを返します。

例

例 1: サイトをリソースとして追加する accessPackageResourceRequest を作成する

要求

要求の例を次に示します。

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"
  }
}

応答

応答の例を次に示します。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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"
}

例 2: サイトをリソースとして追加する accessPackageResourceRequest を作成し、@odata.bind を使用して accessPackageResourceEnvironment を割り当てる

要求

要求の例を次に示します。 この例では、オブジェクト @odata.bind の注釈をオブジェクトに割 id り当てる場合 accessPackageResourceEnvironment に使用 accessPackageResourceEnvironment します。

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"
}

応答

応答の例を次に示します。

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
}

例 3: サイトをリソースとして追加する accessPackageResourceRequest を作成し、originId を使用して accessPackageResourceEnvironment を割り当てる

要求

要求の例を次に示します。 この例では、オブジェクトで an の accessPackageResourceEnvironment パラメーターを指定 accessPackageResourceEnvironment します。

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"
}

応答

応答の例を次に示します。

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
}

例 4: グループをリソースとして追加する accessPackageResourceRequest を作成する

要求

要求の例を次に示します。

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"
  }
}

応答

応答の例を次に示します。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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"
}

例 5: リソースを削除するための accessPackageResourceRequest を作成する

要求

要求の例を次に示します。

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"
  }
}

応答

応答の例を次に示します。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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"
}

例 6: アプリケーションを追加する accessPackageResourceRequest を作成する

要求

次に、カタログにアプリケーションを追加する要求の例を示します。そのアプリケーションの必須属性を指定します。

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"
          }
        }
      ]
  }
}

応答

応答の例を次に示します。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

{
  "id": "f0e632ed-afd2-41d3-8d6e-ccefda457e5e",
  "requestType": "AdminAdd",
  "requestState": "Delivered",
  "requestStatus": "Fulfilled"
}