governanceResource リソースの種類governanceResource resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

特権 Id 管理 (PIM) によって管理される可能性があるリソースを表します。Represents resources that could be managed by Privileged Identity Management (PIM). Azure リソースの場合は、サブスクリプション、リソースグループ、仮想マシン、SQL データベースなどのリソースを使用できます。For Azure resources, it can be a subscription, a resource group, and a resource such as a virtual machine, a SQL database, etc.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
ListList governanceResourceコレクションgovernanceResource collection 要求者がアクセスできるリソースのコレクションを一覧表示します。List a collection of resources the requestor has access to.
GetGet governanceResourcegovernanceResource Id で指定されたリソースエンティティのプロパティとリレーションシップを読み取ります。Read properties and relationships of a resource entity specified by id.
登録Register 管理されていない Azure サブスクリプションまたは管理グループを PIM サービスに登録します。Register an unmanaged Azure subscription or management group to PIM service.

PATCH roleDefinitions現時点では、entity set ではサポートされていませんPOST PUT DELETENo POST, PUT, PATCH, DELETE are supported on roleDefinitions entity set for now.

プロパティProperties

プロパティProperty Type 説明Description
idid 文字列String リソースの id。The id of the resource. GUID 形式です。It is in GUID format.
externalIdexternalId StringString 外部システムの元の id を表す、リソースの外部 id。The external id of the resource, representing its original id in the external system. たとえば、サブスクリプションリソースの外部 id は "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac" にすることができます。For example, a subscription resource's external id can be "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac".
typetype StringString 必須。Required. リソースの種類。Resource type. たとえば、Azure リソースの場合、この型は "Subscription"、"ResourceGroup"、"Microsoft .Sql/server" などになります。For example, for Azure resources, the type could be "Subscription", "ResourceGroup", "Microsoft.Sql/server", etc.
displayNamedisplayName StringString リソースの表示名。The display name of the resource.
statusstatus StringString 指定されたリソースの状態。The status of a given resource. たとえば、リソースがロックされているかどうかを表すことがActive / Lockedできます (値:)。For example, it could represent whether the resource is locked or not (values: Active/Locked). 注: 今後、このプロパティを拡張して、より多くのシナリオをサポートすることができます。Note: This property may be extended in the future to support more scenarios.
registeredDateTimeregisteredDateTime DateTimeOffsetDateTimeOffset リソースが PIM に登録されている日時を表します。Represents the date time when the resource is registered in PIM.
registeredRootregisteredRoot StringString PIM に登録されているリソースのルートスコープの externalId。The externalId of the resource's root scope that is registered in PIM. ルートスコープには、親、親、または上位の先祖リソースを指定できます。The root scope can be the parent, grandparent, or higher ancestor resources.
Role割り当て数roleAssignmentCount Int32Int32 省略可能。Optional. 指定したリソースのロール割り当ての数。The number of role assignments for the given resource. プロパティを取得するには、クエリ$select=roleAssignmentCountで明示的にを使用してください。To get the property, please explictly use $select=roleAssignmentCount in the query.
roleDefinitionCountroleDefinitionCount Int32Int32 省略可能。Optional. 指定したリソースのロール定義の数。The number of role definitions for the given resource. プロパティを取得するには、クエリ$select=roleDefinitionCountで明示的にを使用してください。To get the property, please explictly use $select=roleDefinitionCount in the query.
アクセス許可permissions governancePermissiongovernancePermission 省略可能。Optional. これは、リソースへの要求者のアクセスの状態を表します。プロパティを取得するには、クエリ$select=permissionsで明示的にを使用してください。It represents the status of the requestor's access to the resource.To get the property, please explictly use $select=permissions in the query.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
roleAssignmentsroleAssignments governanceRoleAssignmentコレクションgovernanceRoleAssignment collection リソースのロール割り当てのコレクション。The collection of role assignments for the resource.
roleDefinitionsroleDefinitions governanceRoleDefinitionコレクションgovernanceRoleDefinition collection リソースのロール日のコレクション。The collection of role defintions for the resource.
Rolerequests 要求roleAssignmentRequests governanceRoleAssignmentRequestコレクションgovernanceRoleAssignmentRequest collection リソースに対する役割の割り当て要求のコレクション。The collection of role assignment requests for the resource.
roleSettingsroleSettings governanceRoleSettingコレクションgovernanceRoleSetting collection リソースのロール設定のコレクション。The collection of role settings for the resource.
親行parent governanceResourcegovernanceResource 読み取り専用です。Read-only. 親リソース。The parent resource. シナリオpimforazurerbacの場合は、リソースが属するサブスクリプションを表すことができます。for pimforazurerbac scenario, it can represent the subscription the resource belongs to.

JSON 表記JSON representation

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

{
  "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"
  }
}