Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получение списка объектов agentUser и их свойств.
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения | Разрешение с наименьшими привилегиями | Более высокие привилегированные разрешения |
|---|---|---|
| Делегированные (рабочая или учебная учетная запись) | User.ReadBasic.All | User.Read.All, AgentIdUser.ReadWrite.IdentityParentedBy, AgentIdUser.ReadWrite.All, User.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
| Приложение | User.ReadBasic.All | User.Read.All, AgentIdUser.ReadWrite.IdentityParentedBy, AgentIdUser.ReadWrite.All, User.ReadWrite.All |
HTTP-запрос
GET /users/microsoft.graph.AgentUser
Необязательные параметры запросов
Этот метод поддерживает параметры запроса OData для настройки ответа:
-
$count,$expand,$filter,$orderby,$search,$select,$top. Параметр$skipне поддерживается. -
Ограничения на размер страницы: Размер страницы по умолчанию — 100 объектов. Максимальный размер страницы — 999 объектов, за исключением случаев использования
$select=signInActivityили$filter=signInActivity, максимальный размер страницы — 500. - Для некоторых запросов необходимо задать для заголовка ConsistencyLevel значение
eventualи$count. Дополнительные сведения см. в разделе Расширенные возможности запросов к объектам каталогов.
Заголовки запросов
| Имя | Описание |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов agentUser в теле отклика.
Примеры
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/beta/users/microsoft.graph.agentUser
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value":
{
"@odata.type": "#microsoft.graph.agentUser",
"id": "84e0b4dc-e852-29ed-1e5d-9e1f335611e8",
"deletedDateTime": "String (timestamp)",
"signInActivity": {
"@odata.type": "microsoft.graph.signInActivity"
},
"cloudLicensing": {
"@odata.type": "microsoft.graph.cloudLicensing.userCloudLicensing"
},
"accountEnabled": "Boolean",
"ageGroup": null,
"assignedLicenses": [
{
"@odata.type": "microsoft.graph.assignedLicense"
}
],
"assignedPlans": [
{
"@odata.type": "microsoft.graph.assignedPlan"
}
],
"authorizationInfo": null,
"businessPhones": [
"String"
],
"city": "String",
"cloudRealtimeCommunicationInfo": {
"@odata.type": "microsoft.graph.cloudRealtimeCommunicationInfo"
},
"companyName": "String",
"consentProvidedForMinor": null,
"country": "String",
"createdDateTime": "String (timestamp)",
"creationType": "String",
"department": "String",
"displayName": "String",
"employeeHireDate": "String (timestamp)",
"employeeId": "String",
"employeeOrgData": {
"@odata.type": "microsoft.graph.employeeOrgData"
},
"employeeType": "String",
"employeeLeaveDateTime": "String (timestamp)",
"faxNumber": "String",
"givenName": "String",
"identities": [
{
"@odata.type": "microsoft.graph.objectIdentity"
}
],
"imAddresses": [
"String"
],
"infoCatalogs": [
"String"
],
"isLicenseReconciliationNeeded": "Boolean",
"isManagementRestricted": "Boolean",
"isResourceAccount": "Boolean",
"jobTitle": "String",
"lastPasswordChangeDateTime": null,
"legalAgeGroupClassification": null,
"licenseAssignmentStates": [
{
"@odata.type": "microsoft.graph.licenseAssignmentState"
}
],
"mail": "String",
"mailNickname": "String",
"mobilePhone": "String",
"onPremisesDistinguishedName": null,
"onPremisesExtensionAttributes": null,
"onPremisesImmutableId": null,
"onPremisesLastSyncDateTime": null,
"onPremisesProvisioningErrors": null,
"onPremisesSecurityIdentifier": null,
"onPremisesSipInfo": null,
"onPremisesSyncEnabled": null,
"onPremisesDomainName": null,
"onPremisesSamAccountName": null,
"onPremisesUserPrincipalName": null,
"otherMails": [
"String"
],
"passwordPolicies": null,
"passwordProfile": null,
"officeLocation": "String",
"postalCode": "String",
"preferredDataLocation": "String",
"preferredLanguage": "String",
"provisionedPlans": [
{
"@odata.type": "microsoft.graph.provisionedPlan"
}
],
"proxyAddresses": [
"String"
],
"refreshTokensValidFromDateTime": "String (timestamp)",
"securityIdentifier": "String",
"serviceProvisioningErrors": [
{
"@odata.type": "microsoft.graph.serviceProvisioningXmlError"
}
],
"showInAddressList": "Boolean",
"signInSessionsValidFromDateTime": "String (timestamp)",
"state": "String",
"streetAddress": "String",
"surname": "String",
"usageLocation": "String",
"userPrincipalName": "String",
"externalUserState": null,
"externalUserStateChangeDateTime": null,
"userType": "String",
"identityParentId": "String",
"mailboxSettings": {
"@odata.type": "microsoft.graph.mailboxSettings"
},
"aboutMe": "String",
"birthday": "String (timestamp)",
"interests": [
"String"
],
"mySite": "String",
"pastProjects": [
"String"
],
"preferredName": "String",
"responsibilities": [
"String"
],
"schools": [
"String"
],
"skills": [
"String"
]
}
}