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. |
project
|
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. |
$expand
|
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 |
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 | |
Identity |
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. |
Properties |
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 |
Web |
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 |
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 |
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 |
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 |
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 |
|
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 |
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 |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de