Compartir a través de

tipo de recurso principal

Espacio de nombres: microsoft.graph.externalConnectors

Representa un tipo de datos complejo que se usa para agregar propiedades relacionadas con personas a elementos indexados por externalConnection. También puede usar el tipo de datos principalCollection cuando haya una lista de personas.

Propiedades

Propiedad Tipo Description
externalName Cadena Nombre asociado a la persona del origen de datos externo.
externalId Cadena Identificador asociado a la persona en el origen de datos externo. También podría ser un correo electrónico asociado a la persona en el origen externo.
entraDisplayName Cadena Nombre de la persona como se mencionó en Microsoft Entra.
entraId Cadena Identificador de la persona como se mencionó en Microsoft Entra.
email Cadena El correo electrónico de la persona como se mencionó en Microsoft Entra.
upn Cadena Nombre principal de usuario (UPN) de la persona como se menciona en Azure Active Directory o Microsoft Entra.
tenantId Cadena Identificador del inquilino al que pertenece la persona. El identificador de inquilino es un GUID único que identifica el inquilino Azure Active Directory (Entra ID) de la organización.

Relaciones

Ninguna.

Representación JSON

Puede usar los tipos de datos principal o principalCollection.

Tipo de datos Description
entidad de seguridad Use este tipo de datos cuando la propiedad tenga información sobre una persona. Ejemplo: propiedad Assignee para un vale JIRA donde solo hay un asignador.
principalCollection Use este tipo de datos cuando la propiedad haga referencia a una lista de personas. Ejemplo: propiedad Contributors para una solicitud de incorporación de cambios de GitHub donde puede haber varias personas.

El uso de propiedades de tipo principal o principalCollection en lugar de una colección de cadenas o cadenas para las propiedades relacionadas con personas al ingerir ExternalItems puede proporcionar resultados mejores y más relevantes en copilot Search o chat.

La siguiente representación JSON muestra el tipo de recurso para el tipo de datos principal.

{
  "externalName": "String",
  "externalId": "String",
  "entraDisplayName": "String",
  "entraId": "String",
  "email": "String",
  "upn": "String",
  "tenantId": "String"
}

La siguiente representación JSON muestra el tipo de recurso para el tipo de datos de recopilación de entidades de seguridad.

{
  "principals": [
    {
      "externalName": "String",
      "externalId": "String",
      "entraDisplayName": "String",
      "entraId": "String",
      "email": "String",
      "upn": "String",
      "tenantId": "String"
    }
  ]
}
  • Last updated on