次の方法で共有

プリンシパル リソースの種類

名前空間: microsoft.graph.externalConnectors

externalConnection によってインデックスが作成されたアイテムにユーザー関連のプロパティを追加するために使用される複雑なデータ型を表します。 ユーザーの一覧がある場合は、principalCollection データ型を使用することもできます。

プロパティ

プロパティ 型 説明
externalName 文字列 外部データ ソース内のユーザーに関連付けられている名前。
外部ID 文字列 外部データ ソース内のユーザーに関連付けられている ID。 外部ソース上のユーザーに関連付けられている電子メールの場合もあります。
entraDisplayName 文字列 Microsoft Entraに記載されている人物の名前。
entraId 文字列 Microsoft Entraに記載されている人物の ID。
メール String Microsoft Entraに記載されているユーザーの電子メール。
Upn 文字列 Active Directory または Microsoft Entra に記載されているユーザーのユーザー プリンシパル名 (UPN) Azure。
tenantId String ユーザーが属するテナントの ID。 テナント ID は、organizationの Azure Active Directory (Entra ID) テナントを識別する一意の GUID です。

リレーションシップ

なし。

JSON 表記

プリンシパルまたは principalCollection データ型を使用できます。

データ型 説明
プリンシパル プロパティに 1 人のユーザーに関する情報がある場合は、このデータ型を使用します。 例: 割り当て先が 1 人しかない JIRA チケットの Assignee プロパティ。
principalCollection プロパティがユーザーのリストを参照する場合は、このデータ型を使用します。 例: 複数のユーザーが存在する GitHub PR の共同作成者プロパティ。

ExternalItems の取り込み中に、文字列または文字列コレクションの代わりにプリンシパルまたは principalCollection 型プロパティを使用すると、Copilot Search またはチャットでより適切で関連性の高い結果が得られます。

次の JSON 表現は、プリンシパル データ型のリソースの種類を示しています。

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

次の JSON 表現は、プリンシパル収集データ型のリソースの種類を示しています。

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