Получение организации
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Получение свойств и связей организации, прошедшей проверку подлинности.
Так как ресурс organization поддерживает расширения, с помощью операции GET
вы можете получить настраиваемые свойства и данные расширения в экземпляре организации.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | User.Read, Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Для приложения | Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All |
Приложения, которым предоставлено разрешение User.Read , могут читать только свойства id, displayName и verifiedDomains организации. Все остальные свойства возвращаются со значениями null
. Чтобы прочитать все свойства, используйте по крайней мере Organization.Read.All.
В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие роли с наименьшими привилегиями.
- Администратор лицензий AdHoc
- Администратор приложений
- Администратор проверки подлинности
- Администратор Azure Information Protection
- Администратор Azure Information Protection
- Администратор выставления счетов
- Администратор облачных приложений
- Администратор данных соответствия требованиям
- Утверждающий доступ к lockBox клиента
- Утверждающий доступ к lockBox клиента
- Администратор аналитики компьютеров
- Читатели каталогов
- Рецензент каталога
- Учетные записи синхронизации каталогов — для служб Microsoft Entra Connect и Microsoft Entra Cloud Sync
- Запись каталогов
- Администратор Dynamics 365
- Администратор Dynamics 365
- Глобальный читатель
- Гостевой пользователь
- Администратор службы поддержки
- Администратор гибридных удостоверений
- Администратор Insights
- Администратор Kaizala
- Администратор лицензий
- Администратор почтового ящика
- Администратор компьютеров, управляемых Корпорацией Майкрософт
- Пользователь Microsoft Store для бизнеса
- Администратор современной коммерции
- Администратор Power BI
- Администратор Power BI
- Привилегированный администратор проверки подлинности
- Администратор привилегированных ролей
- Ограниченный гостевой пользователь
- Администратор безопасности
- Оператор безопасности
- Читатель сведений о безопасности
- Администратор поддержки служб
- Администратор Teams
- Администратор коммуникаций Teams
- Инженер службы поддержки связи Teams
- Специалист службы поддержки связи Teams
- Пользователь
- Администратор пользователей
- Пользователь корпоративного центра лицензирования
- Пользователь центра обслуживания корпоративного лицензирования
HTTP-запрос
GET /organization/{organizationId}
Необязательные параметры запросов
Этот метод поддерживает только $select
параметр запроса OData для настройки ответа.
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
При успешном выполнении этот метод возвращает код отклика 200 OK
и коллекцию из одного объекта organization в тексте отклика.
Пример
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/beta/organization/84841066-274d-4ec0-a5c1-276be684bdd3
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#organization/$entity",
"id": "84841066-274d-4ec0-a5c1-276be684bdd3",
"deletedDateTime": null,
"businessPhones": [
"425-555-0100"
],
"city": null,
"country": null,
"countryLetterCode": "NL",
"createdDateTime": "2021-08-02T10:30:06Z",
"defaultUsageLocation": "String",
"displayName": "Contoso",
"isMultipleDataLocationsForServicesEnabled": null,
"marketingNotificationEmails": [],
"onPremisesLastPasswordSyncDateTime": "2021-08-02T10:30:06Z",
"onPremisesLastSyncDateTime": null,
"onPremisesSyncEnabled": null,
"partnerTenantType": "ResellerPartnerDelegatedAdmin",
"postalCode": null,
"preferredLanguage": "en",
"securityComplianceNotificationMails": [],
"securityComplianceNotificationPhones": [],
"state": null,
"street": null,
"technicalNotificationMails": [
"admin@contoso.com"
],
"tenantType": "AAD",
"directorySizeQuota": {
"used": 698,
"total": 50000
},
"assignedPlans": [
{
"assignedDateTime": "2022-04-03T02:46:42Z",
"capabilityStatus": "Deleted",
"service": "Adallom",
"servicePlanId": "932ad362-64a8-4783-9106-97849a1a30b9"
},
{
"assignedDateTime": "2022-04-03T02:46:42Z",
"capabilityStatus": "Deleted",
"service": "MultiFactorService",
"servicePlanId": "8a256a2b-b617-496d-b51b-e76466e88db0"
},
{
"assignedDateTime": "2021-08-02T10:36:57Z",
"capabilityStatus": "Enabled",
"service": "exchange",
"servicePlanId": "113feb6c-3fe4-4440-bddc-54d774bf0318"
},
{
"assignedDateTime": "2021-08-02T10:36:02Z",
"capabilityStatus": "Deleted",
"service": "SCO",
"servicePlanId": "882e1d05-acd1-4ccb-8708-6ee03664b117"
}
],
"privacyProfile": {
"contactEmail": "",
"statementUrl": ""
},
"provisionedPlans": [
{
"capabilityStatus": "Deleted",
"provisioningStatus": "Success",
"service": "Adallom"
},
{
"capabilityStatus": "Enabled",
"provisioningStatus": "Success",
"service": "exchange"
}
],
"verifiedDomains": [
{
"capabilities": "Email, OfficeCommunicationsOnline",
"isDefault": true,
"isInitial": true,
"name": "Contoso.com",
"type": "Managed"
}
]
}