tipo de recurso governanceResourcegovernanceResource resource type

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v 1.0, use el selector de versiones .To determine whether an API is available in v1.0, use the Version selector.

Representa recursos que pueden ser administrados por la administración de identidades privilegiada (PIM).Represents resources that could be managed by Privileged Identity Management (PIM). Para los recursos de Azure, puede ser una suscripción, un grupo de recursos y un recurso como una máquina virtual, una base de datos SQL, etc.For Azure resources, it can be a subscription, a resource group, and a resource such as a virtual machine, a SQL database, etc.

MethodsMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
ListList colección governanceResourcegovernanceResource collection Enumera una colección de recursos a los que tiene acceso el solicitante.List a collection of resources the requestor has access to.
ObtenerGet governanceResourcegovernanceResource Leer las propiedades y las relaciones de una entidad de recurso especificada por ID.Read properties and relationships of a resource entity specified by id.
RegistrarseRegister Registre un grupo de administración o suscripción de Azure no administrados en el servicio PIM.Register an unmanaged Azure subscription or management group to PIM service.

No POST , PUT , PATCH , DELETE se admiten en el roleDefinitions conjunto de entidades en este momento.No POST, PUT, PATCH, DELETE are supported on roleDefinitions entity set for now.

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Identificador del recurso.The id of the resource. Está en formato GUID.It is in GUID format.
externalIdexternalId StringString Identificador externo del recurso, que representa su identificador original en el sistema externo.The external id of the resource, representing its original id in the external system. Por ejemplo, el identificador externo de un recurso de suscripción puede ser "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac".For example, a subscription resource's external id can be "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac".
typetype CadenaString Obligatorio.Required. Tipo de recurso.Resource type. Por ejemplo, para los recursos de Azure, el tipo podría ser "suscripción", "ResourceGroup", "Microsoft. SQL/Server", etc.For example, for Azure resources, the type could be "Subscription", "ResourceGroup", "Microsoft.Sql/server", etc.
displayNamedisplayName CadenaString El nombre para mostrar del recurso.The display name of the resource.
statusstatus CadenaString El estado de un recurso determinado.The status of a given resource. Por ejemplo, podría representar si el recurso está bloqueado o no (valores: Active / Locked ).For example, it could represent whether the resource is locked or not (values: Active/Locked). Nota: esta propiedad puede extenderse en el futuro para admitir más escenarios.Note: This property may be extended in the future to support more scenarios.
registeredDateTimeregisteredDateTime DateTimeOffsetDateTimeOffset Representa la fecha y hora en que el recurso está registrado en PIM.Represents the date time when the resource is registered in PIM.
registeredRootregisteredRoot CadenaString ExternalId del ámbito raíz del recurso que está registrado en PIM.The externalId of the resource's root scope that is registered in PIM. El ámbito raíz puede ser los recursos antecesores primarios, ascendientes o superiores.The root scope can be the parent, grandparent, or higher ancestor resources.
roleAssignmentCountroleAssignmentCount Int32Int32 Opcional.Optional. El número de asignaciones de funciones para el recurso especificado.The number of role assignments for the given resource. Para obtener la propiedad, use explícitamente $select=roleAssignmentCount en la consulta.To get the property, please explictly use $select=roleAssignmentCount in the query.
roleDefinitionCountroleDefinitionCount Int32Int32 Opcional.Optional. El número de definiciones de roles para el recurso especificado.The number of role definitions for the given resource. Para obtener la propiedad, use explícitamente $select=roleDefinitionCount en la consulta.To get the property, please explictly use $select=roleDefinitionCount in the query.
permissionspermissions governancePermissiongovernancePermission Opcional.Optional. Representa el estado del acceso del solicitante al recurso. Para obtener la propiedad, use explícitamente $select=permissions en la consulta.It represents the status of the requestor's access to the resource.To get the property, please explictly use $select=permissions in the query.

RelacionesRelationships

RelaciónRelationship TipoType DescriptionDescription
roleAssignmentsroleAssignments colección governanceRoleAssignmentgovernanceRoleAssignment collection La colección de asignaciones de roles para el recurso.The collection of role assignments for the resource.
roleDefinitionsroleDefinitions colección governanceRoleDefinitiongovernanceRoleDefinition collection La colección de definiciones de roles para el recurso.The collection of role defintions for the resource.
roleAssignmentRequestsroleAssignmentRequests colección governanceRoleAssignmentRequestgovernanceRoleAssignmentRequest collection La colección de solicitudes de asignación de roles para el recurso.The collection of role assignment requests for the resource.
roleSettingsroleSettings colección governanceRoleSettinggovernanceRoleSetting collection La colección de configuraciones de roles para el recurso.The collection of role settings for the resource.
primarioparent governanceResourcegovernanceResource Solo lectura.Read-only. Recurso primario.The parent resource. por pimforazurerbac escenario, puede representar la suscripción a la que pertenece el recurso.for pimforazurerbac scenario, it can represent the subscription the resource belongs to.

Representación JSONJSON representation

La siguiente es una representación JSON del recursoThe 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"
  }
}