Teams - Get Teams
Ottenere un elenco di team.
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
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
organization
|
path | True |
string |
Nome dell'organizzazione di Azure DevOps. |
project
|
path | True |
string |
|
api-version
|
query | True |
string |
Versione dell'API da usare. Deve essere impostato su '7.1-preview.3' per usare questa versione dell'API. |
$expand
|
query |
boolean |
Valore che indica se espandere o meno le informazioni sull'identità nell'oggetto WebApiTeam risultante. |
|
$mine
|
query |
boolean |
Se true restituisce tutti i team che richiedono che l'utente sia membro, in caso contrario restituisce l'accesso in lettura a tutti gli utenti di teams. |
|
$skip
|
query |
integer int32 |
Numero di team da ignorare. |
|
$top
|
query |
integer int32 |
Numero massimo di team da restituire. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
operazione riuscita |
Sicurezza
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 | Descrizione |
---|---|
vso.profile | Concede la possibilità di leggere il profilo, gli account, le raccolte, i progetti, i team e altri artefatti dell'organizzazione di primo livello. |
vso.project | Concede la possibilità di leggere progetti e team. |
Esempio
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
}
Definizioni
Nome | Descrizione |
---|---|
Identity | |
Identity |
Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID. |
Properties |
La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un |
Web |
Identity
Nome | Tipo | Descrizione |
---|---|---|
customDisplayName |
string |
Nome visualizzato personalizzato per l'identità (se presente). L'impostazione di questa proprietà su una stringa vuota cancella il nome visualizzato personalizzato esistente. L'impostazione di questa proprietà su Null non influirà sul valore persistente esistente (poiché i valori Null non vengono inviati tramite rete o al database) |
descriptor |
Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID. |
|
id |
string |
Identificatore di identità. Chiamata anche chiave di archiviazione o VSID |
isActive |
boolean |
True se l'identità ha un'appartenenza a un gruppo Azure Devops nell'organizzazione. |
isContainer |
boolean |
True se l'identità è un gruppo. |
masterId |
string |
|
memberIds |
string[] |
ID dei membri dell'identità (solo gruppi). |
memberOf |
Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID. |
|
members |
Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID. |
|
metaTypeId |
integer |
|
properties |
La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un |
|
providerDisplayName |
string |
Nome visualizzato per l'identità come specificato dal provider di identità di origine. |
resourceVersion |
integer |
|
socialDescriptor |
string |
|
subjectDescriptor |
string |
Descrittore soggetto di un'entità Graph. |
uniqueUserId |
integer |
IdentityDescriptor
Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.
Nome | Tipo | Descrizione |
---|---|---|
identifier |
string |
Identificatore univoco per questa identità, non superiore a 256 caratteri, che verranno salvati in modo permanente. |
identityType |
string |
Tipo di descrittore (ad esempio, Windows, Passport e così via). |
PropertiesCollection
La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object
) ad eccezione DBNull
di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.
Nome | Tipo | Descrizione |
---|---|---|
count |
integer |
Conteggio delle proprietà nell'insieme. |
item |
object |
|
keys |
string[] |
Set di chiavi nell'insieme. |
values |
string[] |
Set di valori nell'insieme. |
WebApiTeam
Nome | Tipo | Descrizione |
---|---|---|
description |
string |
Descrizione del team |
id |
string |
Guid del team (identità). ID Team Foundation. |
identity |
Identità del team. |
|
identityUrl |
string |
URL dell'API REST di identità per questo team |
name |
string |
Nome della squadra |
projectId |
string |
|
projectName |
string |
|
url |
string |
URL DELL'API REST del team |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per