Compartir a través de

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

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 los servicios Microsoft Entra Connect y Microsoft Entra 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
  • Usuario de Microsoft Store para empresas
  • 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/{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"
        }
    ]
}