list permissionGrantPreApprovalPolicies

名前空間: microsoft.graph

テナント内の permissionGrantPreApprovalPolicy オブジェクトの一覧を取得します。

この API は、次の国内クラウド展開で使用できます。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされている Microsoft Entra ロール またはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

• グローバル閲覧者
• アプリケーション管理者
• クラウド アプリケーション管理者

HTTP 要求

GET /policies/permissionGrantPreApprovalPolicies

オプションのクエリ パラメーター

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートしていません。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

要求ヘッダー

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文の permissionGrantPreApprovalPolicy オブジェクトのコレクションを返します。

例

要求

GET https://graph.microsoft.com/beta/policies/permissionGrantPreApprovalPolicies

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.PermissionGrantPreApprovalPolicies.GetAsync();

mgc-beta policies permission-grant-pre-approval-policies list

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
permissionGrantPreApprovalPolicies, err := graphClient.Policies().PermissionGrantPreApprovalPolicies().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

PermissionGrantPreApprovalPolicyCollectionResponse result = graphClient.policies().permissionGrantPreApprovalPolicies().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let permissionGrantPreApprovalPolicies = await client.api('/policies/permissionGrantPreApprovalPolicies')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->policies()->permissionGrantPreApprovalPolicies()->get()->wait();

Import-Module Microsoft.Graph.Beta.Identity.SignIns

Get-MgBetaPolicyPermissionGrantPreApprovalPolicy

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.policies.permission_grant_pre_approval_policies.get()

応答

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

次の例では、

• ポリシー ID 71ba13dc-5947-4e59-bcc5-0ad5c339a853 には、次の設定があります。

  • chat リソースの種類の条件:
    • 秘密度ラベルに関係なく、すべてのチャットがスコープ内にあることを示します
    • すべての API に対するすべてのアプリケーションアクセス許可が事前に承認されるように指定します
  • group リソースの種類の条件:
    • スコープ内の 2 つの秘密度ラベルを指定します
    • 00000003-0000-0000-c000-000000000000 リソース アプリが事前に承認される 2 つのアプリケーションアクセス許可を指定します

• ポリシー ID bd4b701c-a54e-42b8-9f56-e4b4b229be3b には、次の設定があります。

  • group リソースの種類の条件:
    • 秘密度ラベルに関係なく、すべてのグループがスコープ内にあることを示します
    • 00000003-0000-0000-c000-000000000000 リソース アプリのすべてのアプリケーションアクセス許可が事前に承認されるように指定します

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/permissionGrantPreApprovalPolicies",
    "value": [
        {
            "id": "71ba13dc-5947-4e59-bcc5-0ad5c339a853",
            "deletedDateTime": null,
            "conditions": [
                      {
                  "scopeType": "chat",
                  "sensitivityLabels": {
                      "@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
                      "labelKind": "all"
                  },
                  "permissions": {
                      "@odata.type": "#microsoft.graph.allPreApprovedPermissions",
                      "permissionKind": "all",
                      "permissionType": "application"
                  }
              },
              {
                  "scopeType": "group",
                  "scopeSensitivityLabels": {
                      "@odata.type": "microsoft.graph.enumeratedScopeSensitivityLabels",
                      "labelKind": "enumerated",
                      "sensitivityLabels": [
                          "d9c43deb-f3e1-4422-9fd6-ccf22a3206b8",
                          "c99dade2-aa54-4890-ac1c-a146fa26bd1e"
                      ]
                  },
                  "permissions": {
                      "@odata.type": "#microsoft.graph.enumeratedPreApprovedPermissions",
                      "permissionKind": "enumerated",
                      "permissionType": "application",
                      "resourceApplicationId": "00000003-0000-0000-c000-000000000000",
                      "permissionIds": [
                          "134483aa-3dda-4d65-ac91-b8dda1417875",
                          "9d33613d-f855-483b-bca7-ea63ac9f5485"
                      ]
                  }
              }
            ]
        },
        {
            "id": "bd4b701c-a54e-42b8-9f56-e4b4b229be3b",
            "deletedDateTime": null,
            "conditions": [
                {
                    "scopeType": "group",
                    "sensitivityLabels": {
                        "@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
                        "labelKind": "all"
                    },
                    "permissions": {
                        "@odata.type": "#microsoft.graph.allPermissionsOnResourceApp",
                        "permissionKind": "allPermissionsOnResourceApp",
                        "permissionType": "application",
                        "resourceApplicationId": "00000003-0000-0000-c000-000000000000"
                    }
                }
            ]
        }
    ]
}