Comentários Editar

Listar equipes

  • Artigo
  • 2 minutos para o fim da leitura

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 de versão.

Liste todas as equipes em uma organização.

Permissões

Uma das seguintes permissões é obrigató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)
Delegado (conta corporativa ou de estudante) Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo Team.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All

Solicitação HTTP

GET /teams

Parâmetros de consulta opcionais

Este método suporta o $filter, $select, $top, $skiptoken, $count Parâmetros de consulta OData para ajudar a personalizar a resposta.

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório.
Aceitar application/json

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 daequipe no corpo da resposta.

Observação

Atualmente, essa chamada à API retorna apenas as propriedades ID, displayName e description de uma equipe. Para obter todas as propriedades, use a operaçãoObter equipe.

Exemplos

Exemplo 1: Obter uma lista de equipes

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/beta/teams

Resposta

Veja a seguir um exemplo de uma resposta.

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

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

{
  "value": [
    {
      "id": "172b0cce-e65d-44ce-9a49-91d9f2e8493a",
      "displayName": "Contoso Team",
      "description": "This is a Contoso team, used to showcase the range of properties supported by this API"
    },
    {
      "id": "890972b0cce-e65d-44ce-9a49-568hhsd7n",
      "displayName": "Contoso General Team",
      "description": "This is a general Contoso team"
    },
    ,
    {
      "id": "98678abcce0-e65d-44ce-9a49-9980bj8kl0e",
      "displayName": "Contoso API Team",
      "description": "This is Contoso API team"
    }
  ]
}

Exemplo 2: use $filter e $top para obter duas equipes com um nome de exibição que começa com 'A'

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/beta/teams?$filter=startswith(displayName, 'A')&$top=2

Resposta

Veja a seguir um exemplo de uma resposta.

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

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

{
  "value": [
    {
      "id": "172b0cce-e65d-44ce-9a49-91d9f2e8493a",
      "displayName": "A Contoso Team",
      "description": "This is a Contoso team, used to showcase the range of properties supported by this API"
    },
    {
      "id": "890972b0cce-e65d-44ce-9a49-568hhsd7n",
      "displayName": "A Contoso Notification Team",
      "description": "This is a notification Contoso team"
    },
  ]
}

Exemplo 3: use $filter e $select para obter id e descrição para a equipe com displayName igual a "Uma Equipe Contoso"

Solicitação

Este é um exemplo de solicitação.

GET https://graph.microsoft.com/beta/teams?$filter=displayName eq 'A Contoso Team'&$select=id,description

Resposta

Veja a seguir um exemplo de uma resposta.

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

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

{
  "value": [
    {
      "id": "172b0cce-e65d-44ce-9a49-91d9f2e8493a",
      "description": "This is a Contoso team, used to showcase the range of properties supported by this API"
    }
  ]
}

Confira também