Teams - Get Teams

Obtenha uma lista de equipes.

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?api-version=7.1-preview.3
GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?$mine={$mine}&$top={$top}&$skip={$skip}&$expandIdentity={$expandIdentity}&api-version=7.1-preview.3

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
path True

string

O nome da organização do Azure DevOps.

projectId
path True

string

api-version
query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1-preview.3' para usar essa versão da API.

$expandIdentity
query

boolean

Um valor que indica se as informações de identidade devem ou não ser expandidas no objeto WebApiTeam resultante.

$mine
query

boolean

Se true retornar todas as equipes que solicitam que o usuário seja membro, caso contrário, retorne que todos os usuários das equipes tenham acesso de leitura.

$skip
query

integer

int32

Número de equipes a serem ignoradas.

$top
query

integer

int32

Número máximo de equipes a serem retornadas.

Respostas

Nome Tipo Description
200 OK

WebApiTeam[]

operação bem-sucedida

Segurança

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Nome Description
vso.profile Concede a capacidade de ler seu perfil, contas, coleções, projetos, equipes e outros artefatos organizacionais de nível superior.
vso.project Concede a capacidade de ler projetos e equipes.

Exemplos

Sample Request

GET https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams?api-version=7.1-preview.3

Sample Response

{
  "value": [
    {
      "id": "564e8204-a90b-4432-883b-d4363c6125ca",
      "name": "Quality assurance",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/564e8204-a90b-4432-883b-d4363c6125ca",
      "description": "Testing staff",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/564e8204-a90b-4432-883b-d4363c6125ca"
    },
    {
      "id": "66df9be7-3586-467b-9c5f-425b29afedfd",
      "name": "Fabrikam-Fiber-TFVC Team",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/66df9be7-3586-467b-9c5f-425b29afedfd",
      "description": "The default project team.",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/66df9be7-3586-467b-9c5f-425b29afedfd"
    }
  ],
  "count": 2
}

Definições

Nome Description
Identity
IdentityDescriptor

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

PropertiesCollection

A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Valores de todos os tipos primitivos (qualquer tipo com um TypeCode != TypeCode.Object) exceto para DBNull são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.

WebApiTeam

Identity

Nome Tipo Description
customDisplayName

string

O nome de exibição personalizado para a identidade (se houver). Definir essa propriedade como uma cadeia de caracteres vazia limpará o nome de exibição personalizado existente. Definir essa propriedade como null não afetará o valor persistente existente (já que os valores nulos não são enviados pela transmissão ou pelo banco de dados)

descriptor

IdentityDescriptor

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

id

string

Identificador de identidade. Também chamado de Chave de Armazenamento ou VSID

isActive

boolean

True se a identidade tiver uma associação em qualquer grupo do Azure Devops na organização.

isContainer

boolean

True se a identidade for um grupo.

masterId

string

memberIds

string[]

ID dos membros da identidade (somente grupos).

memberOf

IdentityDescriptor[]

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

members

IdentityDescriptor[]

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

metaTypeId

integer

properties

PropertiesCollection

A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Valores de todos os tipos primitivos (qualquer tipo com um TypeCode != TypeCode.Object) exceto para DBNull são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.

providerDisplayName

string

O nome de exibição da identidade, conforme especificado pelo provedor de identidade de origem.

resourceVersion

integer

socialDescriptor

string

subjectDescriptor

string

Descritor de assunto de uma entidade do Graph.

uniqueUserId

integer

IdentityDescriptor

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

Nome Tipo Description
identifier

string

O identificador exclusivo dessa identidade, não excedendo 256 caracteres, que serão persistidos.

identityType

string

Tipo de descritor (por exemplo, Windows, Passport etc.).

PropertiesCollection

A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Valores de todos os tipos primitivos (qualquer tipo com um TypeCode != TypeCode.Object) exceto para DBNull são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.

Nome Tipo Description
count

integer

A contagem de propriedades na coleção.

item

object

keys

string[]

O conjunto de chaves na coleção.

values

string[]

O conjunto de valores na coleção.

WebApiTeam

Nome Tipo Description
description

string

Descrição da equipe

id

string

Guid da Equipe (Identidade). Uma ID do Team Foundation.

identity

Identity

Identidade da equipe.

identityUrl

string

Url da API REST de identidade para essa equipe

name

string

Nome da equipe

projectId

string

projectName

string

url

string

URL da API REST da Equipe