Table of contents

Graph API 常见查询

Jimaco Brannian|上次更新日期: 2016/8/22
|
1 参与者

本主题显示可用于 Azure AD Graph API 的常见查询。 有关查询 Graph 时支持的操作的详细信息,请参阅“Azure AD Graph 中支持的查询、筛选器和分页选项”。

重要说明:Azure AD Graph API 功能也可通过 Microsoft Graph 使用,Microsoft Graph 是一个统一的 API,它也包括其他的 Microsoft 服务(如 Outlook、OneDrive、OneNote、Planner 和 Office Graph)的 API,这些都可以使用单个访问令牌通过单个终结点进行访问。

寻址

下面的所有查询全都使用某一域名对租户进行寻址。 你可以使用租户已注册的域名称之一、租户 ID (GUID) 或 MyOrganization 别名(用于委托访问)替换 contoso.com。 有关对租户进行寻址的其他方法,请参阅“对 Graph API 中的实体和操作进行寻址”。

查询顶层资源

以下常见查询使用 contoso.com 作为示例租户,演示如何通过 Graph API 访问顶层资源。 请注意,要运行针对租户的查询,将需要授权标头,该标头包含接收自 Azure AD 的有效持有者令牌。

顶层资源查询结果URI(对于 contoso.com)
顶层资源为目录服务返回顶层资源的 URI 列表(也在下面列出)https://graph.windows.net/contoso.com?api-version=1.6
公司信息返回公司信息https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6
联系人返回组织联系人信息https://graph.windows.net/contoso.com/contacts?api-version=1.6
Users返回用户信息https://graph.windows.net/contoso.com/users?api-version=1.6
返回组数据https://graph.windows.net/contoso.com/groups?api-version=1.6
目录角色返回租户中所有已激活的目录角色https://graph.windows.net/contoso.com/roles?api-version=1.6
SubscribedSkus返回租户的订阅https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6
目录元数据返回描述数据模型的服务元数据文档(即,目录资源的结构和组织)https://graph.windows.net/contoso.com/$metadata?api-version=1.6

查询操作

下表展示一些将 contoso.com 用作示例租户的示例 Graph API 查询。

查询操作URI(对于 contoso.com)
列出所有用户和组https://graph.windows.net/contoso.com/users?api-version=1.6

https://graph.windows.net/contoso.com/groups?api-version=1.6
通过指定 objectId 或 userPrincipalName 检索单独用户https://graph.windows.net/contoso.com/users/d1f67a6c-02c9-4fe5-81fb-58160ce24fe5?api-version=1.6

https://graph.windows.net/contoso.com/users/admin@contoso.com?api-version=1.6
请求并筛选 displayName 等于“Jon Doe”的用户https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6
请求并筛选 firstName 等于“Jon”的特定用户https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6
筛选 givenName 和 surname 值。https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6
通过指定 objectId 检索单个组https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6
检索用户的经理https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6
检索用户的直接下属列表https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6
检索到用户的直接下属的链接列表https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6
检索某一组的成员身份列表https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6
检索到某一组的成员的链接列表。https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6
检索用户的组成员身份(不可传递)https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6
检索该用户是其成员的组的列表(不可传递)https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6
请求并筛选 displayName >= "az" 和 <= "dz" 的组https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6

注意:查询字符串中的空格应先进行 URL 编码,然而才能发送请求。 例如,对下列查询字符串 https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 进行 URL 编码后应为:https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6

© 2017 Microsoft