サイトの列挙Enumerate sites

重要

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.

指定したフィルター条件とクエリオプションに一致する組織内の使用可能なサイトを一覧表示します。List the available sites in an organization that match provided filter criteria and query options.

次のクエリオプションのみが現在サポートされています。Only the following query options are currently supported:

Filter ステートメントFilter statement Select ステートメントSelect statement 説明Description
siteCollection/root ne null siteCollection,webUrl 組織内のすべてのルートレベルのサイトコレクションを一覧表示します。Lists all root-level site collections in the organization. 各地域のホームサイトを検出するのに役立ちます。Useful for discovering the home site for each geography.

また、'/サイト ' コレクションに対して**[検索][]** クエリを使用して、特定のキーワードに一致するサイトを検索することもできます。In addition, you may use a search query against the '/sites' collection to find sites matching given keywords.

アクセス許可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

GET https://graph.microsoft.com/beta/sites?filter=siteCollection/root ne null

Example

要求Request

GET https://graph.microsoft.com/beta/sites?select=siteCollection,webUrl&filter=siteCollection/root%20ne%20null

応答Response

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

{
  "value": [
    {
      "id": "contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740",
      "name": "Contoso USA",
      "root": { },
      "siteCollection": {
        "hostname": "contoso.sharepoint.com",
        "dataLocationCode": "NAM",
        "root": { }
      },
      "webUrl": "https://contoso.sharepoint.com"
    },
    {
      "id": "contoso-jpn.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e851851",
      "name": "Contoso Japan",
      "root": { },
      "siteCollection": {
        "hostname": "contoso-jp.sharepoint.com",
        "dataLocationCode": "JPN",
        "root": { }
      },
      "webUrl": "https://contoso-jp.sharepoint.com"
    }
  ]
}