パスを使用したサイト リソースの取得

名前空間: microsoft.graph

[サイト][] リソースのプロパティとリレーションシップを取得します。サイト リソースは、SharePoint のチーム サイトを表します。

ID を使用したサイトの取得のほかに、サーバーの相対 URL パスに基づいてサイトを取得できます。

• サイト コレクションのホスト名 (contoso.sharepoint.com)
• サーバーのホスト名を基準にしたサイトのパス。

予約済みのサイト識別子 root もあります。これは次に示すように、常にターゲットのルート サイトを参照します。

• /sites/root:テナントのルート サイト。
• /groups/{group-id}/sites/root:グループのチーム サイト。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

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

HTTP 要求

相対パスを使用してルートの SharePoint サイトにアクセスするには、次のようにします。

GET /sites/{hostname}:/{relative-path}

応答

このメソッドは、一意の識別子によって参照されるサイトの[サイト][] リソースを返します。

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "displayName": "OneDrive Team Site",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}