governanceResource リソースの種類

[アーティクル]
04/09/2024

名前空間: microsoft.graph

重要

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

注意

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

Privileged Identity Management (PIM) リソースを表します。 Azure リソースの場合は、サブスクリプション、リソースグループ、仮想マシンなどのリソースなどを指定できます。

メソッド

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

PUTPATCH現在POST、エンティティセットではroleDefinitions、、 DELETE はサポートされていません。

プロパティ

プロパティ	型	説明
id	String	リソースの ID。 GUID 形式です。
外部ID	String	リソースの外部 ID。外部システム内の元の ID を表します。たとえば、サブスクリプションリソースの外部 ID は "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac" にすることができます。
type	String	必須です。リソースの種類。たとえば、Azure リソースの場合、型は "Subscription"、"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"
  }
}