次の方法で共有

電子情報開示CaseMember を追加する

名前空間: microsoft.graph.security

電子情報開示CaseMember を電子情報開示ケースに追加します。 電子情報開示CaseMember には、ユーザーまたはロール グループの 2 種類のいずれかを指定できます。

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

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

アクセス許可

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

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

HTTP 要求

POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/caseMembers

要求ヘッダー

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

要求本文

要求本文で、更新するプロパティの値 のみを 指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。

次の表に、更新できるプロパティを示します。

プロパティ 型 説明
recipientType microsoft.graph.security.recipientType 電子情報開示ケース メンバーの受信者の種類を指定します。 使用可能な値: user、roleGroup、unknownFutureValue。 必須。
id 文字列 電子情報開示ケース メンバーの ID。 指定しない場合は、 displayName (役割グループの場合) または smtpAddress (ユーザーの場合) を指定する必要があります。
displayName 文字列 電子情報開示ケース メンバーの表示名。 roleGroup 型のケース メンバーに対してのみ使用できます。 指定しない場合は、 ID を 指定する必要があります。
smtpAddress 文字列 電子情報開示ケース メンバーの smtp アドレス。 user 型のケース メンバーに対してのみ使用できます。 指定しない場合は、 ID を 指定する必要があります。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文に追加された microsoft.graph.security.ediscoveryCaseMember オブジェクトを返します。

例

例 1: smtpAddressを使用してユーザー型のケース メンバーを追加する

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/caseMembers
Content-Type: application/json

{
    "recipientType": "user",
    "smtpAddress": "johnadams@microsoft.com"
}

応答

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

HTTP/1.1 200 OK
Content-Type: application/json

{  
    "@odata.type": "microsoft.graph.security.ediscoveryCaseMember",
    "recipientType": "user",
    "id": "c4af6f9d-37f6-43f9-9e17-601544234146",
    "displayName": "John Adams",
    "smtpAddress": "johnadams@microsoft.com"
}

例 2: displayName を使用して roleGroup 型のケース メンバーを追加する

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/caseMembers
Content-Type: application/json

{
    "recipientType": "roleGroup",
    "displayName": "Security Administrator"
}

応答

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

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.type": "microsoft.graph.security.ediscoveryCaseMember",
    "recipientType": "roleGroup",
    "id": "b9fb4f22-5f90-47a0-b309-44fe96a959fd",
    "displayName": "Security Administrator",
    "smtpAddress": ""
}

例 3: ID を使用してユーザー型のケース メンバーを追加する

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/caseMembers
Content-Type: application/json

{
    "recipientType": "user",
    "id": "c4af6f9d-37f6-43f9-9e17-601544234146"
}

応答

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

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.type": "microsoft.graph.security.ediscoveryCaseMember",
    "recipientType": "user",
    "id": "c4af6f9d-37f6-43f9-9e17-601544234146",
    "displayName": "John Adams",
    "smtpAddress": "johnadams@microsoft.com"
}

例 4: ID を使用して roleGroup 型のケース メンバーを追加する

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/caseMembers
Content-Type: application/json

{
    "recipientType": "roleGroup",
    "id": "b9fb4f22-5f90-47a0-b309-44fe96a959fd"
}

応答

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

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.type": "microsoft.graph.security.ediscoveryCaseMember",
    "recipientType": "roleGroup",
    "id": "b9fb4f22-5f90-47a0-b309-44fe96a959fd",
    "displayName": "Security Administrator",
    "smtpAddress": ""
}
  • Last updated on