Tipo de recurso de entidade de segurança

Namespace: microsoft.graph.externalConnectors

Representa um tipo de dados complexo usado para adicionar propriedades relacionadas a pessoas a itens indexados por um externalConnection. Você também pode usar o tipo de dados principalCollection quando houver uma lista de pessoas.

Propriedades

Propriedade Tipo Descrição
externalName Cadeia de caracteres O nome associado à pessoa na fonte de dados externa.
externalId Cadeia de caracteres A ID associada à pessoa na fonte de dados externa. Também pode ser um email associado à pessoa na fonte externa.
entraDisplayName Cadeia de caracteres O nome da pessoa, conforme mencionado no Microsoft Entra.
entraId Cadeia de caracteres A ID da pessoa, conforme mencionado no Microsoft Entra.
email Cadeia de caracteres O email da pessoa, conforme mencionado no Microsoft Entra.
UPN Cadeia de caracteres O Nome Principal do Usuário (UPN) da pessoa, conforme mencionado no Azure Active Directory ou no Microsoft Entra.
tenantId String A ID do locatário ao qual a pessoa pertence. A ID do locatário é um GUID exclusivo que identifica o locatário do Azure Active Directory (ID do Entra) da sua organização.

Relações

Nenhum

Representação JSON

Você pode usar os tipos de dados principal ou principalCollection.

Tipo de dados Descrição
de segurança Use esse tipo de dados quando a propriedade tiver informações sobre uma pessoa. Exemplo: Propriedade do destinatário para um tíquete do JIRA em que há apenas um destinatário.
principalCollection Use esse tipo de dados quando a propriedade se referir a uma lista de pessoas. Exemplo: Propriedade Contributors de uma PR do GitHub em que pode haver várias pessoas.

Usar propriedades de tipo principal ou principalCollection em vez de uma cadeia de caracteres ou coleção de cadeias de caracteres para propriedades relacionadas a pessoas durante a ingestão de ExternalItems pode fornecer resultados melhores e mais relevantes na Pesquisa ou no chat do Copilot.

A representação JSON a seguir mostra o tipo de recurso para o tipo de dados principal.

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

A representação JSON a seguir mostra o tipo de recurso para o tipo de dados da coleção principal.

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