Get organization

  • Artículo

Espacio de nombres: microsoft.graph

Obtenga las propiedades y relaciones de la organización actualmente autenticada.

Desde que laorganización recursos de apoyoextensiones, también puede utilizar la GEToperación para obtener propiedades personalizadas y datos de extensión en una organizaciónde instancia.

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/{organizationId}

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 Descripción
Authorization {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 una colección de un objeto organization en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/organization/dcd219dd-bc68-4b9b-bf0b-4a33a796be35
Respuesta

En el ejemplo siguiente se muestra la respuesta. Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$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": [],
    "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"
        }
    ]
}