パスを使用したサイト リソースの取得Get a site resource by path

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

サイト リソースのプロパティとリレーションシップを取得します。サイト リソースは、SharePoint のチーム サイトを表します。Retrieve properties and relationships for a site resource. A site resource represents a team site in SharePoint.

ID を使用したサイトの取得のほかに、サーバーの相対 URL パスに基づいてサイトを取得できます。In addition to retrieving a site by ID you can retrieve a site based on server-relative URL path.

  • サイト コレクションのホスト名 (contoso.sharepoint.com)Site collection hostname (contoso.sharepoint.com)
  • サーバーのホスト名を基準にしたサイトのパス。Site path, relative to server hostname.

予約済みのサイト識別子 root もあります。これは次に示すように、常にターゲットのルート サイトを参照します。There is also a reserved site identifier, root, which always references the root site for a given target, as follows:

  • /sites/root:テナントのルート サイト。/sites/root: The tenant root site.
  • /groups/{group-id}/sites/root:グループのチーム サイト。/groups/{group-id}/sites/root: The group's team site.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Sites.Read.All、Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication Sites.Read.All、Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All

HTTP 要求HTTP Request

相対パスを使用してルートの SharePoint サイトにアクセスするには、次のようにします。To access the root SharePoint site with a relative path:

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

応答Response

このメソッドは、一意の識別子によって参照されるサイトのサイト リソースを返します。This method returns a site resource for the site referenced by the unique identifier.

HTTP/1.1 200 OK

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "owner": {
    "user": { 
      "displayName": "Daron Spektor",
      "id": "5280E7FE-DC7A-4486-9490-E790D81DFEB3"
    }
  },
  "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"
}