List accessReviewScheduleDefinitions

名前空間: microsoft.graph

統合ルートを使用して、ユーザー中心 (カタログ スコープ) アクセス レビューの accessReviewScheduleDefinition オブジェクトを取得します。 作成されたアクセス レビュー系列ごとに、0 個以上の accessReviewScheduleDefinition オブジェクトのリストが返されます。これには、入れ子になったプロパティのすべてが含まれます。 これには、関連付けられている accessReviewInstance オブジェクトは含まれません。

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

アクセス許可

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

HTTP 要求

GET /identityGovernance/accessReviews/unified/definitions

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

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

この API の既定のページ サイズは 100 accessReviewScheduleDefinition オブジェクトです。 効率を向上させ、大きな結果セットによるタイムアウトを回避するには、 $skip クエリ パラメーターと $top クエリ パラメーターを使用してページネーションを適用します。 詳細については、アプリで Microsoft Graph データをページングするを参照してください。

要求ヘッダー

要求本文

要求本文は指定しないでください。

応答

成功した場合、このメソッドは応答本文で 200 OK 応答コードと accessReviewScheduleDefinition オブジェクトの配列を返します。

例

例 1: ユーザー中心のアクセス レビュー定義を一覧表示する

要求

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions

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

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.IdentityGovernance.AccessReviews.Unified.Definitions.GetAsync();

// 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://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
definitions, err := graphClient.IdentityGovernance().AccessReviews().Unified().Definitions().Get(context.Background(), nil)

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

AccessReviewScheduleDefinitionCollectionResponse result = graphClient.identityGovernance().accessReviews().unified().definitions().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let definitions = await client.api('/identityGovernance/accessReviews/unified/definitions')
	.version('beta')
	.get();

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


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


$result = $graphServiceClient->identityGovernance()->accessReviews()->unified()->definitions()->get()->wait();

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

Get-MgBetaIdentityGovernanceAccessReviewUnifiedDefinition

# 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://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.identity_governance.access_reviews.unified.definitions.get()

応答

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/unified/definitions",
    "@odata.count": 1,
    "value": [
        {
            "id": "29f2d16e-9ca6-4052-bbfe-802c48944448",
            "displayName": "Catalog access review",
            "status": "InProgress",
            "descriptionForAdmins": "Quarterly user-centric review of catalog resources",
            "scope": {
                "@odata.type": "#microsoft.graph.principalResourceMembershipsScope",
                "principalScopes": [
                    {
                        "@odata.type": "#microsoft.graph.accessReviewPrincipalScope",
                        "scopeType": "allUsers"
                    }
                ],
                "resourceScopes": [
                    {
                        "@odata.type": "#microsoft.graph.accessReviewResourceScope",
                        "resourceId": "c6010d0c-ff41-4929-9776-fa03a03dd5ac",
                        "scopeType": "catalog"
                    }
                ]
            },
            "reviewers": [
                {
                    "@odata.type": "#microsoft.graph.accessReviewReviewerScope",
                    "scopeType": "manager"
                }
            ]
        }
    ]
}