Enumerar organizaciones

  • Artículo

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

Para escenarios delegados, el usuario que ha iniciado sesión debe tener al menos uno de los siguientes roles de Microsoft Entra.

  • 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
  • Escritores de directorios
  • Administrador de Dynamics 365
  • Administrador de Dynamics 365
  • Lector global
  • Usuario invitado
  • Administrador del servicio de asistencia
  • 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

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.

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.

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"
                }
            ]
        }
    ]
}