次の方法で共有

追加のソースを追加する

名前空間: microsoft.graph.security

電子情報開示検索に関連付けられた新しい追加ソースを作成します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) eDiscovery.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション eDiscovery.ReadWrite.All 注意事項なし。

HTTP 要求

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/additionalSources

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、 dataSource オブジェクトの JSON 表現を指定します。

dataSource を作成するときに、次のプロパティを指定できます。

手記：メールまたはサイトが必要ですが、両方は必要ありません。

プロパティ 型 説明
email string メールボックスの SMTP アドレス。 グループのメール アドレスを取得するには、[グループの 一覧表示] または [グループの取得] を使用します。 $filterを使用して、グループの名前でクエリを実行できます(たとえば、https://graph.microsoft.com/v1.0/groups?$filter=displayName eq 'secret group'&$select=mail,id,displayName)。
サイト string サイトの URL。たとえば、 https://contoso.sharepoint.com/sites/HumanResources。

応答

成功した場合、このメソッドは応答本文に 201 Created と microsoft.graph.security.dataSource オブジェクトを返します。

例

例 1: サイト ソースから追加の電子情報開示ソースを作成する

要求

次の例は、サイト ソースから電子情報開示ソースを作成する要求を示しています。

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/{ediscoveryCaseId}/searches/{ediscoverySearchId}/additionalSources

{
    "@odata.type": "microsoft.graph.security.siteSource",
    "site": {
        "webUrl": "https://contoso.sharepoint.com/sites/SecretSite"
    }
}

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/searches('c61a5860-d634-4d14-aea7-d82b6f4eb7af')/additionalSources/$entity",
    "@odata.type": "#microsoft.graph.security.siteSource",
    "@odata.id": "https://graph.microsoft.com/v1.0/sites/46303732-3434-4630-3832-363333363441",
    "displayName": "Design - top secret",
    "createdDateTime": "2022-07-15T22:45:36.1096267Z",
    "holdStatus": "0",
    "id": "46303732-3434-4630-3832-363333363441",
    "createdBy": {
        "application": null,
        "user": {
            "id": null,
            "displayName": null
        }
    }
}

例 2: ユーザー ソースから追加の電子情報開示ソースを作成する

要求

次の例は、ユーザー ソースから電子情報開示ソースを作成する要求を示しています。

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/17011798-ca63-4282-9cb3-0086f1042bfc/searches/2f5cc5a6-9728-4ba0-acfa-edce25e91244/additionalSources

{
    "@odata.type": "microsoft.graph.security.userSource",
    "email": "admin@edbig.onmicrosoft.com"
}

応答

次の例は応答を示しています。

HTTP/1.1 200 Created

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#security/cases/ediscoveryCases('17011798-ca63-4282-9cb3-0086f1042bfc')/searches('2f5cc5a6-9728-4ba0-acfa-edce25e91244')/additionalSources/$entity",
    "@odata.type": "#microsoft.graph.security.userSource",
    "displayName": "eDisco Big",
    "createdDateTime": "2024-11-19T20:11:11.5950513Z",
    "holdStatus": "0",
    "id": "5933247d-7011-494d-b9a6-65a3870d88fa",
    "email": "admin@edbig.onmicrosoft.com",
    "includedSources": "mailbox,site",
    "siteWebUrl": "https://edbig-my.sharepoint.com/personal/admin_edbig_onmicrosoft_com",
    "createdBy": {
        "application": null,
        "user": {
            "id": null,
            "displayName": null
        }
    }
}