governanceResource リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

注意事項

Azure リソース用のこのバージョンの Privileged Identity Management (PIM) API は、近日非推奨になります。 Azure リソース ロールに新しい Azure REST PIM API を使用してください

Privileged Identity Management (PIM) によって管理できるリソースを表します。 Azure リソースの場合は、サブスクリプション、リソース グループ、および仮想マシン、SQL データベースなどのリソースを使用できます。

メソッド

メソッド 戻り値の型 説明
List governanceResource コレクション 要求元がアクセスできるリソースのコレクションを一覧表示します。
Get governanceResource id で指定されたリソース エンティティのプロパティとリレーションシップを読み取ります。
登録 非管理対象の Azure サブスクリプションまたは管理グループを PIM サービスに登録します。

現在、エンティティ セットでは roleDefinitions 、いいえ POSTPUTPATCH``DELETE、がサポートされています。

プロパティ

プロパティ 種類 説明
id String リソースの ID。 これは GUID 形式です。
externalId String リソースの外部 ID。外部システム内の元の ID を表します。 たとえば、サブスクリプション リソースの外部 ID は"/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac" にすることができます。
type String 必須です。 リソースの種類。 たとえば、Azure リソースの場合、種類は "サブスクリプション"、"ResourceGroup"、"Microsoft.Sql/server"などです。
displayName String リソースの表示名。
status String 特定のリソースの状態。 たとえば、リソースがロックされているかどうかを表す場合があります (値: Active/Locked)。 注: このプロパティは、今後、より多くのシナリオをサポートするように拡張される可能性があります。
registeredDateTime DateTimeOffset リソースが PIM に登録されている日付時刻を表します。
registeredRoot String PIM に登録されているリソースのルート スコープの externalId。 ルート スコープには、親、祖父母、または上位の先祖リソースを指定できます。
roleAssignmentCount Int32 省略可能。 特定のリソースに対するロールの割り当ての数。 プロパティを取得するには、クエリで明示的に使用 $select=roleAssignmentCount してください。
roleDefinitionCount Int32 省略可能。 特定のリソースのロール定義の数。 プロパティを取得するには、クエリで明示的に使用 $select=roleDefinitionCount してください。
アクセス許可 governancePermission 省略可能。 リソースに対する要求元のアクセスの状態を表します。プロパティを取得するには、クエリで明示的に使用 $select=permissions してください。

リレーションシップ

リレーションシップ 説明
roleAssignments governanceRoleAssignment コレクション リソースのロールの割り当てのコレクション。
roleDefinitions governanceRoleDefinition コレクション リソースのロール定義のコレクション。
roleAssignmentRequests governanceRoleAssignmentRequest コレクション リソースのロール割り当て要求のコレクション。
roleSettings governanceRoleSetting コレクション リソースのロール設定のコレクション。
governanceResource 読み取り専用です。 親リソース。 シナリオでは pimforazurerbac 、リソースが属するサブスクリプションを表すことができます。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "id": "String (identifier)",
  "externalId": "String",
  "type": "String",
  "displayName": "String",
  "status": "String",
  "registeredDateTime": "String (timestamp)",
  "registeredRoot": "String",
  "roleAssignmentCount": 12356,
  "roleDefinitionCount": 12356,
  "permissions": {
    "@odata.type": "microsoft.graph.governancePermission"
  }
}