命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
在 Microsoft Entra 权利管理中,访问包分配策略指定使用者可以通过访问包分配请求或分配访问包的策略。 访问包可以有零个或多个策略。 收到来自使用者的请求时,将使用者与每个策略进行匹配,以查找包含该使用者的 requestorSettings) 的策略 ((如果有)。 然后,策略确定请求是否需要审批、访问包分配的持续时间以及分配是否需要定期审核。
若要将用户分配给访问包,请创建引用访问包和访问包分配策略的 accessPackageAssignmentRequest 。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | accessPackageAssignmentPolicy 集合 | 检索 accessPackageAssignmentPolicy 对象的列表。 |
| 创建 | accessPackageAssignmentPolicy | 创建新的 accessPackageAssignmentPolicy 对象。 |
| Get | accessPackageAssignmentPolicy | 读取 accessPackageAssignmentPolicy 对象的属性和关系。 |
| 更新 | accessPackageAssignmentPolicy | 更新 accessPackageAssignmentPolicy 对象的属性。 |
| 删除 | 删除 accessPackageAssignmentPolicy。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| accessPackageId | String | 访问包的标识符。 |
| accessPackageNotificationSettings | accessPackageNotificationSettings | 表示用于请求访问包的电子邮件通知的设置。 |
| accessReviewSettings | assignmentReviewSettings | 谁必须审阅此策略中对访问包的分配,以及审阅一次。 如果不需要审阅,则此属性为 null。 |
| canExtend | 布尔值 | 指示用户是否可以在批准后延长访问包分配持续时间。 |
| createdBy | String | 只读。 |
| createdDateTime | DateTimeOffset | 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
| description | String | 策略说明。 |
| displayName | String | 策略的显示名称。 支持 $filter(eq)。 |
| durationInDays | Int32 | 来自此策略的分配持续到过期的天数。 |
| expirationDateTime | DateTimeOffset | 在此策略中创建的作业的到期日期。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
| id | String | 只读。 |
| modifiedBy | String | 只读。 |
| modifiedDateTime | DateTimeOffset | 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
| 问题 | accessPackageQuestion 集合 | 向请求者提出的问题。 |
| requestApprovalSettings | approvalSettings | 谁必须批准此策略中访问包的请求。 |
| requestorSettings | requestorSettings | 谁可以从此策略请求此访问包。 |
| verifiableCredentialSettings | verifiableCredentialSettings | 通过 Microsoft Entra Verified I D 服务设置的可验证凭据的设置。 这些设置表示此策略中访问包的请求者可以提供以获得访问包的可验证凭据。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| accessPackage | accessPackage | 具有此策略的访问包。 只读。 可为 NULL。 支持 $expand。 |
| customExtensionHandlers | customExtensionHandler 集合 | 执行一个或多个自定义访问包工作流扩展时的阶段集合。 支持 $expand。 |
| customExtensionStageSettings | customExtensionStageSetting 集合 | 执行一个或多个自定义访问包工作流扩展时的阶段集合。 支持 $expand。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"@odata.type": "#microsoft.graph.accessPackageAssignmentPolicy",
"id": "String (identifier)",
"accessPackageId": "String",
"displayName": "String",
"description": "String",
"canExtend": "Boolean",
"durationInDays": "Integer",
"expirationDateTime": "String (timestamp)",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"modifiedBy": "String",
"modifiedDateTime": "String (timestamp)",
"questions":[
{
"@odata.type": "microsoft.graph.accessPackageQuestion"
}
],
"requestorSettings": {
"@odata.type": "microsoft.graph.requestorSettings"
},
"requestApprovalSettings": {
"@odata.type": "microsoft.graph.approvalSettings"
},
"accessReviewSettings": {
"@odata.type": "microsoft.graph.assignmentReviewSettings"
},
"verifiableCredentialSettings": {
"@odata.type": "microsoft.graph.verifiableCredentialSettings"
},
"accessPackageNotificationSettings": {
"@odata.type": "microsoft.graph.accessPackageNotificationSettings"
}
}