usageRight 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

使用权限表示用户或设备具有的许可证,适用于基于 Power Apps 构建的第三方软件或仅针对基于设备 (订阅) 。

方法

方法 返回类型 说明
列出用户使用情况Rights usageRight 集合 获取用户的使用权限列表。
列出设备使用情况Rights usageRight 集合 获取设备的使用权限列表。

属性

属性 类型 说明
catalogId 字符串 与使用权限对应的产品 ID。
id String 使用权限的 ID。
serviceIdentifier String 与使用权限对应的服务的标识符。
state usageRightState 使用权限的状态。 可能的值是:activeinactivewarningsuspended

usageRightState 值

成员 说明
active 指示使用权限处于活动状态,可用于预配权益。
inactive 指示使用权限不是活动的,并且不能用于预配权益。
警告 指示使用权限可能由于付款违反而获得宽限期。 此状态可用于提醒待付款或提供降级体验。
已挂起 指示使用权限可能由于"付款违反"而暂停
unknownFutureValue Sentinel 值,用于指示未来值。

注意: 只有活动状态和警告状态表示一种可用的好处。 其他所有状态都将被视为未产生可用的好处。

关系

无。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.usageRight",
  "id": "String (identifier)",
  "catalogId": "String",
  "serviceIdentifier": "String",
  "state": "String"
}