アクセス許可: revokeGrants

名前空間: microsoft.graph

指定された driveRecipient エントリをリンクから削除して、共有リンク経由で付与された listItem または driveItem へのアクセスを取り消します。

既にリンクを引き換えた受信者と招待のみを受け取った受信者は両方ともアクセスできなくなります。 許可を取り消すと、この共有リンクからのみ受信者が削除されます。別の共有リンク、直接許可、またはアクセス権を持つグループのメンバーシップを通じて受信者が持つアクセス権は削除されません。

注:

このアクションは、特定のユーザーを対象とした共有リンクでのみサポートされます。

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

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

アクセス許可

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

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

HTTP 要求

POST /drives/{drive-id}/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /me/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /sites/{site-id}/lists/{list-id}/items/{listItem-id}/driveItem/permissions/{perm-id}/revokeGrants
POST /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants

要求ヘッダー

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

要求本文

要求本文で、パラメーターの JSON 表現を指定します。

次の表に、このアクションで使用できるパラメーターを示します。

パラメーター 型 説明
付与先 driveRecipient コレクション 必須です。 共有リンクへのアクセス権が取り消される受信者のコレクション。

応答

成功した場合、このアクションは 200 OK 応答コードと、共有リンクの更新された状態を表す応答本文の アクセス許可 を返します。

返されたアクセス許可の grantedToIdentitiesV2 プロパティには、指定した許可が取り消された後のリンク上の受信者が一覧表示されます。

このアクションは、共有リンクにのみ適用されます。 アイテムに対する直接付与を取り消すために使用することはできません。代わりに 、削除アクセス許可 を使用してください。 共有リンクではないアクセス許可の識別子を指定すると、 400 Bad Request 応答コードが返されます。

共有リンクのスコープを特定のユーザーに設定する必要があります。 スコープが anonymous または organization のリンクは、個々の助成対象者を追跡しません。 これらのリンクには取り消す個別の許可がないため、要求から 400 Bad Request 応答コードが返されます。

エラーが返される方法の詳細については、「 Microsoft Graph のエラー応答とリソースの種類」を参照してください。

例

要求

次の例は、共有リンクで 1 人のユーザーのアクセスを取り消す方法を示しています。

POST https://graph.microsoft.com/v1.0/me/drive/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/permissions/2687a7e0-1b4d-4656-ae32-a4ea393321e1/revokeGrants
Content-Type: application/json

{
  "grantees": [
    {
      "email": "ryan@contoso.com"
    }
  ]
}

応答

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

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

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

{
  "id": "2687a7e0-1b4d-4656-ae32-a4ea393321e1",
  "roles": ["write"],
  "grantedToIdentitiesV2": [
    {
      "user": {
        "id": "e6842c7e-33a1-4207-8b5a-2710922ac2b2",
        "displayName": "Megan Bowen"
      },
      "siteUser": {
        "id": "12",
        "displayName": "Megan Bowen",
        "loginName": "Megan Bowen"
      }
    }
  ],
  "link": {
    "type": "edit",
    "scope": "users",
    "webUrl": "https://contoso-my.sharepoint.com/personal/ellen_contoso_com/..."
  }
}
  • 最終更新: