Enumerar organizaciones
Espacio de nombres: microsoft.graph
Recupera una lista de objetos organization. Solo hay un objeto de organización en la colección.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All |
Importante
Las aplicaciones a las que se concede el permiso User.Read solo pueden leer las propiedades id, displayName y verifiedDomains de la organización. Todas las demás propiedades devuelven valores null . Para leer todas las propiedades, use al menos Organization.Read.All.
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. Se admiten los siguientes roles con privilegios mínimos para esta operación.
- Administrador de licencias de AdHoc
- Administrador de la aplicación
- Administrador de autenticación
- Administrador de Azure Information Protection
- Administrador de Azure Information Protection
- Administrador de facturación
- Administrador de aplicaciones en la nube
- Administrador de datos de cumplimiento
- Aprobador de acceso de caja de seguridad del cliente
- Aprobador de acceso de caja de seguridad del cliente
- Administrador de Análisis de escritorio
- Lectores de directorio
- Revisor de directorios
- Cuentas de sincronización de directorios: para Microsoft Entra Connect y Microsoft Entra servicios de Cloud Sync
- Escritores de directorios
- Administrador de Dynamics 365
- Administrador de Dynamics 365
- Lector global
- Usuario invitado
- Administrador del servicio de asistencia
- Administrador de identidades híbridas
- Administrador de Insights
- Administrador de Kaizala
- Administrador de licencias
- Administrador de buzones
- Administrador de Escritorio administrado de Microsoft
- Microsoft Store para Empresas usuario
- Administrador de comercio moderno
- Administrador de Power BI
- Administrador de Power BI
- Administrador de autenticación con privilegios
- Administrador de roles con privilegios
- Usuario invitado restringido
- Administrador de seguridad
- Operador de seguridad
- Lector de seguridad
- Administrador de soporte técnico de servicio
- Administrador de Teams
- Administrador de comunicaciones de Teams
- Ingeniero de soporte en comunicaciones de Teams
- Especialista de soporte en comunicaciones de Teams
- Usuario
- Administrador de usuarios
- Usuario del Centro de negocios de licencias por volumen
- Usuario del Centro de servicios de licencias por volumen
Solicitud HTTP
GET /organization
Parámetros de consulta opcionales
Este método admite el $selectparámetro de consulta OData para ayudar a personalizar la respuesta.
Encabezados de solicitud
| Nombre | Tipo | Descripción |
|---|---|---|
| Authorization | string | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de objetos organization en el cuerpo de la respuesta. Solo se devuelve un objeto en la colección.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/organization
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#organization",
"value": [
{
"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": [],
"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"
}
]
}
]
}