accessPackageAssignmentPolicy リソースの種類accessPackageAssignmentPolicy resource type

名前空間: microsoft.graphNamespace: microsoft.graph

重要

/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported. API が v2.0 で利用できるかどうかを確認するには、 バージョン セレクターを使用します。To determine whether an API is available in v1.0, use the Version selector.

AZURE AD 受給管理では、アクセスパッケージの割り当てポリシーによって、サブジェクトがアクセスパッケージの割り当てによってアクセスパッケージを要求するか、割り当てるポリシーを指定します。In Azure AD entitlement management, an access package assignment policy specifies the policy by which subjects can request or be assigned an access package via an access package assignment. アクセスパッケージには、0個以上のポリシーを含めることができます。An access package can have zero or more policies. 件名からの要求を受信すると、各ポリシーに対して件名が照合され、そのポリシー (存在する場合) がその件名を含む requestorSettings を検出します。When a request from a subject is received, the subject is matched against each policy to find the policy (if any) with requestorSettings that include that subject. その後、ポリシーによって、要求に承認が必要かどうか、アクセスパッケージの割り当ての期間、および割り当てに定期的にレビューが必要かどうかが決定されます。The policy then determines whether the request requires approval, the duration of the access package assignment, and whether the assignment needs regularly review.

ユーザーをアクセスパッケージに割り当てるには、アクセスパッケージとアクセスパッケージの割り当てポリシーを参照する accessPackageAssignmentRequest を作成 します。To assign a user to an access package, create an accessPackageAssignmentRequest which references the access package and access package assignment policy.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
リスト accessPackageAssignmentPoliciesList accessPackageAssignmentPolicies accessPackageAssignmentPolicy コレクションaccessPackageAssignmentPolicy collection AccessPackageAssignmentPolicy オブジェクトのリストを取得します。Retrieve a list of accessPackageAssignmentPolicy objects.
AccessPackageAssignmentPolicy を作成するCreate accessPackageAssignmentPolicy accessPackageAssignmentPolicyaccessPackageAssignmentPolicy 新しい accessPackageAssignmentPolicy オブジェクトを作成します。Create a new accessPackageAssignmentPolicy object.
AccessPackageAssignmentPolicy を取得するGet accessPackageAssignmentPolicy accessPackageAssignmentPolicyaccessPackageAssignmentPolicy AccessPackageAssignmentPolicy オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of an accessPackageAssignmentPolicy object.
AccessPackageAssignmentPolicy の更新Update accessPackageAssignmentPolicy accessPackageAssignmentPolicyaccessPackageAssignmentPolicy AccessPackageAssignmentPolicy オブジェクトのプロパティを更新します。Update the properties of an accessPackageAssignmentPolicy object.
AccessPackageAssignmentPolicy の削除Delete accessPackageAssignmentPolicy AccessPackageAssignmentPolicy を削除します。Delete an accessPackageAssignmentPolicy.

プロパティProperties

プロパティProperty 種類Type 説明Description
accessPackageIdaccessPackageId StringString アクセスパッケージの ID。ID of the access package.
accessReviewSettingsaccessReviewSettings assignmentReviewSettingsassignmentReviewSettings このポリシーによるアクセスパッケージへの割り当てをレビューするユーザーと頻度。Who must review, and how often, the assignments to the access package from this policy. レビューが不要な場合、このプロパティは null になります。This property is null if reviews are not required.
canExtendcanExtend BooleanBoolean ユーザーが承認後にアクセスパッケージの割り当て期間を延長できるかどうかを示します。Indicates whether a user can extend the access package assignment duration after approval.
createdBycreatedBy StringString 読み取り専用です。Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
descriptiondescription StringString ポリシーの説明。The description of the policy.
displayNamedisplayName StringString ポリシーの表示名。The display name of the policy.
durationInDaysdurationInDays Int32Int32 このポリシーの最後の割り当てが期限切れになるまでの日数。The number of days in which assignments from this policy last until they are expired.
expirationDateTimeexpirationDateTime DateTimeOffsetDateTimeOffset このポリシーで作成された割り当ての有効期限日。The expiration date for assignments created in this policy. Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
idid StringString 読み取り専用です。Read-only.
modifiedBymodifiedBy StringString 読み取り専用です。Read-only.
modifiedDateTimemodifiedDateTime DateTimeOffsetDateTimeOffset Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
requestApprovalSettingsrequestApprovalSettings approvalSettingsapprovalSettings このポリシーでは、だれがアクセスパッケージの要求を承認する必要があります。Who must approve requests for access package in this policy.
requestorSettingsrequestorSettings requestorSettingsrequestorSettings このアクセスパッケージをこのポリシーから要求できるユーザー。Who can request this access package from this policy.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
accessPackageaccessPackage accessPackageaccessPackage このポリシーを使用した access パッケージ。The access package with this policy. 読み取り専用です。Read-only. Null 許容型。Nullable.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

{
    "id": "b2eba9a1-b357-42ee-83a8-336522ed6cbf",
    "accessPackageId": "1b153a13-76da-4d07-9afa-c6c2b1f2e824",
    "displayName": "All Users",
    "description": "All users can request for access to the directory.",
    "isDenyPolicy": false,
    "canExtend": false,
    "durationInDays": 365,
    "requestorSettings" : {
      "scopeType": "AllExistingDirectorySubjects",
      "acceptRequests": true,
      "allowedRequestors": []
    },
    "requestApprovalSettings" : {
      "isApprovalRequired": false,
      "isApprovalRequiredForExtension": false,
      "isRequestorJustificationRequired": false,
      "approvalMode": "NoApproval",
      "approvalStages": []
    },
    "accessReviewSettings" : null
}