Compartilhar via


Listar organizations

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Recupere uma lista de objetos de organização. Existe apenas um objeto de organização na coleção.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante) User.Read, Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Organization.Read.All, Directory.Read.All, Organization.ReadWrite.All, Directory.ReadWrite.All

Para cenários delegados, o utilizador com sessão iniciada tem de ter, pelo menos, uma das seguintes funções do Microsoft Entra.

  • Administrador de Licenças do AdHoc
  • Administrador de Aplicativos
  • Administrador de Autenticação
  • Administrador do Azure Information Protection
  • Administrador do Azure Information Protection
  • Administrador de Cobrança
  • Administrador de Aplicativos de Nuvem
  • Administrador de Dados de Conformidade
  • Aprovador de Acesso do Sistema de Proteção de Dados do Cliente
  • Aprovador de Acesso do Sistema de Proteção de Dados do Cliente
  • Administrador de Análise de Computadores
  • Leitores de Diretórios
  • Revisor de Diretórios
  • Escritores de diretório
  • Administrador do Dynamics 365
  • Administrador do Dynamics 365
  • Leitor Global
  • Utilizador Convidado
  • Administrador da Assistência Técnica
  • Insights do Administrador
  • Administrador do Kaizala
  • Administrador de Licenças
  • Administrador de caixa de correio
  • Administrador de Ambiente de Trabalho Gerido da Microsoft
  • Utilizador da Microsoft Store para Empresas
  • Administrador de Comércio Moderno
  • Administrador do Power BI
  • Administrador do Power BI
  • Administrador de Autenticação Privilegiada
  • Administrador de Função Privilegiada
  • Utilizador Convidado Restrito
  • Administrador de Segurança
  • Operador de Segurança
  • Leitor de Segurança
  • Administrador do Suporte de Serviços
  • Administrador do Teams
  • Administrador de Comunicações do Teams
  • Engenheiro de Suporte de Comunicações de Equipes
  • Especialista em suporte à comunicação de equipes
  • Usuário
  • Administrador do usuário
  • Utilizador do Centro de Empresas de Licenciamento em Volume
  • Utilizador do Centro de Serviços de Licenciamento em Volume

As aplicações concedidas à permissão User.Read só conseguem ler as propriedades id, displayName e verifiedDomains da organização. Todas as outras propriedades são devolvidas com null valores. Para ler todas as propriedades, utilize, pelo menos, Organization.Read.All.

Solicitação HTTP

GET /organization

Parâmetros de consulta opcionais

Este método suporta o $selectparâmetro de consulta OData para ajudar a personalizar a resposta.

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização string {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem-sucedido, este método retorna um código de resposta 200 OK e uma coleção de objetos organization no corpo da resposta. Só é devolvido um objeto na coleção.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/organization
Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

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